2 修改 Hibernate 配置文件

  <? xml version = '1.0' encoding = 'UTF-8' ?>

<! DOCTYPE hibernate-configuration PUBLIC

          "-//Hibernate/Hibernate Configuration DTD 3.0//EN"         "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd" >

<!-- Generated by MyEclipse Hibernate Tools.                   -->

< hibernate-configuration >

< session-factory >

    <property name="connection.useUnicode">true</property>

    <property name="connection.characterEncoding">gb2312</property>

   <!— 只配这一句就可以了的 用户名密码等等其他参数全部不用配了的 -- >

    <property name="connection.datasource">java:comp/env/jdbc/mysql</property>

    < property name = "dialect" >

       org.hibernate.dialect.MySQLDialect

    </ property >

    < mapping resource = "com/test/Hibernate/orm/User.hbm.xml" />

</ session-factory >

</ hibernate-configuration >

3 测试用例

原文地址 http://www.jboss.org/company/corevalues

1. "Professional Open Source™" 专业开源

• We passionately believe in this collection of words, our invention, and the market category it defines. We are committed to making Open Source safe for enterprises.
• 我们满怀热情的相信这个程序的集合体 , 我们的创造和它所定义的市场范畴 . 我们致力于开源企业级的安全性应用 .
• We were born out of the Open Source movement and believe professional open source is the way for OSS to achieve its full potential.
• 我们出生于开源运动并相信专业开源是 OSS 达到它潜力及至的方法 .
• We believe in Free Software as a safe choice for developers, partners and end users alike. We use other licenses as needed.
• 我们相信免费软件对于开发人员 , 合作者和最终用户来说是一个安全的选择 . 我们使用其他需要的认证机制 .
• We believe in for-profit open source as a way to fairly compensate talented individuals.
• 我们相信有偿开源是一种对个人智力劳动付出的公平的补偿方式
• Our survival depends on delivering superior service to customers. We prove that Open Source and Professionalism do rhyme.
• 我们的生存依赖于为用户提供高级的服务 . 我们证明开源和专家主义可以和谐发展 .

2. Group trust and personal integrity 团队的信任和个人的价值完整

• We operate internally on the basis of mutual trust. Nobody in the company will knowingly deceive another member.
• 我们内部的运作基于相互的信任 . 在公司里没有人可以故意欺骗其他成员 .
• We are honest.
• 我们都是正直的人 .
• We tell the truth among ourselves, to our clients, to our partners, to our investors, to our prospects.
• 我们对我们的客户 , 合作伙伴 , 投资者 , 前景在我们自身之间坦诚相告 .
• We are committed to profitability and sound finances. We are thrifty.
• 我们致力于收益率和可靠的财务状况 . 我们勤俭节约 .
• We place the needs of the federation of projects above individual ones.
• 我们将项目中联盟的需要放在个人需要之上 .

3. Excellence and Ambition 优点和雄心

• We innovate at all cost in technology and business. We reward, empower and promote talent.
• 我们在所有的技术和商业领域创新发展 . 我们给予人才回报 , 权利和发展 .
• We operate as a meritocracy. For developers street credentials must be earned. In business common sense must be proved.
• 我们以实力主义来运作 . 开发人员必须有街道的证明 . 必须具备商业常识 .
• We don't underestimate our competition, we remain paranoid.
• 我们不低估我们的竞争对手 , 我们保持偏执 .
• Technology first. We base decisions first on technology, then business, then competition.
• 技术第一 . 我们决定的基础第一是技术 , 再次是商业 , 最后是竞争 .
• Our long term ambition is to make JBoss the defacto middleware platform for the industry.
• 我们长期的雄心是使得 JBoss 成为业界的既成事实上的中间件平台 .

在为 JBoss 配置 Hibernate 的时候发现的问题和心得 , 拿出来共享一下 .

1.       使用微软的 SQLSERVER2000 驱动 , 为三个文件 mssqlserver.jar ,msutil.jar 和 mbase.jar,copy 至 server\default\lib 下 .

