EJB 3.0入门:Stateless Session Beans

    EJB容器的一个重要功能是管理服务对象。该容器实例化对象，管理器生命周期，维护对象池，提供从 应用程序 其他部分访问对象的方法。一个 EJB 3.0 session bean是一个由 EJB容器管理的POJO。在这个例子的以后部分我们将看到，一个 session bean允许我们使用容器的安全，事务，消息，持久，和其他服务。

    一个 session bean的功能由它的服务 interface 定义，该 interface是一个 plain old Java interface。利用 interface 类名， session bean根据服务器的 JNDI，回复该bean的 stub对象。该 stub对象实现了该bean的服务接口。然后客户端即可呼叫bean的接口函数。 stub对象简单地将呼叫传递给容器中的实际bean进程，容器来实现函数，做实际工作。stub对象由EJB容器自动生成，stub对象知道如何将对bean函数的呼叫告知容器--你无需提供stub对象的实现。

  对 stateless session bean来说，客户端stub对象能将你对函数的调用路由到恰好在容器管理的对象池中存在的bean进程。因此，你不能在bean类中存在任何保存bean状态的属性。负责，任何依靠这些属性的函数在经过一段时间后会发生不可预知错误。

  例子程序：
  建立一个 stateless session bean，执行投资计算。客户端程序（一个 servlet 或 rich UI client ）从容器中取得一个bean的 reference ，并使用它的计算服务。

  定义 session bean接口
  首先应定义包含商业函数的服务接口。该 session bean接口仅仅是 plain old Java接口，没有任何 annotation。客户端利用该接口从EJB 3.0 容器取得 session bean的stub对象。

public interface Calculator ...{

  public double calculate (int start, int end, 
                double growthrate, double saving);

}

session bean 实现
  bean实现是一个简单POJO。EJB 3,0 容器自动实例化并且管理POJO进程。以下是StatelessCalculator类的代码。 @Stateless标注表明该bean是一个stateless session bean。

    一旦session bean被部署到EJB 3.0容器，一个stub对象即创建，并在服务器的JDNI注册器处注册。客户端从JNDI注册器处取得bean的一个stub，默认JNDI名格式如下：

• 如果应用是部署到EAR文件，默认JNDI名的格式是：本地接口的stub：EAR-FILE-BASE-NAME/EJB-CLASS-NAME/local。 远端接口：EAR-FILE-BASE-NAME/EJB-CLASS-NAME/local
• 如果bean被部署到JAR文件，JNDI名是EJB-CLASS-NAME/local and EJB-CLASS-NAME/remote。

    以下是JSP页面取得Calculator接口的stub进程的一个例子。你可以调用stub对象的函数，该调用被分配到EJB 3.0容器的bean进程。

private Calculator cal = null;

public void jspInit () ...{
    try ...{
      InitialContext ctx = new InitialContext();
      cal = (Calculator) ctx.lookup(
                  "EJB3Trail/StatelessCalculator/local");
    } catch (Exception e) ...{
      e.printStackTrace ();
    }
}

// ... ...

public void service (Request req, Response rep) ...{
    // ... ...
    double res = cal.calculate(start, end, growthrate, saving);
}

 

远端与本地接口
    一个 session bean能实现多个接口。每个接口针对不同类型的客户端。默认情况，接口服务于“本地”客户端，运行于 EJB 3.0容器的同一个JVM。例如，以上例子中， JSP页面和EJB 3.0容器运行于JBoss的JVM。当客户端通过本地接口查找bean stub时，容器返回 session bean对象的 Java reference。对 Java reference的函数调用非常快速、高效。
    另外一种 session bean接口是 remote interface，服务于 remote客户端。 当客户端通过远程接口查找bean stub时，容器返回一系列实现远程接口的stub对象。 远程stub懂得怎样把 remote procedure calls (RPCs)传给服务器，即使是在一个集群环境下。远程接口也是一个 plain old Java接口。远程接口可以包含与本地接口相同的method。但多数情况下，你可能通过内地和远程接口揭示不同的method。例如，对 CalculatorBean bean来说，远程接口可能显示一个 additional method，以给远程客户端一些服务器信息。

public   interface  RemoteCalculator  ... {

  public double calculate (int start, int end, 
                           double growthrate, double saving);
  public String getServerInfo ();
}

    注：使用远程接口包括对stub的序列化和去序列化，所有对bean进程的呼叫都通过网络。与本地接口相比效率低得多。应避免通过本地客户端查询远程接口。

    对于session bean实现，可以使用 @Local 和 @Remote 标注区分bean的本地和远程接口。也可使用 @LocalBinding 和 @RemoteBinding 区分两种接口的JNDI名称。下面是一个例子，实现了本地和远程接口的JNDI绑定。

Stateless
@Local ( ... {Calculator.class} )
@LocalBinding (jndiBinding = " EJB3Trail/LocalCalculator " )
@Remote ( ... {RemoteCalculator.class} )
@RemoteBinding (jndiBinding = " EJB3Trail/RemoteCalculator " )
public   class  LocalRemoteCalculator  implements  Calculator, RemoteCalculator  ... {

  public double calculate (int start, int end, 
                           double growthrate, double saving) ...{
    double tmp = Math.pow(1. + growthrate / 12., 12. * (end - start) + 1);
    return saving * 12. * (tmp - 1) / growthrate;
  }

  public String getServerInfo () ...{
    return "This is the JBoss EJB 3.0 TrailBlazer";
  }
}

    @Local 和 @Remote标注也可用来标记 session bean接口，而不是bean的实现类。例如，以下代码片断指明了 RemoteCalculator是一个远程接口。由此，在 CalculatorBean 中， 你不再需要 @Remote标记。

@Remote
public   interface  RemoteCalculator  ... {
  // ... ...
}

完整代码：

EJB server

• Calculator.java: 本地接口
• StatelessCalculator.java: 本地接口的session bean实现
• RemoteCalculator.java: 远程接口
• StatelessCalculator2.java: 远程接口的session bean实现 with alternative JNDI binding names

EJB client

• calculator.jsp: calculator session bean的客户端 (使用本地接口)

摘要
    在本节学习了怎样开发 stateless session bean。下一节，我们将讨论另一类型的 session beans， stateful session beans，在web应用中非常重要。











翻译自：
http://trailblazer.demo.jboss.com/EJB3Trail/serviceobjects/slsb/index.html