passenger 2.2.11 → 2.2.12

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of passenger might be problematic. Click here for more details.

Files changed (287) hide show
  1. data/NEWS +29 -0
  2. data/bin/passenger-install-nginx-module +1 -1
  3. data/doc/Users guide Apache.html +38 -7
  4. data/doc/Users guide Nginx.html +36 -5
  5. data/doc/cxxapi/AbstractSpawnManager_8h-source.html +1 -1
  6. data/doc/cxxapi/Account_8h-source.html +1 -1
  7. data/doc/cxxapi/AccountsDatabase_8h-source.html +1 -1
  8. data/doc/cxxapi/AgentsStarter_8h-source.html +1 -1
  9. data/doc/cxxapi/BCrypt_8h-source.html +1 -1
  10. data/doc/cxxapi/Blowfish_8h-source.html +1 -1
  11. data/doc/cxxapi/Bucket_8h-source.html +5 -4
  12. data/doc/cxxapi/Constants_8h-source.html +2 -2
  13. data/doc/cxxapi/ContentHandler_8h-source.html +1 -1
  14. data/doc/cxxapi/DirectoryMapper_8h-source.html +10 -9
  15. data/doc/cxxapi/EventedServer_8h-source.html +415 -0
  16. data/doc/cxxapi/Exceptions_8h-source.html +1 -1
  17. data/doc/cxxapi/FileDescriptor_8h-source.html +1 -1
  18. data/doc/cxxapi/Hooks_8h-source.html +3 -2
  19. data/doc/cxxapi/HttpStatusExtractor_8h-source.html +324 -323
  20. data/doc/cxxapi/Logging_8h-source.html +643 -546
  21. data/doc/cxxapi/MessageChannel_8h-source.html +429 -404
  22. data/doc/cxxapi/MessageClient_8h-source.html +1 -1
  23. data/doc/cxxapi/MessageReadersWriters_8h-source.html +451 -0
  24. data/doc/cxxapi/MessageServer_8h-source.html +1 -1
  25. data/doc/cxxapi/PoolOptions_8h-source.html +287 -279
  26. data/doc/cxxapi/Process_8h-source.html +178 -167
  27. data/doc/cxxapi/RandomGenerator_8h-source.html +45 -18
  28. data/doc/cxxapi/ResourceLocator_8h-source.html +3 -3
  29. data/doc/cxxapi/ScgiRequestParser_8h-source.html +344 -343
  30. data/doc/cxxapi/ServerInstanceDir_8h-source.html +1 -1
  31. data/doc/cxxapi/Session_8h-source.html +387 -374
  32. data/doc/cxxapi/SpawnManager_8h-source.html +547 -538
  33. data/doc/cxxapi/StaticContentHandler_8h-source.html +1 -1
  34. data/doc/cxxapi/StaticString_8h-source.html +1 -1
  35. data/doc/cxxapi/StringListCreator_8h-source.html +1 -1
  36. data/doc/cxxapi/Utils_8h-source.html +545 -520
  37. data/doc/cxxapi/annotated.html +11 -8
  38. data/doc/cxxapi/apache2_2Configuration_8h-source.html +1 -1
  39. data/doc/cxxapi/classAgentWatcher-members.html +1 -1
  40. data/doc/cxxapi/classAgentWatcher.html +1 -1
  41. data/doc/cxxapi/classClient-members.html +1 -1
  42. data/doc/cxxapi/classClient.html +1 -1
  43. data/doc/cxxapi/classHooks-members.html +16 -13
  44. data/doc/cxxapi/classHooks.html +69 -73
  45. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager-members.html +1 -1
  46. data/doc/cxxapi/classPassenger_1_1AbstractSpawnManager.html +1 -1
  47. data/doc/cxxapi/classPassenger_1_1ArgumentException-members.html +1 -1
  48. data/doc/cxxapi/classPassenger_1_1ArgumentException.html +1 -1
  49. data/doc/cxxapi/classPassenger_1_1ArrayReader-members.html +33 -0
  50. data/doc/cxxapi/classPassenger_1_1ArrayReader.html +47 -0
  51. data/doc/cxxapi/classPassenger_1_1BufferedUpload-members.html +1 -1
  52. data/doc/cxxapi/classPassenger_1_1BufferedUpload.html +1 -1
  53. data/doc/cxxapi/classPassenger_1_1BusyException-members.html +1 -1
  54. data/doc/cxxapi/classPassenger_1_1BusyException.html +1 -1
  55. data/doc/cxxapi/classPassenger_1_1ConfigurationException-members.html +1 -1
  56. data/doc/cxxapi/classPassenger_1_1ConfigurationException.html +1 -1
  57. data/doc/cxxapi/classPassenger_1_1DirectoryMapper-members.html +18 -15
  58. data/doc/cxxapi/classPassenger_1_1DirectoryMapper.html +89 -99
  59. data/doc/cxxapi/classPassenger_1_1EOFException-members.html +1 -1
  60. data/doc/cxxapi/classPassenger_1_1EOFException.html +1 -1
  61. data/doc/cxxapi/classPassenger_1_1EventFd-members.html +1 -1
  62. data/doc/cxxapi/classPassenger_1_1EventFd.html +1 -1
  63. data/doc/cxxapi/classPassenger_1_1FileDescriptor-members.html +1 -1
  64. data/doc/cxxapi/classPassenger_1_1FileDescriptor.html +1 -1
  65. data/doc/cxxapi/classPassenger_1_1FileNotFoundException-members.html +1 -1
  66. data/doc/cxxapi/classPassenger_1_1FileNotFoundException.html +1 -1
  67. data/doc/cxxapi/classPassenger_1_1FileSystemException-members.html +1 -1
  68. data/doc/cxxapi/classPassenger_1_1FileSystemException.html +1 -1
  69. data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor-members.html +1 -1
  70. data/doc/cxxapi/classPassenger_1_1HttpStatusExtractor.html +2 -2
  71. data/doc/cxxapi/classPassenger_1_1IOException-members.html +1 -1
  72. data/doc/cxxapi/classPassenger_1_1IOException.html +1 -1
  73. data/doc/cxxapi/classPassenger_1_1MemZeroGuard-members.html +1 -1
  74. data/doc/cxxapi/classPassenger_1_1MemZeroGuard.html +1 -1
  75. data/doc/cxxapi/classPassenger_1_1MessageChannel-members.html +1 -1
  76. data/doc/cxxapi/classPassenger_1_1MessageChannel.html +1 -1
  77. data/doc/cxxapi/classPassenger_1_1MessageServer-members.html +1 -1
  78. data/doc/cxxapi/classPassenger_1_1MessageServer.html +1 -1
  79. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext-members.html +1 -1
  80. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1ClientContext.html +1 -1
  81. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext-members.html +1 -1
  82. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1CommonClientContext.html +1 -1
  83. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler-members.html +1 -1
  84. data/doc/cxxapi/classPassenger_1_1MessageServer_1_1Handler.html +1 -1
  85. data/doc/cxxapi/classPassenger_1_1Process-members.html +4 -3
  86. data/doc/cxxapi/classPassenger_1_1Process.html +40 -9
  87. data/doc/cxxapi/classPassenger_1_1RandomGenerator-members.html +2 -1
  88. data/doc/cxxapi/classPassenger_1_1RandomGenerator.html +29 -2
  89. data/doc/cxxapi/classPassenger_1_1RuntimeException-members.html +1 -1
  90. data/doc/cxxapi/classPassenger_1_1RuntimeException.html +1 -1
  91. data/doc/cxxapi/classPassenger_1_1ScalarReader-members.html +33 -0
  92. data/doc/cxxapi/classPassenger_1_1ScalarReader.html +47 -0
  93. data/doc/cxxapi/classPassenger_1_1ScgiRequestParser-members.html +1 -1
  94. data/doc/cxxapi/classPassenger_1_1ScgiRequestParser.html +1 -1
  95. data/doc/cxxapi/classPassenger_1_1SecurityException-members.html +1 -1
  96. data/doc/cxxapi/classPassenger_1_1SecurityException.html +1 -1
  97. data/doc/cxxapi/classPassenger_1_1Session-members.html +1 -1
  98. data/doc/cxxapi/classPassenger_1_1Session.html +2 -2
  99. data/doc/cxxapi/classPassenger_1_1SpawnException-members.html +1 -1
  100. data/doc/cxxapi/classPassenger_1_1SpawnException.html +1 -1
  101. data/doc/cxxapi/classPassenger_1_1SpawnManager-members.html +2 -2
  102. data/doc/cxxapi/classPassenger_1_1SpawnManager.html +6 -18
  103. data/doc/cxxapi/classPassenger_1_1StandardSession-members.html +1 -1
  104. data/doc/cxxapi/classPassenger_1_1StandardSession.html +1 -1
  105. data/doc/cxxapi/classPassenger_1_1StaticString-members.html +1 -1
  106. data/doc/cxxapi/classPassenger_1_1StaticString.html +1 -1
  107. data/doc/cxxapi/classPassenger_1_1SystemException-members.html +1 -1
  108. data/doc/cxxapi/classPassenger_1_1SystemException.html +1 -1
  109. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException-members.html +1 -1
  110. data/doc/cxxapi/classPassenger_1_1TimeRetrievalException.html +1 -1
  111. data/doc/cxxapi/classPassenger_1_1TimeoutException-members.html +1 -1
  112. data/doc/cxxapi/classPassenger_1_1TimeoutException.html +1 -1
  113. data/doc/cxxapi/classPassenger_1_1Uint16Reader-members.html +33 -0
  114. data/doc/cxxapi/classPassenger_1_1Uint16Reader.html +47 -0
  115. data/doc/cxxapi/classPassenger_1_1Uint32Reader-members.html +33 -0
  116. data/doc/cxxapi/classPassenger_1_1Uint32Reader.html +47 -0
  117. data/doc/cxxapi/classServer-members.html +1 -1
  118. data/doc/cxxapi/classServer.html +1 -1
  119. data/doc/cxxapi/classServerInstanceDirToucher-members.html +1 -1
  120. data/doc/cxxapi/classServerInstanceDirToucher.html +1 -1
  121. data/doc/cxxapi/classes.html +13 -10
  122. data/doc/cxxapi/definitions_8h-source.html +2 -1
  123. data/doc/cxxapi/doxygen.css +91 -0
  124. data/doc/cxxapi/files.html +16 -13
  125. data/doc/cxxapi/functions.html +32 -21
  126. data/doc/cxxapi/functions_enum.html +1 -1
  127. data/doc/cxxapi/functions_eval.html +1 -1
  128. data/doc/cxxapi/functions_func.html +32 -21
  129. data/doc/cxxapi/functions_vars.html +3 -1
  130. data/doc/cxxapi/graph_legend.html +20 -15
  131. data/doc/cxxapi/graph_legend.png +0 -0
  132. data/doc/cxxapi/group__Configuration.html +51 -64
  133. data/doc/cxxapi/group__Configuration.png +0 -0
  134. data/doc/cxxapi/group__Core.html +24 -26
  135. data/doc/cxxapi/group__Core.png +0 -0
  136. data/doc/cxxapi/group__Exceptions.html +1 -1
  137. data/doc/cxxapi/group__Hooks.html +17 -15
  138. data/doc/cxxapi/group__Hooks.png +0 -0
  139. data/doc/cxxapi/group__Support.html +11 -9
  140. data/doc/cxxapi/hierarchy.html +6 -1
  141. data/doc/cxxapi/index.html +10 -5
  142. data/doc/cxxapi/inherit__graph__10.map +1 -1
  143. data/doc/cxxapi/inherit__graph__10.md5 +1 -1
  144. data/doc/cxxapi/inherit__graph__10.png +0 -0
  145. data/doc/cxxapi/inherit__graph__11.map +1 -1
  146. data/doc/cxxapi/inherit__graph__11.md5 +1 -1
  147. data/doc/cxxapi/inherit__graph__11.png +0 -0
  148. data/doc/cxxapi/inherit__graph__12.map +1 -1
  149. data/doc/cxxapi/inherit__graph__12.md5 +1 -1
  150. data/doc/cxxapi/inherit__graph__12.png +0 -0
  151. data/doc/cxxapi/inherit__graph__13.map +1 -1
  152. data/doc/cxxapi/inherit__graph__13.md5 +1 -1
  153. data/doc/cxxapi/inherit__graph__13.png +0 -0
  154. data/doc/cxxapi/inherit__graph__14.map +1 -3
  155. data/doc/cxxapi/inherit__graph__14.md5 +1 -1
  156. data/doc/cxxapi/inherit__graph__14.png +0 -0
  157. data/doc/cxxapi/inherit__graph__15.map +1 -1
  158. data/doc/cxxapi/inherit__graph__15.md5 +1 -1
  159. data/doc/cxxapi/inherit__graph__15.png +0 -0
  160. data/doc/cxxapi/inherit__graph__16.map +3 -1
  161. data/doc/cxxapi/inherit__graph__16.md5 +1 -1
  162. data/doc/cxxapi/inherit__graph__16.png +0 -0
  163. data/doc/cxxapi/inherit__graph__17.map +1 -1
  164. data/doc/cxxapi/inherit__graph__17.md5 +1 -1
  165. data/doc/cxxapi/inherit__graph__17.png +0 -0
  166. data/doc/cxxapi/inherit__graph__18.map +1 -2
  167. data/doc/cxxapi/inherit__graph__18.md5 +1 -1
  168. data/doc/cxxapi/inherit__graph__18.png +0 -0
  169. data/doc/cxxapi/inherit__graph__19.map +1 -1
  170. data/doc/cxxapi/inherit__graph__19.md5 +1 -1
  171. data/doc/cxxapi/inherit__graph__19.png +0 -0
  172. data/doc/cxxapi/inherit__graph__20.map +2 -1
  173. data/doc/cxxapi/inherit__graph__20.md5 +1 -1
  174. data/doc/cxxapi/inherit__graph__20.png +0 -0
  175. data/doc/cxxapi/inherit__graph__21.map +1 -1
  176. data/doc/cxxapi/inherit__graph__21.md5 +1 -1
  177. data/doc/cxxapi/inherit__graph__21.png +0 -0
  178. data/doc/cxxapi/inherit__graph__22.map +1 -1
  179. data/doc/cxxapi/inherit__graph__22.md5 +1 -1
  180. data/doc/cxxapi/inherit__graph__22.png +0 -0
  181. data/doc/cxxapi/inherit__graph__23.map +1 -1
  182. data/doc/cxxapi/inherit__graph__23.md5 +1 -1
  183. data/doc/cxxapi/inherit__graph__23.png +0 -0
  184. data/doc/cxxapi/inherit__graph__24.map +1 -1
  185. data/doc/cxxapi/inherit__graph__24.md5 +1 -1
  186. data/doc/cxxapi/inherit__graph__24.png +0 -0
  187. data/doc/cxxapi/inherit__graph__25.map +1 -1
  188. data/doc/cxxapi/inherit__graph__25.md5 +1 -1
  189. data/doc/cxxapi/inherit__graph__25.png +0 -0
  190. data/doc/cxxapi/inherit__graph__26.map +1 -1
  191. data/doc/cxxapi/inherit__graph__26.md5 +1 -1
  192. data/doc/cxxapi/inherit__graph__26.png +0 -0
  193. data/doc/cxxapi/inherit__graph__27.map +1 -2
  194. data/doc/cxxapi/inherit__graph__27.md5 +1 -1
  195. data/doc/cxxapi/inherit__graph__27.png +0 -0
  196. data/doc/cxxapi/inherit__graph__28.map +1 -1
  197. data/doc/cxxapi/inherit__graph__28.md5 +1 -1
  198. data/doc/cxxapi/inherit__graph__28.png +0 -0
  199. data/doc/cxxapi/inherit__graph__29.map +1 -1
  200. data/doc/cxxapi/inherit__graph__29.md5 +1 -1
  201. data/doc/cxxapi/inherit__graph__29.png +0 -0
  202. data/doc/cxxapi/inherit__graph__30.map +2 -1
  203. data/doc/cxxapi/inherit__graph__30.md5 +1 -1
  204. data/doc/cxxapi/inherit__graph__30.png +0 -0
  205. data/doc/cxxapi/inherit__graph__31.map +1 -3
  206. data/doc/cxxapi/inherit__graph__31.md5 +1 -1
  207. data/doc/cxxapi/inherit__graph__31.png +0 -0
  208. data/doc/cxxapi/inherit__graph__32.map +1 -1
  209. data/doc/cxxapi/inherit__graph__32.md5 +1 -1
  210. data/doc/cxxapi/inherit__graph__32.png +0 -0
  211. data/doc/cxxapi/inherit__graph__33.map +1 -1
  212. data/doc/cxxapi/inherit__graph__33.md5 +1 -1
  213. data/doc/cxxapi/inherit__graph__33.png +0 -0
  214. data/doc/cxxapi/inherit__graph__34.map +3 -1
  215. data/doc/cxxapi/inherit__graph__34.md5 +1 -1
  216. data/doc/cxxapi/inherit__graph__34.png +0 -0
  217. data/doc/cxxapi/inherit__graph__35.map +1 -1
  218. data/doc/cxxapi/inherit__graph__35.md5 +1 -1
  219. data/doc/cxxapi/inherit__graph__35.png +0 -0
  220. data/doc/cxxapi/inherit__graph__36.map +1 -1
  221. data/doc/cxxapi/inherit__graph__36.md5 +1 -1
  222. data/doc/cxxapi/inherit__graph__36.png +0 -0
  223. data/doc/cxxapi/inherit__graph__37.map +1 -0
  224. data/doc/cxxapi/inherit__graph__37.md5 +1 -0
  225. data/doc/cxxapi/inherit__graph__37.png +0 -0
  226. data/doc/cxxapi/inherit__graph__38.map +1 -0
  227. data/doc/cxxapi/inherit__graph__38.md5 +1 -0
  228. data/doc/cxxapi/inherit__graph__38.png +0 -0
  229. data/doc/cxxapi/inherit__graph__39.map +1 -0
  230. data/doc/cxxapi/inherit__graph__39.md5 +1 -0
  231. data/doc/cxxapi/inherit__graph__39.png +0 -0
  232. data/doc/cxxapi/inherit__graph__5.map +1 -1
  233. data/doc/cxxapi/inherit__graph__5.md5 +1 -1
  234. data/doc/cxxapi/inherit__graph__5.png +0 -0
  235. data/doc/cxxapi/inherit__graph__6.map +1 -1
  236. data/doc/cxxapi/inherit__graph__6.md5 +1 -1
  237. data/doc/cxxapi/inherit__graph__6.png +0 -0
  238. data/doc/cxxapi/inherit__graph__7.map +1 -1
  239. data/doc/cxxapi/inherit__graph__7.md5 +1 -1
  240. data/doc/cxxapi/inherit__graph__7.png +0 -0
  241. data/doc/cxxapi/inherit__graph__8.map +1 -1
  242. data/doc/cxxapi/inherit__graph__8.md5 +1 -1
  243. data/doc/cxxapi/inherit__graph__8.png +0 -0
  244. data/doc/cxxapi/inherit__graph__9.map +1 -1
  245. data/doc/cxxapi/inherit__graph__9.md5 +1 -1
  246. data/doc/cxxapi/inherit__graph__9.png +0 -0
  247. data/doc/cxxapi/inherits.html +46 -31
  248. data/doc/cxxapi/main.html +12 -11
  249. data/doc/cxxapi/modules.html +16 -13
  250. data/doc/cxxapi/namespacePassenger.html +82 -5
  251. data/doc/cxxapi/namespacemembers.html +5 -3
  252. data/doc/cxxapi/namespacemembers_enum.html +1 -1
  253. data/doc/cxxapi/namespacemembers_eval.html +1 -1
  254. data/doc/cxxapi/namespacemembers_func.html +5 -3
  255. data/doc/cxxapi/namespacemembers_type.html +1 -1
  256. data/doc/cxxapi/namespaces.html +2 -2
  257. data/doc/cxxapi/nginx_2Configuration_8h-source.html +43 -42
  258. data/doc/cxxapi/ngx__http__passenger__module_8h-source.html +1 -1
  259. data/doc/cxxapi/structPassenger_1_1AnythingToString-members.html +1 -1
  260. data/doc/cxxapi/structPassenger_1_1AnythingToString.html +1 -1
  261. data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01StaticString_01_4_01_4-members.html +33 -0
  262. data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01StaticString_01_4_01_4.html +52 -0
  263. data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01string_01_4_01_4-members.html +1 -1
  264. data/doc/cxxapi/structPassenger_1_1AnythingToString_3_01vector_3_01string_01_4_01_4.html +1 -1
  265. data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard-members.html +1 -1
  266. data/doc/cxxapi/structPassenger_1_1MessageServer_1_1DisconnectEventBroadcastGuard.html +1 -1
  267. data/doc/cxxapi/structPassenger_1_1PoolOptions-members.html +3 -2
  268. data/doc/cxxapi/structPassenger_1_1PoolOptions.html +25 -5
  269. data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash-members.html +1 -1
  270. data/doc/cxxapi/structPassenger_1_1StaticString_1_1Hash.html +1 -1
  271. data/doc/cxxapi/tabs.css +1 -1
  272. data/doc/cxxapi/tree.html +20 -17
  273. data/doc/users_guide_snippets/tips.txt +28 -0
  274. data/ext/apache2/Hooks.cpp +19 -2
  275. data/ext/common/Utils.cpp +15 -4
  276. data/ext/common/Version.h +1 -1
  277. data/ext/nginx/StaticContentHandler.c +6 -3
  278. data/ext/phusion_passenger/native_support.c +25 -0
  279. data/lib/phusion_passenger/abstract_request_handler.rb +1 -0
  280. data/lib/phusion_passenger/constants.rb +1 -1
  281. data/lib/phusion_passenger/events.rb +3 -0
  282. data/lib/phusion_passenger/platform_info.rb +2 -1
  283. data/lib/phusion_passenger/rack/application_spawner.rb +2 -0
  284. data/lib/phusion_passenger/railz/application_spawner.rb +8 -0
  285. data/lib/phusion_passenger/utils.rb +69 -9
  286. data/lib/phusion_passenger/utils/rewindable_input.rb +10 -6
  287. metadata +55 -17
