RubyGems - mongrel - Versions diffs - 0.3.12 → 0.3.12.1 - Mend

mongrel 0.3.12 → 0.3.12.1

Files changed (105) hide show

data/Rakefile +1 -1
data/bin/mongrel_rails +12 -6
data/doc/rdoc/classes/Class.src/M000001.html +10 -10
data/doc/rdoc/classes/Class.src/M000002.html +46 -46
data/doc/rdoc/classes/Class.src/M000003.html +7 -7
data/doc/rdoc/classes/Class.src/M000004.html +6 -6
data/doc/rdoc/classes/IO.src/M000005.html +5 -5
data/doc/rdoc/classes/IO.src/M000006.html +5 -5
data/doc/rdoc/classes/Kernel.src/M000025.html +5 -5
data/doc/rdoc/classes/Kernel.src/M000026.html +11 -11
data/doc/rdoc/classes/Mongrel.html +1 -0
data/doc/rdoc/classes/Mongrel/Command/Base.src/M000030.html +1 -1
data/doc/rdoc/classes/Mongrel/Configurator.src/M000099.html +10 -10
data/doc/rdoc/classes/Mongrel/Configurator.src/M000100.html +9 -9
data/doc/rdoc/classes/Mongrel/Configurator.src/M000101.html +4 -4
data/doc/rdoc/classes/Mongrel/Configurator.src/M000102.html +18 -18
data/doc/rdoc/classes/Mongrel/Configurator.src/M000103.html +5 -5
data/doc/rdoc/classes/Mongrel/Configurator.src/M000104.html +16 -16
data/doc/rdoc/classes/Mongrel/Configurator.src/M000105.html +19 -19
data/doc/rdoc/classes/Mongrel/Configurator.src/M000106.html +4 -4
data/doc/rdoc/classes/Mongrel/Configurator.src/M000107.html +10 -11
data/doc/rdoc/classes/Mongrel/Configurator.src/M000108.html +5 -5
data/doc/rdoc/classes/Mongrel/Configurator.src/M000109.html +8 -8
data/doc/rdoc/classes/Mongrel/Configurator.src/M000110.html +7 -7
data/doc/rdoc/classes/Mongrel/Configurator.src/M000111.html +4 -4
data/doc/rdoc/classes/Mongrel/Configurator.src/M000112.html +14 -13
data/doc/rdoc/classes/Mongrel/Configurator.src/M000113.html +5 -33
data/doc/rdoc/classes/Mongrel/Configurator.src/M000114.html +33 -5
data/doc/rdoc/classes/Mongrel/Configurator.src/M000115.html +18 -0
data/doc/rdoc/classes/Mongrel/Const.html +11 -1
data/doc/rdoc/classes/Mongrel/Error404Handler.src/M000116.html +5 -5
data/doc/rdoc/classes/Mongrel/Error404Handler.src/M000117.html +18 -0
data/doc/rdoc/classes/Mongrel/HeaderOut.html +0 -185
data/doc/rdoc/classes/Mongrel/HeaderOut.src/M000072.html +4 -4
data/doc/rdoc/classes/Mongrel/HeaderOut.src/M000073.html +4 -4
data/doc/rdoc/classes/Mongrel/HttpParser.src/M000054.html +3 -1
data/doc/rdoc/classes/Mongrel/{StopServer.html → HttpParserError.html} +5 -11
data/doc/rdoc/classes/Mongrel/HttpRequest.src/M000118.html +15 -7
data/doc/rdoc/classes/Mongrel/HttpRequest.src/M000119.html +7 -7
data/doc/rdoc/classes/Mongrel/HttpRequest.src/M000120.html +7 -19
data/doc/rdoc/classes/Mongrel/HttpRequest.src/M000121.html +32 -0
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000075.html +12 -12
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000076.html +6 -6
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000077.html +11 -11
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000078.html +8 -8
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000079.html +8 -8
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000080.html +9 -9
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000081.html +4 -4
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000082.html +6 -6
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000083.html +4 -4
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000064.html +10 -10
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000065.html +51 -50
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000066.html +10 -10
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000067.html +45 -45
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000068.html +14 -14
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000069.html +4 -4
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000070.html +8 -8
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000071.html +4 -4
data/doc/rdoc/classes/ObjectTracker.src/M000019.html +20 -22
data/doc/rdoc/classes/RequestLog/Access.src/M000122.html +19 -0
data/doc/rdoc/classes/RequestLog/Files.src/{M000121.html → M000123.html} +5 -5
data/doc/rdoc/classes/RequestLog/Objects.src/{M000122.html → M000124.html} +5 -5
data/doc/rdoc/classes/RequestLog/Params.src/{M000123.html → M000125.html} +5 -5
data/doc/rdoc/classes/Stats.html +1 -1
data/doc/rdoc/classes/Stats.src/M000012.html +2 -2
data/doc/rdoc/created.rid +1 -1
data/doc/rdoc/files/ext/http11/http11_c.html +1 -1
data/doc/rdoc/files/lib/mongrel/command_rb.html +1 -1
data/doc/rdoc/files/lib/mongrel/debug_rb.html +1 -1
data/doc/rdoc/files/lib/mongrel/handlers_rb.html +1 -1
data/doc/rdoc/files/lib/mongrel/stats_rb.html +1 -1
data/doc/rdoc/files/lib/mongrel_rb.html +1 -1
data/examples/random_thrash.rb +19 -0
data/ext/http11/http11.c +57 -12
data/ext/http11/http11_parser.c +58 -52
data/lib/mongrel.rb +37 -10
data/lib/mongrel/command.rb +1 -1
data/lib/mongrel/debug.rb +39 -125
data/lib/mongrel/handlers.rb +2 -2
data/lib/mongrel/rails.rb +2 -1
data/lib/mongrel/stats.rb +2 -2
data/test/test_configurator.rb +2 -2
data/test/test_debug.rb +2 -4
data/test/test_http11.rb +76 -7
data/test/test_stats.rb +6 -4
data/test/test_uriclassifier.rb +0 -14
metadata +12 -24
data/doc/rdoc/classes/Mongrel/CGIWrapper.html +0 -383
data/doc/rdoc/classes/Mongrel/Configurator.html +0 -563
data/doc/rdoc/classes/Mongrel/Error404Handler.html +0 -171
data/doc/rdoc/classes/Mongrel/Error404Handler.src/M000115.html +0 -18
data/doc/rdoc/classes/Mongrel/HttpHandler.html +0 -152
data/doc/rdoc/classes/Mongrel/HttpRequest.html +0 -222
data/doc/rdoc/classes/Mongrel/HttpRequest.src/M000117.html +0 -28
data/doc/rdoc/classes/Mongrel/HttpResponse.html +0 -371
data/doc/rdoc/classes/Mongrel/URIClassifier.html +0 -301
data/doc/rdoc/classes/RequestLog.html +0 -113
data/doc/rdoc/classes/RequestLog/Files.html +0 -144
data/doc/rdoc/classes/RequestLog/Objects.html +0 -144
data/doc/rdoc/classes/RequestLog/Params.html +0 -144
data/doc/rdoc/fr_class_index.html +0 -60
data/doc/rdoc/fr_file_index.html +0 -40
data/doc/rdoc/fr_method_index.html +0 -149
data/doc/rdoc/index.html +0 -24
data/lib/http11.bundle +0 -0

