转载 Eclipse快速上手EJB -- 1. Lomboz + JBoss-IDE 配置1 收藏

新一篇: Eclipse快速上手EJB -- 1. Lomboz + JBoss-IDE 配置2  | 旧一篇: Eclipse+Lomboz+JBoss搭建J2EE开发环境记录

 关于Eclipse、Lomboz、JBoss的客套话免了，直接进入正题。
 
 
1. 所需软件
 
   WindowsXP SP1
   JDK 1.4.2-04  可以从SUN官方网站下载
   MySQL 4.1.8 
   Eclipse 3.0.1 及 语言包   
   Lomboz 3.0.1
   JBoss 4.0.0
   JBoss-IDE 1.4.0
   XDoclet  1.2.2
 
2. 下载
 
● Eclipse 3.0.1 及 语言包
 
 
● Lomboz 3.0.1
lomboz.301.zip (这是7月22日发布的版本)
 
 
  现在主页上有1月6日的新版本，包括3.1和3.0.1的版本，使用后发现有一些小bug，所以还是推荐使用7月22日发布的版本。 
 
● JBoss 4.0.0
  这是一个zip版本，从上面的站点选择一个镜像下载。
 
● JBoss-IDE 1.4.0     http://www.jboss.org/products/jbosside
  现在改名了 JBoss Eclipse IDE，几天不见就换马甲了。
  开发JBoss时使用的Eclipse插件，这里我主要使用它的Xdoclet的提示功能，另外它整合了SolarEclipse。
 
 
● MySQL 4.1.8
 
● XDoclet  1.2.2
   这里主要是为了替换Lomboz中的XDoclet 1.2.1版本。
 
 
3. 安装
 
   F:\j2sdk                              JDK目录 
   F:\java\xdoclet                       XDoclet 目录
   F:\java\jboss                         JBoss  目录 
   D:\eclipse                            Eclipse 3.0.1 目录
   D:\eclipse\myplugins\lomboz.301       Lomboz 目录
   D:\eclipse\myplugins\jboss-ide-1.40   JBoss-IDE 目录
   D:\mysql                              MySQL 4.1.8 目录 
  
· lomboz和jboss-ide 我都是采用links方式安装的，
 
 
二. 配置开发环境
 
   打开Eclipse，如果界面是“资源透视图”，那么切换到“Java透视图”。点击菜单“窗口”->首选项，以下都在“首选项”中配置：
  1. Java->构建路径
     
 
 2. Lomboz
 
 
3. Lomboz ->Server Definitions ->Properties  
  
   因为使用的JBoss 4.0.0 服务器不在 Lomboz 默认服务器之列，所以需要自己建立一个jboss400.server 文件。
   先把下面的jboss400.server 文件复制到Lomboz目录下的 com.objectlearn.jdt.j2ee_3.0.1\servers 目录（如果你是把Lomboz直接安装在Eclipse的Plugins目录中，这个子目录就是“Eclipse安装目录\plugins\com.objectlearn.jdt.j2ee_3.0.1\servers”；如果你是采用links方式安装lomboz的，那么这个子目录就是“Lomboz安装目录\eclipse\plugins\com.objectlearn.jdt.j2ee_3.0.1\servers”）。这个目录下有许多server类型文件，可以把其中认为不需要的文件删除。

jboss400.server

<serverDefinition 
     name="JBOSS 4.0.0"
     ejbModules="true"
     webModules="true"
     earModules="true">
<property id="serverRootDirectory"
    label="Application Server Directory:"
    type="directory"
    default="F:/java/jboss" />
<property id="serverAddress"
    label="Address:"
    type="string"
    default="127.0.0.1" />
<property id="serverPort"
    label="Port:"
    type="string"
    default="8080" />
<property id="serverConfig"
    label="Server Configuration (minimal/default/all):"
    type="string"
    default="default" />
<property id="classPathVariableName"
    label="Classpath Variable Name:"
    type="string"
    default="JBOSS400" />
