mod_jk(Apache+mod_jk+tomcat)配置全攻略

引用：http://blog.csdn.net/platformer/article/details/7175054

首先虽然这个mod_jk已经过时，但还是放出来大家一起学习一下，文章主要分三部分内容：

1.第一部分：说明主要配置过程

2.第二部分：贴出我的httpd.conf文件

3.第三部分：对mod_jk代码讲解(来源百度)

 

第一部分：配置

1.       准备环境：

操作系统：windows7

httpd-2.2.21-win32-x86-no_ssl.msi

apache-tomcat-6.0.7

apache-tomcat-5.0.7

tomcat-connectors-1.2.32-windows-i386-httpd-2.2.x

jdk1.5

2.       下载APACHE

这里下载的是APACHE2.2.21版本

3.       下载JK(Tomcat Connector)

Jk是apache和tomcat的连接器，也可以做负载均衡器，主要是apache通过jk找到tomcat。

下载地址：http://archive.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/windows/

Jk的版本要与apache的版本对应如：mod_jk-1.2.32-httpd-2.2.x.zip其匹配的Apache为2.2.版本以上可用

4.       下载TOMCAT

apache-tomcat-6.0.7.rar

5.       配置修改过程

1)  Apache配置

将Tomcat Connector文件mod_jk.so拷贝到Apache安装目录的modules目录下。

在Apache安装目录下找到conf/httpd.conf文件，使用文本编辑器打开：

伪静态修改

将注释放开

找到AllowOverride None 将其修改为 All 内容如下：

[html]  view plain copy print ?

1. <Directory />  
2.   
3.     Options FollowSymLinks  
4.   
5.     AllowOverride All  
6.   
7.     Order deny,allow  
8.   
9.     Deny from all  
10.   
11. </Directory>  

Tomcat Connector关联项增加

        在LoadModules末尾处增加一下内容：

[plain]  view plain copy print ?

