我与TOMCAT不得不说的二三事-JSP教程,J2EE/EJB/服务器

谨以此文送给所有正在使用tomcat或者打算使用的人们，向tomcat的所有开发人员致敬！

一、小猫tomcat其实很可爱

2003年底，我换公司了，同样也换了webapp，tomcat出现在我的面前（以前使用weblogic），我有点茫然，免费的东西真的能用的好么？担心ing……（其实是在火星呆太久）出门一打听，原来此猫出自名门－jakarta项目，2001年度最具创新的java产品(most innovative java product)，又有java的老大sun的力捧（官方推荐的servlet和jsp容器），以后就靠它吃饭了。不说二话，搞起来先：

1、  安装

tomcat最新版本是5.0.29（http://jakarta.apache.org/site/binindex.cgi）

如果在windows下它可以自动找到你的jdk或者set java_home=c:/jdk

在linux下需要先解压，然后设置java_home

export java_home=/usr/local/jdk

2、  run

设置完毕后就可以运行tomcat服务器了，进入tomcat的bin目录，windows下用startup启动tomcat，linux下用startup.sh，相应的关闭tomcat的命令为shutdown和shutdown.sh。

启动服务后在浏览器里输入http://localhost:8080/来测试一下

3、  目录结构

bin：存放启动和关闭tomcat脚本。

conf：包含不同的配置文件,server.xml(tomcat的主要配置文件)。

work：存放jsp编译后产生的class文件。

webapp：存放应用程序示例，以后你要部署的应用程序也要放到此目录。

logs：存放日志文件

comm./server/shared：这三个文件夹下的lib文件夹放jar文件。

1、  配置server.xml文件

没有什么好说的，看tomcat的文档比较有用，这里提供一些主要的东西吧。

2、  管理

tomcat管理能力很强大，进入http://localhost:8080/，自己慢慢管吧。实践出真知，我喜欢这样搞：

^_^，一切尽在掌握http://localhost:8080/manager/html 。

一、让数据库连接池转起来

作为一个j2ee程序员大家手上可能会有现成的jdbc 数据库连接池，其实这没有太大的必要，因为象weblogic……企业级webapp都有自己的连接池，大家不要费力直接使用吧，效率也很不错，再也不用羡慕.net的ado了（以前作ms从来不担心数据连接，ado确实用起来很爽），如果想实现一个 jdbc connection pool 的注意事项有：

1. 有一个简单的函数从连接池中得到一个 connection。

2. close 函数必须将 connection 放回 数据库连接池。

3. 当数据库连接池中没有空闲的 connection， 数据库连接池必须能够自动增加 connection 个数。

4. 当数据库连接池中的 connection 个数在某一个特别的时间变得很大，但是以后很长时间只用其中一小部分，应该可以自动将多余的 connection 关闭掉。

5. 如果可能，应该提供debug 信息报告没有关闭的 new connection 。

网上有各种各样的连接池代码，抄过来改改吧，嘿嘿～

这里介绍如何配置tomcat的连接池，以sqlserver为例：

步骤1：安装sqlserver的jdbc驱动

sqlserver的jdbc驱动其实就是三个jar文件，msbase.jar/mssqlserver.jar/msutil.jar，将这三个文件拷贝到你的/tomcat_home/common/lib目录下去就可以了。

步骤2：修改server.xml文件

具体代码如下：

<context path=”test” docbase=”f:\yourroot” debug=”5″ reloadable=”true” crosscontext=”true”>

       <logger classname=”org.apache.catalina.logger.filelogger” prefix=”localhost_dbtest_log.” suffix=”.txt” timestamp=”true”/>

       <resource name=”jdbc/sqlserverdb” auth=”container” type=”javax.sql.datasource”/>

       <resourceparams name=”jdbc/sqlserverdb”>

              <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>50</value>

       </parameter>

       <!– maximum number of idle db connections to retain in pool.        set to 0 for no limit.–>

       <parameter>

              <name>maxidle</name>

              <value>20</value>

       </parameter>

       <!– maximum time to wait for a db connection to become available        in ms, in this example 0.5 seconds. an exception is thrown if    this timeout is exceeded. set to -1 to wait indefinitely. –>

       <parameter>

              <name>maxwait</name>

              <value>500</value>

       </parameter>

       <!– mssql db username and password for db connections –>

       <parameter>

              <name>username</name>

              <value>sa</value>

       </parameter>

       <parameter>

              <name>password</name>

              <value>sa</value>

       </parameter>

       <!– class name for sqlserver2000 jdbc driver –>

       <parameter>

              <name>driverclassname</name>

              <value>com.microsoft.jdbc.sqlserver.sqlserverdriver</value>

       </parameter>

       <!– the jdbc connection url for connecting to your ms sql server db.the autoreconnect=true argument to the url makes sure that the mm.sql server 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://10.0.254.11:1433;databasename=yourdb</value>

       <!–must use &amp; not use  & –>

       </parameter>

       </resourceparams>

       </context>

