server.xml文件详解

一、server.xml文件介绍

1.server.xml作用
    Server.xml配置文件用于对整个容器进行相关的配置。
2.server.xml文件的配置元素列表
  1. <Server>:是整个配置文件的根元素。表示整个Catalina容器。
  2. <Connector>:连接器,负责接收客户的请求,以及向客户端回送响应的消息。
  3. <Engine>:为特定的Service处理所有的请示。每个Service只能包含一个Engine元素,它负责接收和处理此Service所有的连接器收到的请求,向连接发回响应,并最终显示在客户端。<Engine>至少有一个<Host>元素,必须至少有一个<Host>属性的名字与defaultHost指定的名字相匹配。
  4. <Host>:表示一个虚拟主机,为特定的虚拟主机处理所有请求
  5. <context>:一个WEB应用程序,处理当前WEB应用程序的所有请求,每一个<Context>必须使用唯一的上下文路径。
  6. <Logger>:表示日志,调试和错误信息。
  7. <Realm>:表示存放用户名,密码及role 的数据库。
  8. <Valve>:功能与Logger 差不多,其prefix 和suffix 属性解释和Logger 中的一样。

二、server.xml配置元素详解

1.<Server>元素
    作用:是整个配置文件的根元素。表示整个Catalina容器。
    属性:
        className:实现了org.apache.catalina.Server接口的类名,标准实现类是org.apache.catalina.core.StandardServer类。
        Port:Tomcat服务器监听用于关闭Tomcat服务器的命令(必须)
        Shutdown:发送到端口上用于关闭Tomcat服务器的命令。
    示例:<Server port ="8005" shutdown ="SHUTDOWN" />
2.<Connector>元素
    作用:连接器,负责接收客户的请求,以及向客户端回送响应的消息。
    HTTP连接器:
    属性:
        allowTrace:是否允许HTTP的TRACE方法,默认为false
        emptySessionPath:如果设置为true,用户的所有路径都将设置为/,默认为false。
        enableLookups:调用request、getRemoteHost()执行DNS查询,以返回远程主机的主机名,如果设置为false,则直接返回IP地址。
        maxPostSize:指定POST方式请求的最大量,没有指定默认为2097152。
        protocol:值必须为HTTP1.1,如果使用AJP处理器,该值必须为AJP/1.3
        proxyName:如这个连接器正在一个代理配置中被使用,指定这个属性,在request.getServerName()时返回
        redirectPort:如连接器不支持SSL请求,如收到SSL请求,Catalina容器将会自动重定向指定的端口号,让其进行处理。
        scheme:设置协议的名字,在request.getScheme()时返回,SSL连接器设为”https”,默认为”http”
        secure:在SSL连接器可将其设置为true,默认为false
        URIEncoding:用于解码URL的字符编码,没有指定默认值为ISO-8859-1
        useBodyEncodingForURI:主要用于Tomcat4.1.x中,指示是否使用在contentType中指定的编码来取代URIEncoding,用于解码URI查询参数,默认为false
        xpoweredBy:为true时,Tomcat使用规范建议的报头表明支持Servlet的规范版本,默认为false
        acceptCount:当所有的可能处理的线程都正在使用时,在队列中排队请求的最大数目。当队列已满,任何接收到的请求都会被拒绝,默认值为10
        bufferSize:设由连接器创建输入流缓冲区的大小,以字节为单位。默认情况下,缓存区大的大小为2048字节
        compressableMimeType:MIME的列表,默认以逗号分隔。默认值是text/html,text/xml,text/plain
        compression:指定是否对响应的数据进行压缩。off:表示禁止压缩、on:表示允许压缩(文本将被压缩)、force:表示所有情况下都进行压缩,默认值为off
        connectionTimeout:设置连接的超时值,以毫秒为单位。默认值为60000=60秒
        disableUploadTimeOut:允许Servlet容器,正在执行使用一个较长的连接超时值,以使Servlet有较长的时间来完成它的执行,默认值为false
        maxHttpHeaderSize:HTTP请求和响应头的最大量,以字节为单位,默认值为4096字节
        maxKeepAliveRequest:服务器关闭之前,客户端发送的流水线最大数目。默认值为100
        maxSpareThreads:允许存在空闲线程的最大数目,默认值为50
        minSpareThreads:设当连接器第一次启协创建线程的数目,确保至少有这么多的空闲线程可用。默认值为4
        port:服务端套接字监听的TCP端口号,默认值为8080(必须)
        socketBuffer:设Socket输出缓冲区的大小(以字节为单位),-1表示禁止缓冲,默认值为9000字节
        toNoDelay:为true时,可以提高性能。默认值为true
        threadPriority:设JVM中请求处理线程优先级。默认值为NORMAL-PRIORITY
    示例:
  1. <Connector port="8080"
  2. maxHttpHeaderSize="8192"
  3. maxThreads="150"
  4. minSpareThreads="25"
  5. maxSpareThreads="75"
  6. enableLookups="false"
  7. redirectPort="8443"
  8. acceptCount="100"
  9. connectionTimeout="20000"
  10. disableUploadTimeout="true"/>

    AJP连接器:用于将Apache与Tomcat集成在一起,当Apache接收到动态内容请求时,通过在配置中指定的端口号将请求发送给在此端口号上监听的AJP连接器组件。
    属性:
        backlog:当所有可能的请求处理线程都在使用时,队列中排队的请求最大数目。默认为10,当队列已满,任何请求都将被拒绝
        maxSpareThread:允许存在空闲线程的最大数目,默认值为50
        maxThread:最大线程数,默认值为200
        minSpareThreads:设当连接器第一次启动时创建线程的数目,确保至少有这么多的空闲线程可用,默认值为4
        port:服务端套接字的TCP端口号,默认值为8089(必须)
        topNoDelay:为true时,可以提高性能,默认值为true
        soTimeout:超时值
    示例:
  1. <Connector port="8089"
  2. enableLookups="false"
  3. redirectPort="8443"
  4. protocol="AJP/1.3"/>
