tomcat7的配置文件server.xml解析

时间:2021-08-16 21:21:12

这里对tomcat7的server.xml文件进行解释一下,方便在分析启动源码的时候理解Digester做的事情。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
<?xml version='1.0' encoding='utf-8'?>
<Server port="8005" shutdown="SHUTDOWN">
 <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
 <Listener className="org.apache.catalina.security.SecurityListener" />
 <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">
  <Executor name="tomcatThreadPool" namePrefix="catalina-exec-"
    maxThreads="150" minSpareThreads="4"/>
 
  <Connector port="8080" protocol="HTTP/1.1"
        connectionTimeout="20000"
        redirectPort="8443" />
 
  <Connector executor="tomcatThreadPool"
        port="8080" protocol="HTTP/1.1"
        connectionTimeout="20000"
        redirectPort="8443" />
 
  <Connector port="8443" protocol="org.apache.coyote.http11.Http11Protocol"
        maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
        clientAuth="false" sslProtocol="TLS" />
 
  <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
 
  <Engine name="Catalina" defaultHost="localhost">
 
   <Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>
 
   <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.authenticator.SingleSignOn" />
 
    <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>

Server

tomcat中Server代表一个tomcat实例,所以只会存在一个Server,而在配置文件中也是作为*元素出现,代码如下:

?
1
2
3
<Server port="8005" shutdown="SHUTDOWN">
。。。
</Server>
  • port,监听shutdown命令的端口,-1表示禁用shutdown命令。
  • shutdown,关闭tomcat的指令。

Listener

监听器,用来监听某些事件的发生。

 

复制代码 代码如下:

<Listener className="org.apache.catalina.startup.VersionLoggerListener" />

 

 

VersionLoggerListener,启动时对tomcat,java,操作系统信息打印日志。

 

复制代码 代码如下:

<Listener className="org.apache.catalina.security.SecurityListener" />

 

 

SecurityListener,启动tomcat时,做一些安全检查。

 

复制代码 代码如下:

<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />

 

 

AprLifecycleListener,用来监听Apache服务器相关的。

 

复制代码 代码如下:

<Listener className="org.apache.catalina.core.JasperListener" />

 

 

JasperListener,Jasper 2 JSP 引擎,主要负责对更新之后的jsp进行重新编译。

 

复制代码 代码如下:

<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />

 

 

JreMemoryLeakPreventionListener,防止内存溢出的监听器。

 

复制代码 代码如下:

<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />

 

 

GlobalResourcesLifecycleListener,初始化定义在元素GlobalNamingResources下的全局JNDI资源

 

复制代码 代码如下:

<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

 

 

ThreadLocalLeakPreventionListener,防止ThreadLocal溢出监听器。

GlobalNamingResources

GlobalNamingResources定义Server的全局JNDI资源。可以为所有的引擎应用程序引用。

?
1
2
3
4
5
6
7
<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>

配置文件中定义了一个JNDI,名为UserDatabase,通过conf/tomcat-users.xml的内容,来得到一个用于授权用户的数据库,是一个内存数据库。

Service

?
1
2
3
<Service name="Catalina">
。。。
</Service>

Server下面可以有多个Service,Service下面有多个Connector和一个Engine。这里默认的Service名字为Catalina,下面有两个Connector:Http和AJP。

  • name,Service显示的名称,名字必须唯一。

Connector

?
1
2
3
<Connector port="8080" protocol="HTTP/1.1"
      connectionTimeout="20000"
      redirectPort="8443" />

上面是用来处理http请求的Connector。

  • port,端口号8080。
  • protocol,协议,http协议
  • connectionTimeout,响应的最大等待时间,20秒
  • redirectPort,ssl请求会重定向到8443端口
?
1
2
3
4
<Connector executor="tomcatThreadPool"
      port="8080" protocol="HTTP/1.1"
      connectionTimeout="20000"
      redirectPort="8443" />

上面是使用线程池,处理http请求。

?
1
2
3
<Connector port="8443" protocol="org.apache.coyote.http11.Http11Protocol"
      maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
      clientAuth="false" sslProtocol="TLS" />

上面处理ssl请求,端口是8443。

?
1
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

上面处理AJP请求,可以将tomcat和apache的http服务器一起运行。

Engine

Engine是容器,一个Service中只包含一个Engine:

?
1
2
3
<Engine name="Catalina" defaultHost="localhost">
...
</Engine>

Engine下面可以包含一个多或者多个Host。Engine从http请求的头信息中的主机名或者ip映射到真确的主机上。

  • name,Engine的名字,需要唯一。
  • defaultHost,默认主机名

Cluster

集群相关的配置。tomcat支持服务器集群,可以复制整个集群的回话和上下文属性,也可以部署一个war包到所有的集群上。

?
1
<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>

Realm

?
1
2
3
4
<Realm className="org.apache.catalina.realm.LockOutRealm">
 <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
     resourceName="UserDatabase"/>
</Realm>

Realm是一个包含user、password、role的数据库,Realm可以定义在任何容器中。这里通过外部资源UserDatabase进行认证。

Host

?
1
2
3
4
5
6
7
8
9
<Host name="localhost" appBase="webapps"
   unpackWARs="true" autoDeploy="true">
 
 <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
 
 <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>

Host虚拟主机,定义在Engine下面,一个Engine下面可以有多个Host,在一个Host下面可以有多个Context。

  • name,虚拟主机的网络名称,必须有一个host的名字和Engine的defaulHost一样。
  • appBase,虚拟主机应用的根目录,默认是webapps。
  • unpackWARs,在webapps目录下的war文件是否应该解压。
  • autoDeploy,值为true时,tomcat会定时检查appBase等目录,对新的web应用和Context描述文件进行部署。

Value

?
1
2
3
4
5
<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
 
<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" />

Value在这里是阀门的意思,可以拦截http请求,可以定义在任何容器中。

SingleSignOn 是单点登录,AccessLogValve是访问日志的记录。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。

原文链接:http://cxis.me/2017/05/16/tomcat7%E7%9A%84server.xml%E8%A7%A3%E6%9E%90/?utm_source=tuicool&utm_medium=referral