Tomcat中配置文件server.xml详解

Context元素中两个重要属性：docBase和path
  和reloadable属性

docBase:
   设置Web应用使用的WAR包路径或应用目录

注意事项:
   在自动部署场景下
    docBase不在appBase目录中,才需要指定
	当docBase指定的WAR包或应用目录就在appBase中,则无需指定
    
path：
   设置访问该Web应用的上下文路径
   当请求到来时,Tomcat根据Web应用path属性与URI的匹配程度来选择Web应用处理相应请求
 例:
   Web应用app1的path属性是”/app1”
   Web应用app2的path属性是”/app2”
   则请求/app1/index.html会交由app1来处理
     请求/app2/index.html会交由app2来处理
   当一个Context元素的path属性为””，那么这个Context是虚拟主机的默认Web应用
   当请求的uri与所有的path都不匹配时，使用该默认Web应用来处理。

注意事项:  
   在自动部署场景下,不能指定path属性
    path属性由配置文件的文件名、WAR文件的文件名或应用目录的名称自动推导出来
    如扫描Web应用时，发现了xmlBase目录下的app1.xml，或appBase目录下的app1.WAR或app1应用目录
         则该Web应用的path属性是”app1”
      如果名称不是app1而是ROOT，则该Web应用是虚拟主机默认的Web应用，此时path属性推导为””。

reloadable属性:
    指tomcat是否在运行时监控在WEB-INF/classes和WEB-INF/lib目录下class文件的改动
    当此值为true，那么当class文件改动时，会触发Web应用的重新加载
     在开发环境下，reloadable设置为true便于调试
     但在生产环境中设置为true会给服务器带来性能压力，因此reloadable参数的默认值为false。

自动部署的示例

 
<Context docBase="D:\Test\app1.war" reloadable="true"/>

docBase位于Host的appBase目录之外
  由于path属性没有指定
  会根据app1.xml自动推导为”app1”
   由于是在开发环境下
   因此reloadable设置为true,便于开发调试

核心组件的关联

整体关系

核心组件之间的整体关系 
Server元素在最顶层
    代表整个Tomcat容器
     一个Server元素中可以有一个或多个Service元素。

Service在Connector和Engine外层,将它们组装在一起,对外提供服务
     一个Service可以包含多个Connector
     但只能包含一个Engine
     Connector接收请求,Engine处理请求

Engine、Host和Context都是容器
   且Engine包含Host,Host包含Context
   每个Host组件代表Engine中的一个虚拟主机
   每个Context组件代表在特定Host上运行的一个Web应用。

Tomcat路由判断方法

当请求被发送到Tomcat所在的主机时
  我们可以使用以下方法判断具体处理此请求的web应用 

 1.使用协议和端口号选定Service和Engine
    Service中的Connector组件可以接收特定端口的请求
   当Tomcat启动时，Service组件就会监听特定的端口
     如:
	   Catalina这个Service监听了8080端口(基于HTTP协议)和8090端口(基于AJP协议)
	      当请求进来时，Tomcat便可以根据协议和端口号选定处理请求的Service
          当Service选择后,Engine也随之确认
 
  2.根据域名或IP地址选定Host
      Service确定后
      Tomcat在Service中寻找名称与域名/IP地址匹配的Host处理该请求
      当没有找到,则使用Engine中指定的defaultHost来处理该请求
      如:
       上例中只有一个Host(name属性为localhost)
	       因此该Service/Engine的所有请求都交给该Host处理。

  3.使用URI选定Context/Web应用
      Tomcat根据应用的 path属性与URI的匹配程度来选择Web应用处理相应请求

  浏览器中输入http://localhost:8080/app1/index.html
    先通过协议和端口号(http和8080)选定Service
   然后通过主机名(localhost)选定Host
   然后通过uri(/app1/index.html)选定Web应用

Tomcat中如何配置多个服务

在Server中配置多个Service服务
 可实现通过不同的端口号来访问同一台机器上部署的不同Web应用

 
 1.复<Service>元素，放在当前<Service>后面。

 2.修改端口号：根据需要监听的端口号修改<Connector>元素的port属性；
    必须确保该端口没有被其他进程占用，否则Tomcat启动时会报错，而无法通过该端口访问Web应用。
    
	 可使用以下方法找出某个端口是否被其他进程占用
          netstat -aon|findstr "8081"发现8081端口被PID为6632的进程占用
           tasklist |findstr "6632"发现该进程为testJava.exe(这是McAfee杀毒软件的进程)。

 3.修改Service和Engine的name属性

 4.修改Host的appBase属性（如webapps2）

 5.Web应用仍然使用自动部署

 6.将要部署的Web应用(WAR包或应用目录)拷贝到新的appBase下。