3.<Engine>元素
    作用:为特定的Service处理所有的请示。每个Service只能包含一个Engine元素,它负责接收和处理此Service所有的连接器收到的请求,向连接发回响应,并最终显示在客户端。<Engine>至少有一个<Host>元素,必须至少有一个<Host>属性的名字与defaultHost指定的名字相匹配。
    属性:
        className:实现org.apache.catalina.Engine接口,默认实现类为org.apache.catalina.core.StandardEngine类
        defaultHost:默认主机名,值必须与<Service>的name值相匹配
        name:指定Engine的逻辑名字(必须)
        jvmRoute:在负载匀衡中使用的标识符,必须唯一
    示例:
  1. <Engine name="Cataline" defaultHost="localhst"/>
4.<Host>元素
    作用:表示一个虚拟主机,为特定的虚拟主机处理所有请求
    属性:
        appBase:设定应用程序的基目录,绝对路径或相对于%CATALINA_HOME%的路径名
        autoDeploy:指示Tomcat运行时,如有新的WEB程序加开appBase指定的目录下,是否为自动布署,默认值为true
        className:实现了org.apache.catalina.Host接口的类,标准实现类为org.apache.catalina.core.StandardHost类
        deployOnStartup:Tomcat启动时,是否自动部署appBase属性指定目录下所有的WEB应用程序,默认值为true
        name:虚拟主机的网络名(必须)
    标准Host实现类org.apahce.catalina.core.StandardHost支持的附加属性:
        deployXML:为false将不会解析WEB应用程序内部的context.xml,默认值为true
        unPackWARs:虚拟主机指定临时读写使用的目录的路径名,不设,Tomcat会在%CATALINA_HOME%/work目录下提供一个合适的目录。
    示例:
  1. <Host name="localhst"
  2. appBase="webapps"
  3. unpackWARs="true"
  4. autoDeploy="true"
  5. xmlValidation="false"
  6. xmlNamespaceAware="false">
    配置虚拟主机:
  1. <Hostname="xxx" appBase="c:/test">
  2. <Contentpath="xxx" docBase="e:/abe"/>
  3. </Hostname>
5.<context>元素
    作用:一个WEB应用程序,处理当前WEB应用程序的所有请求,每一个<Context>必须使用唯一的上下文路径。
    属性:
        className:实现了org.apache.catalina.Context接口的类,标准实现类org.apache.catalina.core.StandardContext类
        cookies:是否将Cookie应用于Session,默认值为true
        crossContext:是否允许跨域访问,为true时,在程序内调用ServletContext.getContext()方法将返回一个虚拟主机上其它web程序的请求调度器。默认值为false,调 径用getContext()返回为null
        docBase:绝对路径或相对于Host的appBase 属性的相对路径
        privileged:为true,允许Web应用程序使用容器的Servlet
        path:指定上下文路径。一个虚拟主机中,上下文路径必须唯一
        reloadable:为true,Tomcat运行时,如果WEB-INF/classes和WEB-INF/lib目录中有改变,Tomcat会自动重新加载该WEB应用程序。虽方便,但开销也大,默认值为false,我们在调用可以打开,发布后再关闭。
        cacheMaxSize:静态资源缓存最大值,以KB为单位,默认值为10240KB
        cachingAllowed:是否允许静态资源缓存,默认为true
        caseSensitive:默认为true,资源文件名大小写敏感,如果为false大小写不敏感
        unpackWAR:默认为true
        workDir:为WEB应用程序内部的Servlet指定临时读写的目录路径名。如没有设置,则Tomcat会在%CATALINA_HOME%/work目录下提供一个合适的目录
    示例:
  1. <Content path="/abc" docBase="d:/xyz" reloadable="true"/>
-------------------------------------------------------------------------------------------------------------------------------





文章来自:http://www.cnblogs.com/LiZhiW/p/4314033.html
© 2021 jiaocheng.bubufx.com  联系我们
ICP备案:鲁ICP备09046678号-3