MyEclipse下EJB应用程序的开发

MyEclipse下EJB应用程序的开发 例子

作者:admin 日期:2007-12-06

 

版权所有，欢迎转载，转载请注明转自http://www.suneca.com

EJB（Enterprise JavaBean）是SUN服务器端组件模型，是J2EE的一部分，基于EJB技术，可以开分布式应用程序。
Jbuilder是一个非常理想的EJB开发工具，在现在这么多免费的开发工具前面，Borland还有一定的市场，可见Jbuilder还是有非常明显的优势。
MyEclipse是一个基于Eclipse的开发工具，这个开发工具也很便宜，官方报价也就29.9美元，算是非常便宜的一个工具了，现在国内很多做Java开发的程序都是使用这个工具。
EJB的开发需要有J2EE应用服务器的支持，注意：Tomcat只是一个Servlet容器，不是一个J2EE应用服务器。本次例子使用的是开源的Jboss4.x
Jboss应用服务器的下载地址：http://www.jboss.org
下面介绍如何基于MyEclipse开发无状态的SessionBean。
第一步，配置J2EE应用服务器：
点击WindowsPreferences，在弹出的对话框当中选择MyEclipse-->Jboss-->Jboss 4.x



将Jboss Sever状态改为Enable
Jboss home directory改为Jboss的安装路径
JDK改为系统的JDK路径，注意，Jboss 4使用的是Tomcat5.5内核，Tomcat5.5运行需要有JDK的支持。
最后，点击OK按钮
第二步，创建一个EJB工程：



点击Next>按钮，在Project Name当中输入EJBTraining，或者输入你喜欢的工程名。如下图所示：


在Package Explorer可以看到工程的目录：


第三步，新建一个SessionBean


点击Next>


在Package上填入zizz.ejb（一般企业做开发的时候都有一定的命名规范，一般喜欢以ejb结尾）
在Name上填入UserServiceBean（一个EJB Bean一般情况是以Bean结尾，特别是在Eclipse开发框架下，因为是使用Xdoclet来生成代码的）
在EJB类型上选择Stateless，表示无状态会话Bean
在Select the access of the EJB上面选择Remote
选上ejbCreate() method
系统生成的UserServiceBean如下：

程序代码

package zizz.ejb;

import java.rmi.RemoteException;

import javax.ejb.EJBException;
import javax.ejb.SessionBean;
import javax.ejb.SessionContext;

import javax.ejb.CreateException;

/**
* XDoclet-based session bean.  The class must be declared
* public according to the EJB specification.
*
* To generate the EJB related files to this EJB:
*        - Add Standard EJB module to XDoclet project properties
*        - Customize XDoclet configuration for your appserver
*        - Run XDoclet
*
* Below are the xdoclet-related tags needed for this EJB.
*
* @ejb.bean name="UserService"
*           display-name="Name for UserService"
*           description="Description for UserService"
*           jndi-name="ejb/UserService"
*           type="Stateless"
*           view-type="remote"
*/
public class UserServiceBean implements SessionBean {

    /** The session context */
    private SessionContext context;

    public UserServiceBean() {
        // TODO Auto-generated constructor stub
    }

    public void ejbActivate() throws EJBException, RemoteException {
        // TODO Auto-generated method stub

    }

    public void ejbPassivate() throws EJBException, RemoteException {
        // TODO Auto-generated method stub

    }

    public void ejbRemove() throws EJBException, RemoteException {
        // TODO Auto-generated method stub

    }

    /**
     * Set the associated session context. The container calls this method
     * after the instance creation.
     *
     * The enterprise bean instance should store the reference to the context
     * object in an instance variable.
     *
     * This method is called with no transaction context.
     *
     * @throws EJBException Thrown if method fails due to system-level error.
     */
    public void setSessionContext(SessionContext newContext)
        throws EJBException {
        context = newContext;
    }

