tomcat中 server.xml配置详解

转载自：http://blog.sina.com.cn/s/blog_4b3c1f950100ol9b.html

Server ------port：指定一个端口，这个端口负责监听关闭tomcat的请求
                   shutdown：指定向端口发送的命令字符串
Service------name：指定service的名字
Connector--port：指定服务器端要创建的端口号，并在这个断口监听来自客户端的请求
                   minProcessors：服务器启动时创建的处理请求的线程数
                   maxProcessors：最大可以创建的处理请求的线程数
                   enableLookups：如果为true，则可以通过调用request.getRemoteHost()进行DNS查询来得到远程客户端的实际主机名，若为false则不进行DNS查询，而是返回其ip地址
                   redirectPort：指定服务器正在处理http请求时收到了一个SSL传输请求后重定向的端口号
                   acceptCount：指定当所有可以使用的处理请求的线程数都被使用时，可以放到处理队列中的请求数，超过这个数的请求将不予处理
                   connectionTimeout：指定超时的时间数(以毫秒为单位)
Engine------defaultHost：指定缺省的处理请求的主机名，它至少与其中的一个host元素的name属性值是一样的
Context-----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

<Server>元素
      它代表整个容器,是Tomcat实例的顶层元素.由org.apache.catalina.Server接口来定义.它包含一个<Service>元素.并且它不能做为任何元素的子元素.

<Server port="8005" shutdown="SHUTDOWN" debug="0">

      className指定实现org.apache.catalina.Server接口的类.默认值为org.apache.catalina.core.StandardServer。
      port指定Tomcat监听shutdown命令端口.终止服务器运行时,必须在Tomcat服务器所在的机器上发出shutdown命令.该属性是必须的。
      shutdown指定终止Tomcat服务器运行时,发给Tomcat服务器的shutdown监听端口的字符串.该属性必须设置。

<Service>元素
      该元素由org.apache.catalina.Service接口定义,它包含一个<Engine>元素,以及一个或多个<Connector>,这些Connector元素共享用同一个Engine元素. 负责处理所有Connector所获得的客户请求.

<Service name="Catalina"><Service name="Apache">

      第一个<Service>处理所有直接由Tomcat服务器接收的web客户请求。
      第二个<Service>处理所有由Apahce服务器转发过来的Web客户请求。
      className 指定实现org.apahce.catalina.Service接口的类.默认为org.apahce.catalina.core.StandardService
      name定义Service的名字
 
<Engine>元素
      每个Service元素只能有一个Engine元素, 由org.apahce.catalina.Engine接口定义.元素处理在同一个<Service>中所有<Connector>元素接收到的客户请求.Engine下可以配置多个虚拟主机Virtual Host，每个虚拟主机都有一个域名,当Engine获得一个请求时，它把该请求匹配到某个Host上，然后把该请求交给该Host来处理,Engine有一个默认虚拟主机，当请求无法匹配到任何一个Host上的时候，将交给该默认Host来处理。

<Engine name="Catalina" defaultHost="localhost" debug="0">

      className指定实现Engine接口的类,默认值为StandardEngine。
      defaultHost指定处理客户的默认主机名,在<Engine>中的<Host>子元素中必须定义这一主机。
      name定义Engine的名字。

     在<Engine>可以包含如下元素<Logger>, <Realm>, <Value>, <Host>

<Host>元素
       它由Host接口定义. 一个Engine元素可以包含多个<Host>元素，每个<Host>的元素定义了一个Virtual Host（虚拟主机），每个虚拟主机和某个网络域名Domain Name相匹配,每个虚拟主机下都可以部署一个或者多个Web 应用，每个Web应用对应于一个Context，有一个Context path.当Host获得一个请求时，将把该请求匹配到某个Context上，然后把该请求交给该Context来处理,匹配的方法是“最长匹配”，所以一个path==""的Context将成为该Host的默认Context.所有无法和其它Context的路径名匹配的请求都将最终和该默认Context匹配。

<Host name="localhost" debug="0" appBase="webapps" unpackWARs="true" autoDeploy="true">

       className指定实现Host接口的类.默认值为StandardHost。
       appBase指定虚拟主机的目录,可以指定绝对目录,也可以指定相对于<CATALINA_HOME>的相对目录.如果没有此项,默认<CATALINA_HOME>/webapps。
       autoDeploy如果此项设为true,表示Tomcat服务处于运行状态时,能够监测appBase下的文件,如果有新有web应用加入进来,会自运发布这个WEB应用。
       unpackWARs如果此项设置为true,表示把WEB应用的WAR文件先展开为开放目录结构后再运行.如果设为false将直接运行为WAR文件。
       alias指定主机别名,可以指定多个别名。
       deployOnStartup如果此项设为true,表示Tomcat服务器启动时会自动发布appBase目录下所有的Web应用.如果Web应用中的server.xml没有相应的<Context>元素,将采用Tomcat默认的Context。
        name定义虚拟主机的名字。
       在<Host>元素中可以包含如下子元素<Logger>, <Realm>, <Value>,<Context>。

