时间：2006-10-17 作者：肖菁 浏览次数： 本文关键字：控件, Controls, EJB, Beehive, 蜂巢计划

文章工具  推荐给朋友  打印文章

创建EJB控件的典型步骤

　　 EJB系统控件无法直接用于访问EJB资源，使用者必须继承EJB控件来创建自己的访问控件。一个继承控件只能对应于一个EJB的访问，所以使用者必须针对不同的EJB创建不同的访问控件。

　　 你可以使用下面的步骤来创建自己的控件实现对EJB资源的访问：

1. 创建Java接口，根据目标EJB资源类型的不同选择继承不同的EJB控件类

要访问SessionBean类型的EJB资源，Java接口必须继承org.apache.beehive.controls.system.ejb.SessionEJBControl接口。

要访问EntityBean类型的EJB资源，Java接口必须继承org.apache.beehive.controls.system.ejb.EntityEJBControl接口。

2. 用@ControlExtension关键字注释新创建的Java接口，通知解析器这个接口继承了另外的某个控件。
3. 继承目标EJB的Home和Remote接口，这些接口可能是本地的或者是远程的。
4. 使用@EJBHome.jndiName或者@EJBHome.ejbLink注释新创建的Java接口，指定控件如何搜索EJB实例。
5. 如果控件使用jndiName来访问EJB，还需要使用@JNDIContextEnv关键字注释新创建的Java接口，说明控件如何与目标EJB容器实现交互。

创建访问SessionBean的控件

　　 在本节中，我们将通过简单的例子演示如何使用EJB控件来访问SessionBean。

　　 我们假设需要开发一个简单的SessionBean并且使用EJB控件来访问它。该EJB提供一个简单的Remote方法sayHello，调用sayHello可以返回”Hello World!”字符串。该EJB支持Remote方式访问。

　　 为了说明Beehive并不仅仅局限于WebLogic平台，我们选择JBoss应用服务器作为演示时使用的EJB容器，EJB发布时使用的JNDI名称是“jndi/helloworld”。

　　接下来的EJB开发、部署和控件访问部分内容也针对JBoss应用服务器。实际情况下，你可能根据不同情况选择其他的J2EE容器比如Websphere、WebLogic、Geronimo、JOnAS等作为EJB容器，请根据下面的提示信息进行适当的调整。

1. 开发SessionBean

　　首先我们来开发提供sayHello业务方法SessionBean，作者使用Eclipse+WTP(Web Tools Platform)插件工具完成开发。

　　 如何开发EJB不是本文的关注点，所以这里只是简单的提供EJB实现对应的代码。开发EJB的学习资料可以在参考资源中找到。

• EJB Bean类源代码—HelloWorld.java

　　清单1 ejbsrc\org\vivianj\beehive\controls\examples\ejb\helloworld.java

1.	package org.vivianj.beehive.controls.examples.ejb;
2.	
3.	import javax.ejb.*;
4.	
5.	public class HelloWorld
6.	  implements SessionBean
7.	{
8.	  public void ejbCreate() {
9.	 }
10.	 public String sayHello()
11.	    {
12.	        return “Hello World!”;
13.	    }
14.	}

• EJB Remote接口类源代码—HelloWorldRemote.java

　　清单2 ejbsrc\org\vivianj\beehive\controls\examples\ejb\HelloWorldRemote.java

1.	package org.vivianj.beehive.controls.examples.ejb;
2.	
3.	import javax.ejb.EJBObject;
4.	import java.rmi.RemoteException;
5.	
6.	import javax.ejb.*;
7.	
8.	public interface HelloWorldRemote extends EJBObject {
9.	
10.	  public String sayHello()     throws RemoteException;
11.	
12.	}

• EJB Home接口类源代码-- HelloWorldHome.java

　　清单3 ejbsrc\org\vivianj\beehive\controls\examples\ejb\HelloWorldHome.java

1.	package org.vivianj.beehive.controls.examples.ejb;
2.	
3.	import javax.ejb.CreateException;
4.	import javax.ejb.EJBHome;
5.	import javax.ejb.FinderException;
6.	import java.rmi.RemoteException;
7.	import java.util.Collection;
8.	
9.	import javax.ejb.*;
10.	
11.	public interface HelloWorldHome extends EJBHome {
12.	
13.	  public HelloWorldRemote create()     
14.	      throws CreateException, RemoteException;
15.	
16.	}

