Tomcat 源码学习 之 AprLifecycleListener

李斯特

　　

类名	org.apache.catalina.core.AprLifecycleListener
继承关系	LifecycleListener
关联类	org.apache.tomcat.jni.Library org.apache.tomcat.jni.SSL
实现功能	检查是否具有 APR/native 库，如果有则将其加载

 
 
 
 
分析
 
在StandardServer一节的学习中，我们遗漏了一个很重要的部分没有提及。那就是加载LifecycleListener。我们已经知道，继承LifecycleListener接口的类可以用来监听component的状态变化。 当StandardServer被初始化时，有一系列的标准LifecycleListener被加载并监听StandardServer的变化（这些Listener被定义在server.xml文件的Server标签下）。接下来的一系列博文中，我们会逐一介绍这些Listener。 
 
APR/native
除了提供正常的web server服务（HTTP，File I/O, etc.）， Tomcat还提供了一种称之为 Apache Portable Runtime的组件为web应用提供高可扩展性，高性能以及更好的与本地服务技术整合的功能。Tomcat的文档中提到了几种典型的功能，比如sendfile，epoll和OpenSSL等高级IO功能。OS级别的功能如随机数的产生，系统状态等等。
 
 想要使用APR/native支持，以下组件需要被安装：
1. APR library
2. Tomcat 使用APR所需的JNI wapper类
3. OpenSSL libraries
 
一旦这些组件被安装并可用，Tomcat的Connector就会自动的使用APR，这里最值得关注的就是SSL的配置，我们接下来会大概的提到。详细的内容会在Connector中具体描述。
 
　　
APR Lifecycle Listener配置
　　APRLifecycleListener的配置项很简单，className属性配置其full name。 SSLEngine属性配置是否使用SSL，默认选项是on：

<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
　　在Connector中，只要配置SSLEnabled为true即可，当然还有其它配置项需要关心，在这里我们不过度深入。

<Connector port="443" maxHttpHeaderSize="8192"
maxThreads="150"
enableLookups="false" disableUploadTimeout="true"
acceptCount="100" scheme="https" secure="true"
SSLEnabled="true"
SSLCertificateFile="${catalina.base}/conf/localhost.crt"
SSLCertificateKeyFile="${catalina.base}/conf/localhost.key" />
　　lifecycleEvent方法
　　AprLifecycleListener类的核心方法是lifecycleEvent，当StandardServer的状态发生改变时，该方法被触发：
　　1. eventType == BEFORE_INIT
　　a. 初始化并加载org.apache.tomcat.jni.Library, 即APR native Library的jni wrapper。
　　b. 初始化并加载org.apache.tomcat.jni.SSL, 即SSL的jni wrapper。
　　2. eventType == AFTER_DESTROY
　　a. 终止org.apache.tomcat.jni.Library
　　b. 终止org.apache.tomcat.jni.SSL
　　org.apache.tomcat.jni.Library 和 SSL 属于jni的部分了，不在本文讨论之列。