首页 > 代码库 > Tomcat全攻略

Tomcat全攻略

技术分享
技术分享
内容:
技术分享
一:简单介绍
二:安装及配置
三:应用
四:综述
參考资料
关于作者
技术分享
技术分享

宗 锋
西北大学计算机系硕士
2001 年 12 月

随着java的流行,其在web上的应用也越来越广,tomcat作为一个开源的servlet容器,应用前景越来越广,本文将向你讲述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中)


(三):执行
设置完成后就能够执行tomcatserver了,进入tomcat的bin文件夹,win98下用startup启动tomcat,linux下用startup.sh,对应的关闭tomcat的命令为shutdown和shutdown.sh。

启动后能够在浏览器中输入http://localhost:8080/測试,因为tomcat本身具有webserver的功能,因此我们不必安装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的文档

元素名属性解释
serverport指定一个port,这个port负责监听关闭tomcat的请求
shutdown指定向port发送的命令字符串
servicename指定service的名字
Connector
(表示client和service之间的连接)
port指定server端要创建的port号,并在这个断口监听来自client的请求
minProcessorsserver启动时创建的处理请求的线程数
maxProcessors最大能够创建的处理请求的线程数
enableLookups假设为true,则能够通过调用request.getRemoteHost()进行DNS查询来得到远程client的实际主机名,若为false则不进行DNS查询,而是返回其ip地址
redirectPort指定server正在处理http请求时收到了一个SSL传输请求后重定向的port号
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
(表示存放username,password及role的数据库)

className指定Realm使用的类名,此类必须实现org.apache.catalina.Realm接口

Valve
(功能与Logger差点儿相同,其prefix和suffix属性解释和Logger 中的一样)

className

指定Valve使用的类名,如用org.apache.catalina.valves.AccessLogValve类能够记录应用程序的訪问信息

directory指定log文件存放的位置
pattern有两个值,common方式记录远程主机名或ip地址,username,日期,第一行请求的字符串,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/,会弹出对话框,输入上面的username和password就可以。

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也能够作webserver,但其处理静态html的速度比不上apache,且其作为webserver的功能远不如apache,因此我们想把apache和tomcat集成起来。

我们以linux系统为例介绍.

从apache站点下载apache1.3.22源码版本号,然后使用例如以下命令配置安装apache:

mkdir /usr/local/apachetar zxvf apache.1.32.tar.gzcd apache.1.32./configure --prefix=/usr/local/apache --enable-module=so makemake install


注意configure命令指定目标安装文件夹,而且增加DSO(Dynamic Shared Object)支持,注意一定不要忘了这一个选项。

然后下载webapp模块,将解压后mod_webapp.so文件放入apache的libexec文件夹,编辑apache的conf文件夹下的httpd.conf,在这个文件的最后增加以下三行:

LoadModule webapp_module libexec/mod_webapp.soWebAppConnection warpConnection warp localhost:8008WebAppDeploy 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最后几行指定的要保持一致。文件例如以下:

 ****** 


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作ejbserver)。jboss的官方站点也提供集成了tomcat3.2*的jboss以供下载。另外一个开源的应用server(enhydra) 也是基于tomcat的,其提供了更友好的管理界面,部署应用程序也更简单,功能也更强大。

參考资料:

  • tomcat文档
  • www.jguru.com的tomcat faq
  • apache的文档


关于作者
宗锋:西北大学计算机系硕士,对于基于 web 的各种新技术都感兴趣。

<style type=text/css></style>
<?xml:namespace prefix = asp />

Tomcat全攻略