<Context>元素
      它由Context接口定义. 一个Context对应于一个Web Application，一个Web Application由一个或者多个Servlet组成，Context在创建的时候将根据配置文件$CATALINA_HOME/conf/web.xml和$WEBAPP_HOME/WEB-INF/web.xml载入Servlet类，当Context获得请求时，将在自己的映射表(mapping table)中寻找相匹配的Servlet类，如果找到，则执行该类，获得请求的回应，并返回。
      每个<Context元素代表了运行在虚拟主机上的单个Web应用.一个<Host>可以包含多个<Context>元素.每个web应用有唯一的一个相对应的Context代表web应用自身.servlet容器为第一个web应用创建一个ServletContext对象.

<Context path="/sample" docBase="sample" debug="0" reloadbale="true">

      className指定实现Context的类,默认为StandardContext类
      path指定访问Web应用的URL入口,注意/myweb,而不是myweb 。
      reloadable如果这个属性设为true, Tomcat服务器在运行状态下会监视在WEB-INF/classes和Web-INF/lib目录CLASS文件的改运.如果监视到有class文件被更新,服务器自重新加载Web应用
      cookies指定是否通过Cookies来支持Session,默认值为true
      useNaming指定是否支持JNDI,默认值为了true
      在<Context>元素中可以包含如下元素<Logger>, <Realm>, <Resource>, <ResourceParams>

Connector元素
      由Connector接口定义.<Connector>元素代表与客户程序实际交互的给件,它负责接收客户请求,以及向客户返回响应结果.

<Connector port="8080" maxThread="50" minSpareThreads="25" maxSpareThread="75" enableLookups="false" redirectPort="8443" acceptCount="100" debug="0" connectionTimeout="20000" disableUploadTimeout="true" /><Connection port="8009" enableLookups="false" redirectPort="8443" debug="0" protocol="AJP/1.3" />

       第一个Connector元素定义了一个HTTP Connector,它通过8080端口接收HTTP请求;第二个Connector元素定义了一个JD Connector,它通过8009端口接收由其它服务器转发过来的请求.
       Connector元素共用属性：
              className指定实现Connector接口的类。
              enableLookups如果设为true,表示支持域名解析,可以把IP地址解析为主机名.WEB应用中调用request.getRemoteHost方法返回客户机主机名.默认值为true。
              redirectPort指定转发端口.如果当前端口只支持non-SSL请求,在需要安全通信的场命,将把客户请求转发至SSL的redirectPort端口。

       HttpConnector元素的属性： 
              className实现Connector的类
              port设定Tcp/IP端口,默认值为8080,如果把8080改成80,则只要输入http://localhost即可。因为TCP/IP的默认端口是80。
              address如果服务器有二个以上ip地址,此属性可以设定端口监听的ip地址.默认情况下,端口会监听服务器上所有的ip地址。
              bufferSize设定由端口创建的输入流的缓存大小.默认值为2048byte。
              protocol设定Http协议,默认值为HTTP/1.1。
              maxThreads设定在监听端口的线程的最大数目,这个值也决定了服务器可以同时响应客户请求的最大数目.默认值为200。
              acceptCount设定在监听端口队列的最大客户请求数量,默认值为10.如果队列已满,客户必须等待。
              connectionTimeout定义建立客户连接超时的时间.如果为-1,表示不限制建立客户连接的时间。

      JkConnector的属性
              className实现Connector的类。
              port设定AJP端口号。
              protocol必须设定为AJP/1.3。

tomcat映射配置server.xml

<Host appBase="webapps">
       appBase:可以指定绝对目录,也可以指定相对于<CATALINA_HOME>的相对目录.如果没有此项,默认为<CATALINA_HOME>/webapps .以上定义了默认根目录为"webapps"（相对路径，相对于<CATALINA_HOME>）
       可以通过在Host标签下加上多个Context来创建自定义访问。一般用Context来覆盖Host的appBase的设定而不是直接修改appBase。
      path: Host的虚拟目录
      docBase: 映射的物理目录的地址，可指定相对路径，相对appBase下，也可以指定绝对路径（例如：D:\Workes\testtomcat\WebRoot）。如果无此项则默认为appBase/ROOT 。

例如：

<Context path="" docBase="ROOT" debug="0"/>

path=""（注意不是path="/")，则相当于是这个Host的虚拟根目录，docBase则指出了物理目录的位置为相对于appBase下的ROOT目录。因此在访问在浏览器中输入http://localhost:8080/，则访问到的是webapps下的ROOT目录。

<Context path="/sample" docBase="sample" debug="0" reloadbale="true"/>

如果访问http://localhost:8080/sample/ ,则会访问到appBase/sample里的内容。

<Context path="" docBase="D:\Workes\testtomcat\WebRoot" debug="0" reloadbale="true"/>

path=""，指的是这是Host的虚拟根目录，而docBase指出物理目录是个绝对地址，因为如果访问http://localhost:8080/ ，则会访问到的是D:\Workes\testtomcat\WebRoot里的内容 。