data/doc/rdoc/classes/Mongrel/HttpRequest.src/M000117.html DELETED

@@ -1,28 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-<head>
-  <title>new (Mongrel::HttpRequest)</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
-</head>
-<body class="standalone-code">
-  <pre>     <span class="ruby-comment cmt"># File lib/mongrel.rb, line 150</span>
-150:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">params</span>, <span class="ruby-identifier">initial_body</span>, <span class="ruby-identifier">socket</span>)
-151:       <span class="ruby-ivar">@body</span> = <span class="ruby-identifier">initial_body</span> <span class="ruby-operator">||</span> <span class="ruby-value str">&quot;&quot;</span>
-152:       <span class="ruby-ivar">@params</span> = <span class="ruby-identifier">params</span>
-153:       <span class="ruby-ivar">@socket</span> = <span class="ruby-identifier">socket</span>
-154:
-155:       <span class="ruby-comment cmt"># now, if the initial_body isn't long enough for the content length we have to fill it</span>
-156:       <span class="ruby-comment cmt"># TODO: adapt for big ass stuff by writing to a temp file</span>
-157:       <span class="ruby-identifier">clen</span> = <span class="ruby-identifier">params</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">CONTENT_LENGTH</span>].<span class="ruby-identifier">to_i</span>
-158:       <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@body</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">clen</span>
-159:         <span class="ruby-ivar">@body</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@socket</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">clen</span> <span class="ruby-operator">-</span> <span class="ruby-ivar">@body</span>.<span class="ruby-identifier">length</span>)
-160:       <span class="ruby-keyword kw">end</span>
-161:
-162:     <span class="ruby-keyword kw">end</span></pre>
-</body>
-</html>