@@ -356,7 +356,7 @@
356
356
  <a name="l00334"></a>00334
357
357
  <a name="l00335"></a>00335 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_EXCEPTIONS_H_ */</span>
358
358
  </pre></div></div>
359
- <hr size="1"><address style="text-align: right;"><small>Generated on Sun Feb 21 12:22:45 2010 for Passenger by&nbsp;
359
+ <hr size="1"><address style="text-align: right;"><small>Generated on Sun Mar 28 14:11:56 2010 for Passenger by&nbsp;
360
360
  <a href="http://www.doxygen.org/index.html">
361
361
  <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
362
362
  </body>
@@ -199,7 +199,7 @@
199
199
  <a name="l00177"></a>00177
200
200
  <a name="l00178"></a>00178 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_FILE_DESCRIPTOR_H_ */</span>
201
201
  </pre></div></div>
202
- <hr size="1"><address style="text-align: right;"><small>Generated on Sun Feb 21 12:22:45 2010 for Passenger by&nbsp;
202
+ <hr size="1"><address style="text-align: right;"><small>Generated on Sun Mar 28 14:11:56 2010 for Passenger by&nbsp;
203
203
  <a href="http://www.doxygen.org/index.html">
204
204
  <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
205
205
  </body>
@@ -10,6 +10,7 @@
10
10
  <ul>
