3.2.10.2. 用 JNDI 远程调用 Session Bean

过程 3.22. 为 session bean 的远程商业接口添加 Maven 项目依赖关系。

1. 添加所需的项目依赖关系

   必须更新项目的 pom.xml 以包含必要的依赖关系。

2. 添加 jboss-ejb-client.properties 文件

   JBoss EJB 客户 API 期望在项目根目录找到名为 jboss-ejb-client.properties 的文件，它包含 JNDI 服务的连接信息。添加这个文件到项目的 src/main/resources/ 目录并包含下列内容。

   # 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
   根据您的服务器来修改主机名和端口号。4447 是默认的端口号码。对于安全的连接，请将 SSL_ENABLED 一行设置为 true 并取消 SSL_STARTTLS 行的注释。容器里的 Remoting 接口支持使用相同端口的安全和不安全的连接。

3. 为远程商业接口添加依赖关系

   在 pom.xml 里为 session bean 的远程商业接口添加 Maven 依赖关系。

   <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

过程 3.23. 用 JNDI 获取 Bean 代理并调用 Bean 的方法

1. 处理 checked 异常

   下面代码里的两个方法 (InitialContext() 和 lookup()) 都会抛出类型为 javax.naming.NamingException 的 checked 异常。这些方法调用必须包括在捕获 NamingException 的 try/catch 块里，或者是再声明抛出 NamingException 的方法里。ejb-remote quickstart 使用了第二种方法。

2. 创建一个 JNDI 上下文

   JNDI 上下文对象提供了从服务器请求资源的机制。请使用下列代码创建 JNDI 上下文：

   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
   JNDI 服务的连接属性是从 jboss-ejb-client.properties 文件里读取的。

3. 使用 JNDI Context's lookup() 方法来获取 bean 代理

   调用 bean 代理的 lookup() 方法并将您请求的 session bean 的 JNDI 名称传入。这将返回一个对象，它必须转换为包含您要调用的方法的远程商业接口的类型。

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

   Copy to Clipboard Toggle word wrap
   Session bean 的 JNDI 名称是用特殊语法定义的。详情请参考 第 3.2.10.3 节 “EJB JNDI 命名引用” 。

4. 调用方法

   现在您已有一个代理 bean 对象，您可以调用远程商业接口里包含的任何方法了。

   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
   代理 bean 将方法调用请求传入服务器上的 session bean。其结果被返回到代理 bean，然后再返回给调用者。代理 bean 和远程 session bean 间的通讯对于调用者来说是透明的。