data/doc/rdoc/classes/Mongrel/HttpResponse.html DELETED

@@ -1,371 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Class: Mongrel::HttpResponse</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Class</strong></td>
-          <td class="class-name-in-header">Mongrel::HttpResponse</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../files/lib/mongrel_rb.html">
-                lib/mongrel.rb
-                </a>
-        <br />
-            </td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>Parent:</strong></td>
-            <td>
-                Object
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <p>
-Writes and controls your response to the client using the HTTP/1.1
-specification. You use it by simply doing:
-</p>
-<pre>
- response.start(200) do |head,out|
-   head['Content-Type'] = 'text/plain'
-   out.write(&quot;hello\n&quot;)
- end
-</pre>
-<p>
-The parameter to start is the response code&#8212;which <a
-href="../Mongrel.html">Mongrel</a> will translate for you based on
-HTTP_STATUS_CODES. The head parameter is how you write custom headers. The
-out parameter is where you write your body. The default status code for <a
-href="HttpResponse.html#M000076">HttpResponse.start</a> is 200 so the above
-example is redundant.
-</p>
-<p>
-As you can see, it&#8217;s just like using a Hash and as you do this it
-writes the proper header to the output on the fly. You can even intermix
-specifying headers and writing content. The <a
-href="HttpResponse.html">HttpResponse</a> class with write the things in
-the proper order once the HttpResponse.block is ended.
-</p>
-<p>
-You may also work the <a href="HttpResponse.html">HttpResponse</a> object
-directly using the various attributes available for the raw socket, body,
-header, and status codes. If you do this you&#8217;re on your own. A design
-decision was made to force the client to not pipeline requests. HTTP/1.1
-pipelining really kills the performance due to how it has to be handled and
-how unclear the standard is. To fix this the <a
-href="HttpResponse.html">HttpResponse</a> gives a &quot;Connection:
-close&quot; header which forces the client to close right away. The bonus
-for this is that it gives a pretty nice speed boost to most clients since
-they can close their connection immediately.
-</p>
-<p>
-One additional caveat is that you don&#8217;t have to specify the
-Content-length header as the <a href="HttpResponse.html">HttpResponse</a>
-will write this for you based on the out length.
-</p>
-    </div>
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000083">done</a>&nbsp;&nbsp;
-      <a href="#M000082">finished</a>&nbsp;&nbsp;
-      <a href="#M000075">new</a>&nbsp;&nbsp;
-      <a href="#M000077">reset</a>&nbsp;&nbsp;
-      <a href="#M000080">send_body</a>&nbsp;&nbsp;
-      <a href="#M000079">send_header</a>&nbsp;&nbsp;
-      <a href="#M000078">send_status</a>&nbsp;&nbsp;
-      <a href="#M000076">start</a>&nbsp;&nbsp;
-      <a href="#M000081">write</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <div id="attribute-list">
-      <h3 class="section-bar">Attributes</h3>
-      <div class="name-list">
-        <table>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">body</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">body_sent</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">header</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">header_sent</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">socket</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">status</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">status</td>
-          <td class="context-item-value">&nbsp;[W]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">status_sent</td>
-          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
-          <td class="context-item-desc"></td>
-        </tr>
-        </table>
-      </div>
-    </div>
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000075" class="method-detail">
-        <a name="M000075"></a>
-        <div class="method-heading">
-          <a href="HttpResponse.src/M000075.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000075.html');return false;">
-          <span class="method-name">new</span><span class="method-args">(socket, filter = nil)</span>
-          </a>
-        </div>
-        <div class="method-description">
-        </div>
-      </div>
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000083" class="method-detail">
-        <a name="M000083"></a>
-        <div class="method-heading">
-          <a href="HttpResponse.src/M000083.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000083.html');return false;">
-          <span class="method-name">done</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-        </div>
-      </div>
-      <div id="method-M000082" class="method-detail">
-        <a name="M000082"></a>
-        <div class="method-heading">
-          <a href="HttpResponse.src/M000082.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000082.html');return false;">
-          <span class="method-name">finished</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-This takes whatever has been done to header and body and then writes it in
-the proper format to make an HTTP/1.1 response.
-</p>
-        </div>
-      </div>
-      <div id="method-M000077" class="method-detail">
-        <a name="M000077"></a>
-        <div class="method-heading">
-          <a href="HttpResponse.src/M000077.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000077.html');return false;">
-          <span class="method-name">reset</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Primarily used in exception handling to reset the response output in order
-to write an alternative response. It will abort with an exception if you
-have already sent the header or the body. This is pretty catastrophic
-actually.
-</p>
-        </div>
-      </div>
-      <div id="method-M000080" class="method-detail">
-        <a name="M000080"></a>
-        <div class="method-heading">
-          <a href="HttpResponse.src/M000080.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000080.html');return false;">
-          <span class="method-name">send_body</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-        </div>
-      </div>
-      <div id="method-M000079" class="method-detail">
-        <a name="M000079"></a>
-        <div class="method-heading">
-          <a href="HttpResponse.src/M000079.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000079.html');return false;">
-          <span class="method-name">send_header</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-        </div>
-      </div>
-      <div id="method-M000078" class="method-detail">
-        <a name="M000078"></a>
-        <div class="method-heading">
-          <a href="HttpResponse.src/M000078.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000078.html');return false;">
-          <span class="method-name">send_status</span><span class="method-args">(content_length=nil)</span>
-          </a>
-        </div>
-        <div class="method-description">
-        </div>
-      </div>
-      <div id="method-M000076" class="method-detail">
-        <a name="M000076"></a>
-        <div class="method-heading">
-          <a href="HttpResponse.src/M000076.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000076.html');return false;">
-          <span class="method-name">start</span><span class="method-args">(status=200, finalize=false) {|@header, @body| ...}</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Receives a block passing it the header and body for you to work with. When
-the block is finished it writes everything you&#8217;ve done to the socket
-in the proper order. This lets you intermix header and body content as
-needed. Handlers are able to modify pretty much any part of the request in
-the chain, and can stop further processing by simple passing
-&quot;finalize=true&quot; to the start method. By default all handlers run
-and then mongrel finalizes the request when they&#8217;re all done.
-</p>
-        </div>
-      </div>
-      <div id="method-M000081" class="method-detail">
-        <a name="M000081"></a>
-        <div class="method-heading">
-          <a href="HttpResponse.src/M000081.html" target="Code" class="method-signature"
-            onclick="popupCode('HttpResponse.src/M000081.html');return false;">
-          <span class="method-name">write</span><span class="method-args">(data)</span>
-          </a>
-        </div>
-        <div class="method-description">
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/doc/rdoc/classes/Mongrel/URIClassifier.html DELETED

