以上所有的工具和软件包不仅流行、功能强大、而且是免费的,是J2EE开发典型搭配。本章将分三个层次来渐进式的展开讲解:
l Lomboz下的纯J2EE开发
l 融合Struts的J2EE开发
l 融合Struts和Hibernate后的J2EE开发
由于篇幅有限,本章以开发环境的安装和配置为重点,并辅以一个典型而有深度的实例来演示具体的开发操作,最后给出一个扩展知识的资料索引。
本章和第8章一样也使用CVS来管理所有例程,在每一节的标题后会用括号显示这一节的版本号。本章具体的环境为:WindowsXP + JDK1.4.2_06 + Eclipse3.1M4 + cvsnt2.0.58d + Tomcat5.0.28 + Lomboz3.1.0 + Struts 1.2.4。
由于V0010版,存在一些空目录,而这些空目录也是必须要的,否则项目会出错。这需要修改一个CVS的配置,如下图9.1所示,打开Eclipse的首选项→小组→CVS→将“修剪空目录”项取消勾选。
图9.1 修改CVS配置
这一节先搭建好Tomcat环境,Tomcat的下载安装和Eclipse、Lomboz都没有直接关系,它是完全独立的。
1、下载Tomcat
(1)用IE打开Tomcat的下载页面:http://jakarta.apache.org/tomcat/index.html,选择页面左边的链接“Binaries”,转到下图9.2所示的页面:
图9.2 Tomcat项目选择
(3)单击上图中标识的“Tomcat”项,出现如下图9.3所示的页面
图9.3 具体下载项
(4)下载上图9.3所示的“5.0.28.exe”项,下载后的文件名为:jakarta-tomcat-5.0.28.exe
l 注意:
l (1)不要下载Tomcat5.5.*版,因为那需要JDK5.0的支持;也不要下载4.1.*版,它的功能太弱了。因为不同版本之间的安装和配置都会有所不同,为了和本教程同步,一定要下载5.0.28版。
l (2)如果用FlashGet等多线程下载工具无法下载,则改用原始的IE右键菜单的“另存为…”项来下载。
2、安装Tomcat
安装Tomcat的过程比较简单,双击得到的下载文件:jakarta-tomcat-5.0.28.exe,开始安装。
(1)选择安装组件。接受默认的勾选即可,如下图9.4所示。
图9.4 选择组件
(2)选择Tomcat安装目录。也一样接受默认值,将安装到C:/Program Files/Apache Software Foundation/Tomcat 5.0目录下,如下图9.5所示:
图9.5 Tomcat的安装目录
(3)选择HTTP监听端口(Port),如下图9.6所示。默认端口是8080,如果8080端口已被你电脑上的其他软件所占用(如IIS、JBoss等),则可以另选择一个空闲的端口。最后,给Tomcat的超级管理员admin设为一个密码(本书设为123456)。
图9.6 设置端口和密码
(4)设置Tomcat使用的JVM,本书的默认值为“C:/Program Files/Java/j2re1.4.2_06”,如下图9.7所示。很多资料都指出,在安装JDK时要设置设置classpath、JAVA_HOME、path等环境变量,但本书从第一章开始就从没有设置过这些环境变量,一样可以运行通畅,也许是新版的JDK1.4.2_06很好的解决了这些问题。从这一步也可以看到,Tomcat已经在安装时定位好了JVM的位置,不必再手工设置了。
设置好JVM后,单击“install”按钮,开始安装。
图9.7 定位JVM的位置
(5)安装完成之后,在Windows的“控制面板”→“管理工具”→“服务”窗口中,可以看到Tomcat已经注册为windows的一项服务,如下图9.8所示。请确定它是“手动”方式,这一点在开发时很重要,因为我们以后要通过Eclipse来启动Tomcat。
图9.8 windows“服务”窗口
3、启动Tomcat
虽然以后在开发时,是要通过Eclipse来启动Tomcat,但现在为了测试Tomcat是否安装成功,暂时先启动Tomcat。
(1)可以通过Windows的“开始”菜单→“Apache Tomcat5.0”组→“Configure Tomcat”项来运行Tomcat的配置界面(如下图9.10所示),这个界面包含了Tomcat的一些参数设置,这些设置一般都不用去改动它。直接“单击”按钮,即可启动Tomcat。
图9.10 Tomcat的配置界面
(2)在IE浏览器中输入“http://localhost:8080”或“http://127.0.0.1:8080”,其中8080为安装时设置的端口号。如果启动成功,则会出现如下图9.11所示的页面;反之,如果没有出现此页面,则表示启动未成功,这时你需要检查前面的安装步骤是否和本书的一致。
图9.11 验证Tomcat是否安装及启动成功
附注:在上图页面的左部有两个链接:Tomcat Administration、Tomcat Manager,它们是用于管理Tomcat的,登录密码都是在安装Tomcat时设置的用户名admin和密码123456。其中,Tomcat Adiministration项可以设置数据库连接池、管理用户及权限、以及其他一些Tomcat服务器相关设置;Tomcat Manager项主要用来发布网页管理,通过它可以轻松的将一个WAR包发布到Tomcat中。
关于Tomcat中文问题的解决,请参阅9.4.6节。
下载Lomboz时一定要针对Eclipse的版本来选择相应的Lomboz版本下载,否则对应版本不同,很有可能会导致Lomboz无法正常使用。本章由于依然要使用CVS,所以还是用Eclipse3.1M4版,Lomboz选择相应的3.1.0版。
1、下载Lomboz
Lomboz的下载地址是:http://forge.objectweb.org/project/showfiles.php?group_id=97 ,下载页面如下图9.12所示,请选择for Eclipse3.1.x的Lomboz来下载,而且还需要同时下载emf包(如图中箭头所示)。
下载后的文件名为:
l org.objectweb.lomboz_3.1.0.N20050106.zip
l emf-sdo-runtime-I200412160800.zip
图9.12 Lomboz的下载页面
2、安装Lomboz
(1)因为Lomboz、emf是Eclipse的插件,所以它和其他Eclipse插件的安装方法一样,本书采用Links式的插件安装方法,具体步骤不再重复,请参阅1.2节的安装步骤。
下图9.13是安装完成后的目录结构:
图9.13 lomboz、emf的安装目录结构
其中图9.13中的links目录有新创建的两个文本文件:
l 文件lomboz.link,内容仅一句:path=lomboz_3.1.0.N20050106
l 文件emf.link,内容也仅一句:path=emf-sdo-runtime-I200412160800
(2)验证Lomboz是否安装成功
启动Eclipse。如果安装成功,选择“文件”→“新建”→“项目”会出现如下图9.14所示的Lomboz项目。
图9.14 验证Lomboz是否安装成功
(3)如果未能出现上图画面,请做如下检查和尝试:
l 删除eclipse目录下的子目录configuration,再启动Eclipse试一试。
l 检查Lomboz的版本是否和Eclipse的一致。
l Links文件中的path项是否设置正确。
l Lomboz的目录结构是否正确:../lomboz_3.1.0.N20050106/eclipse/plugins,注意lomboz_3.1.0.N20050106和plugins的中间还有个elcipse目录。
安装完Lomboz之后,还需要针对Tomcat做一些设置才能用于开发WEB,具体操作步骤如下:
(1)打开Eclipse的首选项,设定JDK的tools.jar包的位置,本书是“C:/jdk/lib/tools.jar”,如下图9.15所示:
图9.15 设定JDK的tools.jar包的位置
(2)如下图9.16所示,注意,在Server types项的下拉框中,要选择和当前所用Tomcat版本相对应的项;Application Server Directory和Classpath Variable两项都是指向Tomcat的安装目录:C:/Program Files/Apache Software Foundation/Tomcat 5.0。
图9.16 Tomcat在Lomboz中的设置
(3)Tomcat5.0.28版本在Lomboz中无法启动,必须还要做一些小修改。到Lomboz插件的“../lomboz_3.1.0.N20050106/eclipse/plugins/com.objectlearn.jdt.j2ee_3.0.1/servers”目录中,可以看到各种Web服务器的配置文件,它们都会显示在上图9.16的server types下拉框中,除了tomcat50x.server文件外,其他都不需要,把它们都删除掉或者备份到其他地方。最后,用记事本打开tomcat50x.server,并将所有“${serverRootDirectory}/bin;${serverRootDirectory}/common/endorsed”项替换成“${serverRootDirectory}/common/endorsed”,共有两处,约在文件中的35、39行位置。
本小节将写一个JSP的HelloWorld,用来验证以上Tomcat和Lomboz的环境是否安装成功。
1、设置Java的构建路径
打开Eclipse首选项,如下图9.17所示,选择“java”→“构建路径”→选择“文件夹”项。经过此步设置之后,新建的Java项目(包括J2EE项目)就会默认以bin为输出目录。
l 注意:这一步相当重要,因为用Lomboz创建J2EE项目时,是无法象创建普通Java项目那样选择“项目布局”的,此时J2EE项目的输出目录将会是在项目根目录下,以后JavaBean的java文件也会和class文件混在一块,非常不便。更关键的是,在后面会要重新定位JavaBean的输出路径,如果不经过这一步,则定位JavaBean的输出路径时,整个项目的输出路径也会自动定位到bin目录下,但此时项目结构都会调整,容易导致混乱。总之,此步一定不能省略。
图9.17 设置Java项目的构建路径
2、创建一个J2EE项目
(1)重启Eclipse。选择“文件”→“新建”→“项目”,选择如下图9.18所示的“Lomboz J2EE Project”项目,然后单击“下一步”。
图9.18 选择“Lomboz J2EE Project”项目
(2)输入项目名称myweb,然后单击“下一步”。
(3)在接下的“定义Java构建设置”页中不做任何改变,直接单击“下一步”。
(4)最后一个页面是J2EE的设置,如下图9.19、9.20所示。共有三步:创建一个名为hello的Web Modules(WEB模块);在Targeted Servers选项卡中,选择“Apache Tomcat v5.0.x”项并单击“Add”加入;单击“完成”按钮,开始生成一个J2EE项目。
图9.19 创建一个Web Modules
图9.20 设置Targeted Servers
(5)完成以上操作之后,“包资源管理器”视图中会出现如下图9.21所示的项目结构。
图9.21 myweb项目的项目结构
3、在Lomboz中启动Tomcat
右键单击“hello模块”,弹出如下图9.22所示的右键菜单,选择Run Server来启动Tomcat(启动前确保Tomcat还是停止状态)。在这个菜单中还有其他常用的菜单项:
l Stop Server - 停止Tomcat
l Debug Server - 用调试方式启动Tomcat。在WEB开发中,它比Run Server更常用。
l Check All JSP Syntax - 检查项目中所有JSP文件的语法是否符合规范
l Undeploy Module - 删除已经发布在Tomcat上的WEB模块
l Deploy Module - 发布WEB模块到Tomcat上
l Show in Browser - 在IE中预览本WEB模块的效果。
图9.22 hello模块的右键菜单
如果启动Tomcat成功,在控制台会显示如下图9.23所示的字符串。
图9.23 控制台的输出显示
4、发布hello模块
右键单击hello模块,打开如上图9.22所示的右键菜单,选择Deploy Module项,将hello模块发布到Tomcat。
从下图9.24的控制台输出,可以看出Lomboz使用Ant来发布网页,每一行都显示出hello模块的打包发布过程,下面给出一些关键词解释:
l mkdir - 创建目录
l copy - 复制文件
l jar - 用JDK的jar来打包(这里是打包成hello.war)
l delete - 删除文件
图9.24 发布hello模块时的控制台输出
再次调出hello模块的右键菜单,选择Show in Browser项。Lomboz将打开IE浏览器,得到如下图9.25所示的效果,也可以直接打开IE浏览器,输入地址“http://127.0.0.1:8080/hello/”来查看效果。这个页面显示的是index.jsp文件。
图9.25 用IE来查看网页效果
5、修改index.jsp
如下图9.26所示,修改index.jsp来显示一个HelloWorld字符串。
图9.26 修改index.jsp
保存好之后,还要再用“Deploy Module” 菜单项重新发布hello模块,然后才能在IE中看到修改后的效果。