*******************************************************
作者：陈刚，普通程序员，曾有幸以Eclipse插件方式开发过一个中型软件。现将所学
付诸于纸，暂取书名<Eclipse插件开发指南>，将于2005年初由清华大学出版社出版。
blog：http://blog.csdn.net/glchengang/
*******************************************************
第9章 Eclipse的J2EE开发
Eclipse默认安装是没有J2EE开发支持的，它需要安装第三方插件，本章的主要介绍的J2EE开发插件是Lomboz，主要开发环境是Tomcat + Lomboz + Struts + Hibernate，这是当前比较流行的一种选择。其中Tomcat充当WEB服务器；Lomboz是J2EE开发的工具；Struts提供强大的MVC模式支持；Hibernate替代笨重的EJB来充当数据库的持久层。
以上所有的工具和软件包不仅流行、功能强大、而且是免费的，是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。
9.1 WEB环境的搭建（V0010）
9.1.1 下载CVS版本注意事项
由于V0010版，存在一些空目录，而这些空目录也是必须要的，否则项目会出错。这需要修改一个CVS的配置，如下图9.1所示，打开Eclipse的首选项→小组→CVS→将“修剪空目录”项取消勾选。
图9.1 修改CVS配置
9.1.2 Tomcat的下载与安装
这一节先搭建好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节。
9.1.3 Lomboz的下载与安装
下载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目录。
9.1.4 Lomboz的环境设置
安装完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行位置。
9.1.5 JSP的HelloWorld
本小节将写一个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中看到修改后的效果。
6、一些相关问题
（1）如果看不到修改效果，有可能是IE的页面缓存的原因，可以尝试如下解决办法：关掉IE，然后再打开，进入“工具”→“Internate选项”，单击下图9.27中的“删除文件”按钮来删除IE的网页缓存。
图9.27 删除IE页面缓存
（2）同样是因为缓存原因，在停止Tomcat服务后，即使刷新网页却依然能正常显示。将IE关掉重启，页面即会无法访问。
（3）如果是在Eclipse中启动Tomcat的，则关闭Eclipse，Tomcat服务也随之停止。但建议还是使用“Stop Server”菜单项来正常停止Tomcat服务。
9.1.6 如何不必发布就可以在IE上显示WEB修改效果
经过前面设置后，虽然可以开发WEB了，但每一次修改都要重新发布hello模块，才能在IE上显示修改后的效果，这无疑是开发时无法接受的，照这样，开发的时间进度至少要增加一倍。本小节将给出不必不发布就可以在IE上显示修改效果的方法。
首先，解决的办法是基于以下知识的：
l 在发布hello模块时，Lomboz是将hello模块打成一个WAR压缩包，然后复制到Tomcat的webapps目录，在IE上显示的网页就是来自于这个目录下的WAR压缩包中，所以不能直接显示修改后的JSP文件也是可以理解的了。
l Tomcat要发布网页，不是必须得打成WAR包，也可以发布未经压缩的文件目录。实际项目中，直接发布零散文件的方式居多，因为这样更新JSP文件比较方便。
l 在Tomcat安装目录下的conf子目录里有一个名为server.xml的文件，它可以用来定义一个新的WEB应用。
由上面的知识，可以得出以下解决思路：通过修改server.xml文件，定义一个新的WEB应用，将这个WEB应用定位到Eclipse的workspace目录中的myweb项目。这样设置以后，IE显示的文件就是Eclipse中正在编写的JSP文件了，也就是说，不必再经过打包成WAR发布这一步。
具体操作步骤如下：
（1）为了避免干扰，先将原来发布的hello模块删除。
打开Tomcat主页面：http://127.0.0.1:8080/。选择链接“Tomcat Manager”，输入用户名密码（admin、123456），得到如下图9.28所示页面。单击hello模块右侧的“Undeploy”将hello模块从Tomcat上的撤消发布。
图9.28 撤消Tomcat上的hello模块
（2）修改server.xml，定义一个新的WEB应用
server.xml此文件的具体路径如下：C:\Program Files\Apache Software Foundation\Tomcat 5.0\conf\server.xml。此server.xml文件最未尾的</Host>项之前插入一项<Context>的设置，<Context>的具体代码如下：
<Context path="/hello"
reloadable="true"
docBase="C:\eclipse3.1M4\eclipse\workspace\myweb\hello"
workDir="C:\eclipse3.1M4\eclipse\workspace\myweb\bin" />
代码说明：
l 注意一定要将以上代码加在紧靠</Host>项之前，<Context>的几个属性可以分行写，也可以写成一行。
l path － 是指WEB模块的名称hello，这样其访问地址为：http://127.0.0.1:8080/hello/
l docBase － 定义jsp文件位置。本处指向Eclipse中hello模块的路径
l workDir － 在IE显示之前，JSP要先编译成servlet，这个属性就是定义hello模块输出的servlet的所在位置。如下图9.29所示，因为所建的myweb项目默认的输出路径为myweb\bin目录，所以这里的workDir也定位到此myweb\bin目录。
图9.29 myweb项目的默认输出文件夹
（4）右键单击“hello”模块→选择Lomboz J2EE→选择Debug Server（或Run Server）。然后，在IE浏览器中输入“http://127.0.0.1:8080/hello/”来查看效果。最后，随便修改一下index.jsp文件，直接刷新一下IE，如果可以看到修改后的效果，表示以上所有设置成功。
如下图9.30所示的“导航器”视图（注意：不是“包资源管理器”视图），index.jsp在经过IE显示之后生成几个新文件和目录（可能需要先刷新一下myweb项目）：
图9.30 myweb项目结构
9.1.7 配置Tomcat的数据库连接池
在WEB开发中，有没有数据库连接池对WEB性能的影响非常大，Tomcat有自带的连接池，这一节就来配置Tomcat的连接池。
1、复制JDBC连接包
将第8章使用的JDBC连接包mysql-connector-java-3.0.16-ga-bin.jar复制到C:\Program Files\Apache Software Foundation\Tomcat 5.0\common\lib目录下，common\lib是Tomcat的全局引用库的所在目录，Tomcat在启动时会自动加载这个目录中的所有JAR包。
有些网上的文章说也可以将数据库连接包复制到WEB应用的WEB-INF\lib中（本例的myweb\hello\WEB-INF\lib目录），这个目录是hello模块发布时会自动加载的一个包目录。但经笔者实验，如果连接包将放在此目录中，不用数据库连接池方式来访问数据库，则连接包可以正常使用；如果使用Tomcat连接池，则会出错误，连接包无法使用。
2、进入Tomcat的配置页面
用IE浏览器输入地址：http://127.0.0.1:8080/admin/ ，打开Tomcat服务器配置的登录页面，再输入用户名admin、密码123456，进入Tomcat的配置页面，如下图9.31所示：
图9.31 连接池设置
单击左边的树结点“Data Source”→选择右上角的下拉框的“Create New Data Source”项，然后在表格中输入相应的连接池配置信息：
l JNDI Name：jdbc/mysql － 设置连接池的JNDI名，在Java程序会用到此名。
l Data Source URL：jdbc:mysql://localhost/sms － 数据库连接字串，sms是数据库。
l JDBC Driver Class：com.mysql.jdbc.Driver － JDBC连接类。
l User Name：root － 数据库登录用户名。
l Password：****** － 数据库登录密码。本例为123456。
l Max. Active Connections：4 － 最大连接数。实际应用时，应该根据WEB使用情况设置得大一些；开发时，4个连接足够了。
l Max. Idle Connections：2 － 最大空闲连接数。
l Max. Wait for Connection：5000 － 最大等待连接限制。
l Validation Query：验证用的查询语句，可以不填。
填写完以上信息之后，单击右下角的“Save”按钮保存修改，再单击右上角的“Commit Changes”按钮提交修改。
3、修改Tomcat的server.xml文件
server.xml文件的具体路径：C:\Program Files\Apache Software Foundation\Tomcat 5.0\conf\server.xml，在原来的<Context>项中加入一个子项< ResourceLink>：
<Context path="/hello"
reloadable="true"
docBase="C:\eclipse3.1M4\eclipse\workspace\myweb\hello"
workDir="C:\eclipse3.1M4\eclipse\workspace\myweb\bin">
<ResourceLink name="jdbc/mysql"
global="jdbc/mysql"
type="javax.sql.DataSourcer"/>
</Context>
4、测试数据库连接池
将以下测试程序命名为test.jsp，创建在hello模块的根目录下，然后通过IE地址：http://127.0.0.1:8080/hello/test.jsp来访问。这个测试程序从数据库连接池中获得一个数据库连接对象Connection，然后再查询数据库的iuser表，并用name（姓名）列的数据打印出来（注：iuser是在第8章创建的用户表）。test.jsp运行效果如下图9.32所示：
图9.32 test.jsp的效果
test.jsp源代码如下：
<%@ page contentType="text/html; charset=GBK"%>
<%@ page import="java.sql.*"%>
<%@ page import="javax.sql.*"%>
<%@ page import="javax.naming.*"%>
<%
Connection con=null;
Statement sm=null;
ResultSet rs=null;
try{
InitialContext ctx=new InitialContext();
DataSource ds=(DataSource)ctx.lookup("java:comp/env/jdbc/mysql");
con = ds.getConnection();
sm = con.createStatement();
rs = sm.executeQuery("select * from iuser");
while(rs.next())
out.println(rs.getString("name")+",");
}catch(Exception e){
e.printStackTrace();
}finally {
if (rs != null) {
try {
rs.close();
} catch (SQLException e) {}
rs = null;
}
if (sm != null) {
try {
sm.close();
} catch (SQLException e) {}
sm = null;
}
if (con != null) {
try {
con.close();
} catch (SQLException e) {}
con = null;
}
}
%>
程序说明：
l <%@ page contentType="text/html; charset=GBK"%> 这一行是设置网页的字符集，也是解决中文乱码问题的关键一句。如果是纯html页面，则应在</HEAD>项之前加入这样一句：<META http-equiv=Content-Type content="text/html; charset=GBK">。
l <%@ page import="java.sql.*"%> 这一句类似于Java中的import java.sql.*。
l ctx.lookup("java:comp/env/jdbc/mysql"); 这一句中comp/env是固定不变的，jdbc/mysql是前面连接池设置的JNDI Name。
l 在程序最后一定要关闭数据库连接（实际是将连接返回给连接池，并没有真正关闭），否则，很快就会因连接数耗尽，而无法再正常显示JSP页面。