2.       设置 mssql-ds.xml, 具体设置方法参见 jboss 说明文档 . 我们可以在 \docs\examples\jca 下找到默认的各种对应数据库配置文件模板 . mssql-ds.xml 为 :

<?xml version="1.0" encoding="UTF-8"?>

<datasources>

  <local-tx-datasource>

    <jndi-name>MSSQLDS</jndi-name>  <connection-url>jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=MyDatabase</connection-url>

    <driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver</driver-class>

    <user-name>x</user-name>

    <password>y</password>

      <!-- corresponding type-mapping in the standardjbosscmp-jdbc.xml (optional) -->

      <metadata>

         <type-mapping>MS SQLSERVER2000</type-mapping>

      </metadata>

  </local-tx-datasource>

</datasources>

修改对应的属性 , 一般修改 jndi-name ,onnection-url, user-name, password.

将修改好的 mssql-ds.xml 拷贝到 server\default\deploy 目录下并删除默认的 hsqldb-ds.xml

3.       设置 server\default\conf 目录下 standardjws.xml 和 standardjbosscmp-jdbc.xml 中 Jndi name 和 type-mapping :

standardjbosscmp-jdbc.xml 中 :

修改 <datasource>java:/MSSQLDS</datasource>

加入 <datasource-mapping>MS SQLSERVER2000</datasource-mapping>

standardjws.xml 中

修改 <datasource>java:/MSSQLDS</datasource>

            <type-mapping>MS SQLSERVER2000</type-mapping>

4.       配置 JMS:

这里 JBoss3.x 和 4.x 有些区别

在 3.x 中拷贝 mssql-jdbc2.xml 到 defult/deploy/jms/ 文件夹下 , 并删除默认的 hsqldb-jdbc2.xml

在 4.x 中拷贝 mssql-jdbc2-service.xml 到 defult\deploy-hasingleton\jms 文件夹下并删除默认的 hsqldb-jdbc2-service.xml.

mssql-jdbc2.xml 和 mssql-jdbc2-service.xml 均能在 docs\examples\jms 中找到模板

       如果没有这个设置 , 就会报关于 JMS_MESSAGES 的异常 :

org. jboss .mq.SpyJMSException: Could not resolve uncommited transactions. Message recovery may not be accurate; - nested throwable: (java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC][SQLServer]SELECT permission denied on object 'JMS_MESSAGES', database 'test'.)

1．  Copy 数据库的 JDBC 驱动至部署文件夹中的 lib 目录下

2．  建立所需要连接的物理数据库表。

3．  建立数据库配置文件，配置数据库参数，文件以 -ds.xml 为结尾，如 mysql-ds.xml 。配置文件具体方法参照 docs/example/jca 下，有各种数据库的例程。在这里只介绍几个常用的配置。修改好的配置文件放在 web 应用部署目录下，如 web 应用为 all ，则放在 $JBOSS4_HOME\server\all\deploy 下。

4．  修变 jboss 的 CMP 配置文件 jbosscmp-jdbc.xml 参数。一般修改

<datasource>java:/DefaultDS</datasource>

<datasource-mapping>mysql</datasource-mapping>

这两个参数，将 DefaultDS 换为你在 -ds.xml 文件中的 <jndi-name> 的值，将

datasource-mapping 改为 -ds.xml 文件中 <type-mapping> 的值。

5．  启动 jboss ，测试数据库连接

一． MYSQL

在 jboss4 文档中默认的例程就是 myssql 的例子。（见第八章 54 页）

1．  Mysql 的 JDBC 驱动 connector/j 可以在 http://www.mysql.com 下载得到 .

现在最新的 mysql 是 4.1, connector/j 是 3.2 。分别对应以下地址

http://dev.mysql.com/downloads/mysql/4.1.html

http://dev.mysql.com/downloads/connector/j/3.2.html

下载的时候感觉韩国的几个站点速度是最快的

（ btw ：台湾站点居然有青天白日旗，一定要跟 jboss 抗议一下）

2．  在 mysql 客户端中建立一个数据库叫做 test

mysql> CREATE DATABASE test;