    /**
     * An ejbCreate method as required by the EJB specification.
     *
     * The container calls the instance?s <code>ejbCreate</code> method whose
     * signature matches the signature of the <code>create</code> method invoked
     * by the client. The input parameters sent from the client are passed to
     * the <code>ejbCreate</code> method. Each session bean class must have at
     * least one <code>ejbCreate</code> method. The number and signatures
     * of a session bean?s <code>create</code> methods are specific to each
     * session bean class.
     *
     * @throws CreateException Thrown if method fails due to system-level error.
     *
     * @ejb.create-method
     *
     */
    public void ejbCreate() throws CreateException {
        // TODO Add ejbCreate method implementation
    }

    /**
     * An example business method
     *
     * @ejb.interface-method view-type = "remote"
     *
     * @throws EJBException Thrown if method fails due to system-level error.
     */
    public void replaceWithRealBusinessMethod() throws EJBException {
        // rename and start putting your business logic here
    }

}

将replaceWithRealBusinessMethod方法改为具体的业务方法，修改完的业务方法如下：

程序代码

package zizz[color=#0000ff].ejb;

import java.rmi.RemoteException;
import java.util.ArrayList;
import java.util.List;

import javax.ejb.CreateException;
import javax.ejb.EJBException;
import javax.ejb.SessionBean;
import javax.ejb.SessionContext;

import zizz.model.User;

/**
* XDoclet-based session bean.  The class must be declared
* public according to the EJB specification.
*
* To generate the EJB related files to this EJB:
*        - Add Standard EJB module to XDoclet project properties
*        - Customize XDoclet configuration for your appserver
*        - Run XDoclet
*
* Below are the xdoclet-related tags needed for this EJB.
*
* @ejb.bean name="UserService"
*           display-name="Name for UserService"
*           description="Description for UserService"
*           jndi-name="ejb/UserService"
*           type="Stateless"
*           view-type="remote"
*/
public class UserServiceBean implements SessionBean {

    /** The session context */
    private SessionContext context;

    public UserServiceBean() {
        // TODO Auto-generated constructor stub
    }

    public void ejbActivate() throws EJBException, RemoteException {
        // TODO Auto-generated method stub

    }

    public void ejbPassivate() throws EJBException, RemoteException {
        // TODO Auto-generated method stub

    }

    public void ejbRemove() throws EJBException, RemoteException {
        // TODO Auto-generated method stub

    }

    /**
     * Set the associated session context. The container calls this method
     * after the instance creation.
     *
     * The enterprise bean instance should store the reference to the context
     * object in an instance variable.
     *
     * This method is called with no transaction context.
     *
     * @throws EJBException Thrown if method fails due to system-level error.
     */
    public void setSessionContext(SessionContext newContext)
        throws EJBException {
        context = newContext;
    }

    /**
     * An ejbCreate method as required by the EJB specification.
     *
     * The container calls the instance?s <code>ejbCreate</code> method whose
     * signature matches the signature of the <code>create</code> method invoked
     * by the client. The input parameters sent from the client are passed to
     * the <code>ejbCreate</code> method. Each session bean class must have at
     * least one <code>ejbCreate</code> method. The number and signatures
     * of a session bean?s <code>create</code> methods are specific to each
     * session bean class.
     *
     * @throws CreateException Thrown if method fails due to system-level error.
     *
     * @ejb.create-method
     *
     */
    public void ejbCreate() throws CreateException {
        // TODO Add ejbCreate method implementation
    }

    /**
     * An example business method
     *
     * @ejb.interface-method view-type = "remote"
     *
     * @throws EJBException Thrown if method fails due to system-level error.
     */
    public List listAllUsers() throws EJBException {
        List<User> users = new ArrayList<User>();
        User user1 = new User();
        user1.setId(1);
        user1.setName("达闻西");
        user1.setLoginId("dwx");
        users.add(user1);
        
        User user2 = new User();
        user2.setId(2);
        user2.setName("零零漆");
        user2.setLoginId("007");
        users.add(user2);
        return users;
    }

}
[/color]

User实体为：

程序代码

package zizz.model;

import java.io.Serializable;

/**
*
* ZIZZ，该对象用以网络传输，必须实现串行化接口.
* @author ZIZZ.
* @version Create Date: 2007-12-5 下午05:29:10.
*/
public class User implements Serializable{
    
    /**
     * serialVersionUID
     */
    private static final long serialVersionUID = -2176183120082246628L;

    private int id;
    
    private String name;
    
    private String loginId;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getLoginId() {
        return loginId;
    }

    public void setLoginId(String loginId) {
        this.loginId = loginId;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
    
}

其中@ejb.interface-method view-type = "remote"这些XDolect注解不应该删除，因为一会还需要靠XDolect生成代码。

第四步，配置XDolect
点击工程右键，选择Properties


将弹出工程属性对话框，在弹出的对话框当中选择Xdolect，如下图所示


点击Add Standard按钮，在弹出的对话框当中选择Stardard EJB，最后点击OK按钮，如下图所示：


点击Standard EJB，在下面将会出来ejbdolect的选择项，将不必要的选择项目删，如下图所示：


删完后的配置项为：  


接着，点击ejbdolect，右键，选择Add


在弹出的对象框当中选择jboss,最后，点击ok按钮


接着需要配置jboss的配置，点击jboss，在加边的配置项当中做如下的修改
Version定义为：4.0
destDir定义为：src/META-INF
最后，点击OK
第五步，生成代码：
在工程上右键，选择MyEclipseRun Xdolect


工程新的目录结构：


此时，我们的EJB程序就开发得差不多了，接着来，进行发布
第五步：发布应用程序（发布跟发布应用程序一样，详细可以参考）
http://www.suneca.com/article.asp?id=18


第六步，启动Jboss应用服务器
在控制台上，可以看到这样提示信息：

程序代码

12:44:48,375 INFO  [EjbModule] Deploying UserService
12:44:48,703 INFO  [ProxyFactory] Bound EJB Home 'UserService' to jndi 'ejb/UserService'

到此，我们的EJB组件已经发布成功了，接下来，我们需要开发一个客户端来验证一下我们的EJB组件的有效性。

我们需要对对model对象及接口（即远程接口跟本地接口）打一个包，然后将打的这个包存存放于客户端的classpath当中。
第七步，打包：
点击File-->Export，在弹出的对象框当中选择JAR file，如下图所示：

点击Next>，将弹出如下的对话框

在JAR file输入框当中输入：c:\UserServiceClient.jar，表示在c盘下生成一个UserServiceClient的jar文件。
第八步，创建一个客户端工程
将UserServiceClient.jar及jbossall-client.jar文件加入到客户端工程的classpath当中。

第九步，编程测试客户端
创建一个测试类，比如叫UserServiceClient.java，调用服务器的组件，
UserServiceClient内容如下：

程序代码

package zizz.ejb.client;

import java.rmi.RemoteException;
import java.util.Iterator;
import java.util.List;
import java.util.Properties;

import javax.ejb.CreateException;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.NamingException;

import zizz.interfaces.UserService;
import zizz.interfaces.UserServiceHome;
import zizz.model.User;

/**
*
* 该程序用于调用服务器端的组件.
*
* @author ZIZZ.
* @version Create Date: 2007-12-6 下午02:06:00.
*/
public class UserServiceClient {

    /**
     * @param args
     */
    public static void main(String[] args) {
        //设置Context工厂，不同应用服务器设置不同
        Properties env = new Properties();
        env.setProperty(Context.INITIAL_CONTEXT_FACTORY,"org.jnp.interfaces.NamingContextFactory");
        env.setProperty(Context.URL_PKG_PREFIXES, "org.jboss.naming.client");
        // 设置jnp地址
        env.setProperty(Context.PROVIDER_URL, "jnp://localhost:1099");
        try {
            //得到Context
            Context enc = new InitialContext(env);
            //得到本地接口
            UserServiceHome home = (UserServiceHome) enc.lookup("ejb/UserService");
            //得到远程对象
            UserService userService = home.create();
            //调用远程对象的方法
            List users = userService.listAllUsers();
            Iterator iter = users.iterator();
            while (iter.hasNext()) {
                User user = (User) iter.next();
                System.out.println(user.getName());
            }
        } catch (NamingException e) {
            e.printStackTrace();
        } catch (RemoteException e) {
            e.printStackTrace();
        } catch (CreateException e) {
            e.printStackTrace();
        }

    }

}