11
11
  <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
12
12
  <li><a href="modules.html"><span>Modules</span></a></li>
13
+ <li><a href="namespaces.html"><span>Namespaces</span></a></li>
13
14
  <li><a href="annotated.html"><span>Classes</span></a></li>
14
15
  <li class="current"><a href="files.html"><span>Files</span></a></li>
15
16
  </ul>
@@ -21,7 +22,7 @@
21
22
  </div>
22
23
  <h1>Hooks.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
23
24
  <a name="l00002"></a>00002 <span class="comment"> * Phusion Passenger - http://www.modrails.com/</span>
24
- <a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2008, 2009 Phusion</span>
25
+ <a name="l00003"></a>00003 <span class="comment"> * Copyright (c) 2010 Phusion</span>
25
26
  <a name="l00004"></a>00004 <span class="comment"> *</span>
26
27
  <a name="l00005"></a>00005 <span class="comment"> * "Phusion Passenger" is a trademark of Hongli Lai &amp; Ninh Bui.</span>
27
28
  <a name="l00006"></a>00006 <span class="comment"> *</span>
@@ -65,7 +66,7 @@
65
66
  <a name="l00044"></a>00044 <span class="preprocessor"></span>
66
67
  <a name="l00045"></a>00045 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_HOOKS_H_ */</span>
67
68
  </pre></div></div>
68
- <hr size="1"><address style="text-align: right;"><small>Generated on Fri Mar 5 11:13:03 2010 for Passenger by&nbsp;
69
+ <hr size="1"><address style="text-align: right;"><small>Generated on Sun Mar 28 14:11:56 2010 for Passenger by&nbsp;
69
70
  <a href="http://www.doxygen.org/index.html">
70
71
  <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
71
72
  </body>
@@ -48,330 +48,331 @@
48
48
  <a name="l00026"></a>00026 <span class="preprocessor">#include &lt;string&gt;</span>
49
49
  <a name="l00027"></a>00027 <span class="preprocessor">#include &lt;cstdio&gt;</span>
50
50
  <a name="l00028"></a>00028 <span class="preprocessor">#include &lt;cstdlib&gt;</span>
