Conectando-se às Instâncias do ObjectGrid Distribuído Programaticamente

É possível conectar a um ObjectGrid distribuído aos terminais de conexão para o domínio de serviço do catálogo. É necessário ter o nome do host e a porta do listener de cada servidor de catálogos no domínio de serviço de catálogo com o qual deseja se conectar.

Antes de Iniciar

Sobre Esta Tarefa

Ao executar em um aplicativo Java EE, considere usar o adaptador de recursos eXtreme Scale. O adaptador de recursos permite que o aplicativo consulte uma conexão ObjectGrid no Java Naming Directory Interface (JNDI) usando um connection factory do Java Connector Architecture (JCA), que simplifica significativamente o acesso à grade de dados e permite a integração com transações Java Transaction API (JTA). Para obter informações adicionais, consulte Usando o JCA para Conectar os Aplicativos Transacionais aos Clientes do eXtreme Scale.

Os métodos ObjectGridManager.connect() se conectam a um domínio de serviço de catálogo usando os terminais de conexão fornecidos e retorna um objeto ClientClusterContext que é usado para recuperar as instâncias ObjectGrid para o domínio. Os terminais de conexão são uma lista delimitada por vírgula de combinações de host e de porta para cada servidor de catálogos no domínio de serviço de catálogo. Consulte o formato a seguir de terminais de serviço de catálogo:
catalogServiceEndpoints ::= <catalogServiceEndpoint> [,<catalogServiceEndpoint>]
catalogServiceEndpoint  ::= <hostName> : <listenerPort>
hostName                ::= The IP address or host name of a catalog service.
listenerPort            ::= The listener port that the catalog service is configured to use.

Depois de se conectar ao domínio de serviço de catálogo, use o método ObjectGridManagerFactory.getObjectGrid(ClientClusterContext ccc, String objectGridName) para recuperar uma instância de cliente ObjectGrid nomeada. Essa instância do ObjectGrid é um proxy para a grade de dados nomeada e é armazenada em cache no aplicativo cliente. A instância ObjectGrid representa uma conexão lógica para a grade de dados remota e tem encadeamento seguro. Todas as conexões físicas subjacentes para a grade de dados são gerenciadas automaticamente e podem tolerar eventos de falha.

As etapas de conexão variam dependendo de você estar usando uma configuração independente ou WebSphere Application Server.

Procedimento

O que Fazer Depois

Se o domínio de serviço de catálogo estiver hospedado em um gerenciador de implementação WebSphere Application Server, os clientes fora da célula, incluindo os clientes Java Platform, Enterprise Edition, devem se conectar ao serviço de catálogo usando o nome do host do gerenciador de implementação e a porta de autoinicialização IIOP. Quando o serviço de catálogo for executado nas células do WebSphere Application Server e os clientes forem executados fora das células, consulte as páginas de configuração de domínio do eXtreme Scale no console administrativo WebSphere Application Server para obter as informações que você precisa para apontar um cliente para o serviço do catálogo.