3.2.10.2. Invocação Remota de um Bean de Sessão usando JNDI

Procedimento 3.22. Adição da Configuração do Projeto Maven para Invocação Remota dos Beans de Sessão

1. Adicione as dependências do projeto necessárias

   O pom.xml para o projeto deve ser atualizado para incluir as dependências necessárias.

2. Adicione o arquivo jboss-ejb-client.properties

   A API do cliente EJB JBoss espera encontrar um arquivo na raiz do projeto nomeado jboss-ejb-client.properties que contenha a informação da conexão para o serviço JNDI. Adicione este arquivo ao diretório src/main/resources/ do seu projeto com o seguinte conteúdo.

   # In the following line, set SSL_ENABLED to true for SSL
   remote.connectionprovider.create.options.org.xnio.Options.SSL_ENABLED=false
   remote.connections=default
   # Uncomment the following line to set SSL_STARTTLS to true for SSL
   # remote.connection.default.connect.options.org.xnio.Options.SSL_STARTTLS=true
   remote.connection.default.host=localhost
   remote.connection.default.port = 4447
   remote.connection.default.connect.options.org.xnio.Options.SASL_POLICY_NOANONYMOUS=false
   # Add any of the following SASL options if required
   # remote.connection.default.connect.options.org.xnio.Options.SASL_POLICY_NOANONYMOUS=false
   # remote.connection.default.connect.options.org.xnio.Options.SASL_POLICY_NOPLAINTEXT=false
   # remote.connection.default.connect.options.org.xnio.Options.SASL_DISALLOWED_MECHANISMS=JBOSS-LOCAL-USER
   

   Copy to Clipboard Toggle word wrap
   Altere a porta e o nome do host para coincidir com o seu servidor. 4447 é o número de porta padrão. Para uma conexão segura, configure a linha SSL_ENABLED como true e remova os comentários da linha SSL_STARTTLS. A interface remota no contêiner suporta as conexões seguras e não seguras usando a mesma porta.

3. Adicione dependências para as interfaces comerciais remotas

   Adicione as dependências Maven ao pom.xml para as interfaces comerciais remotas dos beans de sessão.

   <dependency>
      <groupId>org.jboss.as.quickstarts</groupId>
      <artifactId>jboss-ejb-remote-server-side</artifactId>
      <type>ejb-client</type>
      <version>${project.version}</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

Procedimento 3.23. Obtenção de um Proxy Bean usando JNDI e Invocação de Métodos do Bean

1. Maneje as exceções verificadas

   Dois dos métodos usados nos códigos a seguir (InitialContext() e lookup()) possuem uma exceção verificada do tipo javax.naming.NamingException. Essas chamadas de método devem estar inseridas em um bloco de tentativa/captura que capture NamingException ou em um método que seja declarado para lançar NamingException. O início rápido ejb-remote utiliza a segunda técnica.

2. Crie um Contexto JNDI

   Um objeto do Contexto JNDI fornece o mecanismo para solicitar recursos do servidor. Crie um contexto JNDI usando o seguinte código:

   final Hashtable jndiProperties = new Hashtable();
   jndiProperties.put(Context.URL_PKG_PREFIXES, "org.jboss.ejb.client.naming");
   final Context context = new InitialContext(jndiProperties);

   Copy to Clipboard Toggle word wrap
   As propriedades de conexão para o serviço JNDI são lidas a partir do arquivo jboss-ejb-client.properties.

3. Use o método lookup() do Contexto JNDI para obter um proxy bean

   Invoque o método lookup() do proxy bean e passe-o o nome JNDI do bean de sessão que você necessita. Isto retornará um objeto que deve ser convertido para o tipo da interface comercial remota que contém os métodos que você deseja invocar.

   final RemoteCalculator statelessRemoteCalculator = (RemoteCalculator) context.lookup(
       "ejb:/jboss-ejb-remote-server-side//CalculatorBean!" + 
       RemoteCalculator.class.getName());
   

   Copy to Clipboard Toggle word wrap
   Os nomes JNDI de bean de sessão são definidos usando uma sintaxe especial. Consulte Seção 3.2.10.3, “Referência de Nomeação JNDI EJB ” para mais informações.

4. Invocação de Métodos

   Agora que você possui um objeto bean proxy, você pode invocar qualquer um dos métodos contidos na interface comercial remota.

   int a = 204;
   int b = 340;
   System.out.println("Adding " + a + " and " + b + " via the remote stateless calculator deployed on the server");
   int sum = statelessRemoteCalculator.add(a, b);
   System.out.println("Remote calculator returned sum = " + sum);

   Copy to Clipboard Toggle word wrap
   O bean proxy passa a solicitação de invocação do método para o bean de sessão no servidor, onde é executado. O resultado é retornado ao bean proxy que, então, o retorna ao chamador. A comunicação entre o bean proxy e o bean de sessão remoto é transparente ao chamador.