步骤三：程序调用

package dbmanage;

import java.sql.callablestatement;

import java.sql.connection;

import java.sql.date;

import java.sql.preparedstatement;

import java.sql.resultset;

import java.sql.sqlexception;

import java.sql.statement;

import java.util.enumeration;

import java.util.hashtable;

import java.util.vector;

import javax.naming.context;

import javax.naming.initialcontext;

import javax.sql.datasource;

import util.smartdateformat;

public class dbmanager {

  /************************************

   * @param static private boolean verbose ;

   * @param statement thestatement;

   * @param preparedstatement thepstmt;

   * @param connection theconnection;

   ************************************/

  final static private boolean verbose = true; //打印控制台控制

  //static logger logger = logger.getlogger(dbmanager.class.getname());

  private context initctx = null;

  private context ctx = null;

  private datasource ds = null;

  private long timeout = 5000;

  private statement thestatement = null;

  private preparedstatement thepstmt = null;

  /************************************

   * 初试化initctx

   * 取得数据源对象

   ************************************/

  public

      dbmanager() {

    try {

      initctx = new initialcontext();

      //init context，read config web.xml

      if (initctx == null) {

        throw new exception(“initial failed!”);

      }

      ctx = (context) initctx.lookup(“java:comp/env”);

      //find “jdbc/sqlserverdb” object  this configruation in the server.xml of tomcat

      if (ctx != null) {

        ds = (datasource) ctx.lookup(“jdbc/sqlserverdb”);

      }

      if (ds == null) {

        throw new exception(“look up datasource failed!”);

      }

    }

    catch (exception e) {

      log(e, “can’t get the context!”);

    }

  }

  /************************************

   * get connection

   * @return connection

   ************************************/

  public synchronized

      connection getconnection() {

    //get connection and set to delay time

    long starttime = new java.util.date().gettime();

    connection con = null;

    while (con == null) {

      con = newconnection();

      if (con != null) {

        //log(“create new connection!”);

        break;

      }

      try {

        log(“连接超时，重新连接，等待” + timeout + “ms”);

        wait(timeout);

      }

      catch (interruptedexception e) {

        log(e, “连接超时!”);

      }

      if ( (new java.util.date().gettime() – starttime) >= timeout) {

        log(“connection timeout!”);

        break;

      }

    }

    return con;

  }

  private

      connection newconnection() {

    connection con = null;

    try {

      con = ds.getconnection();

      if (con == null) {

        throw new exception(“create connection failed!”);

      }

    }

    catch (exception e) {

      log(“create connection failed!”);

      system.out.println(e.getmessage());

    }

    return con;

  }

  /************************************

   * release the connection

   * @param conn connection

   * @param stmt statement

   * @param pstmt preparedstatement

   ************************************/

  public synchronized

      void freeconnection(connection conn,

                          statement stmt,

                          preparedstatement pstmt) {

    try {

      //close statement

      if (stmt != null) {

        stmt.close();

        stmt = null;

        //log(“close statement……”);

      }

      //close  preparedstatement

      if (pstmt != null) {

        pstmt.close();

        pstmt = null;

        //log(“close preparedstatement……”);

      }

    }

    catch (exception e) {

      system.out.println(e.getmessage());

    }

    try {

      //close connection

      if (conn != null) {

        conn.close();

        conn = null;

        //log(“close connection……”);

      }

    }

    catch (sqlexception e) {

      log(e, “释放资源出错!”);

    }

  }

  /************************************

   * write log file.

   * @param s string

   ************************************/

  private

      void log(string s) {

    if (verbose) {

      system.out.println(new java.util.date() + “:” + s);

      //logger.info(new java.util.date()+s);

    }

  }

  /************************************

   * write log file.

   * @param ex object

   ************************************/

  private