<property id="classPath"
    label="Classpath Variable:"
    type="directory"
    default="F:/java/jboss" />
<serverHome>${serverRootDirectory}</serverHome>
<webModulesDeployDirectory>${serverRootDirectory}/server/${serverConfig}/deploy</webModulesDeployDirectory>
<ejbModulesDeployDirectory>${serverRootDirectory}/server/${serverConfig}/deploy</ejbModulesDeployDirectory>
<earModulesDeployDirectory>${serverRootDirectory}/server/${serverConfig}/deploy</earModulesDeployDirectory>
<jndiInitialContextFactory>org.jnp.interfaces.NamingContextFactory</jndiInitialContextFactory>
<jndiProviderUrl>jnp://${serverAddress}:1099</jndiProviderUrl>
<startClass>org.jboss.Main</startClass>
<startWorkingDirectory>${serverRootDirectory}/bin</startWorkingDirectory>
<startVmParameters>-Djava.endorsed.dirs=${serverRootDirectory}/lib/endorsed</startVmParameters>
<startProgramArguments>-c ${serverConfig}</startProgramArguments>
<stopClass>org.jboss.Shutdown</stopClass>
<stopWorkingDirectory>${serverRootDirectory}/bin</stopWorkingDirectory>
<stopVmParameters>-cp {classPathVariableName}/bin/shutdown.jar -Djboss.boot.loader.name=shutdown.bat</stopVmParameters>
<stopProgramArguments>-S</stopProgramArguments>
<serverClassPath>
    <jar type="variable">JDK_TOOLS</jar>
    <jar type="variable">${classPathVariableName}/bin/run.jar</jar>
    <jar type="variable">${classPathVariableName}/bin/shutdown.jar</jar>
    <jar type="variable">${classPathVariableName}/lib/concurrent.jar</jar>
    <jar type="variable">${classPathVariableName}/lib/dom4j.jar</jar>
    <jar type="variable">${classPathVariableName}/lib/gnu-regexp.jar</jar>
    <jar type="variable">${classPathVariableName}/lib/jboss-jmx.jar</jar>
    <jar type="variable">${classPathVariableName}/lib/jboss-common.jar</jar>
    <jar type="variable">${classPathVariableName}/lib/jboss-system.jar</jar>
    <jar type="variable">${classPathVariableName}/lib/endorsed/xercesImpl.jar</jar>
    <jar type="variable">${classPathVariableName}/lib/endorsed/xml-apis.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/activation.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/avalon-framework.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/bcel.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/bsh-commands-1.3.0.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/bsh-core-1.3.0.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/bsh-deployer.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/castor-0.9.3.9-xml.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/cglib-full-2.0.1.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/hibernate2.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/hsqldb.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/hsqldb-plugin.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jacorb.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/javax.servlet.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/javax.servlet.jsp.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jaxr-client.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-common-jdbc-wrapper.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-hibernate.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-iiop.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-j2ee.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-jaxrpc.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-jca.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-jsr77.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-management.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-monitoring.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-saaj.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jbossmq.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jbosssx.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jnpserver.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jpl-pattern.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jpl-util.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-transaction.jar</jar>
</serverClassPath>
<clientClassPath>
    <jar type="variable">${classPathVariableName}/client/jboss-j2ee.jar</jar>
    <jar type="variable">${classPathVariableName}/client/jnp-client.jar</jar>
    <jar type="variable">${classPathVariableName}/client/jboss-client.jar</jar>
    <jar type="variable">${classPathVariableName}/client/jboss-common-client.jar</jar>
    <jar type="variable">${classPathVariableName}/client/jbosssx-client.jar</jar>
    <jar type="variable">${classPathVariableName}/client/log4j.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jnpserver.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/javax.servlet.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/javax.servlet.jsp.jar</jar>
