Tomcat配置指南

arongsoft

一、小猫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的文档比较有用，这里提供一些主要的东西吧。
  

元素名	属性	解释
server	port	指定一个端口，这个端口负责监听关闭tomcat的请求
	shutdown	指定向端口发送的命令字符串
service	name	指定service的名字
Connector(表示客户端和service之间的连接)	port	指定服务器端要创建的端口号，并在这个断口监听来自客户端的请求
	minProcessors	服务器启动时创建的处理请求的线程数
	maxProcessors	最大可以创建的处理请求的线程数
	enableLookups	如果为true，则可以通过调用request.getRemoteHost()进行DNS查询来得到远程客户端的实际主机名，若为false则不进行DNS查询，而是返回其ip地址
	redirectPort	指定服务器正在处理http请求时收到了一个SSL传输请求后重定向的端口号
	acceptCount	指定当所有可以使用的处理请求的线程数都被使用时，可以放到处理队列中的请求数，超过这个数的请求将不予处理
	connectionTimeout	指定超时的时间数(以毫秒为单位)
Engine(表示指定service中的请求处理机，接收和处理来自Connector的请求)	defaultHost	指定缺省的处理请求的主机名，它至少与其中的一个host元素的name属性值是一样的
Context(表示一个web应用程序，通常为WAR文件，关于WAR的具体信息见servlet规范)	docBase	应用程序的路径或者是WAR文件存放的路径
	path	表示此web应用程序的url的前缀，这样请求的url为http://localhost:8080/path/****
	reloadable	这个属性非常重要，如果为true，则tomcat会自动检测应用程序的/WEB-INF/lib 和/WEB-INF/classes目录的变化，自动装载新的应用程序，我们可以在不重起tomcat的情况下改变应用程序
host(表示一个虚拟主机)	name	指定主机名
	appBase	应用程序基本目录，即存放应用程序的目录
	unpackWARs	如果为true，则tomcat会自动将WAR文件解压，否则不解压，直接从WAR文件中运行应用程序
Logger(表示日志，调试和错误信息)	className	指定logger使用的类名，此类必须实现org.apache.catalina.Logger 接口
	prefix	指定log文件的前缀
	suffix	指定log文件的后缀
	timestamp	如果为true，则log文件名中要加入时间，如下例:localhost_log.2001-10-04.txt
Realm(表示存放用户名，密码及role的数据库)	className	指定Realm使用的类名，此类必须实现org.apache.catalina.Realm接口
Valve(功能与Logger差不多，其prefix和suffix属性解释和Logger 中的一样)	className	指定Valve使用的类名，如用org.apache.catalina.valves.AccessLogValve类可以记录应用程序的访问信息
	directory	指定log文件存放的位置
	pattern	有两个值，common方式记录远程主机名或ip地址，用户名，日期，第一行请求的字符串，HTTP响应代码，发送的字节数。combined方式比common方式记录的值更多

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文件
具体代码如下：

        
        
        
               
              factory
              org.apache.commons.dbcp.BasicDataSourceFactory
        
        
        
              maxActive
              50
      
        
        
              maxIdle
              20
        
        
        
              maxWait
              500
        
        
        
              username
              sa
      
      
        
              password
              sa
        
        
        
              driverClassName
              com.microsoft.jdbc.sqlserver.SQLServerDriver
        
      
        
              url
              jdbc:microsoft:sqlserver://10.0.254.11:1433;databaseName=yourdb
      
        
        
      
步骤三：程序调用
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个文件就可以轻松搞定。
前提条件，每个页面使用


地球人都知道的东西。
步骤1：添加过滤器
在TOMCAT中找到这2个文件RequestDumperFilter.java，SetCharacterEncodingFilter.java，他们位于D:/Tomcat5.0.27/webapps/jsp-examples/WEB-INF/classes/filters，加到你的工程文件里去，编译他们。
步骤2：配置WEB.XML
在web.xml里加入这一段
……

    Set Character Encoding
    filters.SetCharacterEncodingFilter
   
      encoding
      GBK
   
  
  
    Set Character Encoding
    /*
  
……
看到没有？这样你就不用写那些麻烦的转换代码了，当然这样还不足以解决问题。
步骤3：修改server.xml
在server.xml修改2个地方


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将以你页面定义的字符集解析页面。
在最后添加如下代码：

#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解析

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文件：

   

让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文件，其内容如下：

[shm]
file=D:/ /Apache2/logs/shm.file
size=1048576

#The socket channel
[channel.socket:localhost:8009]
port=8009
host=localhost

#define the worker
[ajp13:localhost:8009]
channel=channel.socket:localhost:8009

#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。
当然还有我们的虚拟目录：

    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


步骤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没有自己作过。具体方法，自己去找吧。