1. #加载mod_jk连接  
2.   
3. LoadModule jk_module modules/mod_jk.so  
4.   
5. ### 配置 mod_jk  
6.   
7. JkWorkersFile "conf\workers.properties" #加载集群中的workers  
8.   
9. #此处是指定分配给tomcat的请求 例如*.do *.jsp  
10.   
11. JkMount /*.jsp controller  
12.   
13. JkLogFile logs/mod_jk.log #指定jk的日志输出文件   
14.   
15. JkLogLevel warn #指定日志级别  
16.   
17.     找到IfModule dir_module 修改默认访问地址，需要根据具体项目实际情况填写，我这里使用的是index.jsp 修改如下：  
18.   
19. <IfModule dir_module>  
20.   
21. DirectoryIndex index.jsp  
22.   
23. </IfModule>  
24.   
25.     找到Virtual hosts 去掉虚拟主机注释  
26.   
27. # Virtual hosts  
28.   
29. #Include conf/extra/httpd-vhosts.conf 将 “#”去掉  
30.   
31. Include conf/extra/httpd-vhosts.conf  
32.   
33. 加载代理(暂时未去掉)  
34.   
35. #LoadModule proxy_module modules/mod_proxy.so  
36.   
37. #LoadModule proxy_ajp_module modules/mod_proxy_ajp.so  
38.   
39. #LoadModule proxy_balancer_module modules/mod_proxy_balancer.so  
40.   
41. #LoadModule proxy_connect_module modules/mod_proxy_connect.so  
42.   
43. #LoadModule proxy_ftp_module modules/mod_proxy_ftp.so  

2)  Tomcat Connector配置

在Apache配置目录Apache2.2\conf创建workers.properties配置文件，该文件主要用于配置Apache与Tomcat的集成要用到的Tomcat实例和负载均衡分发控制器。

Workers.properties文件放置一下内容；

[plain]  view plain copy print ?

1. #下面是分发控制器 注意不要放tomcat实例  
2.   
3. worker.list=lbcontroller  
4.   
5.    
6.   
7. #Tomcat1实例配置 这里要和Tomcat配置文件Service.xml的jvmRoute保持一致  
8.   
9. worker.test1.host=localhost  
10.   
11. worker.test1.port=8009  
12.   
13. worker.test1.type=ajp13  
14.   
15. #分发权重 值越大负载越大  
16.   
17. worker.tomcat1.lbfactor=1  
18.   
19.    
20.   
21. #Tomcat2实例配置  
22.   
23. worker.test2.host=localhost  
24.   
25. worker.test2.port=9009  
26.   
27. worker.test2.type=ajp13  
28.   
29. #分发权重 值越大负载越大  
30.   
31. worker.tomcat2.lbfactor=1  
32.   
33.    
34.   
35. #负载均衡分发控制器  
36.   
37. worker.lbcontroller.type=lb  
38.   
39. worker.lbcontroller.balance_workers=test1,test2  

Tomcat配置文件Service.xml主要注意两个地方，一个是Engine节点需要增加节点标识jvmRoute，一个是将原本注释掉的Session复制节点改为有效。具体如下：

  

[html]  view plain copy print ?

1. <!--jvmRoute在各个Tomcat配置中不能重复且要与worker.properties文件中的名称一致-->  
2.   
3.     <Engine name="Catalina" defaultHost="localhost" jvmRoute="test1">  
4.   
5.    
6.   
7. <!--session复制内容-->  
8.   
9.        <Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"    
10.   
11.                  channelSendOptions="8">     
12.   
13.           <Manager className="org.apache.catalina.ha.session.DeltaManager"    
14.   
15.                    expireSessionsOnShutdown="false"    
16.   
17.                    notifyListenersOnReplication="true"/>     
18.   
19.     
20.   
21. <Channel className="org.apache.catalina.tribes.group.GroupChannel">     
22.   
23. <Membership className="org.apache.catalina.tribes.membership.McastService"    
24.   
25.                         address="228.0.0.4"    
26.   
27.                         port="45564"    
28.   
29.                         frequency="500"    
30.   
31.                         dropTime="3000"/>     
32.   
33. <Receiver className="org.apache.catalina.tribes.transport.nio.NioReceiver"    
34.   
35.                       address="auto"    
36.   
37.                       port="4000"    
38.   
39.                       autoBind="100"    
40.   
41.                       selectorTimeout="5000"    
42.   
43.                       maxThreads="6"/>     
44.   
45.             <!-- timeout="60000"-->     
46.   
47.             <Sender className="org.apache.catalina.tribes.transport.ReplicationTransmitter">     
48.   
49.               <Transport className="org.apache.catalina.tribes.transport.nio.PooledParallelSender" />     
50.   
51.             </Sender>     
52.   
53.             <Interceptor className="org.apache.catalina.tribes.group.interceptors.TcpFailureDetector"/>     
54.   
55.             <Interceptor className="org.apache.catalina.tribes.group.interceptors.MessageDispatch15Interceptor"/>     
56.   
57.             <Interceptor className="org.apache.catalina.tribes.group.interceptors.ThroughputInterceptor"/>     
58.   
59.           </Channel>     
60.   
61.           <!--过滤的文件-->  
62.   
63.           <Valve className="org.apache.catalina.ha.tcp.ReplicationValve"  filter=".*\.gif;.*\.js;.*\.jpg;.*\.png;.*\.htm;.*\.html;.*\.css;.*\.txt;"/>     
64.   
65.           <Valve className="org.apache.catalina.ha.session.JvmRouteBinderValve"/>     
66.   
67.     
68.   
69.           <Deployer className="org.apache.catalina.ha.deploy.FarmWarDeployer"    
70.   
71.                     tempDir="/tmp/war-temp/"    
72.   
73.                     deployDir="/tmp/war-deploy/"    
74.   
75.                     watchDir="/tmp/war-listen/"    
76.   
77.                     watchEnabled="false"/>     
78.   
79.           <ClusterListener className="org.apache.catalina.ha.session.JvmRouteSessionIDBinderListener"/>     
80.   
81.           <ClusterListener className="org.apache.catalina.ha.session.ClusterSessionListener"/>     
82.   
83.         </Cluster>  
84.   
85.       <!--session复制内容-->  

            <!—Host节点增加一下内容表示站点根路径-->

[html]  view plain copy print ?

1. <Context path="/sc" docBase="." privileged="true"/>                                                           

我们分别将两个Tomcat配置文件中的jvmRoute设置为tomcat1、tomcat2，Server节点 端口分别配置为8005和9005， Connector节点端口分别配置为8080和9090，AJPConnector端口分别配置为8009和9009，Connector端口配置参照单主机多站点场景。请注意两个Tomcat配置文件Host节点的域名配置必须一样，Server.xml中的jvmRoute名称必须和worker.properties中的tomcat实例名称一致，不然无法实现session_stricky。

 

[html]  view plain copy print ?

1. *****************************************************************************  
2.   
3.  如果需要实现session 复制 需要在Tomcat 下conf/web.xml 中加上<distributable/>  
4.   
5. <?xml version="1.0" encoding="ISO-8859-1"?>  
6.   
7. 省略N多代码。。。。。。  
8.   
9.     <welcome-file-list>  
10.   
11.         <welcome-file>index.html</welcome-file>  
12.   
13.         <welcome-file>index.htm</welcome-file>  
14.   
15.         <welcome-file>index.jsp</welcome-file>  
16.   
17.     </welcome-file-list>  
18.   
19. <distributable/>  
20.   
21. </web-app>  
22.   
23. *****************************************************************************  

第二部分：httpd.conf文件

[html]  view plain copy print ?

1.   

[html]  view plain copy print ?

1. #  
2. # This is the main Apache HTTP server configuration file.  It contains the  
3. # configuration directives that give the server its instructions.  
4. # See <URL:http://httpd.apache.org/docs/2.2> for detailed information.  
5. # In particular, see   
6. # <URL:http://httpd.apache.org/docs/2.2/mod/directives.html>  
7. # for a discussion of each configuration directive.  
8. #  
9. # Do NOT simply read the instructions in here without understanding  
10. # what they do.  They're here only as hints or reminders.  If you are unsure  
11. # consult the online docs. You have been warned.    
12. #  
13. # Configuration and logfile names: If the filenames you specify for many  
14. # of the server's control files begin with "/" (or "drive:/" for Win32), the  
15. # server will use that explicit path.  If the filenames do *not* begin  
16. # with "/", the value of ServerRoot is prepended -- so "logs/foo.log"  
17. # with ServerRoot set to "D:/Program Files/Apache Software Foundation/Apache2.2" will be interpreted by the  
18. # server as "D:/Program Files/Apache Software Foundation/Apache2.2/logs/foo.log".  
19. #  
20. # NOTE: Where filenames are specified, you must use forward slashes  
21. # instead of backslashes (e.g., "c:/apache" instead of "c:\apache").  
22. # If a drive letter is omitted, the drive on which httpd.exe is located  
23. # will be used by default.  It is recommended that you always supply  
24. # an explicit drive letter in absolute paths to avoid confusion.  
25.   
26. #  
27. # ServerRoot: The top of the directory tree under which the server's  
28. # configuration, error, and log files are kept.  
29. #  
30. # Do not add a slash at the end of the directory path.  If you point  
31. # ServerRoot at a non-local disk, be sure to point the LockFile directive  
32. # at a local disk.  If you wish to share the same ServerRoot for multiple  
33. # httpd daemons, you will need to change at least LockFile and PidFile.  
34. #  
35. ServerRoot "D:/Program Files/Apache Software Foundation/Apache2.2"  
36.   
37. #  
38. # Listen: Allows you to bind Apache to specific IP addresses and/or  
39. # ports, instead of the default. See also the <VirtualHost>  
40. # directive.  
41. #  
42. # Change this to Listen on specific IP addresses as shown below to   
43. # prevent Apache from glomming onto all bound IP addresses.  
44. #  
45. #Listen 12.34.56.78:80  
46. Listen 8080  
47.   
48. #  
49. # Dynamic Shared Object (DSO) Support  
50. #  
51. # To be able to use the functionality of a module which was built as a DSO you  
52. # have to place corresponding `LoadModule' lines at this location so the  
53. # directives contained in it are actually available _before_ they are used.  
54. # Statically compiled modules (those listed by `httpd -l') do not need  
55. # to be loaded here.  
56. #  
57. # Example:  
58. # LoadModule foo_module modules/mod_foo.so  
59. #  
60. LoadModule actions_module modules/mod_actions.so  
61. LoadModule alias_module modules/mod_alias.so  
62. LoadModule asis_module modules/mod_asis.so  
63. LoadModule auth_basic_module modules/mod_auth_basic.so  
64. #LoadModule auth_digest_module modules/mod_auth_digest.so  
65. #LoadModule authn_alias_module modules/mod_authn_alias.so  
66. #LoadModule authn_anon_module modules/mod_authn_anon.so  
67. #LoadModule authn_dbd_module modules/mod_authn_dbd.so  
68. #LoadModule authn_dbm_module modules/mod_authn_dbm.so  
69. LoadModule authn_default_module modules/mod_authn_default.so  
70. LoadModule authn_file_module modules/mod_authn_file.so  
71. #LoadModule authnz_ldap_module modules/mod_authnz_ldap.so  
72. #LoadModule authz_dbm_module modules/mod_authz_dbm.so  
73. LoadModule authz_default_module modules/mod_authz_default.so  
74. LoadModule authz_groupfile_module modules/mod_authz_groupfile.so  
75. LoadModule authz_host_module modules/mod_authz_host.so  
76. #LoadModule authz_owner_module modules/mod_authz_owner.so  
77. LoadModule authz_user_module modules/mod_authz_user.so  
78. LoadModule autoindex_module modules/mod_autoindex.so  
79. #LoadModule cache_module modules/mod_cache.so  
80. #LoadModule cern_meta_module modules/mod_cern_meta.so  
81. LoadModule cgi_module modules/mod_cgi.so  
82. #LoadModule charset_lite_module modules/mod_charset_lite.so  
83. #LoadModule dav_module modules/mod_dav.so  
84. #LoadModule dav_fs_module modules/mod_dav_fs.so  
85. #LoadModule dav_lock_module modules/mod_dav_lock.so  
86. #LoadModule dbd_module modules/mod_dbd.so  
87. #LoadModule deflate_module modules/mod_deflate.so  
88. LoadModule dir_module modules/mod_dir.so  
89. #LoadModule disk_cache_module modules/mod_disk_cache.so  
90. #LoadModule dumpio_module modules/mod_dumpio.so  
91. LoadModule env_module modules/mod_env.so  
92. #LoadModule expires_module modules/mod_expires.so  
93. #LoadModule ext_filter_module modules/mod_ext_filter.so  
94. #LoadModule file_cache_module modules/mod_file_cache.so  
95. #LoadModule filter_module modules/mod_filter.so  
96. #LoadModule headers_module modules/mod_headers.so  
97. #LoadModule ident_module modules/mod_ident.so  
98. #LoadModule imagemap_module modules/mod_imagemap.so  
99. LoadModule include_module modules/mod_include.so  
100. #LoadModule info_module modules/mod_info.so  
101. LoadModule isapi_module modules/mod_isapi.so  
102. #LoadModule ldap_module modules/mod_ldap.so  
103. #LoadModule logio_module modules/mod_logio.so  
104. LoadModule log_config_module modules/mod_log_config.so  
105. #LoadModule log_forensic_module modules/mod_log_forensic.so  
106. #LoadModule mem_cache_module modules/mod_mem_cache.so  
107. LoadModule mime_module modules/mod_mime.so  
108. #LoadModule mime_magic_module modules/mod_mime_magic.so  
109. LoadModule negotiation_module modules/mod_negotiation.so  
110. #LoadModule proxy_module modules/mod_proxy.so  
111. #LoadModule proxy_ajp_module modules/mod_proxy_ajp.so  
112. #LoadModule proxy_balancer_module modules/mod_proxy_balancer.so  
113. #LoadModule proxy_connect_module modules/mod_proxy_connect.so  
114. #LoadModule proxy_ftp_module modules/mod_proxy_ftp.so  
115. #LoadModule proxy_http_module modules/mod_proxy_http.so  
116. #LoadModule proxy_scgi_module modules/mod_proxy_scgi.so  
117. #LoadModule reqtimeout_module modules/mod_reqtimeout.so  
118. #url伪静态  
119. LoadModule rewrite_module modules/mod_rewrite.so  
120. LoadModule setenvif_module modules/mod_setenvif.so  
121. #LoadModule speling_module modules/mod_speling.so  
122. #LoadModule ssl_module modules/mod_ssl.so  
123. #LoadModule status_module modules/mod_status.so  
124. #LoadModule substitute_module modules/mod_substitute.so  
125. #LoadModule unique_id_module modules/mod_unique_id.so  
126. #LoadModule userdir_module modules/mod_userdir.so  
127. #LoadModule usertrack_module modules/mod_usertrack.so  
128. #LoadModule version_module modules/mod_version.so  
129. #LoadModule vhost_alias_module modules/mod_vhost_alias.so  
130.   
131. #加载mod_jk连接  
132. LoadModule jk_module modules/mod_jk.so  
133. #加载集群中的workers  
134. JkWorkersFile "conf/workers.properties"   
135. #此处是指定分配给tomcat的请求 例如*.do *.jsp  
136. JkMount /*.jsp lbcontroller  
137. #指定jk的日志输出文件  
138. JkLogFile "logs/mod_jk.log"  
139. #指定日志级别  
140. JkLogLevel warn   
141.   
142.   
143.   
144.   
145. <IfModule !mpm_netware_module>  
146. <IfModule !mpm_winnt_module>  
147. #  
148. # If you wish httpd to run as a different user or group, you must run  
149. # httpd as root initially and it will switch.    
150. #  
151. # User/Group: The name (or #number) of the user/group to run httpd as.  
152. # It is usually good practice to create a dedicated user and group for  
153. # running httpd, as with most system services.  
154. #  
155. User daemon  
156. Group daemon  
157.   
158. </IfModule>  
159. </IfModule>  
160.   
161. # 'Main' server configuration  
162. #  
163. # The directives in this section set up the values used by the 'main'  
164. # server, which responds to any requests that aren't handled by a  
165. # <VirtualHost> definition.  These values also provide defaults for  
166. # any <VirtualHost> containers you may define later in the file.  
167. #  
168. # All of these directives may appear inside <VirtualHost> containers,  
169. # in which case these default settings will be overridden for the  
170. # virtual host being defined.  
171. #  
172.   
173. #  
174. # ServerAdmin: Your address, where problems with the server should be  
175. # e-mailed.  This address appears on some server-generated pages, such  
176. # as error documents.  e.g. admin@your-domain.com  
177. #  
178. ServerAdmin localhost  
179.   
180. #  
181. # ServerName gives the name and port that the server uses to identify itself.  
182. # This can often be determined automatically, but we recommend you specify  
183. # it explicitly to prevent problems during startup.  
184. #  
185. # If your host doesn't have a registered DNS name, enter its IP address here.  
186. #  
187. ServerName localhost:8080  
188. #  
189. # DocumentRoot: The directory out of which you will serve your  
190. # documents. By default, all requests are taken from this directory, but  
191. # symbolic links and aliases may be used to point to other locations.  
192. #  
193. DocumentRoot "D:/work/work_bz/test/WebRoot"  
194. #  
195. # Each directory to which Apache has access can be configured with respect  
196. # to which services and features are allowed and/or disabled in that  
197. # directory (and its subdirectories).   
198. #  
199. # First, we configure the "default" to be a very restrictive set of   
200. # features.    
201. #    默认为 AllowOverride None  
202. <Directory />  
203.     Options FollowSymLinks  
204.     AllowOverride All  
205.     #Order deny,allow  
206.       #Deny from all  
207.        Order allow,deny  
208.     Allow from all  
209.     Satisfy all  
210. </Directory>  
211.   
212. #首次访问页面  
213. <IfModule dir_module>  
214.     DirectoryIndex index.jsp  
215. </IfModule>  
216.   
217. #  
218. # The following lines prevent .htaccess and .htpasswd files from being   
219. # viewed by Web clients.   
220. #  
221. <FilesMatch "^\.ht">  
222.     Order allow,deny  
223.     Deny from all  
224.     Satisfy All  
225. </FilesMatch>  
226.   
227. #  
228. # ErrorLog: The location of the error log file.  
229. # If you do not specify an ErrorLog directive within a <VirtualHost>  
230. # container, error messages relating to that virtual host will be  
231. # logged here.  If you *do* define an error logfile for a <VirtualHost>  
232. # container, that host's errors will be logged there and not here.  
233. #  
234. ErrorLog "logs/error.log"  
235.   
236. #  
237. # LogLevel: Control the number of messages logged to the error_log.  
238. # Possible values include: debug, info, notice, warn, error, crit,  
239. # alert, emerg.  
240. #  
241. LogLevel warn  
242.   
243. <IfModule log_config_module>  
244.     #  
245.     # The following directives define some format nicknames for use with  
246.     # a CustomLog directive (see below).  
247.     #  
248.     LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined  
249.     LogFormat "%h %l %u %t \"%r\" %>s %b" common  
250.   
251.     <IfModule logio_module>  
252.       # You need to enable mod_logio.c to use %I and %O  
253.       LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio  
254.     </IfModule>  
255.   
256.     #  
257.     # The location and format of the access logfile (Common Logfile Format).  
258.     # If you do not define any access logfiles within a <VirtualHost>  
259.     # container, they will be logged here.  Contrariwise, if you *do*  
260.     # define per-<VirtualHost> access logfiles, transactions will be  
261.     # logged therein and *not* in this file.  
262.     #  
263.     CustomLog "logs/access.log" common  
264.   
265.     #  
266.     # If you prefer a logfile with access, agent, and referer information  
267.     # (Combined Logfile Format) you can use the following directive.  
268.     #  
269.     #CustomLog "logs/access.log" combined  
270. </IfModule>  
271.   
272. <IfModule alias_module>  
273.     #  
274.     # Redirect: Allows you to tell clients about documents that used to   
275.     # exist in your server's namespace, but do not anymore. The client   
276.     # will make a new request for the document at its new location.  
277.     # Example:  
278.     # Redirect permanent /foo http://192.168.12.242/bar  
279.   
280.     #  
281.     # Alias: Maps web paths into filesystem paths and is used to  
282.     # access content that does not live under the DocumentRoot.  
283.     # Example:  
284.     # Alias /webpath /full/filesystem/path  
285.     #  
286.     # If you include a trailing / on /webpath then the server will  
287.     # require it to be present in the URL.  You will also likely  
288.     # need to provide a <Directory> section to allow access to  
289.     # the filesystem path.  
290.   
291.     #  
292.     # ScriptAlias: This controls which directories contain server scripts.   
293.     # ScriptAliases are essentially the same as Aliases, except that  
294.     # documents in the target directory are treated as applications and  
295.     # run by the server when requested rather than as documents sent to the  
296.     # client.  The same rules about trailing "/" apply to ScriptAlias  
297.     # directives as to Alias.  
298.     #  
299.     ScriptAlias /cgi-bin/ "D:/Program Files/Apache Software Foundation/Apache2.2/cgi-bin/"  
300.   
301. </IfModule>  
302.   
303. <IfModule cgid_module>  
304.     #  
305.     # ScriptSock: On threaded servers, designate the path to the UNIX  
306.     # socket used to communicate with the CGI daemon of mod_cgid.  
307.     #  
308.     #Scriptsock logs/cgisock  
309. </IfModule>  
310.   
311. #  
312. # "D:/Program Files/Apache Software Foundation/Apache2.2/cgi-bin" should be changed to whatever your ScriptAliased  
313. # CGI directory exists, if you have that configured.  
314. #  
315. <Directory "D:/Program Files/Apache Software Foundation/Apache2.2/cgi-bin">  
316.     AllowOverride None  
317.     Options None  
318.     Order allow,deny  
319.     Allow from all  
320. </Directory>  
321.   
322. #  
323. # DefaultType: the default MIME type the server will use for a document  
324. # if it cannot otherwise determine one, such as from filename extensions.  
325. # If your server contains mostly text or HTML documents, "text/plain" is  
326. # a good value.  If most of your content is binary, such as applications  
327. # or images, you may want to use "application/octet-stream" instead to  
328. # keep browsers from trying to display binary files as though they are  
329. # text.  
330. #  
331. DefaultType text/plain  
332.   
333. <IfModule mime_module>  
334.     #  
335.     # TypesConfig points to the file containing the list of mappings from  
336.     # filename extension to MIME-type.  
337.     #  
338.     TypesConfig conf/mime.types  
339.   
340.     #  
341.     # AddType allows you to add to or override the MIME configuration  
342.     # file specified in TypesConfig for specific file types.  
343.     #  
344.     #AddType application/x-gzip .tgz  
345.     #  
346.     # AddEncoding allows you to have certain browsers uncompress  
347.     # information on the fly. Note: Not all browsers support this.  
348.     #  
349.     #AddEncoding x-compress .Z  
350.     #AddEncoding x-gzip .gz .tgz  
351.     #  
352.     # If the AddEncoding directives above are commented-out, then you  
353.     # probably should define those extensions to indicate media types:  
354.     #  
355.     AddType application/x-compress .Z  
356.     AddType application/x-gzip .gz .tgz  
357.   
358.     #  
359.     # AddHandler allows you to map certain file extensions to "handlers":  
360.     # actions unrelated to filetype. These can be either built into the server  
361.     # or added with the Action directive (see below)  
362.     #  
363.     # To use CGI scripts outside of ScriptAliased directories:  
364.     # (You will also need to add "ExecCGI" to the "Options" directive.)  
365.     #  
366.     #AddHandler cgi-script .cgi  
367.   
368.     # For type maps (negotiated resources):  
369.     #AddHandler type-map var  
370.   
371.     #  
372.     # Filters allow you to process content before it is sent to the client.  
373.     #  
374.     # To parse .shtml files for server-side includes (SSI):  
375.     # (You will also need to add "Includes" to the "Options" directive.)  
376.     #  
377.     #AddType text/html .shtml  
378.     #AddOutputFilter INCLUDES .shtml  
379. </IfModule>  
380.   
381. #  
382. # The mod_mime_magic module allows the server to use various hints from the  
383. # contents of the file itself to determine its type.  The MIMEMagicFile  
384. # directive tells the module where the hint definitions are located.  
385. #  
386. #MIMEMagicFile conf/magic  
387.   
388. #  
389. # Customizable error responses come in three flavors:  
390. # 1) plain text 2) local redirects 3) external redirects  
391. #  
392. # Some examples:  
393. #ErrorDocument 500 "The server made a boo boo."  
394. #ErrorDocument 404 /missing.html  
395. #ErrorDocument 404 "/cgi-bin/missing_handler.pl"  
396. #ErrorDocument 402 http://192.168.12.242/subscription_info.html  
397. #  
398.   
399. #  
400. # MaxRanges: Maximum number of Ranges in a request before  
401. # returning the entire resource, or 0 for unlimited  
402. # Default setting is to accept 200 Ranges  
403. #MaxRanges 0  
404.   
405. #  
406. # EnableMMAP and EnableSendfile: On systems that support it,   
407. # memory-mapping or the sendfile syscall is used to deliver  
408. # files.  This usually improves server performance, but must  
409. # be turned off when serving from networked-mounted   
410. # filesystems or if support for these functions is otherwise  
411. # broken on your system.  
412. #  
413. #EnableMMAP off  
414. #EnableSendfile off  
415.   
416. # Supplemental configuration  
417. #  
418. # The configuration files in the conf/extra/ directory can be   
419. # included to add extra features or to modify the default configuration of   
420. # the server, or you may simply copy their contents here and change as   
421. # necessary.  
422.   
423. # Server-pool management (MPM specific)修改连接数  
424. Include conf/extra/httpd-mpm.conf  
425.   
426. # Multi-language error messages  
427. #Include conf/extra/httpd-multilang-errordoc.conf  
428.   
429. # Fancy directory listings  
430. #Include conf/extra/httpd-autoindex.conf  
431.   
432. # Language settings  
433. #Include conf/extra/httpd-languages.conf  
434.   
435. # User home directories  
436. #Include conf/extra/httpd-userdir.conf  
437.   
438. # Real-time info on requests and configuration  
439. #Include conf/extra/httpd-info.conf  
440.   
441. # Virtual hosts 虚拟主机 没有域名不需要设置  
442. #Include conf/extra/httpd-vhosts.conf  
443.   
444. # Local access to the Apache HTTP Server Manual  
445. #Include conf/extra/httpd-manual.conf  
446.   
447. # Distributed authoring and versioning (WebDAV)  
448. #Include conf/extra/httpd-dav.conf  
449.   
450. # Various default settings  
451. #Include conf/extra/httpd-default.conf  
452.   
453. # Secure (SSL/TLS) connections  
454. #Include conf/extra/httpd-ssl.conf  
455. #  
456. # Note: The following must must be present to support  
457. #       starting without SSL on platforms with no /dev/random equivalent  
458. #       but a statically compiled-in mod_ssl.  
459. #  
460. <IfModule ssl_module>  
461. SSLRandomSeed startup builtin  
462. SSLRandomSeed connect builtin  
463. </IfModule>  

第三部分：mod_jk代码讲解

mod_jk 分析
1 mod_jk模块的总体功能
由于tomcat的HTTP处理部分都由Java所写（5.5.12版本以后出现了native库，用以
提高其I/O和SSL的性能[1]），在高并发的情况下负载较高。而apache对于静态文件的处
理能力比tomcat强，所以tomcat开发组开发了与apache结合使用的mod_jk模块。该协议
由apache作请求代理，将HTTP协议的请求转化为AJP协议包，并传给后端的
tomcat。mod_jk和apache现在普遍使用AJP1.3协议[2]。它是一个二进制格式的协议，比
字符格式的HTTP协议解析速度要快。
除了性能的提升，mod_jk另外的一个作用可以实现apache与tomcat一对多的对应，
使后端tomcat负载均衡。mod_jk也提供apache与tomcat链接情况的监控。
mod_jk模块的典型工作流程是这样的：一个HTTP请求过来，mod_jk模块根据其URI选
择合适的worker来进行处理。如果是lb_worker（负载均衡的worker），就再根据各种条
件选择后台合适的ajp_worker（处理AJP协议的worker）。ajp_worker将HTTP协议的包，
组装成AJP协议格式的包，然后选取一条空闲的链接，发送给后台的tomcat服务器。等到
后台将数据发送过来时，接收并解析AJP协议，重新组装成HTTP协议，然后把结果发送给
客户端。
2 mod_jk模块的框架
2.1 线程
从宏观上来讲，mod_jk由一个watchdog线程和一组worker线程(进程)组成。
watchdog线程是在apache内部新创建的线程，它是一个维护线程。每隔
JkWatchdogInterval的时间（当然，所有worker线程也有一个统一的worker.maintain 时
间，JkWatchdogInterval应该至少大于worker.maintain），它会扫描所有worker线程。
watchdog线程会检查每个worker线程的空闲链接、负载情况、与后端的链接情况，并使共
享内存同步。worker线程是就是一些ajp13，ajp14，jni，lb或status类型的线程，负责
所有实际的工作。
在mod_jk中，线程内（外）的同步均是通过线程锁（pthread_mutex_lock）来实现的。
而进程之间的全局同步，是用文件记录锁（flock或fcntl）来实现。进程间的数据共享是
用这样做的：进程启动时，创建一个JkShmSize 大小的文件，然后mmap到内存，由于各进
程mmap到内存的是相同的镜像，所以可以实现数据的共享，但是写入共享内存时，要做好
互斥。
由于apache的基本处理方式（prefork和worker模式）就是一个线程/进程负责一个
连接，所以mod_jk各线程中对于网络IO处理都是阻塞的。
2.2 worker对象
从具体的worker对象的角度来讲，mod_jk由ajp_worker、jni_worker、lb_worker和
status_worker组成。这些对象参考了设计模式中factory的模型。每类worker都有生产
workers的factory。
在mod_jk中，其中的worker主要在worker.list中列出。其中，lb_worker可以含有
balance_workers，以lb_sub_worker的形式存储于lb_worker中。lb_sub_worker可以是各
种类型的ajp_worker。所以真正工作的ajp_worker既可以“单干”，也可以由lb_worker
来分配任务。这主要取决于URI到底映射到哪个worker上以及该worker是否在
worker.list配置。
lb_worker，lb_sub_worker和ajp_worker一些配置信息都位于其结构体中，而状态信
息或在运行中可变的参数则位于共享内存中的对应结构体中，当然也并不绝对，有些参数是
冗余的。
从正在运行的某个线程的角度上来讲，ajp_worker就是对应了一个线程。
3 从HTTP到AJP的处理流程
由于mod_jk模块是apache的处理模块，本节主要是讲述mod_jk模块从客户端到后端
服务器的处理流程。中间会涉及一些apache模块的一些结构。
3.1 mod_jk模块在apache中的定义
3.1.1 mod_jk定义
/* 这是jk模块的主要定义结构体*/
module AP_MODULE_DECLARE_DATA jk_module = {
STANDARD20_MODULE_STUFF,
NULL, /* dir config creater */
NULL, /* dir merger --- default is to override */
create_jk_config, /*创建 jk模块的配置结构体*/
merge_jk_config, /* 初始化及合并 jk模块的配置结构体*/
jk_cmds, /* 所有在apahce中的命令及操作函数 */
jk_register_hooks /* 具体的操作函数处理钩子 */
};
3.1.2 mod_jk模块的主要处理函数
/* mod_jk将各处理函数挂到相应的钩子上，钩子实际上就是一些函数指针。针对某个HTTP
请求，这些函数会自上而下执行。*/
static void jk_register_hooks(apr_pool_t * p)
{
/* 该函数在apache读入配置后运行，用以初始化全局互斥锁，jk日志，全局变量的初
始化，以及读入 workers.properties、uriworkermap.properties文件，初始化各worker
的属性，建立worker名称到worker结构体的映射，uri到worker的映射*/
ap_hook_post_config(jk_post_config, NULL, NULL, APR_HOOK_MIDDLE);
/*该函数在apache主进程fork工作子进程后做的初始化工作，主要包括初始化进程内
互斥锁，开启维护线程，读入共享内存*/
ap_hook_child_init(jk_child_init, NULL, NULL, APR_HOOK_MIDDLE);
/* 将mod_jk的URI到真实URI，然后URI到worker的映射翻译过程，用以找到该URI
相应的worker_name */
ap_hook_translate_name(jk_translate, NULL, NULL, APR_HOOK_MIDDLE);
#if (MODULE_MAGIC_NUMBER_MAJOR > 20010808)
/* 绑定那些alias_dir的URI到mod_jk的配置，并找到相应worker_name */
ap_hook_map_to_storage(jk_map_to_storage, NULL, NULL, APR_HOOK_MIDDLE);
/* 这是mod_jk的主要处理函数 */
ap_hook_handler(jk_handler, NULL, NULL, APR_HOOK_MIDDLE);
#endif
}
3.2 jk_handler函数
jk_handler函数是mod_jk的主要处理函数，它负责将HTTP请求从apache发到tomcat,
再从tomcat接受数据，并返回给客户。
它的处理过程如下：
1. 根据前面得到的worker_name，找到相应的jk_worker（其结构体见4.4）。
2. 初始化服务结构体jk_ws_service，主要是针对HTTP服务端的一些设置及函数（服务
的结构体见4.5），与AJP协议关系不大。
3. 调用jk_worker的get_endpoint函数，获取具体的jk_endpoint结构体（函数见
3.3.1和3.4.1，jk_endpoint的结构体定义见4.4）。
4. 调用上述jk_endpoint的service函数。
5. 调用上述jk_endpoint的done函数，结束与tomcat的AJP连接。
6. 根据函数的结果处理各种状态。
7. 释放资源。
3.3 lb_worker的处理函数
3.3.1 lb_worker的get_endpoint
初始化lb_worker的endpoint结构体，挂上其service及done函数。
3.3.2 lb_worker的service函数
它的处理过程如下：
1. 获取共享内存中记录的worker状态。
2. 如果需要绑定sessionID，获取sessionID。
3. 调用get_most_suitable_worker函数，获取相应的lb_sub_worker(也即
ajp_worker)。
4. 调用ajp_worker的get_endpoint函数。
5. 调用上述endpoint的service函数。
6. 调用上述endpoint的done函数。
7. 根据service的返回结果，更新各种记录状态。
3.3.3 get_most_suitable_worker函数
它的处理过程如下：
1. 如果需要绑定sessionID，就根据sessionID找到工作正常的最佳worker。
2. 如果找不到，则调用find_best_worker函数。其处理过程如下：
i. 又调用find_best_byvalue函数。其处理过程如下：按照Round Robin的方式在
本lb_worker中找到第一个不在错误状态、也没有停止、没有disabled 、也不
busy的lb_sub_worker。
ii.如果find_best_byvalue返回错误，说明本lb_worker的lb_sub_worker都处于
非正常工作状态，需要调用find_failover_worker函数，通过
redirect、route、domain指令来进行查找[3]。
3.4 ajp_worker的处理函数
3.4.1 ajp_worker的get_endpoint函数
它的主要功能是：找到与后端tomcat的一个空闲连接。
3.4.2 ajp_worker的ajp_service函数
该函数主要分为 ajp_send_request和and ajp_get_reply两个函数。
它的处理过程如下：
1. 获取共享内存中的状态。
2. 分配AJP请求包、恢复包、POST包的内存。
3. 调用ajp_marshal_into_msgb函数，将HTTP请求包转化为AJP包。
4. 将当前ajp_worker的状态更新。
5. 调用ajp_send_request函数。
6. 如果发送成功，调用ajp_get_reply函数，等待并接受AJP包。
7. 如果成功，更新当前状态。
3.4.2 ajp_worker的ajp_send_request函数
它的处理过程如下：
1. 调用jk_is_socket_connected函数，检查即将发送的socket是否有效。它的检查过
程是运用select函数，等1微妙，如果成功返回说明，该socket的文件描述符至少
在内核中还有效。
2. 如果上一次发送超时，则调用ajp_handle_cping_cpong函数来判断后端连接是否有
效。该函数主要是发出了一个AJP13_CPING_REQUEST类型的AJP包，如果tomcat收
到，应返回一个AJP13_CPONG_REPLY的包。
3. 如果上述的测试都成功，调用ajp_connection_tcp_send_message，发送AJP包。
3.4.3 ajp_worker的ajp_get_reply函数
它的处理过程如下：
1. 调用jk_is_input_event，用select等待接受数据，直到socket有接受数据。
2. 调用ajp_connection_tcp_get_message，接受AJP包，并检查协议头。
3. 调用ajp_process_callback，对该AJP包进行解析处理。其处理过程如下：
i. 如果是JK_AJP13_SEND_HEADERS包，将其解包成HTTP包头。如果没有错误，就调
用jk_ws_service->start_response（）函数发送HTTP回复的head。返回
JK_AJP13_SEND_HEADERS。
ii.如果是JK_AJP13_SEND_BODY_CHUNK包，调用jk_ws_service->write发送HTTP回
复的body。返回JK_AJP13_NO_RESPONSE。
iii.如果是JK_AJP13_GET_BODY_CHUNK包，说明还有数据要发送到tomcat，调用
ajp_read_into_msg_buff，继续发送数据。返回JK_AJP13_HAS_RESPONSE。
iv.如果是JK_AJP13_END_RESPONSE包，就说明tomcat的回复已经完成。返回
JK_AJP13_END_RESPONSE。
3.5 jk_ws_service的一些处理函数
3.5.1 jk_ws_service 的 ws_start_response函数
该函数主要是构建HTTP回复包的头部。
3.5.2 jk_ws_service 的 ws_write函数
调用 apache的ap_rwrite函数，发送整个HTTP包。
3.5.3 jk_ws_service 的 ws_read函数
调用apache的ap_get_client_block读入全部的request body数据。
4 mod_jk的主要数据结构
4.1 lb_worker
lb_worker是负载均衡worker。主要负责调配其名下的一些lb_sub_worker 。