多个Service的配置

  <?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.JasperListener" />
    <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="/opt/project/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 "%r" %s %b" />
       </Host>
     </Engine>
   </Service>
 
   <Service name="Catalina2">
     <Connector port="8084" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
     <Connector port="8010" protocol="AJP/1.3" redirectPort="8443" />
     <Engine name="Catalina2" defaultHost="localhost">
       <Realm className="org.apache.catalina.realm.LockOutRealm">
         <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                resourceName="UserDatabase"/>
       </Realm>
 
       <Host name="localhost"  appBase="/opt/project/webapps2" unpackWARs="true" autoDeploy="true">
         <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" prefix="localhost_access_log." suffix=".txt" pattern="%h %l %u %t "%r" %s %b" />
       </Host>
     </Engine>
   </Service>
 </Server>

将原webapps下的docs目录拷贝到webapps2中
  然后可通过如下两个接口都可以访问docs应用

http://localhost:8080/docs/
http://localhost:8084/docs/

其他组件

Listener

   <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
    <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
    <Listener className="org.apache.catalina.core.JasperListener" />
    <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
    <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
    <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

Listener(即监听器)定义的组件:
    可以在特定事件发生时执行特定的操作
    被监听的事件通常是Tomcat的启动和停止

监听器可以在Server、Engine、Host或Context中
   本例中的监听器都是在Server中
   实际上
     本例中定义的6个监听器
     都只能存在于Server组件中

注意事项:  
   1.监听器不允许内嵌其他组件
   2.监听器需要配置的最重要的属性是className
    该属性设置监听器的具体实现类
   3.该类必须实现org.apache.catalina.LifecycleListener接口。

tomcat监听器的示例分享

VersionLoggerListener：
   当Tomcat启动时，该监听器记录Tomcat、Java和操作系统的信息
     该监听器必须是配置的第一个监听器。
AprLifecycleListener：
    Tomcat启动时，检查APR库，如果存在则加载。APR，即Apache Portable Runtime
	  是Apache可移植运行库，可以实现高可扩展性、高性能，以及与本地服务器技术更好的集成。
JasperListener：
    在Web应用启动之前初始化Jasper
	 Jasper是JSP引擎
	  把JVM不认识的JSP文件解析成java文件
	   然后编译成class文件供JVM使用。
JreMemoryLeakPreventionListener：
     与类加载器导致的内存泄露有关。
GlobalResourcesLifecycleListener：
     使用该监听器，初始化< GlobalNamingResources>标签中定义的全局JNDI资源
	 当没有该监听器，任何全局资源都不能使用。< GlobalNamingResources>将在后文介绍。
ThreadLocalLeakPreventionListener：
     当Web应用因thread-local导致的内存泄露而要停止时，
	   该监听器会触发线程池中线程的更新。
	    当线程执行完任务被收回线程池时，
		活跃线程会一个一个的更新。
		只有当Web应用(即Context元素)的renewThreadsWhenStoppingContext属性设置为true时，该监听器才有效。

 
<Realm className="org.apache.catalina.realm.LockOutRealm">
          <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                 resourceName="UserDatabase"/>
        </Realm>
 
 Realm:
   可以把它理解成“域”
    Realm提供了一种用户密码与web应用的映射关系
    从而实现角色安全管理的作用

   <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>

GlobalNamingResources元素定义全局资源
   使用配置可看出
   该配置是通过读取$TOMCAT_HOME/ conf/tomcat-users.xml实现的。

Valve

Host元素内定义Valve组件 
   <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" prefix="localhost_access_log." 
         suffix=".txt" pattern="%h %l %u %t "%r" %s %b" />
   
   Valve: 在Tomcat中代表了请求处理流水线上的一个组件
          Valve可以与Tomcat的容器(Engine、Host或Context)关联。

例：
   不同的Valve有不同的特性
     下面介绍一下本例中出现的AccessLogValve。

AccessLogValve的功能:
    使用日志记录其所在的容器中处理的所有请求
     在本例中
       Valve放在Host下
       便可以记录该Host处理的所有请求
AccessLogValve记录的日志就是访问日志
    每天的请求会写到一个日志文件里
AccessLogValve可与Engine、Host或Context关联

例:
   只有一个Engine，Engine下只有一个Host
    Host下只有一个Context 

例AccessLogValve属性的配置
    使用的是默认的配置,AccessLogValve中各个属性功能
  1.className：规定了Valve的类型，是最重要的属性
       例:通过该属性规定了这是一个AccessLogValve。
  2.directory：指定日志存储的位置
       例：日志存储在$TOMCAT_HOME/logs目录下。
  3.prefix：设置日志文件的前缀。
  4.suffix：设置日志文件的后缀  
            使用directory、prefix和suffix的配置
            在$TOMCAT_HOME/logs目录下
  5.pattern：设置记录日志的格式 

%h:远程主机名或IP地址 
    当有nginx等反向代理服务器进行请求分发
     该主机名/IP地址代表的是nginx，否则代表的是客户端
%l:远程逻辑用户名，一律是”-” 
%u:授权的远程用户名，如果没有，则是”-”。
%t:访问的时间。
%r:请求的第一行，即请求方法(get/post等)、uri、及协议。
%s:响应状态，200,404等等。
%b:响应的数据量，不包括请求头，如果为0，则是””-。