3．  建立一个 Mysql-ds.xml 文件

<datasources>

<local-tx-datasource>

<jndi-name>DefaultDS</jndi-name>

<connection-url>jdbc:mysql://localhost:3306/test</connection-url>

<driver-class>com.mysql.jdbc.Driver</driver-class>

<user-name>username</user-name>

<password>password</password>

<metadata>

         <type-mapping>mysql</type-mapping>

 </metadata>

</local-tx-datasource>

</datasources>

也可以将 docs/example/jca 下的 Mysql-ds.xml 拷贝过来修改。保存在 deploy 下。并删除 jboss 默认的 hsqldb-ds.xml 。

4．  打开 jbosscmp-jdbc.xml ，将

<datasource>java:/DefaultDS</datasource>

       <!-- optional since 4.0 <datasource-mapping>Hypersonic SQL</datasource-mapping> -->

修改为

<datasource>java:/DefaultDS</datasource>

     <datasource-mapping> mysql </datasource-mapping>

5．  启动 jboss 。如果自己的 web 应用为 all ，则使用 run –c all

二． ORACLE

Oracle 的数据库驱动可以在 Oracle 的安装目录下找到， oracle\ora92\jdbc\lib 下 ojdbc14.jar 或 ojdbc14_g.jar 。

建立 oracle-ds.xml ，注意 Oracle 的 URL 为

<connection-url>jdbc:oracle:thin:@youroraclehost:1521:yoursid</connection-url>

三． SQLSERVER2000

     SQLSERVER2000 的数据库驱动可以在 microsoft 网站找到，包括三个文件

msbase.jar,mssqlserver.jar 和 msutil.jar ，建立 mssql-ds.xml ， SQLSERVER2000 的 URL 为

<connection-url>jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=MyDatabase</connection-url>

     <driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver</driver-class>

如果使用 Weblogic 的 SQLSERVER2000 驱动，则是在 bea\weblogic81\server\lib 下的

mssqlserver4v65.jar ， class 为 weblogic.jdbc.mssqlserver4.Driver