[plain]  view plain copy print ?

1. dist/common/jk_lb_worker.h  
2. struct lb_worker  
3. {  
4. /* jk模块通用worker结构体。包含一些回调函数，不同的worker有不同的函数实现  
5. */  
6. jk_worker_t worker;  
7. /* Shared memory worker data */  
8. jk_shm_lb_worker_t *s;  
9. char name[JK_SHM_STR_SIZ+1];  
10. /* Sequence counter starting at 0 and increasing  
11. * every time we change the config  
12. */  
13. volatile unsigned int sequence;  
14. jk_pool_t p;  
15. jk_pool_atom_t buf[TINY_POOL_SIZE];  
16. JK_CRIT_SEC cs;  
17. /*其名下的workers*/  
18. lb_sub_worker_t *lb_workers;  
19. unsigned int num_of_workers;  
20. int sticky_session;  
21. int sticky_session_force;  
22. int recover_wait_time;  
23. int max_reply_timeouts;  
24. int retries;  
25. int retry_interval;  
26. int lbmethod;  
27. int lblock;  
28. int maintain_time;  
29. unsigned int max_packet_size;  
30. unsigned int next_offset;  
31. /* Session cookie */  
32. char session_cookie[JK_SHM_STR_SIZ+1];  
33. /* Session path */  
34. char session_path[JK_SHM_STR_SIZ+1];  
35. };  
36. lb_sub_worker是由lb_worker支配的ajp_worker。当然lb_sub_worker有不同的类型。  
37. 它们的实际类型存储在ajp_worker中。  
38. dist/common/jk_lb_worker.h  
39. struct lb_sub_worker  
40. {  
41. /* 包含ajp_worker的回调函数及其ajp_worker结构体*/  
42. jk_worker_t *worker;  
43. /* Shared memory worker data */  
44. jk_shm_lb_sub_worker_t *s;  
45. char name[JK_SHM_STR_SIZ+1];  
46. /* Sequence counter starting at 0 and increasing  
47. * every time we change the config  
48. */  
49. volatile unsigned int sequence;  
50. /* route */  
51. char route[JK_SHM_STR_SIZ+1];  
52. /* worker domain */  
53. char domain[JK_SHM_STR_SIZ+1];  
54. /* worker redirect route */  
55. char redirect[JK_SHM_STR_SIZ+1];  
56. /* worker distance */  
57. int distance;  
58. /* current activation state (config) of the worker */  
59. int activation;  
60. /* Current lb factor */  
61. int lb_factor;  
62. /* Current worker index */  
63. int i;  
64. /* Current lb reciprocal factor */  
65. jk_uint64_t lb_mult;  
66. };  
67. typedef struct lb_sub_worker lb_sub_worker_t;  
68. 4.2 ajp_worker  
69. ajp_worker是具体工作的worker，对应后端一个tomcat应用服务。  
70. dist/common/jk_ajp_common.c  
71. struct ajp_worker  
72. {  
73. /* 包含ajp_worker的回调函数*/  
74. jk_worker_t worker;  
75. /* Shared memory worker data */  
76. jk_shm_ajp_worker_t *s;  
77. char name[JK_SHM_STR_SIZ+1];  
78. /* Sequence counter starting at 0 and increasing  
79. * every time we change the config  
80. */  
81. volatile unsigned int sequence;  
82. jk_pool_t p;  
83. jk_pool_atom_t buf[TINY_POOL_SIZE];  
84. JK_CRIT_SEC cs;  
85. struct sockaddr_in worker_inet_addr; /* Contains host and port */  
86. unsigned connect_retry_attempts;  
87. const char *host;  
88. int port;  
89. int maintain_time;  
90. /*  
91. * Open connections cache...  
92. *  
93. * 1. Critical section object to protect the cache.  
94. * 2. Cache size.  
95. * 3. An array of "open" endpoints.  
96. */  
97. unsigned int ep_cache_sz;  
98. unsigned int ep_mincache_sz;  
99. unsigned int ep_maxcache_sz;  
100. int cache_acquire_timeout;  
101. ajp_endpoint_t **ep_cache;  
102. int proto; /* PROTOCOL USED AJP13/AJP14 */  
103. jk_login_service_t *login;  
104. /* Weak secret similar with ajp12, used in ajp13 */  
105. const char *secret;  
106. /*  
107. * Post physical connect handler.  
108. * AJP14 will set here its login handler  
109. */  
110. int (*logon) (ajp_endpoint_t * ae, jk_logger_t *l);  
111. /*  
112. * Handle Socket Timeouts  
113. */  
114. int socket_timeout;  
115. int socket_connect_timeout;  
116. int keepalive;  
117. int socket_buf;  
118. /*  
119. * Handle Cache Timeouts  
120. */  
121. int cache_timeout;  
122. /*  
123. * Handle Connection/Reply Timeouts  
124. */  
125. int connect_timeout; /* connect cping/cpong delay in ms (0 means  
126. disabled) */  
127. int reply_timeout; /* reply timeout delay in ms (0 means disabled) */  
128. int prepost_timeout; /* before sending a request cping/cpong timeout  
129. delay in ms (0 means disabled) */  
130. int conn_ping_interval; /* interval for sending keepalive cping packets on  
131. * unused connection */  
132. int ping_timeout; /* generic cping/cpong timeout. Used for keepalive  
133. packets or  
134. * as default for boolean valued connect and  
135. prepost timeouts.  
136. */  
137. unsigned int ping_mode; /* Ping mode flags (which types of cpings should  
138. be used) */  
139. /*  
140. * Recovery options  
141. */  
142. unsigned int recovery_opts;  
143. /*  
144. * Public property to enable the number of retry attempts  
145. * on this worker.  
146. */  
147. int retries;  
148. unsigned int max_packet_size; /* Maximum AJP Packet size */  
149. int retry_interval; /* Number of milliseconds to sleep before  
150. doing a retry */  
151. /*  
152. * HTTP status that will cause failover (0 means disabled)  
153. */  
154. unsigned int http_status_fail_num;  
155. int http_status_fail[JK_MAX_HTTP_STATUS_FAILS];  
156. };  
157. 4.3 status_worker  
158. status_worker用于产生一些状态的统计信息。  
159. dist/common/jk_statuc.c  
160. struct status_worker  
161. {  
162. jk_pool_t p;  
163. jk_pool_atom_t buf[TINY_POOL_SIZE];  
164. const char *name;  
165. const char *css;  
166. const char *ns;  
167. const char *xmlns;  
168. const char *doctype;  
169. const char *prefix;  
170. int read_only;  
171. char **user_names;  
172. unsigned int num_of_users;  
173. int user_case_insensitive;  
174. jk_uint32_t good_mask;  
175. jk_uint32_t bad_mask;  
176. jk_worker_t worker;  
177. jk_worker_env_t *we;  
178. };  
179. 4.4 jk_worker和 jk_endpoint  
180. jk_worker是所有worker通用结构体名称, 主要包含的是一些函数指针。它是一个类  
181. 似java中抽象类的概念，各成员函数在从factory函数生产时初始化。  
182. dist/common/jk_service.h  
183. struct jk_worker  
184. {  
185. /*  
186. * A 'this' pointer which is used by the subclasses of this class to  
187. * point to data/functions which are specific to a given protocol  
188. * (e.g. ajp12 or ajp13 or ajp14).  
189. */  
190. void *worker_private;/* 指向ajp_worker，lb_worker结构体 ...*/  
191. int type;  
192. /*  
193. * For all of the below (except destroy), the first argument is  
194. * essentially a 'this' pointer.  
195. */  
196. /* 先于init函数调用，用于分配各类worker结构体的内存，作必要的初始化  
197. * Given a worker which is in the process of being created, and a list  
198. * of configuration options (or 'properties'), check to see if it the  
199. * options are. This will always be called before the init() method.  
200. * The init/validate distinction is a bit hazy to me.  
201. * See jk_ajp13_worker.c/jk_ajp14_worker.c and jk_worker.c-  
202. >wc_create_worker()  
203. */  
204. int (JK_METHOD * validate) (jk_worker_t *w,  
205. jk_map_t *props,  
206. jk_worker_env_t *we, jk_logger_t *l);  
207. /*  
208. * Update worker either from jk_status or reloading from workers.properties  
209. */  
210. int (JK_METHOD * update) (jk_worker_t *w,  
211. jk_map_t *props,  
212. jk_worker_env_t *we, jk_logger_t *l);  
213. /*  
214. * Do whatever initialization needs to be done to start this worker up.  
215. * Configuration options are passed in via the props parameter.  
216. */  
217. int (JK_METHOD * init) (jk_worker_t *w,  
218. jk_map_t *props,  
219. jk_worker_env_t *we, jk_logger_t *l);  
220. /*  
221. * Obtain an endpoint to service a particular request. A pointer to  
222. * the endpoint is stored in pend.  
223. */  
224. int (JK_METHOD * get_endpoint) (jk_worker_t *w,  
225. jk_endpoint_t **pend, jk_logger_t *l);  
226. /*  
227. * Shutdown this worker. The first argument is not a 'this' pointer,  
228. * but rather a pointer to 'this', so that the object can be free'd (I  
229. * think -- though that doesn't seem to be happening. Hmmm).  
230. */  
231. int (JK_METHOD * destroy) (jk_worker_t **w, jk_logger_t *l);  
232. /*  
233. * Maintain this worker.  
234. */  
235. int (JK_METHOD * maintain) (jk_worker_t *w, time_t now, jk_logger_t *l);  
236. };  
237. /* jk_endpoint可以称之为通用终端服务结构体，各类worker可能有自己的endpoint结构  
238. 体。比如ajp_worker, 该终端是用来做具体工作的，比如发出请求，接收AJP数据等等。如  
239. 果是lb_worker，该终端是的作用是找出合适ajp_worker, 把任务交给它。* /  
240. struct jk_endpoint  
241. {  
242. jk_uint64_t rd;  
243. jk_uint64_t wr;  
244. /*  
245. * Flag to pass back recoverability status from  
246. * a load balancer member to the load balancer itself.  
247. * Depending on the configuration and request status  
248. * recovery is not allowed.  
249. */  
250. int recoverable;  
251. /*  
252. * A 'this' pointer which is used by the subclasses of this class to  
253. * point to data/functions which are specific to a given protocol  
254. * (e.g. ajp12 or ajp13 or ajp14).  
255. */  
256. void *endpoint_private;  
257. /* 该函数是具体的服务函数  
258. * Forward a request to the servlet engine. The request is described  
259. * by the jk_ws_service_t object.  
260. * is_error is either 0 meaning recoverable or set to  
261. * the HTTP error code.  
262. */  
263. int (JK_METHOD * service) (jk_endpoint_t *e,  
264. jk_ws_service_t *s,  
265. jk_logger_t *l, int *is_error);  
266. /*  
267. * Called when this particular endpoint has finished processing a  
268. * request. For some protocols (e.g. ajp12), this frees the memory  
269. * associated with the endpoint. For others (e.g. ajp13/ajp14), this can  
270. * return the endpoint to a cache of already opened endpoints.  
271. *  
272. * Note that the first argument is *not* a 'this' pointer, but is  
273. * rather a pointer to a 'this' pointer. This is necessary, because  
274. * we may need to free this object.  
275. */  
276. int (JK_METHOD * done) (jk_endpoint_t **p, jk_logger_t *l);  
277. };  
278. 4.5 jk_ws_service  
279. 该结构体是与apache相关的一些参数或函数，面向HTTP协议，与AJP协议不太相关。  
280. dist/common/jk_service.h  
281. struct jk_ws_service  
282. {  
283. /*  
284. * A 'this' pointer which is used by the subclasses of this class to  
285. * point to data which is specific to a given web server platform  
286. * (e.g. Apache or IIS).  
287. */  
288. void *ws_private;  
289. /*  
290. * Provides memory management. All data specific to this request is  
291. * allocated within this pool, which can then be reclaimed at the end  
292. * of the request handling cycle.  
293. *  
294. * Alive as long as the request is alive.  
295. */  
296. jk_pool_t *pool;  
297. /*  
298. * CGI Environment needed by servlets  
299. */  
300. const char *method;  
301. const char *protocol;  
302. char *req_uri;  
303. const char *remote_addr;  
304. const char *remote_host;  
305. const char *remote_user;  
306. const char *auth_type;  
307. const char *query_string;  
308. const char *server_name;  
309. unsigned server_port;  
310. char *server_software;  
311. jk_uint64_t content_length; /* 64 bit integer that represents the content */  
312. /* length should be 0 if unknown. */  
313. unsigned is_chunked; /* 1 if content length is unknown (chunked rq) */  
314. unsigned no_more_chunks; /* 1 if last chunk has been read */  
315. jk_uint64_t content_read; /* number of bytes read */  
316. /*  
317. * SSL information  
318. *  
319. * is_ssl - True if request is in ssl connection  
320. * ssl_cert - If available, base64 ASN.1 encoded client certificates.  
321. * ssl_cert_len - Length of ssl_cert, 0 if certificates are not available.  
322. * ssl_cipher - The ssl cipher suite in use.  
323. * ssl_session - The ssl session string  
324. *  
325. * In some servers it is impossible to extract all this information, in this  
326. * case, we are passing NULL.  
327. */  
328. int is_ssl;  
329. char *ssl_cert;  
330. unsigned ssl_cert_len;  
331. char *ssl_cipher;  
332. char *ssl_session;  
333. /*  
334. * SSL extra information for Servlet 2.3 API  
335. *  
336. * ssl_key_size - ssl key size in use  
337. */  
338. int ssl_key_size;  
339. /*  
340. * Headers, names and values.  
341. */  
342. char **headers_names; /* Names of the request headers */  
343. char **headers_values; /* Values of the request headers */  
344. unsigned num_headers; /* Number of request headers */  
345. /*  
346. * Request attributes.  
347. *  
348. * These attributes that were extracted from the web server and are  
349. * sent to Tomcat.  
350. *  
351. * The developer should be able to read them from the ServletRequest  
352. * attributes. Tomcat is required to append org.apache.tomcat. to  
353. * these attribute names.  
354. */  
355. char **attributes_names; /* Names of the request attributes */  
356. char **attributes_values; /* Values of the request attributes */  
357. unsigned num_attributes; /* Number of request attributes */  
358. /*  
359. * The route is in use when the adapter load balance among  
360. * several workers. It is the ID of a specific target in the load balance  
361. * group. We are using this variable to implement target session  
362. * affinity  
363. */  
364. const char *route;  
365. /* Temp solution for auth. For native1 it'll be sent on each request,  
366. if an option is present. For native2 it'll be sent with the first  
367. request. On java side, both cases will work. For tomcat3.2 or  
368. a version that doesn't support secret - don't set the secret,  
369. and it'll work.  
370. */  
371. const char *secret;  
372. /*  
373. * Area to get POST data for fail-over recovery in POST  
374. */  
375. jk_msg_buf_t *reco_buf;  
376. int reco_status;  
377. /*  
378. * If set call flush after each write  
379. */  
380. int flush_packets;  
381. /*  
382. * If set call flush after AJP13_SEND_HEADERS.  
383. */  
384. int flush_header;  
385. /*  
386. * service extensions  
387. */  
388. svc_extension_t extension;  
389. /*  
390. * JK_TRUE if response headers have been sent back  
391. */  
392. int response_started;  
393. /*  
394. * JK_TRUE if response should not be send to the client  
395. */  
396. int response_blocked;  
397. /*  
398. * HTTP status sent from container.  
399. */  
400. int http_response_status;  
401. /* Uri worker map. Added for virtual host support  
402. */  
403. jk_uri_worker_map_t *uw_map;  
404. /* 下面这些回调函数实现都可以在mod_jk.c找到  
405. * Callbacks into the web server. For each, the first argument is  
406. * essentially a 'this' pointer. All return JK_TRUE on success  
407. * and JK_FALSE on failure.  
408. */  
409. /*  
410. * Send the response headers to the browser.  
411. */  
412. int (JK_METHOD * start_response) (jk_ws_service_t *s,  
413. int status,  
414. const char *reason,  
415. const char *const *header_names,  
416. const char *const *header_values,  
417. unsigned num_of_headers);  
418. /*  
419. * Read a chunk of the request body into a buffer. Attempt to read len  
420. * bytes into the buffer. Write the number of bytes actually read into  
421. * actually_read.  
422. */  
423. int (JK_METHOD * read) (jk_ws_service_t *s,  
424. void *buffer,  
425. unsigned len, unsigned *actually_read);  
426. /*  
427. * Write a chunk of response data back to the browser.  
428. */  
429. int (JK_METHOD * write) (jk_ws_service_t *s,  
430. const void *buffer, unsigned len);  
431. /*  
432. * Flush a chunk of response data back to the browser.  
433. */  
434. void (JK_METHOD * flush) (jk_ws_service_t *s);  
435. /*  
436. * Done with sending response back to the browser.  
437. */  
438. void (JK_METHOD * done) (jk_ws_service_t *s);  
439. /*  
440. * If set do not reuse socket after each full response  
441. */  
442. int disable_reuse;  
443. /*  
444. * Add more data to log facilities.  
445. */  
446. void (JK_METHOD * add_log_items) (jk_ws_service_t *s,  
447. const char *const *log_names,  
448. const char *const *log_values,  
449. unsigned num_of_items);  
450. /*  
451. * Iterate through all vhosts  
452. */  
453. void *(JK_METHOD * next_vhost) (void *d);  
454. /*  
455. * String representation of a vhost  
456. */  
457. void (JK_METHOD * vhost_to_text) (void *d, char *buf, size_t len);  
458. /*  
459. * Get uw_map associated with a vhost  
460. */  
461. jk_uri_worker_map_t *(JK_METHOD * vhost_to_uw_map) (void *d);  
462. };  

