Tomcat学习——server.xml配置文件

学习了tomcat的启动流程，我们来学习一下tomcat的配置文件server.xml

顶级组件Server

代表整个Tomcat容器,表示一个运行于JVM中的tomcat实例，提供一个接口让客户端能够访问到这个Service集合，
同时维护它所包含的所有的Service的生命周期，包括如何初始化、如何结束服务、如何找到客户端要访问的Service，8005端口监听shutdown命令

1、监听器Listener 组件

  <!-- 当Tomcat启动时，用于以日志形式输出Tomcat、JVM和操作系统的信息。该监听器必须是配置的第一个监听器 -->
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />

  <!-- Tomcat启动时，检查APR库，如果存在则加载。APR，即Apache Portable Runtime，是Apache可移植运行库，可以实现高可扩展性、高性能，以及与本地服务器技术更好的集成，如果找不到APR库，则会输出日志，并不影响tomcat启动 -->
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />

  <!-- 在Web应用启动之前初始化Jasper，Jasper是JSP引擎，把JVM不认识的JSP文件解析成java文件，然后编译成class文件供JVM使用 -->
  <Listener className="org.apache.catalina.core.JasperListener" />

  <!-- 与类加载器导致的内存泄露有关，避免JRE内存泄漏问题 -->
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />

  <!-- 通过该监听器，加载和销毁全局命名服务 -->
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />

  <!-- 当Web应用因thread-local导致的内存泄露而要停止时，该监听器会触发线程池中线程的更新。当线程执行完任务被收回线程池时，
  活跃线程会一个一个的更新。只有当Web应用(即Context元素)的renewThreadsWhenStoppingContext属性设置为true时，该监听器才有效 -->
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

2、Service组件

将连接器Connector关联至引擎Engine，因此一个Service内部可以有多个Connector，但是只能有一个Engine

2.1 Executor 组件
<Executor name="tomcatThreadPool" 
          namePrefix="catalina-exec-"
          maxThreads="150" 
          minSpareThreads="4" 
          maxIdleTime="60000" 
          maxQueueSize="Integer.MAX_VALUE" 
          prestartminSpareThreads="false" 
          threadPriority="5" 
          className="org.apache.catalina.core.StandardThreadExecutor"/>

用于配置共享线程池，即多个Connector共享这一个线程池，默认情况下是没有配置的，所以每个Connector都有一个自己的线程池，配置参数说明：

name: 线程池名称，用于在Connector中指定;
namePrefix: 所创建的每个线程的名称前缀，一个单独的线程名称为namePrefix + threadNumber;
maxThreads: 线程池中最大线程数;
minSpareThreads: 活跃线程数，也就是核心池线程数，这些线程不会被销毁，会一直存在，直到线程池被销毁;
maxIdleTime: 线程空闲时间，超过该时间后，空闲线程会被销毁，默认值为6000（1分钟），单位毫秒;
maxQueueSize: 任务队列中任务的上限，超过则请求拒绝;
prestartminSpareThreads: 是否在Executor启动时就生成minSpareThreads个线程;
threadPriority:线程池中线程优先级，值从1到10，默认为5;
className: 线程池实现类，默认为 org.apache.catalina.core.StandardThreadExecutor，可以使用自定义的线程池。

2.2 Connector连接器
    <!-- Connector接收连接请求，创建Request和Response对象用于和请求端交换数据；然后分配线程让Engine来处理这个请求，并把产生的Request和Response对象传给Engine -->
    <!-- http端口地址,协议版本号,超时时间,重定向https请求的端口，指定共享线程池名称， 指定编码URI的字符编码-->
    <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" executor="tomcatThreadPool" URIEncoding="UTF-8"/>

    <!-- ajp端口地址,协议版本号,可应用于apacheJk插件容器的通信 -->
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
2.3 Engine引擎
    <!-- 核心容器，catalina引擎，负责通过Connector接收用户请求 -->
    <Engine name="Catalina" defaultHost="localhost">
      <!-- Realm提供了一种用户密码与web应用的映射关系，从而达到角色安全管理的作用(暂时没用过) -->
      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resourceName="UserDatabase"/>
      </Realm>

      <!-- session复制的配置，还需要在tomcat中部署的应用的web.xml中配置<distributable/>，这种方式不适合大量集群 -->
      <Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>

      <!-- 虚拟主机配置相关(虚拟主机名,应用地址,是否以war包形式运行,是否自动部署),Host组件至少有一个，且其中一个的name必须与Engine组件的defaultHost属性相匹配,除默认主机名外,其他定义的主机名需要去专门的DNS服务器申请 -->
      <Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">

        <!-- 省略Context配置,虚拟主机的应用地址下,每个文件夹表示一个应用,ROOT可直接访问,其他的需要加上应用名 -->

        <!-- Valve理解为'阀',目前主要有客户访问日志阀,远程地址过滤阀,远程主机过滤阀,客户请求记录阀。AccessLogValve(客户访问日志阀)的作用是通过日志记录其所在的容器中处理的所有请求 -->
        <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>

最后将完整的server.xml文件放在这里，供大家学习交流

