欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  网络运营

tomcat7的配置文件server.xml解析

程序员文章站 2022-09-25 21:23:03
这里对tomcat7的server.xml文件进行解释一下,方便在分析启动源码的时候理解digester做的事情。

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

<?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 "%r" %s %b" />
   </host>
  </engine>
 </service>
</server>

server

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

<server port="8005" shutdown="shutdown">
。。。
</server>
  1. port,监听shutdown命令的端口,-1表示禁用shutdown命令。
  2. 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资源。可以为所有的引擎应用程序引用。

<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

<service name="catalina">
。。。
</service>

server下面可以有多个service,service下面有多个connector和一个engine。这里默认的service名字为catalina,下面有两个connector:http和ajp。

  1. name,service显示的名称,名字必须唯一。

connector

<connector port="8080" protocol="http/1.1"
      connectiontimeout="20000"
      redirectport="8443" />

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

  1. port,端口号8080。
  2. protocol,协议,http协议
  3. connectiontimeout,响应的最大等待时间,20秒
  4. redirectport,ssl请求会重定向到8443端口
<connector executor="tomcatthreadpool"
      port="8080" protocol="http/1.1"
      connectiontimeout="20000"
      redirectport="8443" />

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

<connector port="8443" protocol="org.apache.coyote.http11.http11protocol"
      maxthreads="150" sslenabled="true" scheme="https" secure="true"
      clientauth="false" sslprotocol="tls" />

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

<connector port="8009" protocol="ajp/1.3" redirectport="8443" />

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

engine

engine是容器,一个service中只包含一个engine:

<engine name="catalina" defaulthost="localhost">
...
</engine>

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

  1. name,engine的名字,需要唯一。
  2. defaulthost,默认主机名

cluster

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

<cluster classname="org.apache.catalina.ha.tcp.simpletcpcluster"/>

realm

<realm classname="org.apache.catalina.realm.lockoutrealm">
 <realm classname="org.apache.catalina.realm.userdatabaserealm"
     resourcename="userdatabase"/>
</realm>

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

host

<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 "%r" %s %b" />
</host>

host虚拟主机,定义在engine下面,一个engine下面可以有多个host,在一个host下面可以有多个context。

  1. name,虚拟主机的网络名称,必须有一个host的名字和engine的defaulhost一样。
  2. appbase,虚拟主机应用的根目录,默认是webapps。
  3. unpackwars,在webapps目录下的war文件是否应该解压。
  4. autodeploy,值为true时,tomcat会定时检查appbase等目录,对新的web应用和context描述文件进行部署。

value

<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 "%r" %s %b" />

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

singlesignon 是单点登录,accesslogvalve是访问日志的记录。

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