Tomcat全攻略
一：简介
tomcat是jakarta项目中的一个重要的子项目，其被JavaWorld杂志的编辑选为2001年度最具创新的java产品(Most Innovative Java Product)，同时它又是sun公司官方推荐的servlet和jsp容器(具体可以见http://java.sun.com/products/jsp/tomcat/)，因此其越来越多的受到软件公司和开发人员的喜爱。servlet和jsp的最新规范都可以在tomcat的新版本中得到实现。

二：安装及配置
tomcat最新版本为4.0.1，这个版本用了一个新的servlet容器Catalina，完整的实现了servlet2.3和jsp1.2规范。注意安装之前你的系统必须安装了jdk1.2以上版本。

(一)：安装
1：windows平台
从tomcat网站下载jakarta-tomcat-4.0.1.exe，按照一般的windows程序安装步骤即可安装好tomcat,安装时它会自动寻找你的jdk和jre的位置。

2：linux平台
下载jakarta-tomcat-4.0.1.tar.gz，将其解压到一个目录。

(二)：配置
运行tomcat需要设置JAVA_HOME变量
set JAVA_HOME=c:/jdk (win98，在msdos方式下使用，或者放入autoexec.bat中)
export JAVA_HOME=/usr/local/jdk (linux下使用，放到/etc/bashrc或者/etc/profile中)

(三)：运行
设置完毕后就可以运行tomcat服务器了，进入tomcat的bin目录，win98下用startup启动tomcat，linux下用startup.sh，相应的关闭tomcat的命令为shutdown和shutdown.sh。
启动后可以在浏览器中输入http://localhost:8080/测试，由于tomcat本身具有web服务器的功能，因此我们不必安装apache，当然其也可以与apache集成到一起，下面会介绍。
下面你可以测试其自带的jsp和servlet示例。

三：应用

(一):目录结构
tomcat的目录结构如下：
目录名: 简介
bin : 存放启动和关闭tomcat脚本
conf : 包含不同的配置文件,server.xml(Tomcat的主要配置文件)和web.xml
work : 存放jsp编译后产生的class文件
webapp: 存放应用程序示例，以后你要部署的应用程序也要放到此目录
logs : 存放日志文件
lib/japser/common : 这三个目录主要存放tomcat所需的jar文件

(二)：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方式记录的值更多

注意：
1：经过我测试，我设置Context 的path="",reloadable=true，然后放一个WAR文件到webapps目录，结果tomcat不能检测出此文件(重起tomcat可以)，而把此文件解压，则tomcat会自动检测出这个新的应用程序。如果不能自动检测WAR文件，我们可以利用下面管理中讲的方法来部署应用程序。

2：默认的server.xml中，Realm元素只设置了一个className属性，但此文件中也包含几个通过JDBC连接到数据库进行验证的示例(被注释掉了)，通过Realm元素我们可以实现容器安全管理(Container Managed Security)。

3：还有一些元素我们没有介绍，如Parameter，loader，你可以通过tomcat的文档获取这些元素的信息。

(三)：管理

1：配置
在进行具体的管理之前，我们先给tomcat添加一个用户，使这个用户有权限来进行管理。
打开conf目录下的tomcat-users.xml文件，在相应的位置添加下面一行：

注意：这一行的最后部分一定是/>,tomcat的文档掉了/符号，如果没有/符号的话，tomcat重起时将无法访问应用程序。通过logs/catalina.out文件你可以看到这个错误的详细信息。

然后重起tomcat，在浏览器中输入http://localhost:8080/manager/，会弹出对话框，输入上面的用户名和密码即可。

2：应用程序列表
在浏览器中输入http://localhost:8080/manager/list，浏览器将会显示如下的信息：

OK - Listed applications for virtual host localhost
/ex:running:1
/examples:running:1
/webdav:running:0
/tomcat-docs:running:0
/manager:running:0
/:running:0

上面的信息分别为应用程序的路径，当前状态(running 或者stopped)，与这个程序相连的session数。

3：重新装载应用程序
在浏览器中输入 http://localhost:8080/manager/reload?path=/examples，浏览器显示如下：

OK - Reloaded application at context path /examples

表示example应用程序装载成功，如果我们将server.xml的Context元素的reloadable属性设为true(见上面表格)，则没必要利用这种方式重新装载应用程序，因为tomcat会自动装载。

4：显示session信息
在浏览器中输入http://localhost:8080/manager/sessions?path=/examples，浏览器显示如下：

OK - Session information for application at context path /examples Default maximum session inactive interval 30 minutes

5：启动和关闭应用程序
在浏览器中输入http://localhost:8080/manager/start?path=/examples和http://localhost:8080/manager/stop?path=/examples分别启动和关闭examples应用程序。

6：部署及撤销部署
WAR有两种组织方式，一种是按一定的目录结构组织文件，一种是一个后缀为WAR的压缩包，因此它的部署方式也有两种：
(1)：在浏览器中输入：http://localhost:8080/manager/install?path=/examples&war=file:/c:examples
就会将按目录结构组织的WAR部署

(2)：如果输入:http://localhost:8080/manager/install?path=/examples&war=jar:file:/c:examples.war!/
就会将按压缩包组织的WAR部署，注意此url后半部分一定要有!/号。
部署后就可以用 http://localhost:8080/examples访问了。

在浏览器中输入：http://localhost:8080/manager/remove?path=/examples 就会撤销刚才部署的应用程序。

(四)：与apache集成
虽然tomcat也可以作web服务器,但其处理静态html的速度比不上apache,且其作为web服务器的功能远不如apache,因此我们想把apache和tomcat集成起来。
我们以linux系统为例介绍.
从apache网站下载apache1.3.22源代码版本，然后使用如下命令配置安装apache：

mkdir /usr/local/apache
tar zxvf apache.1.32.tar.gz
cd apache.1.32
./configure --prefix=/usr/local/apache --enable-module=so
make
make install

注意configure命令指定目标安装目录，并且加入DSO(Dynamic Shared Object)支持，注意一定不要忘了这一个选项。

然后下载webapp模块，将解压后mod_webapp.so文件放入apache的libexec目录，编辑apache的conf目录下的httpd.conf，在这个文件的最后加入下面三行：

LoadModule webapp_module libexec/mod_webapp.so
WebAppConnection warpConnection warp localhost:8008
WebAppDeploy examples warpConnection /examples/

第一行是加入webapp模块，如果编译apache时不增加DSO支持，则无法使用LoadModule指令，第二行指定tomcat与apache的连接，第三行指定部署那个应用，这两个指令使用格式如下：

WebAppConnection [connection name] [provider] [host:port]
WebAppDeploy [application name] [connection name] [url path]

其中connection name指定连接名，provider只能是warp，port端口与你的tomcat的配置文件server.xml最后几行指定的要保持一致。文件如下：

port="8008" minProcessors="5" maxProcessors="75"
enableLookups="true"
acceptCount="10" debug="0"/>
******

application name与你在tomcat中部署的应用名一致，url path指定访问这个应用的url。例如上面的例子可以通过http://localhost/examples/来访问tomcat中的examples应用。

(五)：中文问题
一般jsp的乱码问题可以通过在jsp中加入来解决，至于servlet的乱码在可以使用servlet2.3中提供的HttpServeletRequest.setCharacterEncoding函数。更详细的中文问题请见JSP/Servlet 中的汉字编码问题。

四：综述
tomcat作为一个servlet(jsp也被编译为servlet执行)容器，其应用前景是非常好的，如果与jboss结合起来，则可以实现sun的j2ee规范(用jboss作ejb服务器)。jboss的官方网站也提供集成了tomcat3.2*的jboss以供下载。另外一个开源的应用服务器(enhydra) 也是基于tomcat的，其提供了更友好的管理界面，部署应用程序也更简单，功能也更强大。

Tomcat中文手册

本文档提供关于Tomcat的基础信息.主要内容如下:
Tomcat二进制版本安装
与Tomcat相关的脚本的主要内容
与server.xml相关的主要内容,Tomcat的主要配置文件
如何设置Tomcat与宿主web服务器一起工作的说明
如何应用Tomcat配置一个现实中的web站点
希望此文档足以使新用户可以开始使用Tomcat.如找不到某方面的内容请(按以下顺序)
查找Tomcat faq
查找Tomcat包清单
向Tomcat用户邮件列表发出问题
如此疑问的答案不存在,我们鼓励把对疑问的解答放入Tomcat faq或此文档.如对此文档有意见或建议,请发送到Tomcat的邮件列表.

Getting Started
Tomcat是一个带有jsp环境的servlet容器.servlet容器是一个根据用户的行为可以管理和激活servlet的运行时的shell.
粗略地可以将servlet容器分为如下几类:

独立的servlet容器
内置有web服务器的一部分.指当使用基于Java的web服务器的情形,例如servlet容器是JavaWebServer的一个部分. 独立的servlet容器是Tomcat的默认模式.
大多数的web服务器并非基于Java,因此,我们可以得出如下两种容器的模式.

进程内的servlet容器
servlet容器作为web服务器的插件和Java容器的实现.Web服务器插件在内部地址空间打开一个JVM(java virtual machine)使Java容器得以在内部运行.如有某个需要调用servlet的请求,,插件将取得对此请求的控制并将他传递(使用JNI)给Java容器.进程内容器对于多线程,单进程的服务器非常合适并且提供很好的运行速度,但伸缩性有所不足.

进程外的servlet容器
servlet容器运行于web服务器之外的地址空间且作为web服务器的插件和Java容器的实现的结合.web服务器插件和Java容器 JVM使用IPC机制(通常是TCP/IP)进行通讯.当一个调用servlet的请求到达时,插件将取得对此请求的控制并将其传递(使用IPC等)给Java容器,进程外容器的反应时间或进程外容器引擎不如进程内容器,但进程外容器引擎在许多其他可比的范围内更好(伸缩性,稳定性等).
Tomcat既可作为独立的容器(主要是用于开发与调试)又可作为对现有服务器的附加(当前支持Apache,IIS和Netscape服务器).即任何时候配置Tomcat你都必须决定如何应用他,如选择第二或第三种模式,你还需要安装一个web服务器接口.
Tomcat与Jserv有何区别?Tomcat是Jserv吗?
这是个常见的误解.Jserv是Servlet API2.0兼容并与Apache一起使用的容器.Tomcat是一个完全重写的并与Servlet API2.2和JSP1.1兼容的容器.
Tomcat使用了一些为Jserv而写的代码,特别是Jserv的Apache接口,但这是唯一的相同之处.
怎样安装Tomcat的二进制版本?
非常简单,只需:
下载 zip/tar.gz 任何压缩文件,从http://jakarta.apche.org/download/binindex.html处.
解压缩此文件到某目录(如:foo).将会生成一子目录,名为”tomcat”.
转换到”tomcat”目录设置一新的环境变量(TOMCAT_HOME)指向你安装的tomcat的目录
WIN32平台,键入:
“set TOMCAT_HOME=foo\tomcat”
Unix平台:
如是bash/sh环境, 键入:”TOMCAT_HOME=foo/tomcat;export TOMCAT_HOME”
如是tcsh环境, 键入:”setenv TOMCAT_HOME foo/tomcat”
设置环境变量JAVA_HOME指向你JDK的目录,然后添加JAVA解释器到你的PATH环境变量.
好了!现在可以运行TOMCAT并作为一个独立的Servlet容器(模式一)
启动与关闭Tomcat
使用”bin”目录中的脚本启动与关闭Tomcat.
启动:
uinx:bin/startup.sh
win32:bin\startup
关闭:
unix:bin/shutdown.sh
win32:bin\shutdown
Tomcat目录结构
假设你已将Tomcat解压,你已得到下列目录结构:
目录名--描述
bin
包含启动/关闭脚本
conf
包含不同的配置文件,
包括 server.xml(Tomcat的主要配置文件)和为不同的Tomcat配置的web应用设置缺省值的文件web.xml
doc
包含各种Tomcat文档
lib
包含Tomcat使用的jar文件.unix平台此目录下的任何文件都被加到Tomcat的classpath中
logs
Tomcat摆放日志文件的地方
src
ServletAPI源文件.先别高兴,这些只有些必须在Servlet容器内实现的空接口和抽象类
webapps
包含web项目示例
此外你可以Tomcat会创建如下目录:
work
Tomcat自动生成,放置Tomcat运行时的临时文件(如编译后的JSP文件).如在Tomcat运行时删除此目录.JSP页面将不能运行.
classes
你可以创建此目录来添加一些附加的类到类路径中.任何你加到此目录中的类都可在Tomcat的类路径中找到自身.
Tomcat的脚本
Tomcat是一个Java程序,因此在设置好几个环境变量后即可用命令行的方式运行.然而设置Tomcat使用的每个环境变量和如下的命令行参数乏味且易错.因此,Tomcat开发组提供了一些脚本使启动和关闭Tomcat变得轻松.
注意:这些脚本仅仅是个便利的方法去启动和关闭Tomcat.你可修改他们来定制CLASSPATH,环境变量如PATH,LD_LIBRARY_PATH,等等,只要是生成一个正确的命令行即可.
这些脚本是什么呢?下表列出对一般用户最重要的脚本.
tomcat
主脚本.设置合适的环境变量,包括CLASSPATH,TOMCAT_HOME和JAVA_HOME和用适合的命令行参数启动Tomcat

startup

在后台启动Tomcat.”tomcat start”命令的替换方式

shutdown

关闭Tomcat.”tomcat stop”命令的替换方式

对用户最重要的脚本是tomcat(tomcat.bat/tomcat.sh).其他Tomcat相关的脚本作为一个简单的面向单任务的指向Tomcat脚本(设置不同的命令行参数等)的入口.

仔细考察tomcat.bat/tomcat.sh,它按以下步骤运行:

在Unix下的步骤：

如未指定,推测 TOMCAT_HOME

如未指定,推测 JAVA_HOME

设置CLASS_PATH包含:

1.${TOMCAT_HOME}/classes目录(如果存在)

2.${TOMCAT_HOME}/lib的一切内容

3.${JAVA_HOME}/lib/tools.jar(此jar文件包含工具javac,我们需要javac处理jsp文件.

运行带有设定Java环境变量的命令行参数的java命令,调入tomcat.home,和org.apache.tomcat.startup.Tomcat 作为启始类.同时也传递命令行参数到org.apache.tomcat.startup.Tomcat ,例如:

执行start/stop/run 等的操作

此Tomcat进程使用指向server.xml的路径,

例如server.xml放置于etc/server_1.xml并且用户意图在后台启动apache,键 入如下命令行:

bin/tomcat.sh start –f /etc/server_1.xml

在Win32下的步骤：(略)

由此可见,win32版的tomcat.bat与Unix版的几乎一致.尤其在它不推测TOMCAT_HOME和JAVA_HOME的值,并且不将所有的jar文件放入类路径中.

Tomcat的配置文件

Tomcat的配置基于两个配置文件:

1.server.xml - Tomcat的全局配置文件

2.web.xml - 在Tomcat中配置不同的关系环境

这一部分将讲述如何使用这些文件.我们不会包含web.xml的内部机制,这些内部机制深入到了Servlet API的细节,因此,我们将讨论涵盖servler.xml内容及web.xml在Tomcat关系环境中的用法.

server.xml

server.xml是Tomcat的主配置文件.完成两个目标:

1 提供Tomcat组件的初始配置.

2 说明Tomcat的结构,含义,使得Tomcat通过实例化组件完成起动及构建自身, 如在server.xml所指定的

下表描述server.xml种的重要元素:

Jakarta-Tomcat 简明中文版用户指南第二部分
　

元素及其描述

Server
server.xml文件中最重要的元素.Server定义了一个Tomcat服务器.一般你不用对他担心太多.Server元素能包含Logger和ContextManager元素类型

Logger
此元素定义一个Logger对象,每个Logger都有一个名字去标识,也有一个纪录Logger的输出和冗余级别(描述此日志级别)和包含日志文件的路径.通常有servlet的Logger(ServletContext.log()处),JSP和Tomcat运行时的Logger.

ContextManager
ContextManager说明一套ContextInterceptor, RequestInterceptor , Context和他们的Connectors的配置及结构.ContextManager有几个随同提供的特性:
1. 用来纪录调试信息的调试级别
2. webapps/,conf/,logs/和所有已定义的环境的基本位置.用来使Tomcat可以在TOMCAT_HOME外的其他目录启动.
3. 工作目录的名字

ContextInterceptor&RequestInterceptor
这些侦听器(interceptors)侦听具体发生在ContextManager中的事件.例如,ContextInterceptor侦听Tomcat的启动及终止事件,RequestInterceptor监视在它服务过程中用户请求需要通过的不同阶段.Tomcat的管理员不必知道太多关于侦听器的知识;另外,开发者应该知道这是如何在Tomcat中实现一个”全局”型的操作(例如安全性及每个请求日志)

Connector
Connector表示一个到用户的联接,不管是通过web服务器或直接到用户浏览器(在一个独立配置中).Connector负责管理Tomcat的工作线程和 读/写 连接到不同用户的端口的 请求/响应.Connector的配置包含如下信息:

1.句柄类

2.句柄监听的TCP/IP端口

3.句柄服务器端口的TCP/IP的backlog.

稍后我们将在此文档中描述如何配置Connector.

Context
每个Context提供一个指向你放置你Web项目的Tomcat的下属目录。每个Context包含如下配置：

1. Context放置的路径,可以是与ContextManager主目录相关的路径.

2.纪录调试信息的调试级别

3.可重载的标志.开发Servlet时,重载更改后的Servlet,这是一个非常便利的特性,你可以调试或用Tomcat测试新代码而不用停止或重新启动Tomcat.要打开重载,把reloadable设为真即可.这虽花费时间但可检测所发生的变化;更重要的事,鉴于,在一个装载类对象装入一个新的servlet时,类装载触发器可能会掷出一些错误.为避免这些问题,你可以设置可重载为假,这将停止重载功能.

从另一个目录中启动Tomcat

作为缺省值将使用TOMCAT_HOME/conf/server.xml作为配置文件.缺省配置将使用TOMCT_HOME作为关系环境的基础.

使用 “-f/你的/目录/server.xml”选项你可改变这种情况,使用另一个服务器配置文件和设置关系环境管理器的目录属性你需要在主目录内设置以下几个文件:

? 一个 webapps/目录(如果你已生成) – 所有war文件奖杯界压倒此目录而且所有子目录将作为关系环境添加.

? conf/目录 - 你可保存一个特殊的web.xml文件和其他配置文件

? logs/ - 所有日志文件将代替TOMCAT_HOME/logs/纪录到此目录中

? work/ - 关系环境的工作目录

如server.xml中的ContextManager.home属性有关联,将关联到到当前工作目录.

web。xml

关于web。xml和web项目结构（包括目录服务及配置）的详细描述可在Servlet API Spec的第9，10，14章中找到。

然而有一个与Tomcat有关的小“特性“与web.xml有关。Tomcat可以让用户通过将缺省的web.xml放入conf目录中来定义所有关系环境的web.xml的缺省值.建立一个新的关系环境时,Tomcat使用缺省的web.xml文件作为基本设置和应用项目特定的web.xml(放在应用项目的WEB-INF/web.xml文件)来覆盖这些缺省值.

设置Tomcat与Apache Web 服务器

服务器

到现在为止,我们未讨论作为服务器扩展的Tomcat,只讨论了作为独立运行的服务器.但有一些问题需要说明:

1. 当处理静态页面时,Tomcat不如Apache迅速.

2. Tomcat不象Apache一样可配置.

3. Tomcat不象Apache一样强壮.

4. 有很多网站已在某一特定web server上投入了很长时间,例如,使用CGI脚本/Server API模组/perl/php…我们不能假设这些遗留下来的东西都会被丢弃.

基于以上原因,一个现实的网站建议使用一个Web服务器,如Apache,为网站的静态页面请求提供服务,并使用Tomcat作为一个Servlet/JSP插件.

我们不准备深入的讨论每个不同的配置,我们将:

1. 涵盖Web服务器的基本行为

2. 解释需要何种配置

3. 在Apache上的实例

Web 服务器操作

简单说来，web服务器总是等待来自客户端的HTTP请求。当请求到达时，服务器会提供一切必要的内容来满足此请求。加入一个Servlet容器某种程度上会改变此行为。但服务器仍需处理如下因素：

载入servlet容器接口库并初始化（处理请求之前）。

当收到一个请求时，检查是否属于某Servlet，如是，则接口库接收此请求并处理。

另一方面，接口库需要知道他将服务某种请求，通常是基于请求的URL的某种模式和将此请求导向何处。

当用户想要设置使用虚拟主机的配置时，事情会变得更加复杂，或者想多个开发者在一个服务器上进行开发但使用不同的Servlet容器的JVMs。以下我们将讨论这两个问题。

必需进行的配置

应该考虑的是最明显的配置是servlet URL具有对servlet容器中的servlet具有表示的责任。很明显，你必须知道传递什么到Servlet容器。我们仍需提供附加的配置项目到web-server或servlet-container的结合体中.

l 考虑到Tomcat进程是否可取得，我们仍需提供配置和Tomcat正在监听的TCP/IP 主机名/端口号。

l 需要告知web服务器接口库的位置（因此我们可以在起始时装入）

l 需要设置接口内部信息如将日志记录在何处和如何纪录，等等。

所有此类信息必须出现在web服务器配置里或被接口使用的私有配置文件中。下面将讲述如何在Apache中如何实现这些配置。

Apache上的实现

这一部分演示如何配置Apache与Tomcat一起工作；并试图解释深入到可能会用到的配置规范。在jserv 安装页上可找到其他信息。