本地&远程访问一个EJB | 从开发角度看应用架构4

魏新宇

发布于 2018-06-25 15:06:49

1.3K0

发布于 2018-06-25 15:06:49

文章被收录于专栏：大魏分享（微信公众号：david-share）大魏分享（微信公众号：david-share）

一、前言

本文仅代表作者的个人观点；

本文的内容仅限于技术探讨，不能作为指导生产环境的素材；

本文素材是红帽公司产品技术和手册；

本文分为系列文章，将会有多篇，初步预计将会有9篇。

二、对EJB的访问方式

EJB是一个包含在应用程序服务器上运行的业务逻辑的可移植组件。如果客户端和EJB是同一应用程序的一部分，则客户端可以在本地访问EJB，如果EJB在远程运行，则客户端可以通过远程接口访问EJB。

如果客户端和EJB是本地的，也就是说，它们在相同的JVM进程中运行，则客户端可以调用EJB中的所有公共方法。在EJB远程的情况下，必须提供一个远程接口，它是一个公开EJB业务方法的简单Java接口。 EJB类实现远程接口中的方法，其实现细节对客户端是隐藏的。

使用@EJB注释访问本地EJB

假设已经定义了如下的EJB：

@Stateless

public class TodoBean {

  public void addTodo(TodoItem item) {
  ...
  }

  public void findTodo(int id) {
  ...
  }
  ...
  }
...
}

客户可以通过使用@EJB注释将EJB直接注入到代码中来调用EJB上的方法：

public class TodoClient {  @EJB
  TodoBean todo;

  TodoItem item = new TodoItem();
  item.setDescription("Buy milk");
  item.setStatus("PENDING");

  //invoke EJB methods
  todo.addTodo(item);
...
}

访问远程EJB

在客户机在Java EE应用程序服务器的上下文之外运行的情况下，或者在应用程序服务器上运行的Java EE组件需要访问部署在远程应用程序服务器上的另一个EJB的情况下，可以使用JNDI来查找EJB。

为了确保远程客户端可以使用EJB，必须声明一个列出EJB业务方法的接口，并让EJB实现并覆盖这些方法。例如，假设希望提供执行各种数学操作的EJB，请声明一个接口并列出如下所示的方法：

package com.redhat.training.ejb;public interface Calculator {

  public int add(int a, int b);
  public int multiply(int a, int b);
...
}

我们现在必须在EJB中提供这些方法的具体实现，并通过使用@Remote注释指出Calculator是EJB的远程接口：

package com.redhat.training.ejb;@Stateless@Remote(Calculator.class)

public class CalculatorBean implements Calculator {

  @Override
  public int add(int a, int b) {
    return a + b;
  }

  @Override
  public int multiply(int a, int b) {
    return a * b;
  }
  ...
  }
...
}

我们的EJB现在可以打包并部署在应用服务器上，并可以为远程客户端提供服务。

三、使用JNDI查找远程EJB

Java EE标准为客户端指定了标准的JNDI查找方案来查找EJB。示例如下：

/<application-name>/<module-name>/<bean-name>!<fully-qualified-interface-name>

application-name：应用程序名称是部署EJB的EAR的名称（没有.ear扩展名）。如果EJB JAR没有在EAR中部署，那么这是空白的。应用程序名称也可以在EAR的application.xml部署描述符中指定。

module-name：默认情况下，模块名称是EJB JAR文件的名称（不带.jar后缀）。模块名称可以在ejb-jar.xml部署描述符中重写。

bean-name：要调用的EJB的名称（实现类）。

fully-qualified-interface-name：远程接口的完全限定类名。包括完整的软件包名称。

考虑到上面的代码清单，假设EJB打包在名为calculator-ejb.jar的文件中，该文件被进一步打包到名为myapp.ear的EAR文件中。客户端可以使用以下查找字符串查找EJB：

myapp/calculator-ejb/CalculatorBean!com.redhat.training.ejb.Calculator

在部署EJB时，应用程序服务器会在服务器日志中列出EJB的不同JNDI绑定。下面的清单显示了如果将EJB打包并部署为JAR文件，而不是EAR文件，则显示JNDI条目：

INFO  [org.jboss.as.ejb3.deployment] (MSC service thread 1-2) WFLYEJB0473: JNDI bindings for session bean named 'CalculatorBean' in deployment unit 'deployment "calculator-ejb.jar"' are as follows:java:global/calculator-ejb/CalculatorBean!com.redhat.training.ejb.Calculator
java:app/calculator-ejb/CalculatorBean!com.redhat.training.ejb.Calculator
java:module/CalculatorBean!com.redhat.training.ejb.Calculator
java:global/calculator-ejb/CalculatorBean
java:app/calculator-ejb/CalculatorBean
java:module/CalculatorBean

使用JNDI命名机制查找远程EJB的示例JNDI客户机程序如下所示：

package com.redhat.training.client;

public class CalculatorClient {

  public static void main(String[] args) throws Exception {    String JNDI_URL= "myapp/calculator-ejb/CalculatorBean!com.redhat.training.ejb.Calculator";
    try {
      Context ic = new InitialContext();      Calculator calc = (Calculator) ic.lookup(JNDI_URL);
      System.out.println("Response from server = " + calc.add(1,2);
      ...
    }
    catch (Exception e) {
      // handle the exception
    }

  }
...
}

我们还需要在客户端程序的类路径中提供一个名为jndi.properties的文件，其中包含运行EJB的远程应用程序服务器的主机名，IP地址，端口和安全详细信息（如果安全用于远程访问）。

java.naming.factory.initial=org.jboss.naming.remote.client.InitialContextFactory
java.naming.provider.url=http-remoting://10.2.0.15:8080
jboss.naming.client.ejb.context=true

JNDI API的InitialContext是一个标准的Java EE通用构造，用于查找部署在应用程序服务器上的组件。它使用一组属性在类路径中查找jndi.properties。某些属性对所有应用程序服务器都是通用的，有些属性是针对每个应用程序服务器的。

四、实验展现

实验由两个Maven子项目组成，它们位于hello-remote目录下的主项目文件夹下，其中包含hello-remote-ejb和hello-remote-client。

hello-remote-ejb项目在JBoss EAP中安装可远程访问的EJB，以便通过JNDI查找可用于外部客户端。 hello-remote-client项目是远程访问（从另一个JVM）EJB的Java SE应用程序。

首先，在JBDS中import已经存在的maven项目：