@@ -1,301 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Class: Mongrel::URIClassifier</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-    <div id="classHeader">
-        <table class="header-table">
-        <tr class="top-aligned-row">
-          <td><strong>Class</strong></td>
-          <td class="class-name-in-header">Mongrel::URIClassifier</td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>In:</strong></td>
-            <td>
-                <a href="../../files/lib/mongrel_rb.html">
-                lib/mongrel.rb
-                </a>
-        <br />
-                <a href="../../files/ext/http11/http11_c.html">
-                ext/http11/http11.c
-                </a>
-        <br />
-            </td>
-        </tr>
-        <tr class="top-aligned-row">
-            <td><strong>Parent:</strong></td>
-            <td>
-                Object
-            </td>
-        </tr>
-        </table>
-    </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-   </div>
-    <div id="method-list">
-      <h3 class="section-bar">Methods</h3>
-      <div class="name-list">
-      <a href="#M000085">inspect</a>&nbsp;&nbsp;
-      <a href="#M000086">new</a>&nbsp;&nbsp;
-      <a href="#M000087">register</a>&nbsp;&nbsp;
-      <a href="#M000089">resolve</a>&nbsp;&nbsp;
-      <a href="#M000088">unregister</a>&nbsp;&nbsp;
-      <a href="#M000084">uris</a>&nbsp;&nbsp;
-      </div>
-    </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-    <div id="methods">
-      <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000086" class="method-detail">
-        <a name="M000086"></a>
-        <div class="method-heading">
-          <a href="URIClassifier.src/M000086.html" target="Code" class="method-signature"
-            onclick="popupCode('URIClassifier.src/M000086.html');return false;">
-          <span class="method-name">URIClassifier.new &rarr; URIClassifier<br />
-</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Initializes a new <a href="URIClassifier.html">URIClassifier</a> object
-that you can use to associate URI sequences with objects. You can actually
-use it with any string sequence and any objects, but it&#8217;s mostly used
-with URIs.
-</p>
-<p>
-It uses TST from <a
-href="http://www.octavian.org/cs/software.html">www.octavian.org/cs/software.html</a>
-to build an ternary search trie to hold all of the URIs. It uses this to do
-an initial search for the a URI prefix, and then to break the URI into
-SCRIPT_NAME and PATH_INFO portions. It actually will do two searches most
-of the time in order to find the right handler for the registered prefix
-portion.
-</p>
-        </div>
-      </div>
-      <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000085" class="method-detail">
-        <a name="M000085"></a>
-        <div class="method-heading">
-          <a href="URIClassifier.src/M000085.html" target="Code" class="method-signature"
-            onclick="popupCode('URIClassifier.src/M000085.html');return false;">
-          <span class="method-name">inspect</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Simply does an inspect that looks like a Hash inspect.
-</p>
-        </div>
-      </div>
-      <div id="method-M000087" class="method-detail">
-        <a name="M000087"></a>
-        <div class="method-heading">
-          <a href="URIClassifier.src/M000087.html" target="Code" class="method-signature"
-            onclick="popupCode('URIClassifier.src/M000087.html');return false;">
-          <span class="method-name">uc.register("/someuri", SampleHandler.new) &rarr; nil<br />
-</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Registers the SampleHandler (one for all requests) with the
-&quot;/someuri&quot;. When URIClassifier::resolve is called with
-&quot;/someuri&quot; it&#8217;ll return SampleHandler immediately. When
-called with &quot;/someuri/iwant&quot; it&#8217;ll also return SomeHandler
-immediatly, with no additional searches, but it will return path info with
-&quot;/iwant&quot;.
-</p>
-<p>
-You actually can reuse this class to register nearly anything and quickly
-resolve it. This could be used for caching, fast mapping, etc. The downside
-is it uses much more memory than a Hash, but it can be a lot faster.
-It&#8217;s main advantage is that it works on prefixes, which is damn hard
-to get right with a Hash.
-</p>
-        </div>
-      </div>
-      <div id="method-M000089" class="method-detail">
-        <a name="M000089"></a>
-        <div class="method-heading">
-          <a href="URIClassifier.src/M000089.html" target="Code" class="method-signature"
-            onclick="popupCode('URIClassifier.src/M000089.html');return false;">
-          <span class="method-name">uc.resolve("/someuri") &rarr; "/someuri", "", handler<br />
-uc.resolve("/someuri/pathinfo") &rarr; "/someuri", "/pathinfo", handler<br />
-uc.resolve("/notfound/orhere") &rarr; nil, nil, nil<br />
-uc.resolve("/") &rarr; "/", "/", handler  # if uc.register("/", handler)<br />
-uc.resolve("/path/from/root") &rarr; "/", "/path/from/root", handler  # if uc.register("/", handler) <br />
-</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Attempts to resolve either the whole URI or at the longest prefix,
-returning the prefix (as script_info), path (as path_info), and registered
-handler (usually an <a href="HttpHandler.html">HttpHandler</a>). If it
-doesn&#8217;t find a handler registered at the longest match then it
-returns nil,nil,nil.
-</p>
-<p>
-Because the resolver uses a trie you are able to register a handler at
-<b>any</b> character in the URI and it will be handled as long as
-it&#8217;s the longest prefix. So, if you registered handler 1 at
-&quot;/something/lik&quot;, and 2 at &quot;/something/like/that&quot;, then
-a a search for &quot;/something/like&quot; would give you 1. A search for
-&quot;/something/like/that/too&quot; would give you 2.
-</p>
-<p>
-This is very powerful since it means you can also attach handlers to parts
-of the ; (semi-colon) separated path params, any part of the path, use off
-chars, anything really. It also means that it&#8217;s very efficient to do
-this only taking as long as the URI has characters.
-</p>
-<p>
-A slight modification to the CGI 1.2 standard is given for handlers
-registered to &quot;/&quot;. CGI expects all CGI scripts to be at some
-script path, so it doesn&#8217;t really say anything about a script that
-handles the root. To make this work, the resolver will detect that the
-requested handler is at &quot;/&quot;, and return that for script_name, and
-then simply return the full URI back as path_info.
-</p>
-<p>
-It expects strings with no embedded &#8217;\0&#8217; characters.
-Don&#8216;t try other string-like stuff yet.
-</p>
-        </div>
-      </div>
-      <div id="method-M000088" class="method-detail">
-        <a name="M000088"></a>
-        <div class="method-heading">
-          <a href="URIClassifier.src/M000088.html" target="Code" class="method-signature"
-            onclick="popupCode('URIClassifier.src/M000088.html');return false;">
-          <span class="method-name">uc.unregister("/someuri")<br />
-</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Yep, just removes this uri and it&#8217;s handler from the trie.
-</p>
-        </div>
-      </div>
-      <div id="method-M000084" class="method-detail">
-        <a name="M000084"></a>
-        <div class="method-heading">
-          <a href="URIClassifier.src/M000084.html" target="Code" class="method-signature"
-            onclick="popupCode('URIClassifier.src/M000084.html');return false;">
-          <span class="method-name">uris</span><span class="method-args">()</span>
-          </a>
-        </div>
-        <div class="method-description">
-          <p>
-Returns the URIs that have been registered with this classifier so far. The
-URIs returned should not be modified as this will cause a memory leak. You
-can use this to inspect the contents of the <a
-href="URIClassifier.html">URIClassifier</a>.
-</p>
-        </div>
-      </div>
-    </div>
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>