passenger 3.0.0.pre1 → 3.0.0.pre2

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 (189) hide show
  1. data/DEVELOPERS.TXT +2 -2
  2. data/NEWS +2 -2
  3. data/Rakefile +1 -1
  4. data/build/packaging.rb +1 -1
  5. data/doc/Users guide Apache.html +22 -22
  6. data/doc/Users guide Apache.txt +2 -2
  7. data/doc/Users guide Nginx.html +14 -14
  8. data/doc/Users guide Nginx.txt +3 -2
  9. data/doc/Users guide Standalone.html +1 -1
  10. data/doc/cxxapi/Constants_8h_source.html +1 -1
  11. data/doc/cxxapi/ResourceLocator_8h_source.html +1 -1
  12. data/doc/rdoc/classes/ConditionVariable.html +215 -0
  13. data/doc/rdoc/classes/Exception.html +120 -0
  14. data/doc/rdoc/classes/GC.html +113 -0
  15. data/doc/rdoc/classes/IO.html +221 -0
  16. data/doc/rdoc/classes/PhusionPassenger.html +368 -0
  17. data/doc/rdoc/classes/PhusionPassenger/AbstractInstaller.html +180 -0
  18. data/doc/rdoc/classes/PhusionPassenger/AbstractRequestHandler.html +647 -0
  19. data/doc/rdoc/classes/PhusionPassenger/AbstractServer.html +654 -0
  20. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/InvalidPassword.html +92 -0
  21. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerAlreadyStarted.html +97 -0
  22. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerError.html +96 -0
  23. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/ServerNotStarted.html +97 -0
  24. data/doc/rdoc/classes/PhusionPassenger/AbstractServer/UnknownMessage.html +96 -0
  25. data/doc/rdoc/classes/PhusionPassenger/AbstractServerCollection.html +619 -0
  26. data/doc/rdoc/classes/PhusionPassenger/AdminTools.html +142 -0
  27. data/doc/rdoc/classes/PhusionPassenger/AdminTools/MemoryStats.html +368 -0
  28. data/doc/rdoc/classes/PhusionPassenger/AdminTools/MemoryStats/Process.html +231 -0
  29. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance.html +588 -0
  30. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/CorruptedDirectoryError.html +92 -0
  31. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/GenerationsAbsentError.html +92 -0
  32. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Group.html +147 -0
  33. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Process.html +279 -0
  34. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/RoleDeniedError.html +92 -0
  35. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/StaleDirectoryError.html +92 -0
  36. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/Stats.html +123 -0
  37. data/doc/rdoc/classes/PhusionPassenger/AdminTools/ServerInstance/UnsupportedGenerationStructureVersionError.html +92 -0
  38. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger.html +341 -0
  39. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/Log.html +294 -0
  40. data/doc/rdoc/classes/PhusionPassenger/AnalyticsLogger/SharedData.html +199 -0
  41. data/doc/rdoc/classes/PhusionPassenger/AppInitError.html +155 -0
  42. data/doc/rdoc/classes/PhusionPassenger/AppProcess.html +367 -0
  43. data/doc/rdoc/classes/PhusionPassenger/ClassicRails.html +95 -0
  44. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/ApplicationSpawner.html +351 -0
  45. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/ApplicationSpawner/Error.html +98 -0
  46. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/CGIFixed.html +200 -0
  47. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner.html +410 -0
  48. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/FrameworkSpawner/Error.html +98 -0
  49. data/doc/rdoc/classes/PhusionPassenger/ClassicRails/RequestHandler.html +156 -0
  50. data/doc/rdoc/classes/PhusionPassenger/ClassicRailsExtensions.html +115 -0
  51. data/doc/rdoc/classes/PhusionPassenger/ClassicRailsExtensions/AnalyticsLogging.html +202 -0
  52. data/doc/rdoc/classes/PhusionPassenger/ConsoleTextTemplate.html +172 -0
  53. data/doc/rdoc/classes/PhusionPassenger/DebugLogging.html +273 -0
  54. data/doc/rdoc/classes/PhusionPassenger/FrameworkInitError.html +145 -0
  55. data/doc/rdoc/classes/PhusionPassenger/HTMLTemplate.html +162 -0
  56. data/doc/rdoc/classes/PhusionPassenger/InitializationError.html +141 -0
  57. data/doc/rdoc/classes/PhusionPassenger/InvalidPath.html +92 -0
  58. data/doc/rdoc/classes/PhusionPassenger/MessageChannel.html +673 -0
  59. data/doc/rdoc/classes/PhusionPassenger/MessageChannel/InvalidHashError.html +92 -0
  60. data/doc/rdoc/classes/PhusionPassenger/MessageClient.html +415 -0
  61. data/doc/rdoc/classes/PhusionPassenger/NativeSupport.html +494 -0
  62. data/doc/rdoc/classes/PhusionPassenger/NativeSupport/FileSystemWatcher.html +96 -0
  63. data/doc/rdoc/classes/PhusionPassenger/Packaging.html +129 -0
  64. data/doc/rdoc/classes/PhusionPassenger/PlatformInfo.html +1758 -0
  65. data/doc/rdoc/classes/PhusionPassenger/Plugin.html +237 -0
  66. data/doc/rdoc/classes/PhusionPassenger/Rack.html +91 -0
  67. data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner.html +312 -0
  68. data/doc/rdoc/classes/PhusionPassenger/Rack/ApplicationSpawner/Error.html +98 -0
  69. data/doc/rdoc/classes/PhusionPassenger/Rack/RequestHandler.html +218 -0
  70. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions.html +114 -0
  71. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging.html +256 -0
  72. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ACExtension.html +139 -0
  73. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ASBenchmarkableExtension.html +118 -0
  74. data/doc/rdoc/classes/PhusionPassenger/Rails3Extensions/AnalyticsLogging/ExceptionLogger.html +135 -0
  75. data/doc/rdoc/classes/PhusionPassenger/SpawnManager.html +378 -0
  76. data/doc/rdoc/classes/PhusionPassenger/Standalone.html +111 -0
  77. data/doc/rdoc/classes/PhusionPassenger/Standalone/AppFinder.html +252 -0
  78. data/doc/rdoc/classes/PhusionPassenger/Standalone/Command.html +161 -0
  79. data/doc/rdoc/classes/PhusionPassenger/Standalone/ConfigFile.html +368 -0
  80. data/doc/rdoc/classes/PhusionPassenger/Standalone/ConfigFile/DisallowedContextError.html +132 -0
  81. data/doc/rdoc/classes/PhusionPassenger/Standalone/HelpCommand.html +151 -0
  82. data/doc/rdoc/classes/PhusionPassenger/Standalone/Main.html +189 -0
  83. data/doc/rdoc/classes/PhusionPassenger/Standalone/PackageRuntimeCommand.html +177 -0
  84. data/doc/rdoc/classes/PhusionPassenger/Standalone/RuntimeInstaller.html +341 -0
  85. data/doc/rdoc/classes/PhusionPassenger/Standalone/StartCommand.html +203 -0
  86. data/doc/rdoc/classes/PhusionPassenger/Standalone/StatusCommand.html +156 -0
  87. data/doc/rdoc/classes/PhusionPassenger/Standalone/StopCommand.html +168 -0
  88. data/doc/rdoc/classes/PhusionPassenger/Standalone/Utils.html +86 -0
  89. data/doc/rdoc/classes/PhusionPassenger/Standalone/VersionCommand.html +135 -0
  90. data/doc/rdoc/classes/PhusionPassenger/UnknownError.html +125 -0
  91. data/doc/rdoc/classes/PhusionPassenger/Utils.html +1468 -0
  92. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher.html +204 -0
  93. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher/DirInfo.html +171 -0
  94. data/doc/rdoc/classes/PhusionPassenger/Utils/FileSystemWatcher/FileInfo.html +140 -0
  95. data/doc/rdoc/classes/PhusionPassenger/Utils/HostsFileParser.html +260 -0
  96. data/doc/rdoc/classes/PhusionPassenger/Utils/PseudoIO.html +169 -0
  97. data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput.html +265 -0
  98. data/doc/rdoc/classes/PhusionPassenger/Utils/RewindableInput/Tempfile.html +120 -0
  99. data/doc/rdoc/classes/PhusionPassenger/Utils/UnseekableSocket.html +561 -0
  100. data/doc/rdoc/classes/PhusionPassenger/VersionNotFound.html +140 -0
  101. data/doc/rdoc/classes/PhusionPassenger/WSGI.html +89 -0
  102. data/doc/rdoc/classes/PhusionPassenger/WSGI/ApplicationSpawner.html +182 -0
  103. data/doc/rdoc/classes/Process.html +115 -0
  104. data/doc/rdoc/classes/Signal.html +139 -0
  105. data/doc/rdoc/created.rid +1 -0
  106. data/doc/rdoc/files/DEVELOPERS_TXT.html +276 -0
  107. data/doc/rdoc/files/README.html +157 -0
  108. data/doc/rdoc/files/ext/phusion_passenger/native_support_c.html +92 -0
  109. data/doc/rdoc/files/lib/phusion_passenger/abstract_installer_rb.html +130 -0
  110. data/doc/rdoc/files/lib/phusion_passenger/abstract_request_handler_rb.html +135 -0
  111. data/doc/rdoc/files/lib/phusion_passenger/abstract_server_collection_rb.html +126 -0
  112. data/doc/rdoc/files/lib/phusion_passenger/abstract_server_rb.html +128 -0
  113. data/doc/rdoc/files/lib/phusion_passenger/admin_tools/memory_stats_rb.html +126 -0
  114. data/doc/rdoc/files/lib/phusion_passenger/admin_tools/server_instance_rb.html +132 -0
  115. data/doc/rdoc/files/lib/phusion_passenger/admin_tools_rb.html +122 -0
  116. data/doc/rdoc/files/lib/phusion_passenger/analytics_logger_rb.html +129 -0
  117. data/doc/rdoc/files/lib/phusion_passenger/app_process_rb.html +127 -0
  118. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/application_spawner_rb.html +141 -0
  119. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/cgi_fixed_rb.html +126 -0
  120. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/framework_spawner_rb.html +146 -0
  121. data/doc/rdoc/files/lib/phusion_passenger/classic_rails/request_handler_rb.html +125 -0
  122. data/doc/rdoc/files/lib/phusion_passenger/classic_rails_extensions/init_rb.html +132 -0
  123. data/doc/rdoc/files/lib/phusion_passenger/console_text_template_rb.html +126 -0
  124. data/doc/rdoc/files/lib/phusion_passenger/constants_rb.html +122 -0
  125. data/doc/rdoc/files/lib/phusion_passenger/debug_logging_rb.html +122 -0
  126. data/doc/rdoc/files/lib/phusion_passenger/dependencies_rb.html +147 -0
  127. data/doc/rdoc/files/lib/phusion_passenger/exceptions_rb.html +122 -0
  128. data/doc/rdoc/files/lib/phusion_passenger/html_template_rb.html +127 -0
  129. data/doc/rdoc/files/lib/phusion_passenger/message_channel_rb.html +120 -0
  130. data/doc/rdoc/files/lib/phusion_passenger/message_client_rb.html +127 -0
  131. data/doc/rdoc/files/lib/phusion_passenger/native_support_rb.html +131 -0
  132. data/doc/rdoc/files/lib/phusion_passenger/packaging_rb.html +122 -0
  133. data/doc/rdoc/files/lib/phusion_passenger/platform_info/apache_rb.html +127 -0
  134. data/doc/rdoc/files/lib/phusion_passenger/platform_info/binary_compatibility_rb.html +129 -0
  135. data/doc/rdoc/files/lib/phusion_passenger/platform_info/compiler_rb.html +126 -0
  136. data/doc/rdoc/files/lib/phusion_passenger/platform_info/curl_rb.html +126 -0
  137. data/doc/rdoc/files/lib/phusion_passenger/platform_info/documentation_tools_rb.html +126 -0
  138. data/doc/rdoc/files/lib/phusion_passenger/platform_info/linux_rb.html +126 -0
  139. data/doc/rdoc/files/lib/phusion_passenger/platform_info/operating_system_rb.html +127 -0
  140. data/doc/rdoc/files/lib/phusion_passenger/platform_info/ruby_rb.html +128 -0
  141. data/doc/rdoc/files/lib/phusion_passenger/platform_info/zlib_rb.html +126 -0
  142. data/doc/rdoc/files/lib/phusion_passenger/platform_info_rb.html +122 -0
  143. data/doc/rdoc/files/lib/phusion_passenger/plugin_rb.html +127 -0
  144. data/doc/rdoc/files/lib/phusion_passenger/public_api_rb.html +127 -0
  145. data/doc/rdoc/files/lib/phusion_passenger/rack/application_spawner_rb.html +137 -0
  146. data/doc/rdoc/files/lib/phusion_passenger/rack/request_handler_rb.html +125 -0
  147. data/doc/rdoc/files/lib/phusion_passenger/rails3_extensions/init_rb.html +127 -0
  148. data/doc/rdoc/files/lib/phusion_passenger/simple_benchmarking_rb.html +122 -0
  149. data/doc/rdoc/files/lib/phusion_passenger/spawn_manager_rb.html +160 -0
  150. data/doc/rdoc/files/lib/phusion_passenger/standalone/app_finder_rb.html +127 -0
  151. data/doc/rdoc/files/lib/phusion_passenger/standalone/command_rb.html +135 -0
  152. data/doc/rdoc/files/lib/phusion_passenger/standalone/config_file_rb.html +126 -0
  153. data/doc/rdoc/files/lib/phusion_passenger/standalone/help_command_rb.html +126 -0
  154. data/doc/rdoc/files/lib/phusion_passenger/standalone/main_rb.html +126 -0
  155. data/doc/rdoc/files/lib/phusion_passenger/standalone/package_runtime_command_rb.html +127 -0
  156. data/doc/rdoc/files/lib/phusion_passenger/standalone/runtime_installer_rb.html +132 -0
  157. data/doc/rdoc/files/lib/phusion_passenger/standalone/start_command_rb.html +136 -0
  158. data/doc/rdoc/files/lib/phusion_passenger/standalone/status_command_rb.html +126 -0
  159. data/doc/rdoc/files/lib/phusion_passenger/standalone/stop_command_rb.html +126 -0
  160. data/doc/rdoc/files/lib/phusion_passenger/standalone/utils_rb.html +126 -0
  161. data/doc/rdoc/files/lib/phusion_passenger/standalone/version_command_rb.html +127 -0
  162. data/doc/rdoc/files/lib/phusion_passenger/utils/file_system_watcher_rb.html +126 -0
  163. data/doc/rdoc/files/lib/phusion_passenger/utils/hosts_file_parser_rb.html +120 -0
  164. data/doc/rdoc/files/lib/phusion_passenger/utils/rewindable_input_rb.html +100 -0
  165. data/doc/rdoc/files/lib/phusion_passenger/utils/tmpdir_rb.html +122 -0
  166. data/doc/rdoc/files/lib/phusion_passenger/utils/unseekable_socket_rb.html +126 -0
  167. data/doc/rdoc/files/lib/phusion_passenger/utils_rb.html +179 -0
  168. data/doc/rdoc/files/lib/phusion_passenger/wsgi/application_spawner_rb.html +132 -0
  169. data/doc/rdoc/fr_class_index.html +139 -0
  170. data/doc/rdoc/fr_file_index.html +109 -0
  171. data/doc/rdoc/fr_method_index.html +435 -0
  172. data/doc/rdoc/index.html +26 -0
  173. data/doc/rdoc/rdoc-style.css +187 -0
  174. data/ext/apache2/Configuration.hpp +1 -1
  175. data/ext/apache2/Hooks.cpp +24 -2
  176. data/ext/common/AgentsStarter.hpp +57 -20
  177. data/ext/common/Constants.h +1 -1
  178. data/ext/common/ResourceLocator.h +1 -1
  179. data/ext/common/Utils/MemZeroGuard.h +1 -1
  180. data/ext/phusion_passenger/native_support.c +1 -1
  181. data/lib/phusion_passenger.rb +2 -2
  182. data/lib/phusion_passenger/abstract_installer.rb +1 -1
  183. data/lib/phusion_passenger/platform_info/apache.rb +3 -0
  184. data/lib/phusion_passenger/platform_info/binary_compatibility.rb +3 -1
  185. data/lib/phusion_passenger/platform_info/compiler.rb +25 -2
  186. data/lib/phusion_passenger/platform_info/ruby.rb +88 -14
  187. data/lib/phusion_passenger/templates/standalone/config.erb +9 -16
  188. metadata +166 -5
  189. data/ext/common/Utils/foo.cpp +0 -10
