23.APR/Native

Apache Portable Runtime (APR) based Native library for Tomcat

Table of Contents

• Introduction
• Installation
  1. Windows
  2. Linux
• APR Components
• APR Lifecycle Listener Configuration
• APR Connectors Configuration
  1. HTTP/HTTPS
  2. AJP

Introduction

Tomcat可以用APR提供更高性能，更高的扩展性，更好的本地服务器端机制。APR是一个高性能的库，其使用在HTTP Server 2.x中。对于APR有很多的用法，其中包括高级IO特性（如sendfile，epoll，openssl），操作系统层级的机制（随机数的生成，系统状态查看等等），还有本地进程IPC机制（共享内存，pipeline，基于Unix的套接字编程）。

这些特性可以让Tomcat变成一个更加通用的webserver，有更好的与本地的native资源集成，利用java语言变成更加成熟可靠的webserver平台。

Installation

APR 需要下面的三个native组件安装：

• APR库
• 对APR的包装tomcat-native (libtcnative)
• OpenSSL库

Windows

Windows的二进制库为tcnative-1，这个直接被编译成.dll文件，这个dll文件中包含openssl和APR。你可以从 here下载到32位和AMDx86-64位的版本。

（一个dll全部包含）

在一些安全的场景中，建议使用分开的openssl，APR，libtcnative-1，并且根据适当的版本进行更新。

windows的openssl库的位置在 Official OpenSSL website。

Linux

大多数的Linux发行版都带了APR和Openssl。JNI的包装（libtcnative，实际上就是tomcat-native）也同样需要被编译。

要求:

• APR 1.2+ development headers (libapr1-dev package)
• OpenSSL 1.0.2+ development headers (libssl-dev package)
• JNI headers from Java compatible JDK 1.4+
• GNU development environment (gcc, make)

tomcat-native的源码在Tomcat的二进制的包中, in the bin/tomcat-native.tar.gz archive. 环境变量需要进行安装(from the folder containing the configure script):

./configure && make && make install

APR Components

一旦库被正确进行安装了，并且可以提供给java进行使用（如果失败了，Library的路径会被提示出来），Tomcat的连接器会自动的使用APR。配置APR的连接器就像配置其他的连接器一样简单，只需一些属性配置。

当APR启动后，下面的特性会加入到Tomcat中:

• 操作系统级别提供的安全的SessionID
• 操作系统层级的内存管理，cpu利用率，可以在Tomcat的status的Servlet中监控出来

APR Lifecycle Listener Configuration

See the listener configuration.

APR Connectors Configuration

HTTP/HTTPS

For HTTP configuration, see the HTTP connector configuration documentation.

For HTTPS configuration, see the HTTPS connector configuration documentation.

An example SSL Connector declaration is:

<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" />

AJP

For AJP configuration, see the AJP connector configuration documentation.

来源： http://tomcat.apache.org/tomcat-8.5-doc/apr.html

来自为知笔记(Wiz)