JBuilder是一个开放的Java IDE，它集成了Tomcat、Weblogic等服务器。虽然JDK、Tomcat、Weblogic不断升级，我们仍可以在JBuilder中使用它们的最新版本。由于Tomcat服务器的配置比较复杂，习惯了Windows平台的程序员常常对Tomcat的使用感到困惑。
本文给出了一个使用Tomcat环境下的数据库连接池Database Connection Pool (DBCP) 的例子，说明了用JBuilder开发Web应用的一般步骤，并回答了一些经常遇到的问题。
JBuilder2005所带JDK的版本是1.4.2_04-b05，其文件放在目录JBuilder_HOME\jdk1.4下，Tomcat的最新版本是5.0.27，其文件放在目录JBuilder_HOME\thirdparty\ jakarta-tomcat-5.0.27下。下面首先给出给出了一个使用Tomcat环境下的数据库连接池Database Connection Pool (DBCP) 的例子。
1. File-New Project新建工程文件,输入工程文件名称myWeb和目录C:\myWeb
2. Project-Project Properties设置工程文件的属性，选择Tomcat为服务器
3. File-New新建Web Module（WAR）
输入Web Module的名称DBTest和目录DBTest
4. File-New新建JSP，输入jsp文件的名称test.jsp，产生test.jsp文件后修改test.jsp的内容：
Test.jsp:
＜%@ page contentType="text/html;
charset=Big5" %＞
＜html＞
＜head＞
＜title＞DB Test＜/title＞
＜/head＞
＜body＞
＜%
foo.DBTest tst = new foo.DBTest();
tst.init();
%＞
＜h2＞Results＜/h2＞
Foo ＜%= tst.getFoo() %＞＜br/＞
Bar ＜%= tst.getBar() %＞
＜/body＞
＜/html＞
将会生成一个名称为test的runtime configuration。选Run-Configurations-Edit可修改runtime configuration，特别是可以指定服务器的端口号和是否自动搜索为被占用的端口。
5. File-New Class，输入类名DBTest和包名foo，产生DBTest.java文件后修改它的内容
DBTest.java
package foo;
import javax.naming.*;
import javax.sql.*;
import java.sql.*;
public class DBTest
{
String foo = "Not Connected";
int bar = -1;
public void init()
{
try{
Context ctx = new InitialContext();
if(ctx == null )
throw new Exception
("Boom - No Context");
DataSource ds
=(DataSource)ctx.lookup
("java:comp/env/JDBC/TestDB");
if (ds != null)
{
Connection conn
= ds.getConnection();
if(conn != null)
{
foo = "Got Connection "
+conn.toString();
Statement stmt =
conn.createStatement();
ResultSet rst
=stmt.executeQuery("select id, foo,
bar from testdata");
if(rst.next())
{
foo=rst.getString(2);
bar=rst.getInt(3);
}
conn.close();
}
}
}catch(Exception e)
{
e.printStackTrace();
}
}
public String getFoo()
{
return foo;
}
public int getBar()
{
return bar;
}
}
6. 修改web.XML的内容
web.xml:
＜?xml version="1.0" encoding="UTF-8"?＞
＜web-app
xmlns="http://java.sun.com/xml/ns/J2EE"
xmlns:xsi=
"http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation=
"http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4"＞
＜description＞MySQL Test App＜/description＞
＜resource-ref＞
＜description＞DB Connection＜/description＞
＜res-ref-name＞jdbc/TestDB＜/res-ref-name＞
＜res-type＞javax.sql.DataSource＜/res-type＞
＜res-auth＞Container＜/res-auth＞
＜/resource-ref＞
＜/web-app＞
7. F9运行应用，myWeb目录中将会生成Tomcat子目录，其中包含了conf子目录，在Tomcat_HOME\conf\Catalina\localhost目录中生成了DBTest.XML文件。
8. 将myWeb\Tomcat\conf目录中的文件server8080.xml加入工程文件，修改server8080.xml的内容：
server8080.xml:
＜?xml version="1.0"
encoding="UTF-8"?＞
＜Server debug="0" port="8081"
shutdown="SHUTDOWN"＞
＜Service name="Catalina"＞
＜Connector acceptCount="10"
connectionTimeout="60000" debug="0"
maxThreads="75" minSpareThreads="5"
port="8080"/＞
＜Engine debug="0"
defaultHost="localhost"
name="Catalina"＞
＜Host apPBase=
"C:\myWeb\Tomcat\webapps"
autoDeploy="false" debug="0"
deployXML="false" name="localhost"
unpackWARs="false"＞
＜Context path="/DBTest"
docBase="C:\myWeb\DBTest"
debug="5" reloadable="true"
crossContext="true"
workDir="C:\myWeb\Tomcat\work\DBTest"＞
＜Logger
className="org.apache.catalina.logger.FileLogger" prefix="localhost_DBTest_log."
suffix=".txt" timestamp="true"/＞
＜Resource name="JDBC/TestDB"
auth="Container"
type="Javax.sql.DataSource"/＞
＜ResourceParams name="jdbc/TestDB"＞
＜parameter＞
＜name＞factory＜/name＞
＜value＞org.apache.commons.dbcp.
BasicDataSourceFactory＜/value＞
＜/parameter＞
＜!--
Maximum number of dB
connections in pool. Make sure you
configure your MySQLd
max_connections large enough to handle
all of your db
connections. Set to 0 for no limit.
--＞
＜parameter＞
＜name＞maxActive＜/name＞
＜value＞100＜/value＞
＜/parameter＞
＜!--
Maximum number of idle dB
connections to retain in pool.
Set to 0 for no limit.
--＞
＜parameter＞
＜name＞maxIdle＜/name＞
＜value＞30＜/value＞
＜/parameter＞
＜!--
Maximum time to wait for a dB
connection to become available
in ms, in this example 10 seconds.
An Exception is thrown if
this timeout is exceeded.
Set to -1 to wait indefinitely.
--＞
＜parameter＞
＜name＞maxWait＜/name＞
＜value＞10000＜/value＞
＜/parameter＞
＜!-- MySQL dB username and
password for dB connections --＞
＜parameter＞
＜name＞username＜/name＞
＜value＞sa＜/value＞
＜/parameter＞
＜parameter＞
＜name＞password＜/name＞
＜value＞topcomputer＜/value＞
＜/parameter＞
＜!-- Class name for mm.mysql JDBC driver --＞
＜parameter＞
＜name＞driverClassName＜/name＞
＜value＞com.microsoft.
jdbc.sqlserver.SQLServerDriver＜/value＞
＜/parameter＞
＜!--
The JDBC connection url
for connecting to your MySQL dB.
The autoReconnect=true argument
to the url makes sure that the
mm.mysql JDBC Driver will
automatically reconnect if mysqld closed the
connection. mysqld by default
closes idle connections after 8 hours.
--＞
＜parameter＞
＜name＞url＜/name＞
＜value＞jdbc:microsoft:sqlserver:
//nt04:1433;DatabaseName=test＜/value＞
＜/parameter＞
＜/ResourceParams＞
＜/Context＞
＜/Host＞
＜/Engine＞
＜/Service＞
＜/Server＞
9. 将JDBC驱动放在C:\Borland\JBuilder2005\thirdparty\jakarta-tomcat-5.0.27\common\lib目录中
10. 在SQL Server中建立数据库test，数据库表文件testdata
creatTable.sql:
if exists (select * from dbo.
sysobjects where id =
object_id(N'[dbo].[testdata]')
and OBJECTPROPERTY
(id, N'IsUserTable') = 1)
drop table [dbo].[testdata]
GO
CREATE TABLE [dbo].[testdata]
(
[id] [int] NOT NULL ,
[foo] [varchar] (50)
COLLATE Chinese_Taiwan_Stroke_CI_AS NULL ,
[bar] [int] NOT NULL
) ON [PRIMARY]
GO
输入几条记录作为测试数据。
11. F9
12. 在c:\myWebmulu中建立批处理文件startup.bat和shutdown.bat内容分别如下：
startup.bat:
C:\Borland\JBuilder2005
JDK1.4\bin\Javaw -classpath
"C:\Borland\JBuilder2005\thirdparty
jakarta-tomcat-5.0.27\bin\bootstrap.jar;
C:\Borland\JBuilder2005\jdk1.4\lib\tools.jar"
"-Dcatalina.home=C:/Borland/JBuilder2005
/thirdparty/jakarta-tomcat-5.0.27"
org.apache.catalina.startup.Bootstrap -config
"C:\myWeb\Tomcat\conf\server8080.XML" start
Shutdown.bat:
C:\Borland\JBuilder2005\jdk1.4
\bin\javaw -classpath
"C:\Borland\JBuilder2005\thirdparty
jakarta-tomcat-5.0.27\bin\bootstrap.jar;
C:\Borland\JBuilder2005\jdk1.4\lib\tools.jar"
"-Dcatalina.home=C:/Borland/JBuilder2005
/thirdparty/jakarta-tomcat-5.0.27"
org.apache.catalina.startup.Bootstrap -config
"C:\myWeb\Tomcat\conf\server8080.xml" stop
13. 运行startup.bat,在浏览器输入http://localhost:8080/DBTest/test.JSP
如何部署Web应用？
1. 打包生成war文件
2. 将DBTest.war拷贝到Tomcat_HOME\webapps
3. 在Tomcat_HOME\conf\Catalina\localhost目录中建立文件DBTest.xml
DBTest.xml
＜!--
Context configuration file for
the Tomcat Administration Web App
$Id: admin.xml,
v 1.2 2002/07/23 12:13:05 remm Exp $
--＞
＜Context path="/DBTest"
docBase="/DBTest" debug="5"
reloadable="true" crossContext="true"
workDir="../work/DBTest"＞
＜Logger className="org.apache.
catalina.logger.FileLogger"
prefix="localhost_DBTest_log."
suffix=".txt" timestamp="true"/＞
＜Resource name="JDBC/TestDB"
auth="Container"
type="javax.sql.DataSource"/＞
＜ResourceParams
name="jdbc/TestDB"＞
＜parameter＞
＜name＞factory＜/name＞
＜value＞org.apache.commons.dbcp.
BasicDataSourceFactory＜/value＞
＜/parameter＞
＜!--
Maximum number of dB
connections in pool. Make sure you
configure your MySQLd max_connections
large enough to handle
all of your db connections.
Set to 0 for no limit.
--＞
＜parameter＞
＜name＞maxActive＜/name＞
＜value＞100＜/value＞
＜/parameter＞
＜!--
Maximum number of idle dB
connections to retain in pool.
Set to 0 for no limit.
--＞
＜parameter＞
＜name＞maxIdle＜/name＞
＜value＞30＜/value＞
＜/parameter＞
＜!--
Maximum time to wait for a dB
connection to become available
in ms, in this example 10 seconds.
An Exception is thrown if
this timeout is exceeded.
Set to -1 to wait indefinitely.
--＞
＜parameter＞
＜name＞maxWait＜/name＞
＜value＞10000＜/value＞
＜/parameter＞
＜!-- MySQL dB username and
password for dB connections --＞
＜parameter＞
＜name＞username＜/name＞
＜value＞sa＜/value＞
＜/parameter＞
＜parameter＞
＜name＞password＜/name＞
＜value＞topcomputer＜/value＞
＜/parameter＞
＜!-- Class name for mm.mysql
JDBC driver --＞
＜parameter＞
＜name＞driverClassName＜/name＞
＜value＞com.microsoft.jdbc.
sqlserver.SQLServerDriver＜/value＞
＜/parameter＞
＜!--
The JDBC connection url for
connecting to your MySQL dB.
The autoReconnect=true argument
to the url makes sure that the
mm.mysql JDBC Driver will automatically
reconnect if mysqld closed the
connection. mysqld by default closes
idle connections after 8 hours.
--＞
＜parameter＞
＜name＞url＜/name＞
＜value＞jdbc:microsoft:sqlserver:
//nt04:1433;DatabaseName=test＜/value＞
＜/parameter＞
＜/ResourceParams＞
＜/Context＞
4. 启动Tomcat，DBTest.war将会解压到Tomcat_HOME\webapps\DBTest,并且在Tomcat_HOME\work\Catalina\localhost目录中生成DBTest目录
为什么不能生成war文件？
在proterties for Web Module对话框中设置与Build有关的属性Build Web archive。
如何在Web应用中加入目录和文件？
右击Module directory，在弹出的菜单中选择New-directory，输入目录名称；或右击拟在其中建立文件的目录，在弹出的菜单中选择New-File，选择文件类型，输入文件名。注意这样加入的文件只能是指定的文件类型。这样加入的目录和文件都会打包到war文件中。
如何加入其它类型的文件？
可以将文件拷贝到指定的目录，在proterties for Web Module对话框中设置属性Content，选择include all classes and resources，这样也可以将加入的文件打包到war文件中。
如何使用指定的JDK？
选择菜单Tools-Configure-JDKs，在弹出的对话框中按New按钮，然后选择JDK的路径。
选择菜单Project-Project Properties，在弹出的对话框中选择加入的JDK。
如何使用指定的Tomcat？
选择菜单EntERPrise-Configure Servers,在弹出的对话框中选择Tomcat5.0后按Copy按钮，
选择Copy产生的服务器Copy of Tomcat 5.0，选择Home Directory
选择菜单Project-Project Properties，在弹出的对话框中设置属性server,选择加入的Tomcat服务器