</clientClassPath>
<projectClassPath>
    <jar type="variable">JDK_TOOLS</jar>
    <jar type="variable">${classPathVariableName}/bin/run.jar</jar>
    <jar type="variable">${classPathVariableName}/bin/shutdown.jar</jar>
    <jar type="variable">${classPathVariableName}/client/jboss-j2ee.jar</jar>
    <jar type="variable">${classPathVariableName}/lib/jboss-system.jar</jar>
    <jar type="variable">${classPathVariableName}/lib/concurrent.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jnpserver.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jpl-pattern.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jpl-util.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/jboss-transaction.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/bcel.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/javax.servlet.jar</jar>
    <jar type="variable">${classPathVariableName}/server/${serverConfig}/lib/javax.servlet.jsp.jar</jar>
</projectClassPath>
</serverDefinition>

 然后切换到Eclipse，效果如下图
 
 
 4. 切换到主界面，点击“窗口”菜单->定制透视图

最后，确定即可。
 
1. 新建一个项目
 
●  右击“包资源管理器”的空白处， 在弹出菜单中选择“新建” ->“Lomboz J2EE Project”  
·项目名：HelloEJB 
·EJB Modules：helloEJB
·Targeted Server：  JBoss 4.0.0
 
效果如下：（利用下图中的小倒三角按钮将引入的 JBoss 库文件过滤了 ）
 
 
2. xdoclet.xml 的修改： 
 
  打开 build.xml 和 xdoclet.xml ，仔细看看里面的内容。
 
  如果你看过关于 XDoclet 方面的文章，那么应该比较明白 Lomboz 开发 EJB 的运行方式。其实就是 Ant ＋ XDoclet  ，这里着重谈谈 xdoclet.xml 文件。

xdoclet.xml

  1: <?xml version="1.0"?>
  2:
  3: <!-- Copyright (c) 2002,2003,2004 by eteration a.s.
  4:       www.eteration.com
  5:       All rights reserved. -->
  6:
  7:
  8: <project name="xdocletBuild" default="ejbdoclet" basedir=".">
  9:
10:    <!-- Init -->
11:    <target name="init">
12:       <property file="build.properties"/>
13:
14:       <property name="ejb.dd.dir" value="../META-INF"/>
15:       <property name="web.dd.dir" value="../WEB-INF"/>
16:       <property name="xdoclet.force" value="true"/>
17:       <property name="container.type" value="ejb-jar"/>
18:      
19:      <!-- Set up java.class.path -->
20:       <path id="project.class.path">
21:         <pathelement location="${project.dir}/${bin.dir}" />
22:
23:
24:       <fileset dir="${eclipse.home}/plugins">
25:         <include name="**/ant.jar"/>
26:         <include name="**/sf.net.xdoclet*/*.jar"/>
27:         <include name="**/org.apache.log4j*/**/*.jar"/>
28:         <include name="**/org.apache.commons*/**/*.jar"/>
29:       </fileset>
30:
31:         <!-- append the external classpath lastly -->
32:         <pathelement path="${java.class.path}" />
33:        
34:         <!-- append the path sent through eclipse to classpath -->
35:         <pathelement path="${project.path}" />
36:        
37:      </path>
38:
39:
40:    </target>
41:
42:    <!-- Run EJBDoclet -->
43:    <target name="ejbdoclet" depends="init">
44:
45:     <taskdef name="ejbdoclet" classname="xdoclet.modules.ejb.EjbDocletTask">
46: <classpath refid="project.class.path"/>
47: </taskdef>
48:
49:
50:       <ejbdoclet
51:             destdir="${project.dir}/${ejbsrc.dir}"
52:             mergedir="${ejb.dd.dir}"
53:             excludedtags="@version,@author,@todo"
54:             addedtags="@lomboz generated"
55:             ejbspec="2.0"
56:             force="${xdoclet.force}"
57:             verbose="true" >
58:
59: <!-- PLEASE KEEP THE BEAN MARKER COMMENTS IF YOU MODIFY THE FILE.
60:      CONTENTS BETWEEN THE MARKERS ARE AUTO INSERTED WITH EACH
61:      BUILD. -->
62: <!-- BEANS START -->
63:    <fileset dir="../../src" defaultexcludes="yes">
64:      <patternset includesfile="ejbs.xml" />
65:    </fileset>
66: <!-- BEANS END -->
67:
68:          <dataobject/>
69:          <dao pattern="{0}" destdir="${project.dir}/${ejbsrc.dir}"/>
70:         
71:          <valueobject/>
72:          <utilobject cacheHomes="true" includeGUID="true" kind="physical"/>
73:         
74:          <remoteinterface/>
75:          <localinterface/>
76:          <homeinterface />
77:          <localhomeinterface/>
78:         
79:          <entitypk/>
80:          <entitycmp/>
81:          <entitybmp/>
82:          <session/>
83:
84:          <deploymentdescriptor
85:             destdir="${ejb.dd.dir}"
86:             validatexml="false"
87:             mergedir="${ejb.dd.dir}"
88:             />
89:
90:          <!--
91:          Have struts form objects generated based on entity beans'
92:          data objects.  Will require struts.jar to compile. -->
93:          <strutsform />
94:
95:
96:          <!--
97:          Have a mapping.xml file generated for castor classes.
98:          -->
99:          <castormapping destdir="${ejb.dd.dir}" validatexml="false" />
100:          <!-- -->
101:
102:       <weblogic
103:          version="6.1"
104:          xmlencoding="UTF-8"
105:          destdir="${ejb.dd.dir}"
106:          validatexml="false"
107:          datasource="PLEASE_MODIFY_THIS"
108:          mergedir="${ejb.dd.dir}"
109:          persistence="weblogic"
110:       />
111:   <jboss
112:             version="3.0"
113:             unauthenticatedPrincipal="nobody"
114:             xmlencoding="UTF-8"
115:             destdir="${ejb.dd.dir}"
116:             validatexml="false"
117:         datasource="PLEASE_MODIFY_THIS"
118:             datasourcemapping="PLEASE_MODIFY_THIS"
119:             preferredrelationmapping="PLEASE_MODIFY_THIS"
120:           />
121:          
122:           <jrun
123:                 version="4.0"
124:                 xmlencoding="UTF-8"
125:                 destdir="${ejb.dd.dir}"
126:                 validatexml="false"
127:                 />
128:
129:            <webSphere destdir="${ejb.dd.dir}"/>
130:             <jonas
131:                 version="3.2"
132:                 xmlencoding="UTF-8"
133:                 destdir="${ejb.dd.dir}"
134:                 validatexml="false"
135:             mergedir="${ejb.dd.dir}"
136:                 />
137:
138:             <orion
139:             destdir="${ejb.dd.dir}"
140:             />
141:
142:             <apachesoap
143:             destdir="${ejb.dd.dir}"
144:             />
145:         
146:       </ejbdoclet>
147:    </target>
148:
149: </project>
 
· 采用 links 方式安装 Lomboz 插件不能运行 XDoclet 的原因及补救方法：
24:       <fileset dir="${eclipse.home}/plugins">
25:         <include name="**/ant.jar"/>
26:         <include name="**/sf.net.xdoclet*/*.jar"/>
27:         <include name="**/org.apache.log4j*/**/*.jar"/>
28:         <include name="**/org.apache.commons*/**/*.jar"/>
29:       </fileset>
 
 · 从第24行和26行可以看到，Lomboz 是从“Eclipse安装目录\plugins\”的目录下寻找 “sf.net.xdoclet_1.2.1” 子目录中的 *.jar 文件来运行 XDoclet的。 由于采用了 links 方式安装插件，所以会找不到 “sf.net.xdoclet_1.2.1” 这个目录，无法加载 XDoclet的库文件。
 
