- Tomcat 作为服务器的配置,主要是 server.xml ⽂件的配置;
- server.xml中包含了 Servlet容器的相关配置,即 Catalina 的配置;
一,主要标签结构
<!--
Server 根元素,创建⼀个Server实例,⼦标签有 Listener、GlobalNamingResources、Service
-->
<Server>
<!--定义监听器-->
<Listener/>
<!--定义服务器的全局JNDI资源 -->
<GlobalNamingResources/>
<!-- 定义⼀个Service服务,⼀个Server标签可以有多个Service服务实例 -->
<Service/>
</Server>
二,Server标签
标签属性:
- port
- shutdown
说明Tomcat来监听port端口来执行关闭
<!--
port:关闭服务器的监听端⼝
shutdown:关闭服务器的指令字符串
-->
<Server port="8005" shutdown="SHUTDOWN">
<!-- 以⽇志形式输出服务器 、操作系统、JVM的版本信息 -->
<Listener className="org.apache.catalina.startup.VersionLoggerListener" />
<!-- Security listener. Documentation at /docs/config/listeners.html
<Listener className="org.apache.catalina.security.SecurityListener" />
-->
<!--APR library loader. Documentation at /docs/apr.html -->
<!-- 加载(服务器启动) 和 销毁 (服务器停⽌) APR。 如果找不到APR库, 则会输出⽇志, 并不影响 Tomcat启动 -->
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
<!-- Prevent memory leaks due to use of particular java/javax APIs-->
<!-- 避免JRE内存泄漏问题 -->
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<!-- 加载(服务器启动) 和 销毁(服务器停⽌) 全局命名服务 -->
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<!-- 在Context停⽌时重建 Executor 池中的线程, 以避免ThreadLocal 相关的内存泄漏 -->
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
<!-- Global JNDI resources Documentation at /docs/jndi-resources-howto.html
GlobalNamingResources 中定义了全局命名服务
-->
<GlobalNamingResources>
<!-- Editable user database that can also be used by
UserDatabaseRealm to authenticate users
-->
<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>
<!-- A "Service" is a collection of one or more "Connectors" that share
a single "Container" Note: A "Service" is not itself a "Container",
so you may not define subcomponents such as "Valves" at this level.
Documentation at /docs/config/service.html
-->
<Service name="Catalina">
...
</Service>
</Server>
子标签:
Listener
- VersionLoggerListener(以⽇志形式输出服务器 、操作系统、JVM的版本信息)
- AprLifecycleListener (加载(服务器启动) 和 销毁 (服务器停⽌) APR。 如果找不到APR库, 则会输出⽇志, 并不影响 Tomcat启动)
- JreMemoryLeakPreventionListener (避免JRE内存泄漏问题)
- GlobalResourcesLifecycleListener (加载(服务器启动) 和 销毁(服务器停⽌) 全局命名服务)
- ThreadLocalLeakPreventionListener (在Context停⽌时重建 Executor 池中的线程, 以避免ThreadLocal 相关的内存泄漏)
GlobalNamingResources (中定义了全局命名服务)
Service (如下)
以上标签Listener
、GlobalNamingResources
一般情况下保持默认即可,不需要而外操作,重点在于Service 标签
三,Service 标签
<Service name="Catalina">
...
</Service>
该标签⽤于创建 Service 实例,默认使⽤ org.apache.catalina.core.StandardService
。 默认情况下,Tomcat 仅指定了Service 的名称, 值为 "Catalina"。
子标签:
- Listener (Listener ⽤于为Service添加⽣命周期监听器)
- Executor (⽤于配置Service 共享线程池,给Connector使用)
- Connector (⽤于配置Service 包含的链接器)
- Engine (⽤于配置Service中链接器对应的Servlet 容器引擎)
四,Executor 标签
用来定义共享线程池的。
默认是被注释掉的,且属性不全。那么该如何使用呢?
默认情况下,Service 并未添加共享线程池配置。 如果我们想添加⼀个线程池, 可以在
<Executor name="commonThreadPool"
namePrefix="thread-exec-"
maxThreads="200"
minSpareThreads="100"
maxIdleTime="60000"
maxQueueSize="Integer.MAX_VALUE"
prestartminSpareThreads="false"
threadPriority="5"
className="org.apache.catalina.core.StandardThreadExecutor"/>
属性:
- name:线程池名称,⽤于 Connector中指定
- namePrefix:所创建的每个线程的名称前缀,⼀个单独的线程名称为 namePrefix+threadNumber
- maxThreads:池中最⼤线程数
- minSpareThreads:活跃线程数,也就是核⼼池线程数,这些线程不会被销毁,会⼀直存在
- maxIdleTime:线程空闲时间,超过该时间后,空闲线程会被销毁,默认值为6000(1分钟),单位 毫秒
- maxQueueSize:在被执⾏前最⼤线程排队数⽬,默认为Int的最⼤值,也就是⼴义的⽆限。除⾮特殊情况,这个值不需要更改,否则会有请求不会被处理的情况发⽣
- prestartminSpareThreads:启动线程池时是否启动 minSpareThreads部分线程。默认值为 false,即不启动
- threadPriority:线程池中线程优先级,默认值为5,值从1到10
- className:线程池实现类,未指定情况下,默认实现类为:
org.apache.catalina.core.StandardThreadExecutor
。如果想使⽤⾃定义线程池⾸先需要实现org.apache.catalina.Executor
接⼝
五,Connector标签
Connector 标签⽤于创建链接器实例默认情况下,server.xml
配置了两个链接器,⼀个⽀持HTTP协议,⼀个⽀持AJP协议,⼤多数情况下,我们并不需要新增链接器配置,只是根据需要对已有链接器进⾏优化。
<!--org.apache.coyote.http11.Http11NioProtocol , ⾮阻塞式 Java NIO 链接器-->
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
属性:
- port:端⼝号,Connector ⽤于创建服务端Socket 并进⾏监听, 以等待客户端请求链接。如果该属性设置 为0, Tomcat将会随机选择⼀个可⽤的端⼝号给当前Connector 使⽤
- protocol:当前Connector ⽀持的访问协议。 默认为 HTTP/1.1 , 并采⽤⾃动切换机制选择⼀个基于 JAVA NIO 的链接器或者基于本地APR的链接器(根据本地是否含有Tomcat的本地库判定)
- connectionTimeOut: Connector接收链接后的等待超时时间, 单位为毫秒。 -1 表示不超时。
- redirectPort: 当前Connector 不⽀持SSL请求, 接收到了⼀个请求, 并且也符合security-constraint 约束, 需要SSL传输,Catalina⾃动将请求重定向到指定的端⼝。比如说:如果访问的是8080端口,然后它发现是一个https的请求,那么他就会转发到8443端口,当然也可以直接访问8443端口
- executor: 指定共享线程池的名称(就是Executor标签的name属性), 也可以通过
maxThreads
、minSpareThreads
等属性配置内部线程池。 - URIEncoding: ⽤于指定编码URI的字符编码, Tomcat8.x版本默认的编码为 UTF-8 , Tomcat7.x版本默认为ISO8859-1
可以使用共享线程池:
<Connector port="8080"
protocol="HTTP/1.1"
executor="commonThreadPool"
maxThreads="1000"
minSpareThreads="100"
acceptCount="1000" //往往和maxThreads保持一致
maxConnections="1000" //往往和maxThreads保持一致
connectionTimeout="20000"
compression="on" //要不要启动gzip压缩
compressionMinSize="2048" //压缩处理的最小大小,超过此大小才压缩
disableUploadTimeout="true" //单独的给servlet放宽超时时间
redirectPort="8443"
URIEncoding="UTF-8" />
六,Engine标签
Engine 表示 Servlet 引擎
<Engine name="Catalina" defaultHost="localhost">
...
</Engine>
属性:
- name:⽤于指定Engine 的名称, 默认为Catalina
- defaultHost:默认使⽤的虚拟主机名称, 当客户端请求指向的主机⽆效时, 将交由默认的虚拟主机处理, 默认为localhost
子标签:
- Cluster:集群方面的标签
- Realm:验证安全的标签
- Host:⽤于配置⼀个虚拟主机
七,Host标签
<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
...
</Host>
标签属性:
- appBase:这个网站的程序存放的位置,可以是绝对路径也可以是相对路径。webapps就是相对路径,在tomcat的根目录下
- unpackWARs:默认为true,把war包解压成文件夹
- autoDeploy:自动部署,当资源变更时自动部署,类似于热部署
子标签:
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log" suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
当请求来临时,日志存放起来,
- 存放在
directory
值的目录 - prefix:日志文件前缀
- suffix:日志文件后缀
- pattern:打印的日志格式
启动Tomcat 浏览器输入:http://localhost:8080
<Host name="localhost" appBase="webapps"
unpackWARs="true" autoDeploy="true">
hostname是localhost,appBase是webapps,去webapps文件夹下找应用程序文件夹,没有指定,默认就去ROOT文件夹下:
我们来做个实验:
- 把host标签复制一份,两个host标签的name分别为
www.abc.com
,www.def.com
。appBase分别为webapps
、webapps2
- 进入Tomcat根目录,把webapps拷贝一份到根目录,命名为webapps2
- 为了方便区分,把webapps2/ROOT/index.jsp 中的Home改为Home-webapps2
- 重新启动Tomcat
- 配置hosts文件
- 访问浏览器http://localhost:8080、 http://www.abc.com和http😕/www.def.com
- 可以看到:
可以看到localhost:8080访问不到了,因为这个虚拟主机被我们修改了
而abc和def均可以找到。同时def.com的Home也被修改为Home-webapps2了。
八,Context标签
用于配置一个Web应用——一个虚拟主机下可以配置多个应用
<Host name="www.abc.com" appBase="webapps" unpackWARs="true"
autoDeploy="true">
<!--
docBase:Web应⽤⽬录或者War包的部署路径。可以是绝对路径,也可以是相对于 Host appBase的
相对路径。
path:Web应⽤的Context 路径。如果我们Host名为localhost, 则该web应⽤访问的根路径为:
http://localhost:8080/web_demo。
-->
<Context docBase="E://dengxhh" path="/dengxh"></Context>
<Valve className="org.apache.catalina.valves.AccessLogValve"
directory="logs"
prefix="localhost_access_log" suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
</Host>
为了方便演示,我们就拿ROOT中的程序做例子,把webapps中的ROOT文件夹复制到E盘根目录,取名为dengxhh
在Host标签中,增加
<Context docBase="E://dengxhh" path="/dengxh"></Context>
重启Tomcat,访问www.abc.com/dengxh/ ,成功跳转了。
如此操作就可以在一个虚拟主机中,配置多个应用,只需要在host标签中配置多个Context标签,区分的时候只需要在虚拟主机后跟上Context的path属性的值即可找到对应的资源。
例如:Host name="www.abc.com" ,Context path ="dengxh" ,那么浏览器中输入 www.abc.com/dengxh
即可。
总结:
思维导图在线观看地址:https://www.processon.com/view/link/5fe4da565653bb054783ca6e