0%

tomcat之server配置文件

server.xml配置文件

Server节点

Server节点是server.xml的根元素,用于创建Server实例

属性

  • port 端口
  • shutdown 关闭服务器的指令字符串

子节点

内嵌子元素为Service、GlobalNamingResources和Listener

GlobalNamingResources定义了全局的命名服务

Listener用于为Server添加生命周期监听器

Service节点

用于创建Service实例

默认情况下,tomcat仅指定了Service的名称,值为Catalina

子节点

子节点为Listener、Executor、Connector、Engine

Executor用于配置Service共享线程池

Connector用于配置Service包含的链接器

Engine用于配置Service中链接器对应的Servlet容器引擎

Executor节点

默认没有配置共享线程池

1
2
<Executor name="tomcatThreadPool" namePrefix="catalina-exec-"
maxThreads="150" minSpareThreads="4"/>

属性

  • name Executor名称,唯一
  • namePrefix 创建的线程名称前缀
  • maxThreads 线程池中活动现成的最大数目
  • minSpareThreads 备用线程的最小数量

Connector节点

默认配置了两个链接器,一个支持HTTP协议,一个支持AJP协议

1
2
3
4
<Connector port="8090" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

属性

  • port 端口号
  • protocol 当前Connector支持的访问协议
  • connectionTimeout 等待超时时间,-1表示不超时
  • redirectPort 如果当前Connector支持non-ssl请求,并且接收到有个请求,符合约束,需要SSL传输,Catalina自动将请求重定向到此处指定的端口
  • executor 线程池,指定线程池名称
  • acceptCount 最大接收链接数,用于控制Socket的排队链接的最大个数,大于acceptCount时,将拒绝新的链接请求
  • URIEncoding URI编码 默认为ISO-8859-1
  • GZIP压缩 compression设置为on表示开启压缩 compressableMimeType表示指定哪些类型的响应可以压缩 compressionMinSize指定响应内容大小的限制,当响应大于该值时,才会压缩 noCompressionUserAgent用于指定正则表达式,对于user-agent头信息匹配的HTTP请求不进行压缩
  • enableLookups true表示调用request.getRemoteHost()将执行DNS查询 false直接返回IP

Engine节点

子节点

Cluster、Listener、Realm、Value、Host

属性

  • name 指定Engine的名称,默认为Catalina
  • defaultHost 默认使用的虚拟主机名称,当客户端请求指向的主机无效时,将交由默认虚拟主机处理。默认localhost
  • jvmRoute 用于负载均衡场景下启用粘性会话,使得将来自于某个特定会话的请求定向到同一个Tomcat实例

Host节点

用于配置一个虚拟主机

子节点

Alias、Cluster、Listener、Value、Realm、Context

属性

  • name 当前Host通用的网络名称,必须与DNS服务器上的注册信息一致
  • appBase 当前Host的应用基础目录,默认为webapps
  • unpackWARs true表示Host在启动时会将appBase目录下的WAR包解压成目录 false直接从WAR文件中启动web应用
  • autoDeploy true表示tomcat将定期检查appBase和xmlBase目录,不熟新发现的web应用或者context描述文件

Context节点

用于配置web应用

子节点

CookieProcessor、Loader、Manager、Realm、Resources、WatchResource、JarScanner、Value

属性

  • docBase web应用目录或者WAR包的部署路径
  • path web应用的context路径

CookieProcessor节点

用于将HTTP请求中的cookie头信息转为javax.servlet.http.Cookie对象,或者将Cookie对象转为HTTP响应中的Cookie头信息

Loader节点

用于配置当前Context对应的web应用的类加载器,默认为org.apache.catalina.loader.WebappLoader

属性

  • delegate 控制类加载顺序 true表示采用标准的java委派模式加载类,先尝试从父类加载器加载,然后才会从web应用的类加载器加载 false先从web应用的类加载器加载,然后从父类加载器加载 默认false
  • reloadable true catalina监控WEB-INF/classes和WEB-INF/lib的变更,自动重新加载web应用
  • loaderClass 指定Loader创建的web应用类加载器的具体实现

Manager节点

用于配置当前web应用的会话管理器

tomcat提供了独立管理和集群管理两种方式

独立会话管理器

  • org.apache.catalina.session.StandardManager 简单的会话存储,在Tomcat正常停止时,会将所有会话串行化到一个文件(默认SESSION.ser),在Tomcat启动时,加载有效会话

  • org.apache.catalina.session.PersistentManager 在每次会话过期检测之后,将超过配置数量的活跃会话以及空闲会话持久化到文件或者数据库,即使tomcat强制关闭,也只会丢失没有持久化的会话

    包含两种会话持久化存储方案

    • org.apache.catalina.session.FileStore

      1
      2
      3
      4
      5
      6
      7
      8
      9
      <Context docBase="myApp" path="/myApp">
      <Manager className="org.apache.catalina.session.PersistentManager"
      saveOnRestart="true"
      maxActiveSession="-1"
      minIdleSwap="30"
      maxIdleBackup="0">
      <Store className="org.apache.catalina.session.FileStore" directory="sessions"></Store>
      </Manager>
      </Context>
  • org.apache.catalina.session.JDBCStore

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    <Context docBase="myApp" path="/myApp">
    <Manager className="org.apache.catalina.session.PersistentManager"
    saveOnRestart="true"
    maxActiveSession="-1"
    minIdleSwap="30"
    maxIdleBackup="0">
    <Store className="org.apache.catalina.session.JDBCStore"
    driverName="com.mysql.jdbc.Driver"
    connectionURL="jdbc:mysql://localhost:3306/demo?user=&password="
    sessionTable="session_table"
    sessionIdCol="id"
    sessionDataCol="data"
    sessionValidCol="valid"
    sessionMaxInactiveCol=""
    sessionLastAccessedCol=""
    sessionAppCol=""></Store>
    </Manager>
    </Context>