[bigdata-116] tomcat官网文档-翻译-不完整

1. 官网地址
http://tomcat.apache.org/tomcat-8.5-doc/index.html


2. 介绍
$CATALINA_HOME  这个目录就是tomcat的安装目录
$CATALINA_BASE是一个目录，这个目录是每一个实例的安装目录




3. 在linux下安装和启动
http://tomcat.apache.org/tomcat-8.5-doc/RUNNING.txt


3.1 需要安装jre7或者更高


3.2 配置环境变量
tomcat是java程序，不需要环境变量。tomcat的启动脚本需要环境变量。
需要配置如下环境变量：
3.2.1 CATALINA_HOME:tomcat的安装目录
3.2.2 CATALINA_BASE:这个环境变量指定了"active configuration"的tomcat的根目录，默认情况下等于CATLINA_HOME。
对tomcat，分开使用CATALINA_HOME和CATALINA_BASE，便于简化升级和维护。
3.2.3 JAVA_HOME或者JRE_HOME：这是jdk或者jre的安装目录
3.2.4 CATALINA_OPTS：很少使用，这是起停tomcat和其他命令的附加参数。
3.2.5 CATALINA_PID:这个是tomcat的pid文件所在位置


3.3 setenv脚本
除了CATALINA_HOME和CATALINA_BASE，所有环境变量都由setenv脚本指定。


3.4 启动tomcat
$CATALINA_HOME/bin/startup.sh
$CATALINA_HOME/bin/catalina.sh start
启动后，tomcat默认的web服务位于 http://localhost:8080


3.5 关闭tomcat
$CATALINA_HOME/bin/shutdwon.sh
$CATALINA_HOME/bin/catalina.sh stop


3.6 多tomcat实例配置
通常，在机器上有一个tomcat二进制安装包，但多个用户可以使用--使用方式是，设置CATALINA_BASE。
如果同时配置CATALINA_HOME和CATALINA_BASE，这两个目录下的内容分别如下
CATALINA_BASE目录下有bin,conf,lib,logs,webapps,work,temp
CATALINA_HOME目录下有bin和lib目录
注意：
3.6.1 CALTALINA_BASE/lib和CATALINA_HOME/lib下的jar都会被加入到classpath，但CATALINA_BASE的是先加入且先被搜索。行规是：CATALINA_HOME/lib下放tomcat的标准库，CATALINA_BASE/lib放各种第三方库比如数据库驱动。但是，最好的建议是，不要在不同的web应用下共享各种jar包，而是要把它们分别放在WEB-INF/lib目录下。
3.6.2 CATALINA_BASE/bin目录，只有setenv.sh和tomcat-juli.jar这两个文件，但CATALINA_HOME/bin下面有各种起停脚本文件，如果CATALINA_BASE/bin目录下没有setenv.sh和tomcat-juli.jar这两个文件，就使用CATALINA_HOME/bin下的这两个文件。
3.6.3 CATALINA_HOME和CATALINA_BASE可以在xml里配置读取。




3.7 注意事项
在单例tomcat上，只有两个事情可能会出错：
3.7.1 tomcat默认端口是8080，如果两个web应用的端口都是8080，那么会冲突，需要修改$CATALINA_HOME/conf/server.xml
3.7.2 'localhost'机器找不到，这里要检查代理，可能是因为你的服务器使用了代理。


3.8 可选组件
tomcat native libary和commons deamon service launcher。
新人可以不用考虑它们。






4. 第一个webapp
4.1 一个标准webapp的目录层次
*.html、*.jsp等，html和jsp页面，需要放在不同的目录里，如果是小项目，放在同一个目录也可以。
/WEB-INF/web.xml，web应用部署描述 web application deployment descriptor，这个文件描述servlet和其他组件，这些组件组成应用。包括初始化参数，以及容器安全管理等等。
/WEB-INF/classes/，应用所需的所有java类都在这里，包括serverlet和非servelet，都会打包成jar文件，
/WEB-INF/lib，第三方jar放在这里。


4.2 如何部署
4.2.1 将未打包的文件直接copy到$CATALINA_BASE/webappps，tomcat会自动启动这个web服务。我们可以使用build.xml下使用这个技术，因为这个是最快最容易的部署方式。


