使用Eclipse开发J2EE应用
内容:
相关内容:
--
----集成Eclipse, Lomboz和JBoss
联想集团软件设计中心的开发工程师
2003 年 6 月
Eclipse是一个非常优秀的集成开发环境,这个在IBM支持下的开放源码项目经过一段时期的发展完善,已经为广大Java开发者所熟悉。Eclipse的出现,为Java开发者提供了免费使用强大的Java IDE的机会,通过集成大量的plugin,Eclipse的功能可以不断扩展,以支持各种不同的应用。
Lomboz是一个免费的Eclipse plugin,它将很多Java应用服务器、J2EE组件和Web应用开发集成到Eclipse中,可以帮助Java开发者使用Eclipse建立、测试、部署J2EE应用。
JBoss是一个开放源码、功能强大的Java应用服务器,也是目前最受Java开发者欢迎的Java应用服务器,被Java World的编辑们评为2002年的最佳应用服务器。2003年到目前为止的下载量已经超过了一百五十万次。
一、下载、安装和配置
1. Eclipse的下载和安装
首先需要安装JDK,可以到Sun的网站上去下载最新版本并安装。
然后到www.eclipse.org去下载Eclipse的最新版本,目前的最新版本是2.1。下载以后解压到自己想要的目录中,比如D:\Eclipse,直接运行eclipse.exe,第一次运行的时候会自动寻找JDK并完成相应的配置,然后就进入了Eclipse的主界面。关于Eclipse的基本使用方法,developerWorks,Eclipse的网站以及Eclipse的随机文档上都有详细地介绍,这里不详细描述了。
2. Jboss的下载、安装
JBoss目前的最新版本是3.2.1,不过我觉得这个版本有一些问题,启动服务器的时候会有一些jar包找不到,导致WARN和ERROR的发生。所以我推荐下载3.0.7,也可以下载集成了Tomcat 4.1.24的JBoss 3.0.7版本。
下载后解压,我们假设JBOSS_HOME为JBoss的主目录,执行JBOSS_HOME/bin/run.bat,就启动了JBoss服务器。一般会在1分钟左右启动完毕。
3. Lomboz的下载、安装和配置
Lomboz目前的最新版本是2.1,我们假设Eclipse的主目录为ECLIPSE_HOME,下载以后将其解压到ECLIPSE_HOME/plugins文件夹下面,这样在这个文件夹下面就多了一个com.objectlearn.jdt.j2ee文件夹。
然后启动Eclipse, 会自动出现Customize Perspective的对话框,如果没有出现的话,也可以通过菜单"Window->Customize Perspective"来显示这个对话框,如下图所示:
展开File->New,选择所有与Lomboz相关的选项;
展开Window->Show View,选择Lomboz J2EE View;
展开Other,选择Lomboz Actions。
确认OK。
下面要进行Lomboz的配置:
首先,打开属性对话框,确保Java->New Project中的设置:
接着在Lomboz属性中,确保如下设置:
最后,设置服务器属性。
Lomboz预先定义了一些常用的Java服务器的设置,这些配置文件放在ECLIPSE_HOME/plugins/com.objectlearn.jdt.j2ee/servers 文件夹下面,你可以用文本编辑器手工修改(除非你所用的服务器不在Lomboz默认的服务器中,否则我不推荐你这么做),也可以在Eclipse的属性对话框中设置,设置的过程非常简单,如下图所示:
记得每次修改以后,都要点击Apply。
上图是Properties标签下的设置,Classpath标签下一般不需要做任何改动(注意:如果你没有听我文章开始部分的劝告,使用了JBoss3.2.0以上的版本,可能需要手工加入多了个jar包,这是体力活,有些麻烦。我不知道这是不是JBoss的问题,具体操作我在下面会提一下)。
通过以上三个步骤,就完成了Lomboz对J2EE开发的支持和JBoss的配置。你可以进入文章的第二部分"使用Eclipse开发Web应用"了。
注意事项:
a.如果服务器不在默认服务器之列;
在ECLIPSE_HOME/plugins/com.objectlearn.jdt.j2ee/servers 文件夹下新建一个后缀名为server的文件,然后根据已有的server文件为模版,用文本编辑器编辑server文件。建立了一个新的server文件以后,也可以在Lomboz的属性页中进行相应的设置。
b. 如果使用了JBoss3.2.0版本。
打开Window>Preferences>Lomboz>ServerDefinitions,选择你的服务器,然后选择classpath标签,将如下的jar包加入到server library中:
JBOSS_HOME\lib\concurrent.jar
JBOSS_HOME \lib\boss-system.jar
JBOSS_HOME \server\default\lib\jboss.jar
JBOSS_HOME \server\default\lib\jpl-pattern.jar
JBOSS_HOME \server\default\lib\jpl-util.jar
JBOSS_HOME \server\default\lib\jnpserver.jar
JBOSS_HOME \server\default\lib\jboss-transaction.jar
我的JBoss320.server文件中的全部内容在本文的最后部分呈现。
二、使用Eclipse开发Web应用
首先,打开File->New->Lomboz J2EE Project,创建一个名为TestJ2EE的J2EE Project。
点击Next,默认各种设置,点击Next,进入下一个对话框,在Targeted Server中加入已经配置好的服务器,如下图:
在Web Modules和EJB Modules中分别新建Web模块和EJB模块,在本例中,我们分别命名为MyWeb和MyEJB,然后点击Finish。这样,一个J2EE项目的框架就自动生成了。
在MyWeb模块下面,自动生成了两个jsp文件:index.jsp和error.jsp,以及WEB-INF文件下面的配置文件。我们可以在此基础上面添加自己的jsp文件和servlet,然后build project。
在Eclipse的工具栏上点击Lomboz J2EE project outliner的按钮:
这样,在Eclipse上就出现了Lomboz J2EE View,如下图所示:
由于我事先已经部署了另一个Web服务器:Tomcat,所以在MyWeb这个模块上面出现了它所绑定的这两个服务器,JBoss 3.0 All 旁边的红色标记表示它是默认的服务器。可以通过右击Web模块选择更改默认的服务器,如下图:
选择好服务器以后,在Lomboz J2EE View中右键单击服务器,选择运行服务器,等服务器启动好以后,右键单击Web模块,选择Deploy Module,这样就完成了Web模块在服务器上的部署。打开IE浏览器,键入http://127.0.0.1:8080/MyWeb,就可以看到自己开发的Web应用了。
这里有一点需要说明,如果采用Tomcat作为Web服务器的话,如果Web模块需要重新部署,则须重新启动Tomcat服务器,JBoss则不需要这么做。
注意事项:
如果从Eclipse中启动JBoss服务器的时候,遇到了这个问题:
Error occurred during initialization of VM
java/lang/NoClassDefFoundError: java/lang/Object
一般遇到这个问题,可能是由于JRE没有设置好,请在Eclipse中的Preference对话框中,展开Java->Installed JREs,查看JRE是否设置好了;然后打开所开发的项目属性对话框,查看Java Build Path的library中是否有JRE System Library,没有的话,点击Add Library,添加JRE System Library。
三、使用Eclipse开发EJB
在第二部分"使用Eclipse开发Web应用"中,我们已经在TestJ2EE这个J2EE项目中添加了一个名为MyEJB的EJB模块。下面我们通过Lomboz EJB Creation Wizard向MyEJB模块中添加一个Session Bean。
点击File->New->Lomboz EJB Creation Wizard,或者右击MyEJB模块,选择New->Lomboz EJB Creation Wizard,显示出如下对话框:
在com.dino.testj2ee.myejb这个包下面创建一个名为MyEJB的Stateless Session Bean。完成以后,在TestJ2EE项目的src文件夹下面,出现了一个名为MyEJBBean.java的文件,右击这个文件,选择New->Lomboz EJB Method Wizard,可以给这个EJB添加各种方法。我添加了一个helloWorld方法,返回一个String类型。如下图所示:
然后,需要把MyEJB这个Session Bean添加到MyEJB这个模块上面:右击MyEJB.java,选择Lomboz J2EE…->Add EJB to Module,选择MyEJB,OK。
右击MyEJB模块,选择LombozJ2EE…->Generate EJB Classes,这样就在ejbsrc目录下面自动生成了下面几个文件:
MyEJBHome.java
MyEJBRome.java
MyEJBLocalHome.java
MyEJBLocal.java
MyEJBSession.java (MyEJBSession extends MyEJBBean)
MyEJBUtil.java
Build project以后,自动将模块打包完毕。接着就可以按照部署Web模块的步骤来部署EJB模块了。
最后,我们建立一个应用程序来测试EJB。
通过File->New->Lomboz EJB Test Client Wizard打开一个对话框,按下图填写:
完成以后,在src目录下面生成了TestMyEJB.java,在其中的testBean方法中加入测试代码:
System.out.println(myBean.helloWorld());
如果目前JBoss服务器已经启动,而且MyEJB模块已经部署的话,执行TestMyEJB,就会在Console窗口上显示出:
hehe, I can deploy EJB by Eclipse!
四、总结
通过以上的介绍,我们了解到,Lomboz使Eclipse开发J2EE应用变得非常简便,而且Eclipse, Lomboz, JBoss这些工具都是免费和开放源码的项目,所以这样的组合对Java开发者来说更有吸引力。
对于开发复杂的J2EE应用来说,上面的介绍可能还不够全面,希望大家在做项目的过程中体会,再将总结出来的经验放到developerWorks上来分享。
参考资料:
www.eclipse.org Eclipse的官方网站;
www.jboss.org JBoss的官方网站;
www.objectlearn.com Lomboz的网站,上面有关于Lomboz的教程。
Eclipse in Action: A Guide for Web Developers, by David Gallardo, Ed Burnette and Robert McGovern, Manning Publications. 一本介绍使用Eclipse开发的好书。
JBoss 3.0: Quick Start Guide, by JBoss Group. 一本关于JBoss入门的好书。
关于作者
姜巍巍,是联想集团软件设计中心的开发工程师,热衷于J2EE和Web服务技术。闲暇时,喜欢阅读计算机书籍,并频繁光顾各个Java论坛;周末的晚上,一般会乖乖的在电视机前面观看意甲直播。地址:北京市上地信息产业基地开拓路7号先锋大厦 邮编:100085 。您可以通过E-mail: jiangww@lenovo.com 与他取得联系。
附录:JBoss320.server
<serverDefinition name="JBOSS 3.2"
ejbModules="true" webModules="true" earModules="true">
<property id="serverRootDirectory" label="Application Server Directory:"
type="directory" default="D:/jboss-3.2.0" />
<property id="serverAddress" label="Address:"
type="string" default="127.0.0.1" />
<property id="serverPort" label="Port:"
type="string" default="8080" />
<property id="classPathVariableName" label="Classpath Variable Name:"
type="string" default="JBOSS32" />
<property id="classPath" label="Classpath Variable:"
type="directory" default="D:/jboss-3.2.0" />
<serverHome>${serverRootDirectory}</serverHome>
<webModulesDeployDirectory>${serverRootDirectory}/server/all/deploy</webModulesDeployDirectory>
<ejbModulesDeployDirectory>${serverRootDirectory}/server/all/deploy</ejbModulesDeployDirectory>
<earModulesDeployDirectory>${serverRootDirectory}/server/all/deploy</earModulesDeployDirectory>
<jndiInitialContextFactory>org.jnp.interfaces.NamingContextFactory</jndiInitialContextFactory>
<jndiProviderUrl>jnp://${serverAddress}:1099</jndiProviderUrl>
<startClass>org.jboss.Main</startClass>
<startWorkingDirectory>${serverRootDirectory}/bin</startWorkingDirectory>
<startVmParameters></startVmParameters>
<startProgramArguments>-c all</startProgramArguments>
<stopClass>org.jboss.Shutdown</stopClass>
<stopWorkingDirectory>${serverRootDirectory}/bin</stopWorkingDirectory>
<stopVmParameters></stopVmParameters>
<stopProgramArguments>${serverAddress} ${serverPort}</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}/client/jboss-j2ee.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/javax.servlet.jar</jar>
<jar type="variable">${classPathVariableName}/lib/commons-httpclient.jar</jar>
<jar type="variable">${classPathVariableName}/lib/concurrent.jar</jar>
<jar type="variable">${classPathVariableName}/lib/getopt.jar</jar>
<jar type="variable">${classPathVariableName}/lib/jboss-boot.jar</jar>
<jar type="variable">${classPathVariableName}/lib/jboss-common.jar</jar>
<jar type="variable">${classPathVariableName}/lib/jboss-jmx.jar</jar>
<jar type="variable">${classPathVariableName}/lib/jboss-system.jar</jar>
<jar type="variable">${classPathVariableName}/lib/jdom.jar</jar>
<jar type="variable">${classPathVariableName}/lib/log4j-boot.jar</jar>
<jar type="variable">${classPathVariableName}/lib/webdavlib.jar</jar>
<jar type="variable">${classPathVariableName}/lib/xercesImpl.jar</jar>
<jar type="variable">${classPathVariableName}/lib/xml-apis.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jnet.jar</jar>
<jar type="variable">${classPathVariableName}/lib/gnu-regexp.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jboss.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jnpserver.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jpl-util.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jpl-pattern.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jsse.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jbossha.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jboss-jaas.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jts.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jboss-transaction.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/javagroups-2.0.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jmxri.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jmxtools.jar</jar>
<jar type="variable">${classPathVariableName}/server/all/lib/jbossmx.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}/client/jnet.jar</jar>
<jar type="variable">${classPathVariableName}/client/jaas.jar</jar>
</clientClassPath>
</serverDefinition>