      void logerr(object ex) {

    if (verbose) {

      //system.out.println(new java.util.date()+”:”+s);

      //logger.error(ex);

    }

  }

  /************************************

   * write log file.

   * @param e throwable

   * @param msg string

   ************************************/

  private

      void log(throwable e, string msg) {

    system.out.println(new java.util.date() + “: ” + msg);

    //logger.info(new java.util.date() + “: ” + msg, e);

  }

……

}

ok，你现在可以方便的使用连接池了，想要一个得一个，记得要释放哦，连接池的数量总是有限的。

二、中文问题照样很简单

每个国家（或区域）都规定了计算机信息交换用的字符编码集，如美国的扩展 ascii码, 中国的 gb2312-80，日本的 jis 等，作为该国家/区域内信息处理的基础，有着统一编码的重要作用。字符编码集按长度分为 sbcs（单字节字符集），dbcs（双字节字符集）两大类。早期的软件（尤其是操作系统），为了解决本地字符信息的计算机处理，出现了各种本地化版本（l10n），为了区分，引进了 lang, codepage 等概念。但是由于各个本地字符集代码范围重叠，相互间信息交换困难；软件各个本地化版本独立维护成本较高。因此有必要将本地化工作中的共性抽取出来，作一致处理，将特别的本地化处理内容降低到最少。这也就是所谓的国际化（i18n）。各种语言信息被进一步规范为 locale 信息。处理的底层字符集变成了几乎包含了所有字形的 unicode。

现在大部分具有国际化特征的软件核心字符处理都是以 unicode 为基础的，在软件运行时根据当时的 locale/lang/codepage 设置确定相应的本地字符编码设置，并依此处理本地字符。在处理过程中需要实现 unicode 和本地字符集的相互转换，甚或以 unicode 为中间的两个不同本地字符集的相互转换。这种方式在网络环境下被进一步延伸，任何网络两端的字符信息也需要根据字符集的设置转换成可接受的内容。

java 语言内部是用 unicode 表示字符的，遵守 unicode v2.0。java 程序无论是从/往文件系统以字符流读/写文件，还是往 url 连接写 html 信息，或从 url 连接读取参数值，都会有字符编码的转换。这样做虽然增加了编程的复杂度，容易引起混淆，但却是符合国际化的思想的。从理论上来说，这些根据字符集设置而进行的字符转换不应该产生太多问题。而事实是由于应用程序的实际运行环境不同，unicode 和各个本地字符集的补充、完善，以及系统或应用程序实现的不规范，转码时出现的问题时时困扰着程序员和用户。

其实解决 java 程序中的汉字编码问题的方法往往很简单，但理解其背后的原因，定位问题，还需要了解现有的汉字编码和编码转换。相信这样的东西大家都见过了

new string(request.getparameter(“test”).getbytes(“iso-8859-1″),”gbk”)

但这样的代码相信不是一个解决的办法，这样会增加程序的复杂度，写数据库，提交表单，url中传中文参数，到处都是中文问题！作为一个连走路都要算计最短距离的懒人，当然不愿天天叨念着new string(request.getparameter(“test”).getbytes(“iso-8859-1″),”gbk”)，然汉战战兢兢的处理各种字符转换的问题，我跋山涉水，翻山越岭，终于找到了完美的解决方式，在tomcat中只需要简单的配置，引入2个文件就可以轻松搞定。

前提条件，每个页面使用

<%@ page contenttype=”text/html; charset=gbk” language=”java” import=”java.sql.*” errorpage=”” %>

<meta http-equiv=”content-type” content=”text/html; charset=gbk”>

地球人都知道的东西。

步骤1：添加过滤器

在tomcat中找到这2个文件requestdumperfilter.java，setcharacterencodingfilter.java，他们位于d:\tomcat5.0.27\webapps\jsp-examples\web-inf\classes\filters，加到你的工程文件里去，编译他们。

步骤2：配置web.xml

在web.xml里加入这一段

……