<!-- 代表整个Tomcat容器,表示一个运行于JVM中的tomcat实例，提供一个接口让客户端能够访问到这个Service集合，
同时维护它所包含的所有的Service的生命周期，包括如何初始化、如何结束服务、如何找到客户端要访问的Service，8005端口监听shutdown命令 -->
<Server port="8005" shutdown="SHUTDOWN">

  <!-- 当Tomcat启动时，用于以日志形式输出Tomcat、JVM和操作系统的信息。该监听器必须是配置的第一个监听器 -->
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />

  <!-- Tomcat启动时，检查APR库，如果存在则加载。APR，即Apache Portable Runtime，是Apache可移植运行库，可以实现高可扩展性、高性能，以及与本地服务器技术更好的集成，如果找不到APR库，则会输出日志，并不影响tomcat启动 -->
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />

  <!-- 在Web应用启动之前初始化Jasper，Jasper是JSP引擎，把JVM不认识的JSP文件解析成java文件，然后编译成class文件供JVM使用 -->
  <Listener className="org.apache.catalina.core.JasperListener" />

  <!-- 与类加载器导致的内存泄露有关，避免JRE内存泄漏问题 -->
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />

  <!-- 通过该监听器，加载和销毁全局命名服务 -->
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />

  <!-- 当Web应用因thread-local导致的内存泄露而要停止时，该监听器会触发线程池中线程的更新。当线程执行完任务被收回线程池时，
  活跃线程会一个一个的更新。只有当Web应用(即Context元素)的renewThreadsWhenStoppingContext属性设置为true时，该监听器才有效 -->
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />


  <!-- GlobalNamingResources元素定义了全局资源，通过配置可以看出，该配置是通过读取$TOMCAT_HOME/conf/tomcat-users.xml实现的 -->
  <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>

  <!--将连接器Connector关联至引擎Engine，因此一个Service内部可以有多个Connector，但是只能有一个Engine -->
  <Service name="Catalina">

    <!-- 用于配置共享线程池，即多个Connector共享这一个线程池，默认情况下是没有配置的，所以每个Connector都有一个自己的线程池
    name: 线程池名称，用于在Connector中指定
    namePrefix: 所创建的每个线程的名称前缀，一个单独的线程名称为namePrefix+threadNumber
    maxThreads: 线程池中最大线程数
    minSpareThreads: 活跃线程数，也就是核心池线程数，这些线程不会被销毁，会一直存在，直到线程池被销毁
    maxIdleTime: 线程空闲时间，超过该时间后，空闲线程会被销毁，默认值为6000（1分钟），单位毫秒
    maxQueueSize: 任务队列中任务的上限，超过则请求拒绝
    prestartminSpareThreads: 是否在Executor启动时就生成minSpareThreads个线程
    threadPriority: 线程池中线程优先级，值从1到10，默认为5
    className: 线程池实现类，默认为org.apache.catalina.core.StandardThreadExecutor，可以使用自定义的线程池-->
    <Executor name="tomcatThreadPool" namePrefix="catalina-exec-"
        maxThreads="150" minSpareThreads="4" maxIdleTime="60000" maxQueueSize="Integer.MAX_VALUE" 
        prestartminSpareThreads="false" threadPriority="5" className="org.apache.catalina.core.StandardThreadExecutor"/>


    <!-- Connector接收连接请求，创建Request和Response对象用于和请求端交换数据；然后分配线程让Engine来处理这个请求，并把产生的Request和Response对象传给Engine -->
    <!-- http端口地址,协议版本号,超时时间,重定向https请求的端口，指定共享线程池名称， 指定编码URI的字符编码-->
    <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" executor="tomcatThreadPool" URIEncoding="UTF-8"/>

    <!-- ajp端口地址,协议版本号,可应用于apacheJk插件容器的通信 -->
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />


    <!-- 核心容器，catalina引擎，负责通过Connector接收用户请求 -->
    <Engine name="Catalina" defaultHost="localhost">
      <!-- Realm提供了一种用户密码与web应用的映射关系，从而达到角色安全管理的作用(暂时没用过) -->
      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resourceName="UserDatabase"/>
      </Realm>

      <!-- session复制的配置，还需要在tomcat中部署的应用的web.xml中配置<distributable/>，这种方式不适合大量集群 -->
      <Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>

      <!-- 虚拟主机配置相关(虚拟主机名,应用地址,是否以war包形式运行,是否自动部署),Host组件至少有一个，且其中一个的name必须与Engine组件的defaultHost属性相匹配,除默认主机名外,其他定义的主机名需要去专门的DNS服务器申请 -->
      <Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">

        <!-- 省略Context配置,虚拟主机的应用地址下,每个文件夹表示一个应用,ROOT可直接访问,其他的需要加上应用名 -->

        <!-- Valve理解为'阀',目前主要有客户访问日志阀,远程地址过滤阀,远程主机过滤阀,客户请求记录阀。AccessLogValve(客户访问日志阀)的作用是通过日志记录其所在的容器中处理的所有请求 -->
        <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>
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 202,009评论 5赞 474
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 84,808评论 2赞 378
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 148,891评论 0赞 335
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,283评论 1赞 272
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,285评论 5赞 363
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,409评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,809评论 3赞 393
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,487评论 0赞 256
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,680评论 1赞 295
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,499评论 2赞 318
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,548评论 1赞 329
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,268评论 4赞 318
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,815评论 3赞 304
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,872评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,102评论 1赞 258
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 42,683评论 2赞 348
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,253评论 2赞 341