●  修改方法：
 
 · 不采用 links 方式安装 Lomboz 插件；
 · 若采用 links 方式安装插件，将其 Lomboz 插件目录下的那三个目录（即上面的三个目录）复制到 “Eclipse安装目录\plugins\”的目录下；   
 · 直接修改xdoclet.xml 文件，将“${eclipse.home}/plugins”替换成 links 方式下的插件目录；如这里，我将它替换成了<fileset dir="D:/eclipse/myplugins/lomboz-3.0.1/eclipse/plugins">     
 · 或将1.2.2版本的库文件路径加入到类路径中。
   注意到没有，这个版本是1.2.1，而当前版本是1.2.2；所以最好将自己下载的1.2.2版本的 Xdoclet中的库文件替换掉1.2.1版本的库文件，不然某些功能可能无法在 JBoss 4.0.0 配合使用。
 
● 其它修改的地方
 
· 看55行，生成的是2.0版本规范的EJB，当然要改成“2.1”了，人要往高处走啊。
55:             ejbspec="2.0"
 
· 从102行到140行，可以看出 Lomboz 可以使用 weblogic 、jboss、webSphere 等服务器，由于这里我只使用 jboss开发EJB，所以只需要保留 jboss 项就够了，避免生成太多的服务器配置文件。
   既然使用 jboss 了，也不是拿来就用的，修改一下，使它更适合自己。
（有关数据库的配置，下篇文章详细说明，是为了开发实体Bean设置的）
 
 
● 修改后的 XDoclet 文件

xdoclet.xml

<?xml version="1.0" encoding="GBK"?>
<!-- 
  Copyright (c) 2002, 2003,2004 Eteration Bilisim A.S.
  Naci Dai and others.
  
  Parts developed under contract ref:FT/R&D/MAPS/AMS/2004-09-09/AL are 
  Copyright France Telecom, 2004.
  
  All rights reserved. This program and the accompanying materials
  are made available under the terms of the Eclipse Public License v1.0
  which accompanies this distribution, and is available at
  http://www.eclipse.org/legal/epl-v10.html
  
  Contributors:
      Eteration Bilisim A.S. - initial API and implementation
      Naci Dai
  For more information on eteration, please see
  <http://www.eteration.com/>.
 -->

<project name="xdocletBuild" default="ejbdoclet" basedir=".">
   <!-- Init -->
   <target name="init">
      <property file="build.properties"/>
      <property name="ejb.dd.dir" value="../META-INF"/>
      <property name="web.dd.dir" value="../WEB-INF"/>
      <property name="xdoclet.force" value="true"/>
      <property name="container.type" value="ejb-jar"/>
      
      <!-- Set up java.class.path -->
      <path id="project.class.path">
        <pathelement location="${project.dir}/${bin.dir}" />
        <!-- 由于使用links方式安装Lomboz插件，所以需要修改这个目录，使其
              正确指向Lomboz目录，还建议使用1.2.2版本的XDoclet 目录下的库
              文件来代替 sf.net.xdoclet* 目录下的库文件
         -->
       <fileset dir="D:/eclipse/myplugins/lomboz-3.0.1/eclipse/plugins">
         <include name="**/ant.jar"/>
         <include name="**/sf.net.xdoclet*/*.jar"/>
         <include name="**/org.apache.log4j*/**/*.jar"/>
         <include name="**/org.apache.commons*/**/*.jar"/>
       </fileset>
       
        <!-- append the external classpath lastly -->
        <pathelement path="${java.class.path}" />
        
        <!-- append the path sent through eclipse to classpath -->
        <pathelement path="${project.path}" />
        
     </path>

   </target>
   <!-- Run EJBDoclet -->
   <target name="ejbdoclet" depends="init">
    <taskdef name="ejbdoclet" classname="xdoclet.modules.ejb.EjbDocletTask">
  <classpath refid="project.class.path"/>
 </taskdef>

      <ejbdoclet
            destdir="${project.dir}/${ejbsrc.dir}"
            mergedir=