@@ -0,0 +1,619 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+ <html>
6
+ <head>
7
+ <title>Class: PhusionPassenger::AbstractServerCollection</title>
8
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
9
+ <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
10
+
11
+ <script language="JavaScript" type="text/javascript">
12
+ // <![CDATA[
13
+
14
+ function toggleSource( id )
15
+ {
16
+ var elem
17
+ var link
18
+
19
+ if( document.getElementById )
20
+ {
21
+ elem = document.getElementById( id )
22
+ link = document.getElementById( "l_" + id )
23
+ }
24
+ else if ( document.all )
25
+ {
26
+ elem = eval( "document.all." + id )
27
+ link = eval( "document.all.l_" + id )
28
+ }
29
+ else
30
+ return false;
31
+
32
+ if( elem.style.display == "block" )
33
+ {
34
+ elem.style.display = "none"
35
+ link.innerHTML = "show source"
36
+ }
37
+ else
38
+ {
39
+ elem.style.display = "block"
40
+ link.innerHTML = "hide source"
41
+ }
42
+ }
43
+
44
+ function openCode( url )
45
+ {
46
+ window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
47
+ }
48
+ // ]]>
49
+ </script>
50
+ </head>
51
+
52
+ <body>
53
+ <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
54
+ <td class="file-title"><span class="file-title-prefix">Class</span><br />PhusionPassenger::AbstractServerCollection</td>
55
+ <td align="right">
56
+ <table cellspacing="0" cellpadding="2">
57
+ <tr valign="top">
58
+ <td>In:</td>
59
+ <td>
60
+ <a href="../../files/lib/phusion_passenger/abstract_server_collection_rb.html">lib/phusion_passenger/abstract_server_collection.rb</a>
61
+ </td>
62
+ </tr>
63
+ <tr>
64
+ <td>Parent:</td>
65
+ <td>
66
+ Object
67
+ </td>
68
+ </tr>
69
+ </table>
70
+ </td>
71
+ </tr>
72
+ </table>
73
+ <!-- banner header -->
74
+
75
+ <div id="bodyContent">
76
+ <div id="content">
77
+
78
+ <div class="description"><p>
79
+ This class maintains a collection of <a
80
+ href="AbstractServer.html">AbstractServer</a> objects. One can add <a
81
+ href="AbstractServerCollection.html#M000314">new</a> <a
82
+ href="AbstractServer.html">AbstractServer</a> objects, or look up existing
83
+ ones via a key. <a
84
+ href="AbstractServerCollection.html">AbstractServerCollection</a> also
85
+ automatically takes care of cleaning up AbstractServers that have been idle
86
+ for too long.
87
+ </p>
88
+ <p>
89
+ This class exists because both <a href="SpawnManager.html">SpawnManager</a>
90
+ and <a
91
+ href="ClassicRails/FrameworkSpawner.html">ClassicRails::FrameworkSpawner</a>
92
+ need this kind of functionality. <a
93
+ href="SpawnManager.html">SpawnManager</a> maintains a collection of <a
94
+ href="ClassicRails/FrameworkSpawner.html">ClassicRails::FrameworkSpawner</a>
95
+ and <a
96
+ href="ClassicRails/ApplicationSpawner.html">ClassicRails::ApplicationSpawner</a>
97
+ objects, while <a
98
+ href="ClassicRails/FrameworkSpawner.html">ClassicRails::FrameworkSpawner</a>
99
+ maintains a collection of <a
100
+ href="ClassicRails/ApplicationSpawner.html">ClassicRails::ApplicationSpawner</a>
101
+ objects.
102
+ </p>
103
+ <p>
104
+ This class is thread-safe as long as the specified thread-safety rules are
105
+ followed.
106
+ </p>
107
+ </div>
108
+
109
+
110
+
111
+ <div class="sectiontitle">Methods</div>
112
+ <ul>
113
+ <li><a href="#M000321">check_idle_servers!</a></li>
114
+ <li><a href="#M000325">cleanup</a></li>
115
+ <li><a href="#M000324">clear</a></li>
116
+ <li><a href="#M000319">delete</a></li>
117
+ <li><a href="#M000322">each</a></li>
118
+ <li><a href="#M000323">each_pair</a></li>
119
+ <li><a href="#M000318">empty?</a></li>
120
+ <li><a href="#M000317">has_key?</a></li>
121
+ <li><a href="#M000316">lookup_or_add</a></li>
122
+ <li><a href="#M000314">new</a></li>
123
+ <li><a href="#M000320">register_activity</a></li>
124
+ <li><a href="#M000315">synchronize</a></li>
125
+ </ul>
126
+
127
+ <div class="sectiontitle">Included Modules</div>
128
+ <ul>
129
+ <li><a href="Utils.html">Utils</a></li>
130
+ </ul>
131
+
132
+
133
+
134
+
135
+ <div class="sectiontitle">Attributes</div>
136
+ <table border='0' cellpadding='5'>
137
+ <tr valign='top'>
138
+ <td class='attr-rw'>
139
+ [R]
140
+ </td>
141
+ <td class='attr-name'>next_cleaning_time</td>
142
+ <td class='attr-desc'></td>
143
+ </tr>
144
+ </table>
145
+
146
+ <div class="sectiontitle">Public Class methods</div>
147
+ <div class="method">
148
+ <div class="title">
149
+ <a name="M000314"></a><b>new</b>()
150
+ </div>
151
+ <div class="sourcecode">
152
+ <p class="source-link">[ <a href="javascript:toggleSource('M000314_source')" id="l_M000314_source">show source</a> ]</p>
153
+ <div id="M000314_source" class="dyn-source">
154
+ <pre>
155
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 44</span>
156
+ 44: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>
157
+ 45: <span class="ruby-ivar">@collection</span> = {}
158
+ 46: <span class="ruby-ivar">@lock</span> = <span class="ruby-constant">Mutex</span>.<span class="ruby-identifier">new</span>
159
+ 47: <span class="ruby-ivar">@cleanup_lock</span> = <span class="ruby-constant">Mutex</span>.<span class="ruby-identifier">new</span>
160
+ 48: <span class="ruby-ivar">@cond</span> = <span class="ruby-constant">ConditionVariable</span>.<span class="ruby-identifier">new</span>
161
+ 49: <span class="ruby-ivar">@done</span> = <span class="ruby-keyword kw">false</span>
162
+ 50:
163
+ 51: <span class="ruby-comment cmt"># The next time the cleaner thread should check for idle servers.</span>
164
+ 52: <span class="ruby-comment cmt"># The value may be nil, in which case the value will be calculated</span>
165
+ 53: <span class="ruby-comment cmt"># at the end of the #synchronized block.</span>
166
+ 54: <span class="ruby-comment cmt">#</span>
167
+ 55: <span class="ruby-comment cmt"># Invariant:</span>
168
+ 56: <span class="ruby-comment cmt"># if value is not nil:</span>
169
+ 57: <span class="ruby-comment cmt"># There exists an s in @collection with s.next_cleaning_time == value.</span>
170
+ 58: <span class="ruby-comment cmt"># for all s in @collection:</span>
171
+ 59: <span class="ruby-comment cmt"># if eligable_for_cleanup?(s):</span>
172
+ 60: <span class="ruby-comment cmt"># s.next_cleaning_time &lt;= value</span>
173
+ 61: <span class="ruby-ivar">@next_cleaning_time</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span> <span class="ruby-operator">+</span> <span class="ruby-value">60</span> <span class="ruby-operator">*</span> <span class="ruby-value">60</span>
174
+ 62: <span class="ruby-ivar">@next_cleaning_time_changed</span> = <span class="ruby-keyword kw">false</span>
175
+ 63:
176
+ 64: <span class="ruby-ivar">@cleaner_thread</span> = <span class="ruby-constant">Thread</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span>
177
+ 65: <span class="ruby-keyword kw">begin</span>
178
+ 66: <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
179
+ 67: <span class="ruby-identifier">cleaner_thread_main</span>
180
+ 68: <span class="ruby-keyword kw">end</span>
181
+ 69: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
182
+ 70: <span class="ruby-identifier">print_exception</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">to_s</span>, <span class="ruby-identifier">e</span>)
183
+ 71: <span class="ruby-keyword kw">end</span>
184
+ 72: <span class="ruby-keyword kw">end</span>
185
+ 73: <span class="ruby-keyword kw">end</span>
186
+ </pre>
187
+ </div>
188
+ </div>
189
+ </div>
190
+ <div class="sectiontitle">Public Instance methods</div>
191
+ <div class="method">
192
+ <div class="title">
193
+ <a name="M000321"></a><b>check_idle_servers!</b>()
194
+ </div>
195
+ <div class="description">
196
+ <p>
197
+ Tell the cleaner thread to check the collection as soon as possible,
198
+ instead of sleeping until the next scheduled cleaning time.
199
+ </p>
200
+ <p>
201
+ Precondition: this method must NOT be called within a <a
202
+ href="AbstractServerCollection.html#M000315">#synchronize</a> block.
203
+ </p>
204
+ </div>
205
+ <div class="sourcecode">
206
+ <p class="source-link">[ <a href="javascript:toggleSource('M000321_source')" id="l_M000321_source">show source</a> ]</p>
207
+ <div id="M000321_source" class="dyn-source">
208
+ <pre>
209
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 208</span>
210
+ 208: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">check_idle_servers!</span>
211
+ 209: <span class="ruby-identifier">must_not_be_in_synchronize_block</span>
212
+ 210: <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
213
+ 211: <span class="ruby-ivar">@next_cleaning_time</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span> <span class="ruby-operator">-</span> <span class="ruby-value">60</span> <span class="ruby-operator">*</span> <span class="ruby-value">60</span>
214
+ 212: <span class="ruby-ivar">@cond</span>.<span class="ruby-identifier">signal</span>
215
+ 213: <span class="ruby-keyword kw">end</span>
216
+ 214: <span class="ruby-keyword kw">end</span>
217
+ </pre>
218
+ </div>
219
+ </div>
220
+ </div>
221
+ <div class="method">
222
+ <div class="title">
223
+ <a name="M000325"></a><b>cleanup</b>()
224
+ </div>
225
+ <div class="description">
226
+ <p>
227
+ Cleanup all resources used by this <a
228
+ href="AbstractServerCollection.html">AbstractServerCollection</a>. All
229
+ AbstractServers from the collection will be deleted. Each <a
230
+ href="AbstractServer.html">AbstractServer</a> will be stopped, if
231
+ necessary. The background thread which removes idle AbstractServers will be
232
+ stopped.
233
+ </p>
234
+ <p>
235
+ After calling this method, this <a
236
+ href="AbstractServerCollection.html">AbstractServerCollection</a> object
237
+ will become unusable.
238
+ </p>
239
+ <p>
240
+ Precondition: this method must <b>NOT</b> be called within a <a
241
+ href="AbstractServerCollection.html#M000315">#synchronize</a> block.
242
+ </p>
243
+ </div>
244
+ <div class="sourcecode">
245
+ <p class="source-link">[ <a href="javascript:toggleSource('M000325_source')" id="l_M000325_source">show source</a> ]</p>
246
+ <div id="M000325_source" class="dyn-source">
247
+ <pre>
248
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 260</span>
249
+ 260: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cleanup</span>
250
+ 261: <span class="ruby-identifier">must_not_be_in_synchronize_block</span>
251
+ 262: <span class="ruby-ivar">@cleanup_lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
252
+ 263: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@done</span>
253
+ 264: <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
254
+ 265: <span class="ruby-ivar">@done</span> = <span class="ruby-keyword kw">true</span>
255
+ 266: <span class="ruby-ivar">@cond</span>.<span class="ruby-identifier">signal</span>
256
+ 267: <span class="ruby-keyword kw">end</span>
257
+ 268: <span class="ruby-ivar">@cleaner_thread</span>.<span class="ruby-identifier">join</span>
258
+ 269: <span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
259
+ 270: <span class="ruby-identifier">clear</span>
260
+ 271: <span class="ruby-keyword kw">end</span>
261
+ 272: <span class="ruby-keyword kw">end</span>
262
+ 273: <span class="ruby-keyword kw">end</span>
263
+ </pre>
264
+ </div>
265
+ </div>
266
+ </div>
267
+ <div class="method">
268
+ <div class="title">
269
+ <a name="M000324"></a><b>clear</b>()
270
+ </div>
271
+ <div class="description">
272
+ <p>
273
+ Delete all AbstractServers from the collection. Each <a
274
+ href="AbstractServer.html">AbstractServer</a> will be stopped, if
275
+ necessary.
276
+ </p>
277
+ <p>
278
+ Precondition: this method must be called within a <a
279
+ href="AbstractServerCollection.html#M000315">#synchronize</a> block.
280
+ </p>
281
+ </div>
282
+ <div class="sourcecode">
283
+ <p class="source-link">[ <a href="javascript:toggleSource('M000324_source')" id="l_M000324_source">show source</a> ]</p>
284
+ <div id="M000324_source" class="dyn-source">
285
+ <pre>
286
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 241</span>
287
+ 241: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">clear</span>
288
+ 242: <span class="ruby-identifier">must_be_in_synchronize_block</span>
289
+ 243: <span class="ruby-ivar">@collection</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">server</span><span class="ruby-operator">|</span>
290
+ 244: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">server</span>.<span class="ruby-identifier">started?</span>
291
+ 245: <span class="ruby-identifier">server</span>.<span class="ruby-identifier">stop</span>
292
+ 246: <span class="ruby-keyword kw">end</span>
293
+ 247: <span class="ruby-keyword kw">end</span>
294
+ 248: <span class="ruby-ivar">@collection</span>.<span class="ruby-identifier">clear</span>
295
+ 249: <span class="ruby-ivar">@next_cleaning_time</span> = <span class="ruby-keyword kw">nil</span>
296
+ 250: <span class="ruby-keyword kw">end</span>
297
+ </pre>
298
+ </div>
299
+ </div>
300
+ </div>
301
+ <div class="method">
302
+ <div class="title">
303
+ <a name="M000319"></a><b>delete</b>(key)
304
+ </div>
305
+ <div class="description">
306
+ <p>
307
+ Deletes from the collection the <a
308
+ href="AbstractServer.html">AbstractServer</a> that&#8216;s associated with
309
+ the given key. If no such <a href="AbstractServer.html">AbstractServer</a>
310
+ exists, nothing will happen.
311
+ </p>
312
+ <p>
313
+ If the <a href="AbstractServer.html">AbstractServer</a> is started, then it
314
+ will be stopped before deletion.
315
+ </p>
316
+ <p>
317
+ Precondition: this method must be called within a <a
318
+ href="AbstractServerCollection.html#M000315">#synchronize</a> block.
319
+ </p>
320
+ </div>
321
+ <div class="sourcecode">
322
+ <p class="source-link">[ <a href="javascript:toggleSource('M000319_source')" id="l_M000319_source">show source</a> ]</p>
323
+ <div id="M000319_source" class="dyn-source">
324
+ <pre>
325
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 170</span>
326
+ 170: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>)
327
+ 171: <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;cleanup() has already been called.&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@done</span>
328
+ 172: <span class="ruby-identifier">must_be_in_synchronize_block</span>
329
+ 173: <span class="ruby-identifier">server</span> = <span class="ruby-ivar">@collection</span>[<span class="ruby-identifier">key</span>]
330
+ 174: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">server</span>
331
+ 175: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">server</span>.<span class="ruby-identifier">started?</span>
332
+ 176: <span class="ruby-identifier">server</span>.<span class="ruby-identifier">stop</span>
333
+ 177: <span class="ruby-keyword kw">end</span>
334
+ 178: <span class="ruby-ivar">@collection</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>)
335
+ 179: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">server</span>.<span class="ruby-identifier">next_cleaning_time</span> <span class="ruby-operator">==</span> <span class="ruby-ivar">@next_cleaning_time</span>
336
+ 180: <span class="ruby-ivar">@next_cleaning_time</span> = <span class="ruby-keyword kw">nil</span>
337
+ 181: <span class="ruby-keyword kw">end</span>
338
+ 182: <span class="ruby-keyword kw">end</span>
339
+ 183: <span class="ruby-keyword kw">end</span>
340
+ </pre>
341
+ </div>
342
+ </div>
343
+ </div>
344
+ <div class="method">
345
+ <div class="title">
346
+ <a name="M000322"></a><b>each</b>() {|server| ...}
347
+ </div>
348
+ <div class="description">
349
+ <p>
350
+ Iterate over all <a href="AbstractServer.html">AbstractServer</a> objects.
351
+ </p>
352
+ <p>
353
+ Precondition: this method must be called within a <a
354
+ href="AbstractServerCollection.html#M000315">#synchronize</a> block.
355
+ </p>
356
+ </div>
357
+ <div class="sourcecode">
358
+ <p class="source-link">[ <a href="javascript:toggleSource('M000322_source')" id="l_M000322_source">show source</a> ]</p>
359
+ <div id="M000322_source" class="dyn-source">
360
+ <pre>
361
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 219</span>
362
+ 219: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each</span>
363
+ 220: <span class="ruby-identifier">must_be_in_synchronize_block</span>
364
+ 221: <span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">server</span><span class="ruby-operator">|</span>
365
+ 222: <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">server</span>
366
+ 223: <span class="ruby-keyword kw">end</span>
367
+ 224: <span class="ruby-keyword kw">end</span>
368
+ </pre>
369
+ </div>
370
+ </div>
371
+ </div>
372
+ <div class="method">
373
+ <div class="title">
374
+ <a name="M000323"></a><b>each_pair</b>() {|key, server| ...}
375
+ </div>
376
+ <div class="description">
377
+ <p>
378
+ Iterate over all keys and associated <a
379
+ href="AbstractServer.html">AbstractServer</a> objects.
380
+ </p>
381
+ <p>
382
+ Precondition: this method must be called within a <a
383
+ href="AbstractServerCollection.html#M000315">#synchronize</a> block.
384
+ </p>
385
+ </div>
386
+ <div class="sourcecode">
387
+ <p class="source-link">[ <a href="javascript:toggleSource('M000323_source')" id="l_M000323_source">show source</a> ]</p>
388
+ <div id="M000323_source" class="dyn-source">
389
+ <pre>
390
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 229</span>
391
+ 229: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_pair</span>
392
+ 230: <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;cleanup() has already been called.&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@done</span>
393
+ 231: <span class="ruby-identifier">must_be_in_synchronize_block</span>
394
+ 232: <span class="ruby-ivar">@collection</span>.<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">server</span><span class="ruby-operator">|</span>
395
+ 233: <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">key</span>, <span class="ruby-identifier">server</span>)
396
+ 234: <span class="ruby-keyword kw">end</span>
397
+ 235: <span class="ruby-keyword kw">end</span>
398
+ </pre>
399
+ </div>
400
+ </div>
401
+ </div>
402
+ <div class="method">
403
+ <div class="title">
404
+ <a name="M000318"></a><b>empty?</b>()
405
+ </div>
406
+ <div class="description">
407
+ <p>
408
+ Checks whether the collection is empty.
409
+ </p>
410
+ <p>
411
+ Precondition: this method must be called within a <a
412
+ href="AbstractServerCollection.html#M000315">#synchronize</a> block.
413
+ </p>
414
+ </div>
415
+ <div class="sourcecode">
416
+ <p class="source-link">[ <a href="javascript:toggleSource('M000318_source')" id="l_M000318_source">show source</a> ]</p>
417
+ <div id="M000318_source" class="dyn-source">
418
+ <pre>
419
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 159</span>
420
+ 159: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">empty?</span>
421
+ 160: <span class="ruby-identifier">must_be_in_synchronize_block</span>
422
+ 161: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@collection</span>.<span class="ruby-identifier">empty?</span>
423
+ 162: <span class="ruby-keyword kw">end</span>
424
+ </pre>
425
+ </div>
426
+ </div>
427
+ </div>
428
+ <div class="method">
429
+ <div class="title">
430
+ <a name="M000317"></a><b>has_key?</b>(key)
431
+ </div>
432
+ <div class="description">
433
+ <p>
434
+ Checks whether there&#8216;s an <a
435
+ href="AbstractServer.html">AbstractServer</a> object associated with the
436
+ given key.
437
+ </p>
438
+ <p>
439
+ Precondition: this method must be called within a <a
440
+ href="AbstractServerCollection.html#M000315">#synchronize</a> block.
441
+ </p>
442
+ </div>
443
+ <div class="sourcecode">
444
+ <p class="source-link">[ <a href="javascript:toggleSource('M000317_source')" id="l_M000317_source">show source</a> ]</p>
445
+ <div id="M000317_source" class="dyn-source">
446
+ <pre>
447
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 151</span>
448
+ 151: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">key</span>)
449
+ 152: <span class="ruby-identifier">must_be_in_synchronize_block</span>
450
+ 153: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@collection</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">key</span>)
451
+ 154: <span class="ruby-keyword kw">end</span>
452
+ </pre>
453
+ </div>
454
+ </div>
455
+ </div>
456
+ <div class="method">
457
+ <div class="title">
458
+ <a name="M000316"></a><b>lookup_or_add</b>(key) {|| ...}
459
+ </div>
460
+ <div class="description">
461
+ <p>
462
+ Lookup and returns an <a href="AbstractServer.html">AbstractServer</a> with
463
+ the given key.
464
+ </p>
465
+ <p>
466
+ If there is no AbstractSerer associated with the given key, then the given
467
+ block will be called. That block must return an <a
468
+ href="AbstractServer.html">AbstractServer</a> object. Then, that object
469
+ will be stored in the collection, and returned.
470
+ </p>
471
+ <p>
472
+ The block must set the &#8216;max_idle_time&#8217; attribute on the <a
473
+ href="AbstractServer.html">AbstractServer</a>. <a
474
+ href="AbstractServerCollection.html">AbstractServerCollection</a>&#8216;s
475
+ idle cleaning interval will be adapted to accomodate with this. Changing
476
+ the value outside this block is not guaranteed to have any effect on the
477
+ idle cleaning interval. A max_idle_time value of nil or 0 means the <a
478
+ href="AbstractServer.html">AbstractServer</a> will never be idle cleaned.
479
+ </p>
480
+ <p>
481
+ If the block raises an exception, then the collection will not be modified,
482
+ and the exception will be propagated.
483
+ </p>
484
+ <p>
485
+ Precondition: this method must be called within a <a
486
+ href="AbstractServerCollection.html#M000315">#synchronize</a> block.
487
+ </p>
488
+ </div>
489
+ <div class="sourcecode">
490
+ <p class="source-link">[ <a href="javascript:toggleSource('M000316_source')" id="l_M000316_source">show source</a> ]</p>
491
+ <div id="M000316_source" class="dyn-source">
492
+ <pre>
493
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 124</span>
494
+ 124: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">lookup_or_add</span>(<span class="ruby-identifier">key</span>)
495
+ 125: <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;cleanup() has already been called.&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@done</span>
496
+ 126: <span class="ruby-identifier">must_be_in_synchronize_block</span>
497
+ 127: <span class="ruby-identifier">server</span> = <span class="ruby-ivar">@collection</span>[<span class="ruby-identifier">key</span>]
498
+ 128: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">server</span>
499
+ 129: <span class="ruby-identifier">register_activity</span>(<span class="ruby-identifier">server</span>)
500
+ 130: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">server</span>
501
+ 131: <span class="ruby-keyword kw">else</span>
502
+ 132: <span class="ruby-identifier">server</span> = <span class="ruby-keyword kw">yield</span>
503
+ 133: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">server</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:start</span>)
504
+ 134: <span class="ruby-identifier">raise</span> <span class="ruby-constant">TypeError</span>, <span class="ruby-value str">&quot;The block didn't return a valid AbstractServer object.&quot;</span>
505
+ 135: <span class="ruby-keyword kw">end</span>
506
+ 136: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">eligable_for_cleanup?</span>(<span class="ruby-identifier">server</span>)
507
+ 137: <span class="ruby-identifier">server</span>.<span class="ruby-identifier">next_cleaning_time</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">server</span>.<span class="ruby-identifier">max_idle_time</span>
508
+ 138: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@next_cleaning_time</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">server</span>.<span class="ruby-identifier">next_cleaning_time</span> <span class="ruby-operator">&lt;</span> <span class="ruby-ivar">@next_cleaning_time</span>
509
+ 139: <span class="ruby-ivar">@next_cleaning_time</span> = <span class="ruby-identifier">server</span>.<span class="ruby-identifier">next_cleaning_time</span>
510
+ 140: <span class="ruby-ivar">@next_cleaning_time_changed</span> = <span class="ruby-keyword kw">true</span>
511
+ 141: <span class="ruby-keyword kw">end</span>
512
+ 142: <span class="ruby-keyword kw">end</span>
513
+ 143: <span class="ruby-ivar">@collection</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">server</span>
514
+ 144: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">server</span>
515
+ 145: <span class="ruby-keyword kw">end</span>
516
+ 146: <span class="ruby-keyword kw">end</span>
517
+ </pre>
518
+ </div>
519
+ </div>
520
+ </div>
521
+ <div class="method">
522
+ <div class="title">
523
+ <a name="M000320"></a><b>register_activity</b>(server)
524
+ </div>
525
+ <div class="description">
526
+ <p>
527
+ Notify this <a
528
+ href="AbstractServerCollection.html">AbstractServerCollection</a> that
529
+ <tt>server</tt> has performed an activity. This <a
530
+ href="AbstractServerCollection.html">AbstractServerCollection</a> will
531
+ update the idle information associated with <tt>server</tt> accordingly.
532
+ </p>
533
+ <p>
534
+ <a href="AbstractServerCollection.html#M000316">lookup_or_add</a> already
535
+ automatically updates idle information, so you only need to call this
536
+ method if the time at which the server has performed an activity is not
537
+ close to the time at which <a
538
+ href="AbstractServerCollection.html#M000316">lookup_or_add</a> had been
539
+ called.
540
+ </p>
541
+ <p>
542
+ Precondition: this method must be called within a <a
543
+ href="AbstractServerCollection.html#M000315">#synchronize</a> block.
544
+ </p>
545
+ </div>
546
+ <div class="sourcecode">
547
+ <p class="source-link">[ <a href="javascript:toggleSource('M000320_source')" id="l_M000320_source">show source</a> ]</p>
548
+ <div id="M000320_source" class="dyn-source">
549
+ <pre>
550
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 194</span>
551
+ 194: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">register_activity</span>(<span class="ruby-identifier">server</span>)
552
+ 195: <span class="ruby-identifier">must_be_in_synchronize_block</span>
553
+ 196: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">eligable_for_cleanup?</span>(<span class="ruby-identifier">server</span>)
554
+ 197: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">server</span>.<span class="ruby-identifier">next_cleaning_time</span> <span class="ruby-operator">==</span> <span class="ruby-ivar">@next_cleaning_time</span>
555
+ 198: <span class="ruby-ivar">@next_cleaning_time</span> = <span class="ruby-keyword kw">nil</span>
556
+ 199: <span class="ruby-keyword kw">end</span>
557
+ 200: <span class="ruby-identifier">server</span>.<span class="ruby-identifier">next_cleaning_time</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">server</span>.<span class="ruby-identifier">max_idle_time</span>
558
+ 201: <span class="ruby-keyword kw">end</span>
559
+ 202: <span class="ruby-keyword kw">end</span>
560
+ </pre>
561
+ </div>
562
+ </div>
563
+ </div>
564
+ <div class="method">
565
+ <div class="title">
566
+ <a name="M000315"></a><b>synchronize</b>() {|| ...}
567
+ </div>
568
+ <div class="description">
569
+ <p>
570
+ Acquire the lock for this <a
571
+ href="AbstractServerCollection.html">AbstractServerCollection</a> object,
572
+ and run the code within the block. The entire block will be a single atomic
573
+ operation.
574
+ </p>
575
+ </div>
576
+ <div class="sourcecode">
577
+ <p class="source-link">[ <a href="javascript:toggleSource('M000315_source')" id="l_M000315_source">show source</a> ]</p>
578
+ <div id="M000315_source" class="dyn-source">
579
+ <pre>
580
+ <span class="ruby-comment cmt"># File lib/phusion_passenger/abstract_server_collection.rb, line 78</span>
581
+ 78: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">synchronize</span>
582
+ 79: <span class="ruby-ivar">@lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword kw">do</span>
583
+ 80: <span class="ruby-ivar">@in_synchronize_block</span> = <span class="ruby-keyword kw">true</span>
584
+ 81: <span class="ruby-keyword kw">begin</span>
585
+ 82: <span class="ruby-keyword kw">yield</span>
586
+ 83: <span class="ruby-keyword kw">ensure</span>
587
+ 84: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@next_cleaning_time</span>.<span class="ruby-identifier">nil?</span>
588
+ 85: <span class="ruby-ivar">@collection</span>.<span class="ruby-identifier">each_value</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">server</span><span class="ruby-operator">|</span>
589
+ 86: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@next_cleaning_time</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">||</span>
590
+ 87: (<span class="ruby-identifier">eligable_for_cleanup?</span>(<span class="ruby-identifier">server</span>) <span class="ruby-operator">&amp;&amp;</span>
591
+ 88: <span class="ruby-identifier">server</span>.<span class="ruby-identifier">next_cleaning_time</span> <span class="ruby-operator">&lt;</span> <span class="ruby-ivar">@next_cleaning_time</span>
592
+ 89: )
593
+ 90: <span class="ruby-ivar">@next_cleaning_time</span> = <span class="ruby-identifier">server</span>.<span class="ruby-identifier">next_cleaning_time</span>
594
+ 91: <span class="ruby-keyword kw">end</span>
595
+ 92: <span class="ruby-keyword kw">end</span>
596
+ 93: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@next_cleaning_time</span>.<span class="ruby-identifier">nil?</span>
597
+ 94: <span class="ruby-comment cmt"># There are no servers in the collection with an idle timeout.</span>
598
+ 95: <span class="ruby-ivar">@next_cleaning_time</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span> <span class="ruby-operator">+</span> <span class="ruby-value">60</span> <span class="ruby-operator">*</span> <span class="ruby-value">60</span>
599
+ 96: <span class="ruby-keyword kw">end</span>
600
+ 97: <span class="ruby-ivar">@next_cleaning_time_changed</span> = <span class="ruby-keyword kw">true</span>
601
+ 98: <span class="ruby-keyword kw">end</span>
602
+ 99: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@next_cleaning_time_changed</span>
603
+ 100: <span class="ruby-ivar">@next_cleaning_time_changed</span> = <span class="ruby-keyword kw">false</span>
604
+ 101: <span class="ruby-ivar">@cond</span>.<span class="ruby-identifier">signal</span>
605
+ 102: <span class="ruby-keyword kw">end</span>
606
+ 103: <span class="ruby-ivar">@in_synchronize_block</span> = <span class="ruby-keyword kw">false</span>
607
+ 104: <span class="ruby-keyword kw">end</span>
608
+ 105: <span class="ruby-keyword kw">end</span>
609
+ 106: <span class="ruby-keyword kw">end</span>
610
+ </pre>
611
+ </div>
612
+ </div>
613
+ </div>
614
+ </div>
615
+
616
+ </div>
617
+
618
+ </body>
619
+ </html>