[plain]  view plain copy print ?

1.    

[plain]  view plain copy print ?

1. 4.6 共享内存中一些数据结构  
2. 共享内存中的数据结构基本上都是记录之用。有些参数在运行中会实时变化。  

[plain]  view plain copy print ?

1. dist/common/jk_shm.h  
2. /** jk shm generic worker record structure */  
3. struct jk_shm_worker_header  
4. {  
5. int id;  
6. int type;  
7. /* worker name */  
8. char name[JK_SHM_STR_SIZ+1];  
9. /* Sequence counter starting at 0 and increasing  
10. * every time we change the config  
11. */  
12. volatile unsigned int sequence;  
13. };  
14. typedef struct jk_shm_worker_header jk_shm_worker_header_t;  
15. /** jk shm ajp13/ajp14 worker record structure */  
16. struct jk_shm_ajp_worker  
17. {  
18. jk_shm_worker_header_t h;  
19. /* Configuration data mirrored from ajp_worker */  
20. int cache_timeout;  
21. int connect_timeout;  
22. int reply_timeout;  
23. int prepost_timeout;  
24. unsigned int recovery_opts;  
25. int retries;  
26. int retry_interval;  
27. unsigned int max_packet_size;  
28. /* current error state (runtime) of the worker */  
29. volatile int state;  
30. /* Statistical data */  
31. /* Number of currently busy channels */  
32. volatile int busy;  
33. /* Maximum number of busy channels  
34. 该参数并非我们的maxbusy，它是该worker自程序运行以来busy的最大值 */  
35. volatile int max_busy;  
36. volatile time_t error_time;  
37. /* Number of bytes read from remote */  
38. volatile jk_uint64_t readed;  
39. /* Number of bytes transferred to remote */  
40. volatile jk_uint64_t transferred;  
41. /* Number of times the worker was used */  
42. volatile jk_uint64_t used;  
43. /* Number of times the worker was used - snapshot during maintenance */  
44. volatile jk_uint64_t used_snapshot;  
45. /* Number of non 200 responses */  
46. volatile jk_uint32_t errors;  
47. /* Decayed number of reply_timeout errors */  
48. volatile jk_uint32_t reply_timeouts;  
49. /* Number of client errors */  
50. volatile jk_uint32_t client_errors;  
51. /* Last reset time */  
52. volatile time_t last_reset;  
53. volatile time_t last_maintain_time;  
54. };  
55. typedef struct jk_shm_ajp_worker jk_shm_ajp_worker_t;  
56. /** jk shm lb sub worker record structure */  
57. struct jk_shm_lb_sub_worker  
58. {  
59. jk_shm_worker_header_t h;  
60. /* route */  
61. char route[JK_SHM_STR_SIZ+1];  
62. /* worker domain */  
63. char domain[JK_SHM_STR_SIZ+1];  
64. /* worker redirect route */  
65. char redirect[JK_SHM_STR_SIZ+1];  
66. /* Number of currently busy channels */  
67. volatile int busy;  
68. /* worker distance */  
69. volatile int distance;  
70. /* current activation state (config) of the worker */  
71. volatile int activation;  
72. /* current error state (runtime) of the worker */  
73. volatile int state;  
74. /* Current lb factor */  
75. volatile int lb_factor;  
76. /* 我们的参数加在这里*/  
77. volatile int maxbusy;  
78. /* Current lb reciprocal factor */  
79. volatile jk_uint64_t lb_mult;  
80. /* Current lb value */  
81. volatile jk_uint64_t lb_value;  
82. /* Statistical data */  
83. volatile time_t error_time;  
84. /* Number of times the worker was elected - snapshot during maintenance */  
85. volatile jk_uint64_t elected_snapshot;  
86. /* Number of non 200 responses */  
87. volatile jk_uint32_t errors;  
88. };  
89. typedef struct jk_shm_lb_sub_worker jk_shm_lb_sub_worker_t;  
90. /** jk shm lb worker record structure */  
91. struct jk_shm_lb_worker  
92. {  
93. jk_shm_worker_header_t h;  
94. /* Number of currently busy channels，该值是其名下ajp_worker的busy值之和*/  
95. volatile int busy;  
96. /* Maximum number of busy channels，该值是其名下ajp_worker的max_busy值之和  
97. */  
98. volatile int max_busy;  
99. int sticky_session;  
100. int sticky_session_force;  
101. int recover_wait_time;  
102. int max_reply_timeouts;  
103. int retries;  
104. int retry_interval;  
105. int lbmethod;  
106. int lblock;  
107. unsigned int max_packet_size;  
108. /* Last reset time */  
109. volatile time_t last_reset;  
110. volatile time_t last_maintain_time;  
111. /* Session cookie */  
112. char session_cookie[JK_SHM_STR_SIZ+1];  
113. /* Session path */  
114. char session_path[JK_SHM_STR_SIZ+1];  
115. };  
116. typedef struct jk_shm_lb_worker jk_shm_lb_worker_t;