51
- <a name="l00029"></a>00029
52
- <a name="l00030"></a>00030 <span class="keyword">namespace </span>Passenger {
53
- <a name="l00031"></a>00031
54
- <a name="l00032"></a>00032 <span class="keyword">using namespace </span>std;
55
- <a name="l00033"></a>00033 <span class="comment"></span>
56
- <a name="l00034"></a>00034 <span class="comment">/**</span>
57
- <a name="l00035"></a>00035 <span class="comment"> * Utility class for extracting the HTTP status value from an HTTP response.</span>
58
- <a name="l00036"></a>00036 <span class="comment"> *</span>
59
- <a name="l00037"></a>00037 <span class="comment"> * This class is used for generating a proper HTTP response. The response data</span>
60
- <a name="l00038"></a>00038 <span class="comment"> * that Passenger backend processes generate are like CGI responses, and do not</span>
61
- <a name="l00039"></a>00039 <span class="comment"> * include an initial "HTTP/1.1 [status here]" line, so this class used to</span>
62
- <a name="l00040"></a>00040 <span class="comment"> * extract the status from the response in order to generate a proper initial</span>
63
- <a name="l00041"></a>00041 <span class="comment"> * HTTP response line.</span>
64
- <a name="l00042"></a>00042 <span class="comment"> *</span>
65
- <a name="l00043"></a>00043 <span class="comment"> * This class is supposed to be used as follows:</span>
66
- <a name="l00044"></a>00044 <span class="comment"> * - Keep feeding HTTP response data until feed() returns true. feed()</span>
67
- <a name="l00045"></a>00045 <span class="comment"> * buffers all fed data until it is able to extract the HTTP status.</span>
68
- <a name="l00046"></a>00046 <span class="comment"> * - Call getStatusLine() to retrieve the status line, and use this to generate</span>
69
- <a name="l00047"></a>00047 <span class="comment"> * an HTTP response line.</span>
70
- <a name="l00048"></a>00048 <span class="comment"> * - Call getBuffer() to retrieve all fed data so far. This data can be sent to</span>
71
- <a name="l00049"></a>00049 <span class="comment"> * the HTTP client.</span>
72
- <a name="l00050"></a>00050 <span class="comment"> *</span>
73
- <a name="l00051"></a>00051 <span class="comment"> * This class will also ensure that the status line contains a status text, e.g.</span>
74
- <a name="l00052"></a>00052 <span class="comment"> * if the HTTP data's status value is only "200" then "OK" will be automatically</span>
75
- <a name="l00053"></a>00053 <span class="comment"> * appended.</span>
76
- <a name="l00054"></a>00054 <span class="comment"> *</span>
77
- <a name="l00055"></a>00055 <span class="comment"> * @note</span>
78
- <a name="l00056"></a>00056 <span class="comment"> * When the API documentation for this class refers to "\r\n", we actually</span>
79
- <a name="l00057"></a>00057 <span class="comment"> * mean "\x0D\x0A" (the HTTP line termination string). "\r\n" is only written</span>
80
- <a name="l00058"></a>00058 <span class="comment"> * out of convenience.</span>
81
- <a name="l00059"></a>00059 <span class="comment"> */</span>
82
- <a name="l00060"></a><a class="code" href="classPassenger_1_1HttpStatusExtractor.html">00060</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1HttpStatusExtractor.html" title="Utility class for extracting the HTTP status value from an HTTP response.">HttpStatusExtractor</a> {
83
- <a name="l00061"></a>00061 <span class="keyword">private</span>:
84
- <a name="l00062"></a>00062 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> CR = <span class="stringliteral">'\x0D'</span>;
85
- <a name="l00063"></a>00063 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> LF = <span class="stringliteral">'\x0A'</span>;
86
- <a name="l00064"></a>00064
87
- <a name="l00065"></a>00065 <span class="keywordtype">string</span> buffer;
88
- <a name="l00066"></a>00066 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> searchStart;
89
- <a name="l00067"></a>00067 <span class="keywordtype">bool</span> fullHeaderReceived;
90
- <a name="l00068"></a>00068 <span class="keywordtype">string</span> statusLine;
91
- <a name="l00069"></a>00069
92
- <a name="l00070"></a>00070 <span class="keywordtype">bool</span> extractStatusLine() {
93
- <a name="l00071"></a>00071 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> statusHeaderName[] = <span class="stringliteral">"Status: "</span>;
94
- <a name="l00072"></a>00072 string::size_type start_pos, newline_pos;
95
- <a name="l00073"></a>00073
96
- <a name="l00074"></a>00074 <span class="keywordflow">if</span> (buffer.size() &gt; <span class="keyword">sizeof</span>(statusHeaderName) - 1
97
- <a name="l00075"></a>00075 &amp;&amp; memcmp(buffer.c_str(), statusHeaderName, <span class="keyword">sizeof</span>(statusHeaderName) - 1) == 0) {
98
- <a name="l00076"></a>00076 <span class="comment">// Status line starts at beginning of the header.</span>
99
- <a name="l00077"></a>00077 start_pos = <span class="keyword">sizeof</span>(statusHeaderName) - 1;
100
- <a name="l00078"></a>00078 newline_pos = buffer.find(<span class="stringliteral">"\x0D\x0A"</span>, 0, 2) + 2;
101
- <a name="l00079"></a>00079 } <span class="keywordflow">else</span> {
102
- <a name="l00080"></a>00080 <span class="comment">// Status line is not at the beginning of the header.</span>
103
- <a name="l00081"></a>00081 <span class="comment">// Look for it.</span>
104
- <a name="l00082"></a>00082 start_pos = buffer.find(<span class="stringliteral">"\x0D\x0AStatus: "</span>);
105
- <a name="l00083"></a>00083 <span class="keywordflow">if</span> (start_pos != string::npos) {
106
- <a name="l00084"></a>00084 start_pos += 2 + <span class="keyword">sizeof</span>(statusHeaderName) - 1;
107
- <a name="l00085"></a>00085 newline_pos = buffer.find(<span class="stringliteral">"\x0D\x0A"</span>, start_pos, 2) + 2;
108
- <a name="l00086"></a>00086 }
109
- <a name="l00087"></a>00087 }
110
- <a name="l00088"></a>00088 <span class="keywordflow">if</span> (start_pos != string::npos) {
111
- <a name="l00089"></a>00089 <span class="comment">// Status line has been found. Extract it.</span>
112
- <a name="l00090"></a>00090 statusLine = buffer.substr(start_pos, newline_pos - start_pos);
113
- <a name="l00091"></a>00091 addStatusTextIfNecessary();
114
- <a name="l00092"></a>00092 <span class="keywordflow">return</span> <span class="keyword">true</span>;
115
- <a name="l00093"></a>00093 } <span class="keywordflow">else</span> {
116
- <a name="l00094"></a>00094 <span class="comment">// Status line is not found. Do not change default</span>
117
- <a name="l00095"></a>00095 <span class="comment">// status line value.</span>
118
- <a name="l00096"></a>00096 <span class="keywordflow">return</span> <span class="keyword">false</span>;
119
- <a name="l00097"></a>00097 }
120
- <a name="l00098"></a>00098 }
121
- <a name="l00099"></a>00099
122
- <a name="l00100"></a>00100 <span class="keywordtype">void</span> addStatusTextIfNecessary() {
123
- <a name="l00101"></a>00101 <span class="keywordflow">if</span> (statusLine.find(<span class="charliteral">' '</span>) == string::npos) {
124
- <a name="l00102"></a>00102 <span class="comment">// The status line doesn't contain a status text, so add it.</span>
125
- <a name="l00103"></a>00103 <span class="keywordtype">int</span> statusCode = <a class="code" href="group__Support.html#g73b17b509ee44938a56bf16cbf82fb48" title="Converts the given string to an integer.">atoi</a>(statusLine.c_str());
126
- <a name="l00104"></a>00104 <span class="keywordflow">switch</span> (statusCode) {
127
- <a name="l00105"></a>00105 <span class="keywordflow">case</span> 100:
128
- <a name="l00106"></a>00106 statusLine = <span class="stringliteral">"100 Continue\x0D\x0A"</span>;
129
- <a name="l00107"></a>00107 <span class="keywordflow">break</span>;
130
- <a name="l00108"></a>00108 <span class="keywordflow">case</span> 101:
131
- <a name="l00109"></a>00109 statusLine = <span class="stringliteral">"101 Switching Protocols\x0D\x0A"</span>;
132
- <a name="l00110"></a>00110 <span class="keywordflow">break</span>;
133
- <a name="l00111"></a>00111 <span class="keywordflow">case</span> 102:
134
- <a name="l00112"></a>00112 statusLine = <span class="stringliteral">"102 Processing\x0D\x0A"</span>;
135
- <a name="l00113"></a>00113 <span class="keywordflow">break</span>;
136
- <a name="l00114"></a>00114 <span class="keywordflow">case</span> 200:
137
- <a name="l00115"></a>00115 statusLine = <span class="stringliteral">"200 OK\x0D\x0A"</span>;
138
- <a name="l00116"></a>00116 <span class="keywordflow">break</span>;
139
- <a name="l00117"></a>00117 <span class="keywordflow">case</span> 201:
140
- <a name="l00118"></a>00118 statusLine = <span class="stringliteral">"201 Created\x0D\x0A"</span>;
141
- <a name="l00119"></a>00119 <span class="keywordflow">break</span>;
142
- <a name="l00120"></a>00120 <span class="keywordflow">case</span> 202:
143
- <a name="l00121"></a>00121 statusLine = <span class="stringliteral">"202 Accepted\x0D\x0A"</span>;
144
- <a name="l00122"></a>00122 <span class="keywordflow">break</span>;
145
- <a name="l00123"></a>00123 <span class="keywordflow">case</span> 203:
146
- <a name="l00124"></a>00124 statusLine = <span class="stringliteral">"203 Non-Authoritative Information\x0D\x0A"</span>;
147
- <a name="l00125"></a>00125 <span class="keywordflow">break</span>;
148
- <a name="l00126"></a>00126 <span class="keywordflow">case</span> 204:
149
- <a name="l00127"></a>00127 statusLine = <span class="stringliteral">"204 No Content\x0D\x0A"</span>;
150
- <a name="l00128"></a>00128 <span class="keywordflow">break</span>;
151
- <a name="l00129"></a>00129 <span class="keywordflow">case</span> 205:
152
- <a name="l00130"></a>00130 statusLine = <span class="stringliteral">"205 Reset Content\x0D\x0A"</span>;
153
- <a name="l00131"></a>00131 <span class="keywordflow">break</span>;
154
- <a name="l00132"></a>00132 <span class="keywordflow">case</span> 206:
155
- <a name="l00133"></a>00133 statusLine = <span class="stringliteral">"206 Partial Content\x0D\x0A"</span>;
156
- <a name="l00134"></a>00134 <span class="keywordflow">break</span>;
157
- <a name="l00135"></a>00135 <span class="keywordflow">case</span> 207:
158
- <a name="l00136"></a>00136 statusLine = <span class="stringliteral">"207 Multi-Status\x0D\x0A"</span>;
159
- <a name="l00137"></a>00137 <span class="keywordflow">break</span>;
160
- <a name="l00138"></a>00138 <span class="keywordflow">case</span> 300:
161
- <a name="l00139"></a>00139 statusLine = <span class="stringliteral">"300 Multiple Choices\x0D\x0A"</span>;
162
- <a name="l00140"></a>00140 <span class="keywordflow">break</span>;
163
- <a name="l00141"></a>00141 <span class="keywordflow">case</span> 301:
164
- <a name="l00142"></a>00142 statusLine = <span class="stringliteral">"301 Moved Permanently\x0D\x0A"</span>;
165
- <a name="l00143"></a>00143 <span class="keywordflow">break</span>;
166
- <a name="l00144"></a>00144 <span class="keywordflow">case</span> 302:
167
- <a name="l00145"></a>00145 statusLine = <span class="stringliteral">"302 Found\x0D\x0A"</span>;
168
- <a name="l00146"></a>00146 <span class="keywordflow">break</span>;
169
- <a name="l00147"></a>00147 <span class="keywordflow">case</span> 303:
170
- <a name="l00148"></a>00148 statusLine = <span class="stringliteral">"303 See Other\x0D\x0A"</span>;
171
- <a name="l00149"></a>00149 <span class="keywordflow">break</span>;
172
- <a name="l00150"></a>00150 <span class="keywordflow">case</span> 304:
173
- <a name="l00151"></a>00151 statusLine = <span class="stringliteral">"304 Not Modified\x0D\x0A"</span>;
174
- <a name="l00152"></a>00152 <span class="keywordflow">break</span>;
175
- <a name="l00153"></a>00153 <span class="keywordflow">case</span> 305:
176
- <a name="l00154"></a>00154 statusLine = <span class="stringliteral">"305 Use Proxy\x0D\x0A"</span>;
177
- <a name="l00155"></a>00155 <span class="keywordflow">break</span>;
178
- <a name="l00156"></a>00156 <span class="keywordflow">case</span> 306:
179
- <a name="l00157"></a>00157 statusLine = <span class="stringliteral">"306 Switch Proxy\x0D\x0A"</span>;
180
- <a name="l00158"></a>00158 <span class="keywordflow">break</span>;
181
- <a name="l00159"></a>00159 <span class="keywordflow">case</span> 307:
182
- <a name="l00160"></a>00160 statusLine = <span class="stringliteral">"307 Temporary Redirect\x0D\x0A"</span>;
183
- <a name="l00161"></a>00161 <span class="keywordflow">break</span>;
184
- <a name="l00162"></a>00162 <span class="keywordflow">case</span> 308:
185
- <a name="l00163"></a>00163 <span class="comment">// Google Gears: http://code.google.com/p/gears/wiki/ResumableHttpRequestsProposal</span>
186
- <a name="l00164"></a>00164 statusLine = <span class="stringliteral">"308 Resume Incomplete\x0D\x0A"</span>;
187
- <a name="l00165"></a>00165 <span class="keywordflow">break</span>;
188
- <a name="l00166"></a>00166 <span class="keywordflow">case</span> 400:
189
- <a name="l00167"></a>00167 statusLine = <span class="stringliteral">"400 Bad Request\x0D\x0A"</span>;
190
- <a name="l00168"></a>00168 <span class="keywordflow">break</span>;
191
- <a name="l00169"></a>00169 <span class="keywordflow">case</span> 401:
192
- <a name="l00170"></a>00170 statusLine = <span class="stringliteral">"401 Unauthorized\x0D\x0A"</span>;
193
- <a name="l00171"></a>00171 <span class="keywordflow">break</span>;
194
- <a name="l00172"></a>00172 <span class="keywordflow">case</span> 402:
195
- <a name="l00173"></a>00173 statusLine = <span class="stringliteral">"402 Payment Required\x0D\x0A"</span>;
196
- <a name="l00174"></a>00174 <span class="keywordflow">break</span>;
197
- <a name="l00175"></a>00175 <span class="keywordflow">case</span> 403:
198
- <a name="l00176"></a>00176 statusLine = <span class="stringliteral">"403 Forbidden\x0D\x0A"</span>;
199
- <a name="l00177"></a>00177 <span class="keywordflow">break</span>;
200
- <a name="l00178"></a>00178 <span class="keywordflow">case</span> 404:
201
- <a name="l00179"></a>00179 statusLine = <span class="stringliteral">"404 Not Found\x0D\x0A"</span>;
202
- <a name="l00180"></a>00180 <span class="keywordflow">break</span>;
203
- <a name="l00181"></a>00181 <span class="keywordflow">case</span> 405:
204
- <a name="l00182"></a>00182 statusLine = <span class="stringliteral">"405 Method Not Allowed\x0D\x0A"</span>;
205
- <a name="l00183"></a>00183 <span class="keywordflow">break</span>;
206
- <a name="l00184"></a>00184 <span class="keywordflow">case</span> 406:
207
- <a name="l00185"></a>00185 statusLine = <span class="stringliteral">"406 Not Acceptable\x0D\x0A"</span>;
208
- <a name="l00186"></a>00186 <span class="keywordflow">break</span>;
209
- <a name="l00187"></a>00187 <span class="keywordflow">case</span> 407:
210
- <a name="l00188"></a>00188 statusLine = <span class="stringliteral">"407 Proxy Authentication Required\x0D\x0A"</span>;
211
- <a name="l00189"></a>00189 <span class="keywordflow">break</span>;
212
- <a name="l00190"></a>00190 <span class="keywordflow">case</span> 408:
213
- <a name="l00191"></a>00191 statusLine = <span class="stringliteral">"408 Request Timeout\x0D\x0A"</span>;
214
- <a name="l00192"></a>00192 <span class="keywordflow">break</span>;
215
- <a name="l00193"></a>00193 <span class="keywordflow">case</span> 409:
216
- <a name="l00194"></a>00194 statusLine = <span class="stringliteral">"409 Conflict\x0D\x0A"</span>;
217
- <a name="l00195"></a>00195 <span class="keywordflow">break</span>;
218
- <a name="l00196"></a>00196 <span class="keywordflow">case</span> 410:
219
- <a name="l00197"></a>00197 statusLine = <span class="stringliteral">"410 Gone\x0D\x0A"</span>;
220
- <a name="l00198"></a>00198 <span class="keywordflow">break</span>;
221
- <a name="l00199"></a>00199 <span class="keywordflow">case</span> 411:
222
- <a name="l00200"></a>00200 statusLine = <span class="stringliteral">"411 Length Required\x0D\x0A"</span>;
223
- <a name="l00201"></a>00201 <span class="keywordflow">break</span>;
224
- <a name="l00202"></a>00202 <span class="keywordflow">case</span> 412:
225
- <a name="l00203"></a>00203 statusLine = <span class="stringliteral">"412 Precondition Failed\x0D\x0A"</span>;
226
- <a name="l00204"></a>00204 <span class="keywordflow">break</span>;
227
- <a name="l00205"></a>00205 <span class="keywordflow">case</span> 413:
228
- <a name="l00206"></a>00206 statusLine = <span class="stringliteral">"413 Request Entity Too Large\x0D\x0A"</span>;
229
- <a name="l00207"></a>00207 <span class="keywordflow">break</span>;
230
- <a name="l00208"></a>00208 <span class="keywordflow">case</span> 414:
231
- <a name="l00209"></a>00209 statusLine = <span class="stringliteral">"414 Request-URI Too Long\x0D\x0A"</span>;
232
- <a name="l00210"></a>00210 <span class="keywordflow">break</span>;
233
- <a name="l00211"></a>00211 <span class="keywordflow">case</span> 415:
234
- <a name="l00212"></a>00212 statusLine = <span class="stringliteral">"415 Unsupported Media Type\x0D\x0A"</span>;
235
- <a name="l00213"></a>00213 <span class="keywordflow">break</span>;
236
- <a name="l00214"></a>00214 <span class="keywordflow">case</span> 416:
237
- <a name="l00215"></a>00215 statusLine = <span class="stringliteral">"416 Requested Range Not Satisfiable\x0D\x0A"</span>;
238
- <a name="l00216"></a>00216 <span class="keywordflow">break</span>;
239
- <a name="l00217"></a>00217 <span class="keywordflow">case</span> 417:
240
- <a name="l00218"></a>00218 statusLine = <span class="stringliteral">"417 Expectation Failed\x0D\x0A"</span>;
241
- <a name="l00219"></a>00219 <span class="keywordflow">break</span>;
242
- <a name="l00220"></a>00220 <span class="keywordflow">case</span> 418:
243
- <a name="l00221"></a>00221 statusLine = <span class="stringliteral">"418 Not A Funny April Fools Joke\x0D\x0A"</span>;
244
- <a name="l00222"></a>00222 <span class="keywordflow">break</span>;
245
- <a name="l00223"></a>00223 <span class="keywordflow">case</span> 422:
246
- <a name="l00224"></a>00224 statusLine = <span class="stringliteral">"422 Unprocessable Entity\x0D\x0A"</span>;
247
- <a name="l00225"></a>00225 <span class="keywordflow">break</span>;
248
- <a name="l00226"></a>00226 <span class="keywordflow">case</span> 423:
249
- <a name="l00227"></a>00227 statusLine = <span class="stringliteral">"423 Locked\x0D\x0A"</span>;
250
- <a name="l00228"></a>00228 <span class="keywordflow">break</span>;
251
- <a name="l00229"></a>00229 <span class="keywordflow">case</span> 424:
252
- <a name="l00230"></a>00230 statusLine = <span class="stringliteral">"424 Unordered Collection\x0D\x0A"</span>;
253
- <a name="l00231"></a>00231 <span class="keywordflow">break</span>;
254
- <a name="l00232"></a>00232 <span class="keywordflow">case</span> 426:
255
- <a name="l00233"></a>00233 statusLine = <span class="stringliteral">"426 Upgrade Required\x0D\x0A"</span>;
256
- <a name="l00234"></a>00234 <span class="keywordflow">break</span>;
257
- <a name="l00235"></a>00235 <span class="keywordflow">case</span> 449:
258
- <a name="l00236"></a>00236 statusLine = <span class="stringliteral">"449 Retry With\x0D\x0A"</span>;
259
- <a name="l00237"></a>00237 <span class="keywordflow">break</span>;
260
- <a name="l00238"></a>00238 <span class="keywordflow">case</span> 450:
261
- <a name="l00239"></a>00239 statusLine = <span class="stringliteral">"450 Blocked\x0D\x0A"</span>;
262
- <a name="l00240"></a>00240 <span class="keywordflow">break</span>;
263
- <a name="l00241"></a>00241 <span class="keywordflow">case</span> 500:
264
- <a name="l00242"></a>00242 statusLine = <span class="stringliteral">"500 Internal Server Error\x0D\x0A"</span>;
265
- <a name="l00243"></a>00243 <span class="keywordflow">break</span>;
266
- <a name="l00244"></a>00244 <span class="keywordflow">case</span> 501:
267
- <a name="l00245"></a>00245 statusLine = <span class="stringliteral">"501 Not Implemented\x0D\x0A"</span>;
268
- <a name="l00246"></a>00246 <span class="keywordflow">break</span>;
269
- <a name="l00247"></a>00247 <span class="keywordflow">case</span> 502:
270
- <a name="l00248"></a>00248 statusLine = <span class="stringliteral">"502 Bad Gateway\x0D\x0A"</span>;
271
- <a name="l00249"></a>00249 <span class="keywordflow">break</span>;
272
- <a name="l00250"></a>00250 <span class="keywordflow">case</span> 503:
273
- <a name="l00251"></a>00251 statusLine = <span class="stringliteral">"503 Service Unavailable\x0D\x0A"</span>;
274
- <a name="l00252"></a>00252 <span class="keywordflow">break</span>;
275
- <a name="l00253"></a>00253 <span class="keywordflow">case</span> 504:
276
- <a name="l00254"></a>00254 statusLine = <span class="stringliteral">"504 Gateway Timeout\x0D\x0A"</span>;
277
- <a name="l00255"></a>00255 <span class="keywordflow">break</span>;
278
- <a name="l00256"></a>00256 <span class="keywordflow">case</span> 505:
279
- <a name="l00257"></a>00257 statusLine = <span class="stringliteral">"505 HTTP Version Not Supported\x0D\x0A"</span>;
280
- <a name="l00258"></a>00258 <span class="keywordflow">break</span>;
281
- <a name="l00259"></a>00259 <span class="keywordflow">case</span> 506:
282
- <a name="l00260"></a>00260 statusLine = <span class="stringliteral">"506 Variant Also Negotiates\x0D\x0A"</span>;
283
- <a name="l00261"></a>00261 <span class="keywordflow">break</span>;
284
- <a name="l00262"></a>00262 <span class="keywordflow">case</span> 507:
285
- <a name="l00263"></a>00263 statusLine = <span class="stringliteral">"507 Insufficient Storage\x0D\x0A"</span>;
286
- <a name="l00264"></a>00264 <span class="keywordflow">break</span>;
287
- <a name="l00265"></a>00265 <span class="keywordflow">case</span> 509:
288
- <a name="l00266"></a>00266 statusLine = <span class="stringliteral">"509 Bandwidth Limit Exceeded\x0D\x0A"</span>;
289
- <a name="l00267"></a>00267 <span class="keywordflow">break</span>;
290
- <a name="l00268"></a>00268 <span class="keywordflow">case</span> 510:
291
- <a name="l00269"></a>00269 statusLine = <span class="stringliteral">"510 Not Extended\x0D\x0A"</span>;
292
- <a name="l00270"></a>00270 <span class="keywordflow">break</span>;
293
- <a name="l00271"></a>00271 <span class="keywordflow">default</span>:
294
- <a name="l00272"></a>00272 <span class="keywordtype">char</span> temp[32];
295
- <a name="l00273"></a>00273 snprintf(temp, <span class="keyword">sizeof</span>(temp),
296
- <a name="l00274"></a>00274 <span class="stringliteral">"%d Unknown Status Code\x0D\x0A"</span>,
297
- <a name="l00275"></a>00275 statusCode);
298
- <a name="l00276"></a>00276 temp[<span class="keyword">sizeof</span>(temp) - 1] = <span class="charliteral">'\0'</span>;
299
- <a name="l00277"></a>00277 statusLine = temp;
300
- <a name="l00278"></a>00278 }
301
- <a name="l00279"></a>00279 }
302
- <a name="l00280"></a>00280 }
303
- <a name="l00281"></a>00281
304
- <a name="l00282"></a>00282 <span class="keyword">public</span>:
305
- <a name="l00283"></a>00283 <a class="code" href="classPassenger_1_1HttpStatusExtractor.html" title="Utility class for extracting the HTTP status value from an HTTP response.">HttpStatusExtractor</a>() {
306
- <a name="l00284"></a>00284 searchStart = 0;
307
- <a name="l00285"></a>00285 fullHeaderReceived = <span class="keyword">false</span>;
308
- <a name="l00286"></a>00286 statusLine = <span class="stringliteral">"200 OK\r\n"</span>;
309
- <a name="l00287"></a>00287 }
310
- <a name="l00288"></a>00288 <span class="comment"></span>
311
- <a name="l00289"></a>00289 <span class="comment"> /**</span>
312
- <a name="l00290"></a>00290 <span class="comment"> * Feed HTTP response data to this HttpStatusExtractor.</span>
313
- <a name="l00291"></a>00291 <span class="comment"> *</span>
314
- <a name="l00292"></a>00292 <span class="comment"> * One is to keep feeding data until this method returns true.</span>
315
- <a name="l00293"></a>00293 <span class="comment"> * When a sufficient amount of data has been fed, this method will</span>
316
- <a name="l00294"></a>00294 <span class="comment"> * extract the status line from the data that has been fed so far,</span>
317
- <a name="l00295"></a>00295 <span class="comment"> * and return true.</span>
318
- <a name="l00296"></a>00296 <span class="comment"> *</span>
319
- <a name="l00297"></a>00297 <span class="comment"> * Do not call this method again once it has returned true.</span>
320
- <a name="l00298"></a>00298 <span class="comment"> *</span>
321
- <a name="l00299"></a>00299 <span class="comment"> * It is safe to feed excess data. That is, it is safe if the 'data'</span>
322
- <a name="l00300"></a>00300 <span class="comment"> * argument contains a part of the HTTP response body.</span>
323
- <a name="l00301"></a>00301 <span class="comment"> * HttpStatusExtractor will only look for the status line in the HTTP</span>
324
- <a name="l00302"></a>00302 <span class="comment"> * response header, not in the HTTP response body. All fed data is</span>
325
- <a name="l00303"></a>00303 <span class="comment"> * buffered and will be available via getBuffer(), so no data will be</span>
326
- <a name="l00304"></a>00304 <span class="comment"> * lost.</span>
327
- <a name="l00305"></a>00305 <span class="comment"> *</span>
328
- <a name="l00306"></a>00306 <span class="comment"> * @return Whether the HTTP status has been extracted yet.</span>
329
- <a name="l00307"></a>00307 <span class="comment"> * @pre feed() did not previously return true.</span>
330
- <a name="l00308"></a>00308 <span class="comment"> * @pre data != NULL</span>
331
- <a name="l00309"></a>00309 <span class="comment"> * @pre size &gt; 0</span>
332
- <a name="l00310"></a>00310 <span class="comment"> */</span>
333
- <a name="l00311"></a><a class="code" href="classPassenger_1_1HttpStatusExtractor.html#ca6fd77038e76b313830757730780d51">00311</a> <span class="keywordtype">bool</span> <a class="code" href="classPassenger_1_1HttpStatusExtractor.html#ca6fd77038e76b313830757730780d51" title="Feed HTTP response data to this HttpStatusExtractor.">feed</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *data, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
334
- <a name="l00312"></a>00312 <span class="keywordflow">if</span> (fullHeaderReceived) {
335
- <a name="l00313"></a>00313 <span class="keywordflow">return</span> <span class="keyword">true</span>;
336
- <a name="l00314"></a>00314 }
337
- <a name="l00315"></a>00315 buffer.append(data, size);
338
- <a name="l00316"></a>00316 <span class="keywordflow">for</span> (; buffer.size() &gt;= 3 &amp;&amp; searchStart &lt; buffer.size() - 3; searchStart++) {
339
- <a name="l00317"></a>00317 <span class="keywordflow">if</span> (buffer[searchStart] == CR &amp;&amp;
340
- <a name="l00318"></a>00318 buffer[searchStart + 1] == LF &amp;&amp;
341
- <a name="l00319"></a>00319 buffer[searchStart + 2] == CR &amp;&amp;
342
- <a name="l00320"></a>00320 buffer[searchStart + 3] == LF) {
343
- <a name="l00321"></a>00321 fullHeaderReceived = <span class="keyword">true</span>;
344
- <a name="l00322"></a>00322 extractStatusLine();
345
- <a name="l00323"></a>00323 <span class="keywordflow">return</span> <span class="keyword">true</span>;
346
- <a name="l00324"></a>00324 }
347
- <a name="l00325"></a>00325 }
348
- <a name="l00326"></a>00326 <span class="keywordflow">return</span> <span class="keyword">false</span>;
349
- <a name="l00327"></a>00327 }
350
- <a name="l00328"></a>00328 <span class="comment"></span>
351
- <a name="l00329"></a>00329 <span class="comment"> /**</span>
352
- <a name="l00330"></a>00330 <span class="comment"> * Returns the HTTP status line that has been determined.</span>
353
- <a name="l00331"></a>00331 <span class="comment"> *</span>
354
- <a name="l00332"></a>00332 <span class="comment"> * The default value is "200 OK\r\n", which is returned if the HTTP</span>
355
- <a name="l00333"></a>00333 <span class="comment"> * response data that has been fed so far does not include a status</span>
356
- <a name="l00334"></a>00334 <span class="comment"> * line.</span>
357
- <a name="l00335"></a>00335 <span class="comment"> *</span>
358
- <a name="l00336"></a>00336 <span class="comment"> * @note The return value includes a trailing CRLF, e.g. "404 Not Found\r\n".</span>
359
- <a name="l00337"></a>00337 <span class="comment"> */</span>
360
- <a name="l00338"></a><a class="code" href="classPassenger_1_1HttpStatusExtractor.html#f0db266fc713f532047880c5eaae44d5">00338</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1HttpStatusExtractor.html#f0db266fc713f532047880c5eaae44d5" title="Returns the HTTP status line that has been determined.">getStatusLine</a>()<span class="keyword"> const </span>{
361
- <a name="l00339"></a>00339 <span class="keywordflow">return</span> statusLine;
362
- <a name="l00340"></a>00340 }
363
- <a name="l00341"></a>00341 <span class="comment"></span>
364
- <a name="l00342"></a>00342 <span class="comment"> /**</span>
365
- <a name="l00343"></a>00343 <span class="comment"> * Get the data that has been fed so far.</span>
366
- <a name="l00344"></a>00344 <span class="comment"> */</span>
367
- <a name="l00345"></a><a class="code" href="classPassenger_1_1HttpStatusExtractor.html#3749842ba4f8f59b6b69c594da963f22">00345</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1HttpStatusExtractor.html#3749842ba4f8f59b6b69c594da963f22" title="Get the data that has been fed so far.">getBuffer</a>()<span class="keyword"> const </span>{
368
- <a name="l00346"></a>00346 <span class="keywordflow">return</span> buffer;
369
- <a name="l00347"></a>00347 }
370
- <a name="l00348"></a>00348 };
371
- <a name="l00349"></a>00349
372
- <a name="l00350"></a>00350 } <span class="comment">// namespace Passenger</span>
51
+ <a name="l00029"></a>00029 <span class="preprocessor">#include &lt;cstring&gt;</span>
52
+ <a name="l00030"></a>00030
53
+ <a name="l00031"></a>00031 <span class="keyword">namespace </span>Passenger {
54
+ <a name="l00032"></a>00032
55
+ <a name="l00033"></a>00033 <span class="keyword">using namespace </span>std;
56
+ <a name="l00034"></a>00034 <span class="comment"></span>
57
+ <a name="l00035"></a>00035 <span class="comment">/**</span>
58
+ <a name="l00036"></a>00036 <span class="comment"> * Utility class for extracting the HTTP status value from an HTTP response.</span>
59
+ <a name="l00037"></a>00037 <span class="comment"> *</span>
60
+ <a name="l00038"></a>00038 <span class="comment"> * This class is used for generating a proper HTTP response. The response data</span>
61
+ <a name="l00039"></a>00039 <span class="comment"> * that Passenger backend processes generate are like CGI responses, and do not</span>
62
+ <a name="l00040"></a>00040 <span class="comment"> * include an initial "HTTP/1.1 [status here]" line, so this class used to</span>
63
+ <a name="l00041"></a>00041 <span class="comment"> * extract the status from the response in order to generate a proper initial</span>
64
+ <a name="l00042"></a>00042 <span class="comment"> * HTTP response line.</span>
65
+ <a name="l00043"></a>00043 <span class="comment"> *</span>
66
+ <a name="l00044"></a>00044 <span class="comment"> * This class is supposed to be used as follows:</span>
67
+ <a name="l00045"></a>00045 <span class="comment"> * - Keep feeding HTTP response data until feed() returns true. feed()</span>
68
+ <a name="l00046"></a>00046 <span class="comment"> * buffers all fed data until it is able to extract the HTTP status.</span>
69
+ <a name="l00047"></a>00047 <span class="comment"> * - Call getStatusLine() to retrieve the status line, and use this to generate</span>
70
+ <a name="l00048"></a>00048 <span class="comment"> * an HTTP response line.</span>
71
+ <a name="l00049"></a>00049 <span class="comment"> * - Call getBuffer() to retrieve all fed data so far. This data can be sent to</span>
72
+ <a name="l00050"></a>00050 <span class="comment"> * the HTTP client.</span>
73
+ <a name="l00051"></a>00051 <span class="comment"> *</span>
74
+ <a name="l00052"></a>00052 <span class="comment"> * This class will also ensure that the status line contains a status text, e.g.</span>
75
+ <a name="l00053"></a>00053 <span class="comment"> * if the HTTP data's status value is only "200" then "OK" will be automatically</span>
76
+ <a name="l00054"></a>00054 <span class="comment"> * appended.</span>
77
+ <a name="l00055"></a>00055 <span class="comment"> *</span>
78
+ <a name="l00056"></a>00056 <span class="comment"> * @note</span>
79
+ <a name="l00057"></a>00057 <span class="comment"> * When the API documentation for this class refers to "\r\n", we actually</span>
80
+ <a name="l00058"></a>00058 <span class="comment"> * mean "\x0D\x0A" (the HTTP line termination string). "\r\n" is only written</span>
81
+ <a name="l00059"></a>00059 <span class="comment"> * out of convenience.</span>
82
+ <a name="l00060"></a>00060 <span class="comment"> */</span>
83
+ <a name="l00061"></a><a class="code" href="classPassenger_1_1HttpStatusExtractor.html">00061</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1HttpStatusExtractor.html" title="Utility class for extracting the HTTP status value from an HTTP response.">HttpStatusExtractor</a> {
84
+ <a name="l00062"></a>00062 <span class="keyword">private</span>:
85
+ <a name="l00063"></a>00063 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> CR = <span class="stringliteral">'\x0D'</span>;
86
+ <a name="l00064"></a>00064 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> LF = <span class="stringliteral">'\x0A'</span>;
87
+ <a name="l00065"></a>00065
88
+ <a name="l00066"></a>00066 <span class="keywordtype">string</span> buffer;
89
+ <a name="l00067"></a>00067 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> searchStart;
90
+ <a name="l00068"></a>00068 <span class="keywordtype">bool</span> fullHeaderReceived;
91
+ <a name="l00069"></a>00069 <span class="keywordtype">string</span> statusLine;
92
+ <a name="l00070"></a>00070
93
+ <a name="l00071"></a>00071 <span class="keywordtype">bool</span> extractStatusLine() {
94
+ <a name="l00072"></a>00072 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> statusHeaderName[] = <span class="stringliteral">"Status: "</span>;
95
+ <a name="l00073"></a>00073 string::size_type start_pos, newline_pos;
96
+ <a name="l00074"></a>00074
97
+ <a name="l00075"></a>00075 <span class="keywordflow">if</span> (buffer.size() &gt; <span class="keyword">sizeof</span>(statusHeaderName) - 1
98
+ <a name="l00076"></a>00076 &amp;&amp; memcmp(buffer.c_str(), statusHeaderName, <span class="keyword">sizeof</span>(statusHeaderName) - 1) == 0) {
99
+ <a name="l00077"></a>00077 <span class="comment">// Status line starts at beginning of the header.</span>
100
+ <a name="l00078"></a>00078 start_pos = <span class="keyword">sizeof</span>(statusHeaderName) - 1;
101
+ <a name="l00079"></a>00079 newline_pos = buffer.find(<span class="stringliteral">"\x0D\x0A"</span>, 0, 2) + 2;
102
+ <a name="l00080"></a>00080 } <span class="keywordflow">else</span> {
103
+ <a name="l00081"></a>00081 <span class="comment">// Status line is not at the beginning of the header.</span>
104
+ <a name="l00082"></a>00082 <span class="comment">// Look for it.</span>
105
+ <a name="l00083"></a>00083 start_pos = buffer.find(<span class="stringliteral">"\x0D\x0AStatus: "</span>);
106
+ <a name="l00084"></a>00084 <span class="keywordflow">if</span> (start_pos != string::npos) {
107
+ <a name="l00085"></a>00085 start_pos += 2 + <span class="keyword">sizeof</span>(statusHeaderName) - 1;
108
+ <a name="l00086"></a>00086 newline_pos = buffer.find(<span class="stringliteral">"\x0D\x0A"</span>, start_pos, 2) + 2;
109
+ <a name="l00087"></a>00087 }
110
+ <a name="l00088"></a>00088 }
111
+ <a name="l00089"></a>00089 <span class="keywordflow">if</span> (start_pos != string::npos) {
112
+ <a name="l00090"></a>00090 <span class="comment">// Status line has been found. Extract it.</span>
113
+ <a name="l00091"></a>00091 statusLine = buffer.substr(start_pos, newline_pos - start_pos);
114
+ <a name="l00092"></a>00092 addStatusTextIfNecessary();
115
+ <a name="l00093"></a>00093 <span class="keywordflow">return</span> <span class="keyword">true</span>;
116
+ <a name="l00094"></a>00094 } <span class="keywordflow">else</span> {
117
+ <a name="l00095"></a>00095 <span class="comment">// Status line is not found. Do not change default</span>
118
+ <a name="l00096"></a>00096 <span class="comment">// status line value.</span>
119
+ <a name="l00097"></a>00097 <span class="keywordflow">return</span> <span class="keyword">false</span>;
120
+ <a name="l00098"></a>00098 }
121
+ <a name="l00099"></a>00099 }
122
+ <a name="l00100"></a>00100
123
+ <a name="l00101"></a>00101 <span class="keywordtype">void</span> addStatusTextIfNecessary() {
124
+ <a name="l00102"></a>00102 <span class="keywordflow">if</span> (statusLine.find(<span class="charliteral">' '</span>) == string::npos) {
125
+ <a name="l00103"></a>00103 <span class="comment">// The status line doesn't contain a status text, so add it.</span>
126
+ <a name="l00104"></a>00104 <span class="keywordtype">int</span> statusCode = <a class="code" href="group__Support.html#g73b17b509ee44938a56bf16cbf82fb48" title="Converts the given string to an integer.">atoi</a>(statusLine.c_str());
127
+ <a name="l00105"></a>00105 <span class="keywordflow">switch</span> (statusCode) {
128
+ <a name="l00106"></a>00106 <span class="keywordflow">case</span> 100:
129
+ <a name="l00107"></a>00107 statusLine = <span class="stringliteral">"100 Continue\x0D\x0A"</span>;
130
+ <a name="l00108"></a>00108 <span class="keywordflow">break</span>;
131
+ <a name="l00109"></a>00109 <span class="keywordflow">case</span> 101:
132
+ <a name="l00110"></a>00110 statusLine = <span class="stringliteral">"101 Switching Protocols\x0D\x0A"</span>;
133
+ <a name="l00111"></a>00111 <span class="keywordflow">break</span>;
134
+ <a name="l00112"></a>00112 <span class="keywordflow">case</span> 102:
135
+ <a name="l00113"></a>00113 statusLine = <span class="stringliteral">"102 Processing\x0D\x0A"</span>;
136
+ <a name="l00114"></a>00114 <span class="keywordflow">break</span>;
137
+ <a name="l00115"></a>00115 <span class="keywordflow">case</span> 200:
138
+ <a name="l00116"></a>00116 statusLine = <span class="stringliteral">"200 OK\x0D\x0A"</span>;
139
+ <a name="l00117"></a>00117 <span class="keywordflow">break</span>;
140
+ <a name="l00118"></a>00118 <span class="keywordflow">case</span> 201:
141
+ <a name="l00119"></a>00119 statusLine = <span class="stringliteral">"201 Created\x0D\x0A"</span>;
142
+ <a name="l00120"></a>00120 <span class="keywordflow">break</span>;
143
+ <a name="l00121"></a>00121 <span class="keywordflow">case</span> 202:
144
+ <a name="l00122"></a>00122 statusLine = <span class="stringliteral">"202 Accepted\x0D\x0A"</span>;
145
+ <a name="l00123"></a>00123 <span class="keywordflow">break</span>;
146
+ <a name="l00124"></a>00124 <span class="keywordflow">case</span> 203:
147
+ <a name="l00125"></a>00125 statusLine = <span class="stringliteral">"203 Non-Authoritative Information\x0D\x0A"</span>;
148
+ <a name="l00126"></a>00126 <span class="keywordflow">break</span>;
149
+ <a name="l00127"></a>00127 <span class="keywordflow">case</span> 204:
150
+ <a name="l00128"></a>00128 statusLine = <span class="stringliteral">"204 No Content\x0D\x0A"</span>;
151
+ <a name="l00129"></a>00129 <span class="keywordflow">break</span>;
152
+ <a name="l00130"></a>00130 <span class="keywordflow">case</span> 205:
153
+ <a name="l00131"></a>00131 statusLine = <span class="stringliteral">"205 Reset Content\x0D\x0A"</span>;
154
+ <a name="l00132"></a>00132 <span class="keywordflow">break</span>;
155
+ <a name="l00133"></a>00133 <span class="keywordflow">case</span> 206:
156
+ <a name="l00134"></a>00134 statusLine = <span class="stringliteral">"206 Partial Content\x0D\x0A"</span>;
157
+ <a name="l00135"></a>00135 <span class="keywordflow">break</span>;
158
+ <a name="l00136"></a>00136 <span class="keywordflow">case</span> 207:
159
+ <a name="l00137"></a>00137 statusLine = <span class="stringliteral">"207 Multi-Status\x0D\x0A"</span>;
160
+ <a name="l00138"></a>00138 <span class="keywordflow">break</span>;
161
+ <a name="l00139"></a>00139 <span class="keywordflow">case</span> 300:
162
+ <a name="l00140"></a>00140 statusLine = <span class="stringliteral">"300 Multiple Choices\x0D\x0A"</span>;
163
+ <a name="l00141"></a>00141 <span class="keywordflow">break</span>;
164
+ <a name="l00142"></a>00142 <span class="keywordflow">case</span> 301:
165
+ <a name="l00143"></a>00143 statusLine = <span class="stringliteral">"301 Moved Permanently\x0D\x0A"</span>;
166
+ <a name="l00144"></a>00144 <span class="keywordflow">break</span>;
167
+ <a name="l00145"></a>00145 <span class="keywordflow">case</span> 302:
168
+ <a name="l00146"></a>00146 statusLine = <span class="stringliteral">"302 Found\x0D\x0A"</span>;
169
+ <a name="l00147"></a>00147 <span class="keywordflow">break</span>;
170
+ <a name="l00148"></a>00148 <span class="keywordflow">case</span> 303:
171
+ <a name="l00149"></a>00149 statusLine = <span class="stringliteral">"303 See Other\x0D\x0A"</span>;
172
+ <a name="l00150"></a>00150 <span class="keywordflow">break</span>;
173
+ <a name="l00151"></a>00151 <span class="keywordflow">case</span> 304:
174
+ <a name="l00152"></a>00152 statusLine = <span class="stringliteral">"304 Not Modified\x0D\x0A"</span>;
175
+ <a name="l00153"></a>00153 <span class="keywordflow">break</span>;
176
+ <a name="l00154"></a>00154 <span class="keywordflow">case</span> 305:
177
+ <a name="l00155"></a>00155 statusLine = <span class="stringliteral">"305 Use Proxy\x0D\x0A"</span>;
178
+ <a name="l00156"></a>00156 <span class="keywordflow">break</span>;
179
+ <a name="l00157"></a>00157 <span class="keywordflow">case</span> 306:
180
+ <a name="l00158"></a>00158 statusLine = <span class="stringliteral">"306 Switch Proxy\x0D\x0A"</span>;
181
+ <a name="l00159"></a>00159 <span class="keywordflow">break</span>;
182
+ <a name="l00160"></a>00160 <span class="keywordflow">case</span> 307:
183
+ <a name="l00161"></a>00161 statusLine = <span class="stringliteral">"307 Temporary Redirect\x0D\x0A"</span>;
184
+ <a name="l00162"></a>00162 <span class="keywordflow">break</span>;
185
+ <a name="l00163"></a>00163 <span class="keywordflow">case</span> 308:
186
+ <a name="l00164"></a>00164 <span class="comment">// Google Gears: http://code.google.com/p/gears/wiki/ResumableHttpRequestsProposal</span>
187
+ <a name="l00165"></a>00165 statusLine = <span class="stringliteral">"308 Resume Incomplete\x0D\x0A"</span>;
188
+ <a name="l00166"></a>00166 <span class="keywordflow">break</span>;
189
+ <a name="l00167"></a>00167 <span class="keywordflow">case</span> 400:
190
+ <a name="l00168"></a>00168 statusLine = <span class="stringliteral">"400 Bad Request\x0D\x0A"</span>;
191
+ <a name="l00169"></a>00169 <span class="keywordflow">break</span>;
192
+ <a name="l00170"></a>00170 <span class="keywordflow">case</span> 401:
193
+ <a name="l00171"></a>00171 statusLine = <span class="stringliteral">"401 Unauthorized\x0D\x0A"</span>;
194
+ <a name="l00172"></a>00172 <span class="keywordflow">break</span>;
195
+ <a name="l00173"></a>00173 <span class="keywordflow">case</span> 402:
196
+ <a name="l00174"></a>00174 statusLine = <span class="stringliteral">"402 Payment Required\x0D\x0A"</span>;
197
+ <a name="l00175"></a>00175 <span class="keywordflow">break</span>;
198
+ <a name="l00176"></a>00176 <span class="keywordflow">case</span> 403:
199
+ <a name="l00177"></a>00177 statusLine = <span class="stringliteral">"403 Forbidden\x0D\x0A"</span>;
200
+ <a name="l00178"></a>00178 <span class="keywordflow">break</span>;
201
+ <a name="l00179"></a>00179 <span class="keywordflow">case</span> 404:
202
+ <a name="l00180"></a>00180 statusLine = <span class="stringliteral">"404 Not Found\x0D\x0A"</span>;
203
+ <a name="l00181"></a>00181 <span class="keywordflow">break</span>;
204
+ <a name="l00182"></a>00182 <span class="keywordflow">case</span> 405:
205
+ <a name="l00183"></a>00183 statusLine = <span class="stringliteral">"405 Method Not Allowed\x0D\x0A"</span>;
206
+ <a name="l00184"></a>00184 <span class="keywordflow">break</span>;
207
+ <a name="l00185"></a>00185 <span class="keywordflow">case</span> 406:
208
+ <a name="l00186"></a>00186 statusLine = <span class="stringliteral">"406 Not Acceptable\x0D\x0A"</span>;
209
+ <a name="l00187"></a>00187 <span class="keywordflow">break</span>;
210
+ <a name="l00188"></a>00188 <span class="keywordflow">case</span> 407:
211
+ <a name="l00189"></a>00189 statusLine = <span class="stringliteral">"407 Proxy Authentication Required\x0D\x0A"</span>;
212
+ <a name="l00190"></a>00190 <span class="keywordflow">break</span>;
213
+ <a name="l00191"></a>00191 <span class="keywordflow">case</span> 408:
214
+ <a name="l00192"></a>00192 statusLine = <span class="stringliteral">"408 Request Timeout\x0D\x0A"</span>;
215
+ <a name="l00193"></a>00193 <span class="keywordflow">break</span>;
216
+ <a name="l00194"></a>00194 <span class="keywordflow">case</span> 409:
217
+ <a name="l00195"></a>00195 statusLine = <span class="stringliteral">"409 Conflict\x0D\x0A"</span>;
218
+ <a name="l00196"></a>00196 <span class="keywordflow">break</span>;
219
+ <a name="l00197"></a>00197 <span class="keywordflow">case</span> 410:
220
+ <a name="l00198"></a>00198 statusLine = <span class="stringliteral">"410 Gone\x0D\x0A"</span>;
221
+ <a name="l00199"></a>00199 <span class="keywordflow">break</span>;
222
+ <a name="l00200"></a>00200 <span class="keywordflow">case</span> 411:
223
+ <a name="l00201"></a>00201 statusLine = <span class="stringliteral">"411 Length Required\x0D\x0A"</span>;
224
+ <a name="l00202"></a>00202 <span class="keywordflow">break</span>;
225
+ <a name="l00203"></a>00203 <span class="keywordflow">case</span> 412:
226
+ <a name="l00204"></a>00204 statusLine = <span class="stringliteral">"412 Precondition Failed\x0D\x0A"</span>;
227
+ <a name="l00205"></a>00205 <span class="keywordflow">break</span>;
228
+ <a name="l00206"></a>00206 <span class="keywordflow">case</span> 413:
229
+ <a name="l00207"></a>00207 statusLine = <span class="stringliteral">"413 Request Entity Too Large\x0D\x0A"</span>;
230
+ <a name="l00208"></a>00208 <span class="keywordflow">break</span>;
231
+ <a name="l00209"></a>00209 <span class="keywordflow">case</span> 414:
232
+ <a name="l00210"></a>00210 statusLine = <span class="stringliteral">"414 Request-URI Too Long\x0D\x0A"</span>;
233
+ <a name="l00211"></a>00211 <span class="keywordflow">break</span>;
234
+ <a name="l00212"></a>00212 <span class="keywordflow">case</span> 415:
235
+ <a name="l00213"></a>00213 statusLine = <span class="stringliteral">"415 Unsupported Media Type\x0D\x0A"</span>;
236
+ <a name="l00214"></a>00214 <span class="keywordflow">break</span>;
237
+ <a name="l00215"></a>00215 <span class="keywordflow">case</span> 416:
238
+ <a name="l00216"></a>00216 statusLine = <span class="stringliteral">"416 Requested Range Not Satisfiable\x0D\x0A"</span>;
239
+ <a name="l00217"></a>00217 <span class="keywordflow">break</span>;
240
+ <a name="l00218"></a>00218 <span class="keywordflow">case</span> 417:
241
+ <a name="l00219"></a>00219 statusLine = <span class="stringliteral">"417 Expectation Failed\x0D\x0A"</span>;
242
+ <a name="l00220"></a>00220 <span class="keywordflow">break</span>;
243
+ <a name="l00221"></a>00221 <span class="keywordflow">case</span> 418:
244
+ <a name="l00222"></a>00222 statusLine = <span class="stringliteral">"418 Not A Funny April Fools Joke\x0D\x0A"</span>;
245
+ <a name="l00223"></a>00223 <span class="keywordflow">break</span>;
246
+ <a name="l00224"></a>00224 <span class="keywordflow">case</span> 422:
247
+ <a name="l00225"></a>00225 statusLine = <span class="stringliteral">"422 Unprocessable Entity\x0D\x0A"</span>;
248
+ <a name="l00226"></a>00226 <span class="keywordflow">break</span>;
249
+ <a name="l00227"></a>00227 <span class="keywordflow">case</span> 423:
250
+ <a name="l00228"></a>00228 statusLine = <span class="stringliteral">"423 Locked\x0D\x0A"</span>;
251
+ <a name="l00229"></a>00229 <span class="keywordflow">break</span>;
252
+ <a name="l00230"></a>00230 <span class="keywordflow">case</span> 424:
253
+ <a name="l00231"></a>00231 statusLine = <span class="stringliteral">"424 Unordered Collection\x0D\x0A"</span>;
254
+ <a name="l00232"></a>00232 <span class="keywordflow">break</span>;
255
+ <a name="l00233"></a>00233 <span class="keywordflow">case</span> 426:
256
+ <a name="l00234"></a>00234 statusLine = <span class="stringliteral">"426 Upgrade Required\x0D\x0A"</span>;
257
+ <a name="l00235"></a>00235 <span class="keywordflow">break</span>;
258
+ <a name="l00236"></a>00236 <span class="keywordflow">case</span> 449:
259
+ <a name="l00237"></a>00237 statusLine = <span class="stringliteral">"449 Retry With\x0D\x0A"</span>;
260
+ <a name="l00238"></a>00238 <span class="keywordflow">break</span>;
261
+ <a name="l00239"></a>00239 <span class="keywordflow">case</span> 450:
262
+ <a name="l00240"></a>00240 statusLine = <span class="stringliteral">"450 Blocked\x0D\x0A"</span>;
263
+ <a name="l00241"></a>00241 <span class="keywordflow">break</span>;
264
+ <a name="l00242"></a>00242 <span class="keywordflow">case</span> 500:
265
+ <a name="l00243"></a>00243 statusLine = <span class="stringliteral">"500 Internal Server Error\x0D\x0A"</span>;
266
+ <a name="l00244"></a>00244 <span class="keywordflow">break</span>;
267
+ <a name="l00245"></a>00245 <span class="keywordflow">case</span> 501:
268
+ <a name="l00246"></a>00246 statusLine = <span class="stringliteral">"501 Not Implemented\x0D\x0A"</span>;
269
+ <a name="l00247"></a>00247 <span class="keywordflow">break</span>;
270
+ <a name="l00248"></a>00248 <span class="keywordflow">case</span> 502:
271
+ <a name="l00249"></a>00249 statusLine = <span class="stringliteral">"502 Bad Gateway\x0D\x0A"</span>;
272
+ <a name="l00250"></a>00250 <span class="keywordflow">break</span>;
273
+ <a name="l00251"></a>00251 <span class="keywordflow">case</span> 503:
274
+ <a name="l00252"></a>00252 statusLine = <span class="stringliteral">"503 Service Unavailable\x0D\x0A"</span>;
275
+ <a name="l00253"></a>00253 <span class="keywordflow">break</span>;
276
+ <a name="l00254"></a>00254 <span class="keywordflow">case</span> 504:
277
+ <a name="l00255"></a>00255 statusLine = <span class="stringliteral">"504 Gateway Timeout\x0D\x0A"</span>;
278
+ <a name="l00256"></a>00256 <span class="keywordflow">break</span>;
279
+ <a name="l00257"></a>00257 <span class="keywordflow">case</span> 505:
280
+ <a name="l00258"></a>00258 statusLine = <span class="stringliteral">"505 HTTP Version Not Supported\x0D\x0A"</span>;
281
+ <a name="l00259"></a>00259 <span class="keywordflow">break</span>;
282
+ <a name="l00260"></a>00260 <span class="keywordflow">case</span> 506:
283
+ <a name="l00261"></a>00261 statusLine = <span class="stringliteral">"506 Variant Also Negotiates\x0D\x0A"</span>;
284
+ <a name="l00262"></a>00262 <span class="keywordflow">break</span>;
285
+ <a name="l00263"></a>00263 <span class="keywordflow">case</span> 507:
286
+ <a name="l00264"></a>00264 statusLine = <span class="stringliteral">"507 Insufficient Storage\x0D\x0A"</span>;
287
+ <a name="l00265"></a>00265 <span class="keywordflow">break</span>;
288
+ <a name="l00266"></a>00266 <span class="keywordflow">case</span> 509:
289
+ <a name="l00267"></a>00267 statusLine = <span class="stringliteral">"509 Bandwidth Limit Exceeded\x0D\x0A"</span>;
290
+ <a name="l00268"></a>00268 <span class="keywordflow">break</span>;
291
+ <a name="l00269"></a>00269 <span class="keywordflow">case</span> 510:
292
+ <a name="l00270"></a>00270 statusLine = <span class="stringliteral">"510 Not Extended\x0D\x0A"</span>;
293
+ <a name="l00271"></a>00271 <span class="keywordflow">break</span>;
294
+ <a name="l00272"></a>00272 <span class="keywordflow">default</span>:
295
+ <a name="l00273"></a>00273 <span class="keywordtype">char</span> temp[32];
296
+ <a name="l00274"></a>00274 snprintf(temp, <span class="keyword">sizeof</span>(temp),
297
+ <a name="l00275"></a>00275 <span class="stringliteral">"%d Unknown Status Code\x0D\x0A"</span>,
298
+ <a name="l00276"></a>00276 statusCode);
299
+ <a name="l00277"></a>00277 temp[<span class="keyword">sizeof</span>(temp) - 1] = <span class="charliteral">'\0'</span>;
300
+ <a name="l00278"></a>00278 statusLine = temp;
301
+ <a name="l00279"></a>00279 }
302
+ <a name="l00280"></a>00280 }
303
+ <a name="l00281"></a>00281 }
304
+ <a name="l00282"></a>00282
305
+ <a name="l00283"></a>00283 <span class="keyword">public</span>:
306
+ <a name="l00284"></a>00284 <a class="code" href="classPassenger_1_1HttpStatusExtractor.html" title="Utility class for extracting the HTTP status value from an HTTP response.">HttpStatusExtractor</a>() {
307
+ <a name="l00285"></a>00285 searchStart = 0;
308
+ <a name="l00286"></a>00286 fullHeaderReceived = <span class="keyword">false</span>;
309
+ <a name="l00287"></a>00287 statusLine = <span class="stringliteral">"200 OK\r\n"</span>;
310
+ <a name="l00288"></a>00288 }
311
+ <a name="l00289"></a>00289 <span class="comment"></span>
312
+ <a name="l00290"></a>00290 <span class="comment"> /**</span>
313
+ <a name="l00291"></a>00291 <span class="comment"> * Feed HTTP response data to this HttpStatusExtractor.</span>
314
+ <a name="l00292"></a>00292 <span class="comment"> *</span>
315
+ <a name="l00293"></a>00293 <span class="comment"> * One is to keep feeding data until this method returns true.</span>
316
+ <a name="l00294"></a>00294 <span class="comment"> * When a sufficient amount of data has been fed, this method will</span>
317
+ <a name="l00295"></a>00295 <span class="comment"> * extract the status line from the data that has been fed so far,</span>
318
+ <a name="l00296"></a>00296 <span class="comment"> * and return true.</span>
319
+ <a name="l00297"></a>00297 <span class="comment"> *</span>
320
+ <a name="l00298"></a>00298 <span class="comment"> * Do not call this method again once it has returned true.</span>
321
+ <a name="l00299"></a>00299 <span class="comment"> *</span>
322
+ <a name="l00300"></a>00300 <span class="comment"> * It is safe to feed excess data. That is, it is safe if the 'data'</span>
323
+ <a name="l00301"></a>00301 <span class="comment"> * argument contains a part of the HTTP response body.</span>
324
+ <a name="l00302"></a>00302 <span class="comment"> * HttpStatusExtractor will only look for the status line in the HTTP</span>
325
+ <a name="l00303"></a>00303 <span class="comment"> * response header, not in the HTTP response body. All fed data is</span>
326
+ <a name="l00304"></a>00304 <span class="comment"> * buffered and will be available via getBuffer(), so no data will be</span>
327
+ <a name="l00305"></a>00305 <span class="comment"> * lost.</span>
328
+ <a name="l00306"></a>00306 <span class="comment"> *</span>
329
+ <a name="l00307"></a>00307 <span class="comment"> * @return Whether the HTTP status has been extracted yet.</span>
330
+ <a name="l00308"></a>00308 <span class="comment"> * @pre feed() did not previously return true.</span>
331
+ <a name="l00309"></a>00309 <span class="comment"> * @pre data != NULL</span>
332
+ <a name="l00310"></a>00310 <span class="comment"> * @pre size &gt; 0</span>
333
+ <a name="l00311"></a>00311 <span class="comment"> */</span>
334
+ <a name="l00312"></a><a class="code" href="classPassenger_1_1HttpStatusExtractor.html#ca6fd77038e76b313830757730780d51">00312</a> <span class="keywordtype">bool</span> <a class="code" href="classPassenger_1_1HttpStatusExtractor.html#ca6fd77038e76b313830757730780d51" title="Feed HTTP response data to this HttpStatusExtractor.">feed</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *data, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> size) {
335
+ <a name="l00313"></a>00313 <span class="keywordflow">if</span> (fullHeaderReceived) {
336
+ <a name="l00314"></a>00314 <span class="keywordflow">return</span> <span class="keyword">true</span>;
337
+ <a name="l00315"></a>00315 }
338
+ <a name="l00316"></a>00316 buffer.append(data, size);
339
+ <a name="l00317"></a>00317 <span class="keywordflow">for</span> (; buffer.size() &gt;= 3 &amp;&amp; searchStart &lt; buffer.size() - 3; searchStart++) {
340
+ <a name="l00318"></a>00318 <span class="keywordflow">if</span> (buffer[searchStart] == CR &amp;&amp;
341
+ <a name="l00319"></a>00319 buffer[searchStart + 1] == LF &amp;&amp;
342
+ <a name="l00320"></a>00320 buffer[searchStart + 2] == CR &amp;&amp;
343
+ <a name="l00321"></a>00321 buffer[searchStart + 3] == LF) {
344
+ <a name="l00322"></a>00322 fullHeaderReceived = <span class="keyword">true</span>;
345
+ <a name="l00323"></a>00323 extractStatusLine();
346
+ <a name="l00324"></a>00324 <span class="keywordflow">return</span> <span class="keyword">true</span>;
347
+ <a name="l00325"></a>00325 }
348
+ <a name="l00326"></a>00326 }
349
+ <a name="l00327"></a>00327 <span class="keywordflow">return</span> <span class="keyword">false</span>;
350
+ <a name="l00328"></a>00328 }
351
+ <a name="l00329"></a>00329 <span class="comment"></span>
352
+ <a name="l00330"></a>00330 <span class="comment"> /**</span>
353
+ <a name="l00331"></a>00331 <span class="comment"> * Returns the HTTP status line that has been determined.</span>
354
+ <a name="l00332"></a>00332 <span class="comment"> *</span>
355
+ <a name="l00333"></a>00333 <span class="comment"> * The default value is "200 OK\r\n", which is returned if the HTTP</span>
356
+ <a name="l00334"></a>00334 <span class="comment"> * response data that has been fed so far does not include a status</span>
357
+ <a name="l00335"></a>00335 <span class="comment"> * line.</span>
358
+ <a name="l00336"></a>00336 <span class="comment"> *</span>
359
+ <a name="l00337"></a>00337 <span class="comment"> * @note The return value includes a trailing CRLF, e.g. "404 Not Found\r\n".</span>
360
+ <a name="l00338"></a>00338 <span class="comment"> */</span>
361
+ <a name="l00339"></a><a class="code" href="classPassenger_1_1HttpStatusExtractor.html#f0db266fc713f532047880c5eaae44d5">00339</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1HttpStatusExtractor.html#f0db266fc713f532047880c5eaae44d5" title="Returns the HTTP status line that has been determined.">getStatusLine</a>()<span class="keyword"> const </span>{
362
+ <a name="l00340"></a>00340 <span class="keywordflow">return</span> statusLine;
363
+ <a name="l00341"></a>00341 }
364
+ <a name="l00342"></a>00342 <span class="comment"></span>
365
+ <a name="l00343"></a>00343 <span class="comment"> /**</span>
366
+ <a name="l00344"></a>00344 <span class="comment"> * Get the data that has been fed so far.</span>
367
+ <a name="l00345"></a>00345 <span class="comment"> */</span>
368
+ <a name="l00346"></a><a class="code" href="classPassenger_1_1HttpStatusExtractor.html#3749842ba4f8f59b6b69c594da963f22">00346</a> <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1HttpStatusExtractor.html#3749842ba4f8f59b6b69c594da963f22" title="Get the data that has been fed so far.">getBuffer</a>()<span class="keyword"> const </span>{
369
+ <a name="l00347"></a>00347 <span class="keywordflow">return</span> buffer;
370
+ <a name="l00348"></a>00348 }
371
+ <a name="l00349"></a>00349 };
372
+ <a name="l00350"></a>00350
373
+ <a name="l00351"></a>00351 } <span class="comment">// namespace Passenger</span>
373
374
  </pre></div></div>
374
- <hr size="1"><address style="text-align: right;"><small>Generated on Sun Feb 21 12:22:45 2010 for Passenger by&nbsp;
375
+ <hr size="1"><address style="text-align: right;"><small>Generated on Sun Mar 28 14:11:56 2010 for Passenger by&nbsp;
375
376
  <a href="http://www.doxygen.org/index.html">
376
377
  <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
377
378
  </body>