server.xml详解

原文地址：http://www.blogjava.net/baoyaer/articles/107278.html
         http://blog.csdn.net/weinianjie1/article/details/7954425

Tomcat Server结构图

 

server.xml
<?xml version='1.0' encoding='utf-8'?>
<Server port="8005" shutdown="SHUTDOWN">
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" /> 
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" /> 
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

 
  <GlobalNamingResources>    
    <Resource name="UserDatabase" auth="Container"
              type="org.apache.catalina.UserDatabase"
              description="User database that can be updated and saved"
              factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
              pathname="conf/tomcat-users.xml" />
  </GlobalNamingResources>

  
  <Service name="Catalina">
    
    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" /> 
   
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
    
    <Engine name="Catalina" defaultHost="localhost">     

      <Realm className="org.apache.catalina.realm.LockOutRealm">       
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resourceName="UserDatabase"/>
      </Realm>

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

        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
               prefix="localhost_access_log" suffix=".txt"
               pattern="%h %l %u %t &quot;%r&quot; %s %b" />

      </Host>
    </Engine>
  </Service>
</Server>

1）<Server>元素代表了整个Catalina 可以包含一个或多个<Service>,配置如下
<Server     port="8005"     shutdown="SHUTDOWN"     debug="0">
port:负责关闭tomcat的请求端口  必须设置
shutdown：指定发送端口命令字符串  必须设置

2）<Service>元素由org.apache.catalina.Service接口定义,它包含一个<Engine>元素,以及一个或多个<Connector>元素,这些<Connector>元素共享一个<Engine>元素.
<Service     name="Catalina">
name:指定service的名字

3） <Engine>元素由org.apahe.catalina.Engine接口定义. 每个<Service>元素只能包括一个<Engine>元素.
    <Engine>元素处理在同一个<Service>中所有<Connector>元素接收到的客户请求.
    <Engine     name="Catalina"     defaultHost="localhost"     debug="0"> 
name:指定Engine名字 defaultHost:指定缺省的处理请求的主机名，它至少与其中的一个host元素的name属性值是一样的

4)<Host>元素由org.apache.catalina.Host接口定义.一个<Engine>元素可以包含多个<Host>元素.每个<Host>元素定义了一个虚拟主机,它可以包含一个或多个Web应用.
<Host     name="localhost"     debug="0"     appBase="webapps"　unpackWARs="true"     autoDeploy="true">
appBase:指定虚拟主机的目录,可以指定绝对目录,也可以指定相对于<CATALINA_HOME>的相对目录.     如果此项没有设定,默认值为<CATALINA_HOME>/webapps.
unpackWARs:如果此项设为true,表示将把Web应用的WAR文件先展开为开放目录结构后再运行.如果设为false,将直接运行WAR文件.
autoDeploy:如果此项设为true,表示当Tomcat服务器处于运行状态时,能够监测appBase下的文件,如果有新的Web应用加入进来,会自动发布这个Web应用.
alias:指定虚拟主机的别名,可以指定多个别名.
deployOnStartup:如果此项设为true,表示Tomcat服务器启动时会自动发布appBase目录下的所有Web应用,如果Web应用在server.xml中没有相应的<Context>元素,
                将采用Tomcat默认的Context.     deployOnStartup的默认值为true.
name:定义虚拟主机的名字.

5)<Context>元素由org.apache.catalina.Context接口定义.<Context>元素是使用最频繁的元素.每个<Context>元素代表了运行在虚拟主机上的单个Web应用.
<Context     path="/sample"     docBase="sample"     debug="0"     reloadable="true"> 
path:指定访问该Web应用的URL入口.
docBase:指定Web应用的文件路径.可以给定绝对路径,也可以给定相对于Host的appBase属性的相对路径. 
        如果Web应用采用开放目录结构,那就指定Web应用的根目录;如果Web应用是个WAR文件,那就指定WAR文件的路径.
reloadable:如果这个属性设为true,Tomcat服务器在运行状态下会监视在WEB-INF/class和WEB-INF/lib目录下CLASS文件的改动.
           如果检测到有calss文件被更新,服务器会自动重新加载Web应用.
cookies:指定是否通过Cookie来支持Session,默认为true.
useNaming:指定是否支持JNDI,默认为true.

6)<Connector>元素由org.apache.catalina.Connector接口定义.<Connector>元素代表与客户程序实际交互的组件,它负责接收客户的请求,以及向客户返回响应结果.
<Connector       <Connector     port="8080"
                                    maxThreads="150"     minSpareThreads="25"     maxSpareThreads="75"
                                    enableLookups="false"     redirectPort="8443"     acceptCount="100"
                                    debug="0"     connectionTimeout="20000"  
                                    disableUploadTimeout="true"     />

 enableLookups:如果设为true,表示支持域名解析,可以把IP地址解析为主机名.Web应用调用request.getRemostHost方法将返回客户的主机名.该属性默认值为true.
 redirectPort:指定转发端口.如果当前端口只支持non-SSL请求,在需要安全通信的场合,将把客户请求转发到基于SSL的redirectPort的端口.