　　EJB开发完成后，我们可以将EJB打包成企业应用，然后将生成的企业应用发布到JBoss应用服务器上。

2. 开发EJB控件

　　我们现在来开发一个EJB控件-- HelloWorldSessionEJBControl，通过它我们能够直接访问 1.开发SessionBean 中开发和部署的EJB。

　　 HelloWorldSessionEJBControl通过JBoss提供的org.jnp.interfaces.NamingContextFactory工厂类获取EJB访问的上下文环境。

　　 清单4中是EJB控件的全部源代码。

　　清单4 src\org\vivianj\beehive\controls\examples\controls\

　　 HelloWorldSessionEJBControl.java

1.	package org.vivianj.beehive.controls.examples.controls;
2.	
3.	import org.apache.beehive.controls.api.bean.ControlExtension;
4.	import org.apache.beehive.controls.system.ejb.SessionEJBControl;
5.	import org.vivianj.beehive.controls.examples.ejb.helloworldHome;
6.	import org.vivianj.beehive.controls.examples.ejb.helloworldRemote;
7.	
8.	/**
9.	 * HelloWorldSessionEJBControl 用于封装访问远程JBoss服务器上	
10.	 * SessionBean的操作方法
11.	 */
12.	@ControlExtension
13.	@SessionEJBControl.EJBHome(jndiName = “jndi/helloworld”)
14.	@SessionEJBControl.JNDIContextEnv(
15.	   contextFactory = “org.jnp.interfaces.NamingContextFactory”, 
16.	   providerURL = “jnp://localhost:1099”)
17.	public interface HelloWorldSessionEJBControl 
18.	    extends SessionEJBControl,
19.		HelloWorldHome, HelloWorldRemote {
20.	}

3. EJB控件调用

　　我们可以通过下面的几个步骤，实例化EJB控件并调用它的业务方法。

• 在Controller中使用声明式控件实例化定义成员变量_ejbControl

　　@Control

　　 HelloWorldSessionEJBControl _ejbControl;

• 完成控件的业务方法调用

　　 在控件的某个Action方法中完成EJB业务方法的调用，这里要注意的是控件的业务方法通常都声明抛出RemoteException，所以调用的时候需要调用try … catch处理。

  try {
  _ejbControl.sayHello();
  } catch (Exception e) {
  e.printStackTrace();
  }

• 移除控件实例，释放EJB引用

　　 在控件使用完毕以后，应该调用控件的remove方法，以便释放对于EJB的引用，避免可能出现的服务器性能问题。

  try {
  _ejbControl.remove();
  } catch (Exception e) {
  e.printStackTrace();
  }

• 测试EJB控件

　　一切准备就绪后，启动JBoss服务器，参考《控件入门》中“使用JUnit测试控件”部分的内容，编写单元测试TestCase测试新创建的EJB控件。

实例分析

　　 从上面的例子中我们可以看到，使用EJB控件访问EJB资源的时候，开发者的工作被大大的简化了。开发者只需要开发一个继承自EJB控件的控件，使用EJB控件中规定的注释提供访问EJB所需要的一些环境参数，随后便可以使用声明式控件实例化方式完成控件的实例化，通过调用该控件实例的相关业务方法完成EJB资源的访问。

　　 现在我们来分析一下上面创建的EJB控件-- HelloWorldSessionEJBControl (参见清单4)中的主要代码。

  12. @ControlExtension

　　 在控件例子的12行，我们通过@ControllerExcention注释来说明接下来声明的这个接口是另外一个控件的扩展。HelloWorldSessionEJBControl控件继承自SessionEJBControl，所以必须使用在接口定义前使用ControllerExcention。

  13. @SessionEJBControl.EJBHome(jndiName  = “jndi/helloworld”)

　　 在第13行代码中我们使用@SessionEJBControl.EJBHome关键词和它的jndiName属性来设置我们要访问EJB在目标服务器中发布时使用的jndiName.

  14. @SessionEJBControl.JNDIContextEnv(
  15. contextFactory = “org.jnp.interfaces.NamingContextFactory”,
  16. providerURL = “jnp://localhost:1099”)

　　 在第14~16行中我们使用@SessionEJBControl.JNDIContextEnv的contextFactory属性和providerURL来设置目标服务器的JNDI上下文环境工厂和目标服务器的访问地址信息。

  17. public interface  HelloWorldSessionEJBControl
  18. extends  SessionEJBControl,
  19. HelloWorldHome,  HelloWorldRemote {

　　 在第17~19行中，我们声明该控件继承了EJB控件SessionEJBControl接口和目标EJB的Home、Remote接口。

　　 前面的两节内容中，我们通过创建访问SessionBean控件的例子，简单的说明了如何通过继承EJB控件快速访问EJB资源的步骤和方法。通过控件访问Entity Bean的步骤和访问SessionBean的步骤基本一致，只不过继承对象变成了EntityEJBControl，而不再是SessionEJBControl，请读者参考上面的步骤自己完成。

使用注释定制EJB控件

　　 J2EE架构下，客户端访问EJB多采用jnp协议访问EJB容器的JNDI树，通过查找相应的JNDI对象获取EJB访问实例。EJB控件提供了注释EJBHome和JNDIContextEnv，其中JNDIContextEnv用于指定访问目标EJB容器上下文环境所需要的参数，EJBHome用于指定如何在上下文中获取EJB的Home接口。

　　 下面的内容将详细的讲述如何使用EJBHome和JNDIContextEnv两个注释来定制EJB控件。

JNDIContextEnv

　　 JNDIContextEnv注释是类级别的注释元素，用于设置EJB继承类访问EJB时所需要使用的JNDI上下文工厂类名、目标服务器的相关必要信息（访问协议、ip地址、端口等）、访问时需要提供的访问用户名和密码。JNDIContextEnv包括contextFactory、providerURL、principal、credentials属性。

• contextFactory

　　 字符串类型的属性，设置访问EJB JNDI上下文环境需要使用工厂类，比如访问JBoss应用服务器上的EJB资源时可以设置contextFactory属性为”org.jnp.interfaces.NamingContextFactory”。

• providerURL

　　 字符串类型的属性，设置目标EJB容器的相关属性，包括访问JNDI上下文环境使用的协议、目标服务器IP地址、服务端口等，比如访问JBoss容器中ejb时，providerURL可以写成”jnp://localhost:1099”。

• principal

　　 字符串类型的属性，设置访问EJB时需要提供的安全用户名。

• credentials

　　 字符串类型的属性，设置访问EJB时需要提供的安全密码。

EJBHome

　　 EJBHome是类级别的注释元素，用于设定获取EJB Home接口的实例，支持的属性包括了jndiName和ejbLink，你可以选择性的使用其中任何一个。

• jndiName

　　 String类型，EJB在EJB容器中发布时使用的jndi名称，你也可以使用jndi协议形式的url来设置这个参数。比如你可以使用jndi/helloworld来设置这个参数，你也可以使用jndi://localhost:7001/jndi/helloworld这样的url来设置这个参数。

• ejbLink

　　 String类型，用于设置与包含的EJB jar文件应用路径相关的目标EJB名，命名的语法是BeanName#EJBJAR，比如HelloWorldHome@HelloWorldEjb.jar。

结束语

　　 EJB是J2EE框架中最重要的部分，也是企业应用中最常用的技术之一，然而EJB的客户端编写对于开发者而言不是一件轻松的事情。控件架构中的EJB控件大大的简化了EJB资源的复杂性、难度，开发者只需要通过简单的继承org.apache.beehive.controls.system.ejb.SessionEJBControl或者org.apache.beehive.controls.system.ejb.EntityEJBControl，然后通过提供相应的注释就可以完成EJB资源的访问。

　　 本文中，作者首先通过简单的例子介绍了EJB控件使用的基本步骤，然后详细的介绍了EJB控件提供的EJBHome和JNDIContextEnv注释以及它们的使用方法。

　　参考资源

　　 Beehive在线资源：

　　 http://beehive.apache.org/documentation.html

　　下载资源

　　 本文中例子下载地址：

　　 EJBControlExamples.zip

作者简介
肖菁	肖菁 是唯J族(www.vivianj.org)创始人，BEA 杭州User Group负责人，自由撰稿人，开源项目BuildFileDesigner(buildfiledesign.sourceforge.net)和V-Security(v-security.sourceforge.net)创始人。

• 将支持Websphere的企业应用转化为支持Weblogic
• WebLogic8中的扩展JSP标签实例解析
• 用Pollinate可视化开发页面流（JPF）
• Beehive中的页面流
• Beehive中的Web服务开发

您对本文的评价
您对这篇文章的看法如何?
太棒了！5分 不错啊 4分 一般般 3分 有待提高 2分 不好 1分