4.2.2 把jar包文件放到$CATALINA_BASE/webapps，tomcat启动后，会自动将jar包解压缩展开，然后执行应用。注意，如果你用这种方法更新web应用，需要同时删除jar文件和展开的目录，然后再重启tomcat。


4.2.3 如果使用tomcate的管理功能，也就是tomcat的/manager，你可以部署和删除应用且不需要重启。


4.2.4 还有一个就是，tomcat热部署，有若干中解决方案。


4.3 一个基于ant的第一个webapp
4.3.1 目录结构
docs/ 文档
src/ java源码
web/ 静态的文件，比如html, jsp, javascript, css, images
web/WEB-INF web应用所需的特定的配置文件，包括web.xml。
在构建过程里，又会有如下两个目录
build/ 这个目录饱含webapp的所有东西
dist/ 执行ant dist会创建webapp所有东西，好扩license信息，文档，readme文件。




4.4 部署
将sample.war扔到webapps里，几秒内自动解压缩生效，可以在浏览器里看到url和对应页面; 如果删除sample.war，几秒后sample/目录也被自动删除;如果更新war包，同理。




5. 部署器deployer
5.1 tomcat manager是交互式/可编程的webapp部署和管理的java应用
http://tomcat.apache.org/tomcat-8.5-doc/manager-howto.html
此外，tomcat maven plugin也提供了许多非常方便的工具，http://tomcat.apache.org/maven-plugin.html。


5.2 webapp的静态部署没有安装需求，tomcat manager也没有任何安装需求但需要做一些配置。Tomcat client deployer(TCD)是需要安装的，具体参考这里http://tomcat.apache.org/tomcat-8.5-doc/deployer-howto.html#Deploying_using_the_Client_Deployer_Package。


5.3 context
关于webapp，有个context的概念，一个context就是tomcat称之为webapp的东西。用context descriptor配置context。一个context descriptor是一个xml文件，有各种配置，比如naming resources, session manager等等。早期，context descrptor放置在server.xml文件，但现在不鼓励这种做法。tomcate manager和tcd也引用context descriptor的配置参数。这个文件在 
$CATALINA_BASE/conf/[enginename]/[hostname]/[webappname].xml
$CATALINA_BASE/webapps/[webappname]/META-INF/context.xml


5.4 启动的tomcat时的部署
appbase，就是部署webapp的目录，默认的appbase是$CATALINA_BASE/webapps。在部署顺序上，优先级如下：
每个Context Descriptor最先部署;
每个展开的webapp被部署，这些webapp是没有被任何context descriptor引用。如果它们有一个关联的war文件，且这个war文件比它们的版本新，那么这个展开的webapp会被删除，然后部署新的基于这个war文件的应用;
每个war文件。


5.5 正在运行的tomcat的部署
如果autoDeploy的属性是true，那么它就会自动动态部署所有的被更新的webapp。这里分好几种情况，不过只需要记住war可以自动更新部署就行，其他细节用的比较少。


5.6 tomcat manger部署


5.7 tcd部署




6. manager
这里主要描述tomcat manager的使用


7. realms and AAA
这里主要是配置tomcat支持容器管理安全container managed security，基于数据库的用户/密码/用户角色管理。只有，你的webapp使用到了一个或者多个 <security-constraint>元素或者<login-config>元素才需要了解这一章，否则不需要看。




8. JNDI 资源（主要是各种xml文件配置）
tomcat提供一个jndi的initialContext初始上下文实现实例，每个webapp都在initialContext下运行。jndi兼容于java企业版应用服务器。


8.1 web.xml配置
<env-entry> 环境变量
<resource-ref> 资源索引，比如jdbc数据源，比如javamail的session。
<resource-env-ref> 新版的<resource-ref>


8.2 context.xml配置
tomcat指定的资源配置，在$CATALINA_BASE/conf/server.xml 或者 META-INF/context.xml的 <context>元素。在<context>有如下元素：
<Environment>环境变量
<Resource>资源文件
<ResourceLink>给资源文件增加一个link
<Transction> 事务
<GlobalNamingResoures>全局配置




8.3 如何使用资源
java代码
-----------------------
// Obtain our environment naming context
Context initCtx = new InitialContext();
Context envCtx = (Context) initCtx.lookup("java:comp/env");


// Look up our data source
DataSource ds = (DataSource)envCtx.lookup("jdbc/EmployeeDB");