<filter>

    <filter-name>set character encoding</filter-name>

    <filter-class>filters.setcharacterencodingfilter</filter-class>

    <init-param>

      <param-name>encoding</param-name>

      <param-value>gbk</param-value>

    </init-param>

  </filter>

  <filter-mapping>

    <filter-name>set character encoding</filter-name>

    <url-pattern>/*</url-pattern>

  </filter-mapping>

……

看到没有？这样你就不用写那些麻烦的转换代码了，当然这样还不足以解决问题。

步骤3：修改server.xml

在server.xml修改2个地方

<connector port=”8080″

               maxthreads=”150″ minsparethreads=”25″ maxsparethreads=”75″

               enablelookups=”false” redirectport=”8443″ acceptcount=”100″

               debug=”0″ connectiontimeout=”20000″

               disableuploadtimeout=”true” uriencoding=’gbk’/>

<connector classname=”org.apache.coyote.tomcat5.coyoteconnector”

               port=”8009″ minprocessors=”5″ maxprocessors=”75″

               enablelookups=”true” redirectport=”8443″

               acceptcount=”10″ debug=”0″ connectiontimeout=”0″

               useurivalidationhack=”false” protocol=”ajp/1.3″

               protocolhandlerclassname=”org.apache.jk.server.jkcoyotehandler”

               uriencoding=’gbk’/>

ok，搞定！

三、apache和tomcat他们俩关系非同一般

apache和tomcat都是很优秀的软件，更可贵的是它们是免费的。其实他们2个都是jakarta项目的重要组成部分。按辈分来讲，tomcat是apache的儿子，apache的专长是解析静态文件，cgi,php……图片……，儿子当然不能抢了老爹的饭碗，所以tomcat只有在j2ee这个上面发愤图强，其实tomcat并非不能干他老爹的活，只是稳定性差点而已（偶没有明显的感觉，可能是商业炒作吧），现在大家明白为什么把他们2个扯一起了吧，上阵还靠父子兵呢～

把2个家伙整一起有大致有2种方法，一种是利用mod_jk2.so，一种是利用mod_jk_1.2.5_2.0.47.dll。这2个东东叫联接器（tomcat就是通过这家伙与apache勾搭上的）

1、  利用mod_jk_1.2.5_2.0.47.dll在windows下整合

步骤1：准备材料

apache2.0.52

http://apache.te8.com/dist/httpd/binaries/win32/apache_2.0.52-win32-x86-no_ssl.msi

tomcat5.0.27

http://apache.linuxforum.net/dist/jakarta/tomcat-5/v5.0.19/bin/jakarta-tomcat-5.0.27.exe

jdk（这个不用说了吧^_^）

mod_jk_1.2.5_2.0.47.dll（关键是这个东东啊，找了我n久），据说在下面连接可以下到，最后在我同事那找到的。

http://apache.linuxforum.net/dist/jakarta/tomcat-connectors/jk/binaries/win32/mod_jk_1.2.5_2.0.47.dll

安装apache\ tomcat\jdk。

步骤2：安装后设置环境变量

设置我的电脑\属性\高级\环境变量\新建系统变量　变量名：java_home 变量值：c:\jbuilderx\jdk1.4 (指向jdk的实际安装路径)；tomcat_hmom 变量值：tomcat5.0.27；lasspath 编辑变量值中加上　……;%java_home%\bin;%java_home%\lib;%tomcat_home%\bin;.;

测试一下，访问http://localhost和http://localhost:8080，默认安装是不会有什么错误的^_^

把连接器mod_jk_1.2.5_2.0.47.dll　copy到d:\apache2\modules\下。

步骤3：apache配置

在d:\apache2\conf下找到httpd.conf，找到directoryindex，在index.html后添加index.jsp；查找“listen”用于本机测试时：listen 127.0.0.1:80，我的是这样设置的listen *:80

查找adddefaultcharset设置为adddefaultcharset off，这样apache将以你页面定义的字符集解析页面。

在最后添加如下代码：

<virtualhost *:80> #localhost为本机，你可用本机ip

    serveradmin darkxie@hotmail.com #你的mail地址

    documentroot f:/uutang/uutang #你的项目组根目录

    servername dark #你的服务名，若你的机器有域名，设为域名

    errorlog logs/errorlog.txt #错误日志

    customlog logs/customlog.txt common #访问日志

    jkmount /servlet/* ajp13 #让apache支持对servlet传送，用以tomcat解析

    jkmount /*.jsp ajp13 #让apache支持对jsp传送，用以tomcat解析

    jkmount /*.do ajp13 #让apache支持对struts的action传送，用以tomcat解析

</virtualhost>

loadmodule jk_module modules/mod_jk_1.2.5_2.0.47.dll

jkworkersfile “d:/tomcat5.0.27/conf/workers.properties”

jklogfile “d:/tomcat5.0.27/logs/mod_jk2.log”

jkloglevel info

步骤4：tomcat配置

在d:\tomcat5\conf下新建一个workers.properties文件 .内容如下: 

workers.tomcat_home=d:\tomcat5 #让mod_jk模块知道tomcat

workers.java_home=d:\jdk1.3  #让mod_jk模块知道j2sdk

ps=\

worker.list=ajp13 #模块版本,现有ajp13了,不要修改

worker.ajp13.port=8009 #工作端口,若没占用则不用修改

worker.ajp13.host=localhost #主机,若上面的apache主机不为localhost,作相应修改

worker.ajp13.type=ajp13 #类型

worker.ajp13.lbfactor=1 #代理数,不用修改

修改tomcat的server.xml文件：

<!– define a coyote/jk2 ajp 1.3 connector on port 8009 –>

    <connector classname=”org.apache.coyote.tomcat5.coyoteconnector”

               port=”8009″ minprocessors=”5″ maxprocessors=”75″

               enablelookups=”true” redirectport=”8443″

               acceptcount=”10″ debug=”0″ connectiontimeout=”0″

               useurivalidationhack=”false” protocol=”ajp/1.3″

               protocolhandlerclassname=”org.apache.jk.server.jkcoyotehandler”

               uriencoding=’gbk’/>

让tomcat知道ajp13协议，apache和tomcat俩父子间靠这个协议沟通。

测试一下，访问http://localhost和http://localhost:8080，看到相同的页面没有？细心点，其实很简单，看看e文的帮助，搞定不成问题。

2、  利用mod_jk2.so（也叫jk2）整合

jk2是一个jakarta-tomcat-connectors-jk2.0.4-win32-apache2.0.49.zip文件，主要用的是其中的mod_jk2.so。其实利用mod_jk2.so整合和利用mod_jk_1.2.5_2.0.47.dll整合大同小异，只是换了个联接器而已，现在一步一步整起来～

步骤1：没有多说的，安装好tomcat和apache

下载jakarta-tomcat-connectors-jk2.0.4-win32-apache2.0.49.zip，解压，将mod_jk2放到apache的安装文件夹下的modules文件夹中。

步骤2：apache配置

在/conf中加入一个work.properties文件，其内容如下：

<!–这个文件的作用不是很清楚，总之路径设置正确就行了。我的apache装在d:/apache2，根据情况自己修改。–>

[shm]

file=d:/ /apache2/logs/shm.file

size=1048576

<!–这个socket channel是必须的，port和host对应于tomcat端的设置。–>

#the socket channel

[channel.socket:localhost:8009]

port=8009

host=localhost

<!–worker，必须的。–>

#define the worker

[ajp13:localhost:8009]

channel=channel.socket:localhost:8009

<!–url mapping，我的主要是.jsp和struts的.do，servlet的话设置成[uri:/xxx/*]之类的。–>

#uri mapping

[uri:/*] #和第一种方式一样吧^_^

[uri:/*.jsp]

[uri:/*.do]

worker=ajp13:localhost:8009

在httpd.conf中，在loadmodule那里加入这句：

loadmodule jk2_module modules/mod_jk2.so

在最后加入这句：

jkset config.file “conf/work.properties”

这是告诉apache去哪里找jk的配置的，根据具体情况修改。

还要修改一下directoryindex，directoryindex index.html index.html.var index.jsp查找“listen”用于本机测试时：listen 127.0.0.1:80，我的是这样设置的listen *:80。

当然还有我们的虚拟目录：

<virtualhost *:80>

    serveradmin darkxie@hotmail.com

    documentroot f:/uutang/uutang

    servername dark

    errorlog logs/errorlog.txt

    customlog logs/customlog.txt common

    #jkmount /servlet/* ajp13

    #jkmount /*.jsp ajp13

    #jkmount /*.do ajp13

</virtualhost>

步骤3：tomcat配置

tomcat的端口设置为8080。

在/conf文件夹加入jk2.properties文件，其内容如下：

# set the desired handler list

handler.list=apr,request,channelsocket

#

# override the default port for the socketchannel

channelsocket.port=8009

tomcat自己已经生成了这个文件，找到相关的地方把注视去掉改一下就成。

注意：用这种方式整合最好是自己编译mod_jk2.so文件，特别是在unix/linux下,我没有环境，制作mod_webapp.so没有自己作过。具体方法，自己去找吧。