// Allocate and use a connection from the pool
Connection conn = ds.getConnection();
... use this connection to access the database ...
conn.close();
-----------------------


8.4 tomcat标准资源factories
有诸多自定义的标准资源
generic javabean resources:


8.4.1 resource factory可以创建任意的java class。这里给出一个创建javabean的例子。
8.4.2 数据库账户用户名和密码关系，这个xml文件也在tomcat-users.xml里




9. jdbc datasrouces--JNDI Datasource HOW-TO
包括oracle，mysql, db2, postgre等等。
这一块，貌似不需要在这里配置了，直接在应用里配置更简单




10. Class Loader类加载器
tomcat的父子类加载器如下
   Bootstrap
          |
       System
          |
       Common
       /     \
  Webapp1   Webapp2 ...


每个类加载器，加载不同部位的类。






11. jasper 2 jsp 引擎
这个东东是必需的。
jasper2有如下特性：
jsp custom tag pooling,这个jsp custom tags可以池化和重用。
background jsp compliation,如果jsp页面发生变化，可以在background自动重编译。
recompile jsp when included page changes, 重编译jsp
jdt-eclipse的jsp的编译插件


12. ssl/tsl配置


13. ssi


14. cgi


15. proxy support


16. MBeans descriptors


17.default servlet
 


18. clustering
tomcat集群，主要是通过session进行all-to-all复制进行的。


19. load balancer
这块不用考虑


20. connectors连接器
http和ajp，不知道是什么作用


21. Monitoring and Managing监控和管理
如果需要jmx，需要设置参数。
这里有一个具体的例子，用jmx监控tomcat
http://www.cnblogs.com/dongguacai/p/5900507.html
http://www.open-open.com/lib/view/open1397359125465.html




22. Logging
主要配置在${catalina.base}/conf/logging.properties
如果不可用则 ${java.home}/lib/logging.properties 
对webapp而言，是WEB-INF/classes/logging.properties


23. Apache Portable Runtime (APR) based Native library for Tomcat
主要是用本地代码提升性能。


24. virtual hosting
虚拟主机。这里是配置虚拟主机。如果有两个hostname，也就是ren和stimpy，如何配置。
server.xml文件，配置engine，如下:
<Engine name="Catalina" defaultHost="ren">
    <Host name="ren"    appBase="renapps"/>
    <Host name="stimpy" appBase="stimpyapps"/>
</Engine>
然后再创建webapps目录
mkdir $CATALINA_HOME/renapps
mkdir $CATALINA_HOME/stimpyapps


25. advanced io
异步写静态文件，可以暂时不用考虑。


26. additional components
暂时不用考虑


27. mavenized
可以在tomcat里引用maven


28. Security Considerations
安全问题。
28.1 首先，操作系统，网络，数据库等，这些非tomcat要安全
28.2 不要使用root帐号运行tomcat。要使用那些无法远程登录的账户启动tomcat。要设定tomcat各种文件的读写权限。
28.3 网络有防火墙设定。
如此等等






29. windows service
不用考虑


30. windows authenticaion
不用考虑


31. The Tomcat JDBC Connection Pool
jdbc连接池有多种选择。大型的web应用服务weblogic和websphere都提供连接池机制。tomcat也提供连接池。
连接池对象，可以在代码实例化配置参数，也可以在xml里配置，建议在xml里配置，这样代码最少。
在连接池里也可以配置拦截器interceptors


32. websocket
是一堆参数配置


33. Rewrite valve
这个功能类似apache的mod_rewrite功能。
rewrite valve可以配置在host的，也就是rewrite.config，配置方式在http://tomcat.apache.org/tomcat-8.5-doc/config/host.html。
也可以配置在webapp的context.xml文件，valve配置的rewrite.config文件，在WEB-INF目录。
rewrite.conf文件，包含一系列的待重写的目录directives


RewriteCond TestString CondPattern


举例，根据user agent，向用户返回不同的页面：
RewriteCond  %{HTTP_USER_AGENT}  ^Mozilla.*
RewriteRule  ^/$                 /homepage.max.html  [L]
RewriteCond  %{HTTP_USER_AGENT}  ^Lynx.*
RewriteRule  ^/$                 /homepage.min.html  [L]
RewriteRule  ^/$                 /homepage.std.html  [L]