RubyGems - mongrel - Versions diffs - 0.3.13 → 0.3.13.1 - Mend

mongrel 0.3.13 → 0.3.13.1

Files changed (179) hide show

data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000091.html CHANGED

@@ -5,47 +5,14 @@
 <html>
 <head>
-  <title>register (Mongrel::URIClassifier)</title>
+  <title>inspect (Mongrel::URIClassifier)</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>/**
- * call-seq:
- *    uc.register(&quot;/someuri&quot;, SampleHandler.new) -&gt; nil
- *
- * Registers the SampleHandler (one for all requests) with the &quot;/someuri&quot;.
- * When URIClassifier::resolve is called with &quot;/someuri&quot; it'll return
- * SampleHandler immediately.  When called with &quot;/someuri/iwant&quot; it'll also
- * return SomeHandler immediatly, with no additional searches, but it will
- * return path info with &quot;/iwant&quot;.
- *
- * 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's main advantage is that it works on prefixes, which
- * is damn hard to get right with a Hash.
- */
-VALUE URIClassifier_register(VALUE self, VALUE uri, VALUE handler)
-{
-  int rc = 0;
-  void *ptr = NULL;
-  struct tst *tst = NULL;
-  DATA_GET(self, struct tst, tst);
-  rc = tst_insert((unsigned char *)StringValueCStr(uri), (void *)handler , tst, 0, &amp;ptr);
-  if(rc == TST_DUPLICATE_KEY) {
-    rb_raise(rb_eStandardError, &quot;Handler already registered with that name&quot;);
-  } else if(rc == TST_ERROR) {
-    rb_raise(rb_eStandardError, &quot;Memory error registering handler&quot;);
-  } else if(rc == TST_NULL_KEY) {
-    rb_raise(rb_eStandardError, &quot;URI was empty&quot;);
-  }
-  rb_hash_aset(rb_ivar_get(self, id_handler_map), uri, handler);
-  return Qnil;
-}</pre>
+  <pre>    <span class="ruby-comment cmt"># File lib/mongrel.rb, line 58</span>
+58:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">inspect</span>
+59:       <span class="ruby-ivar">@handler_map</span>.<span class="ruby-identifier">inspect</span>
+60:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000092.html CHANGED

@@ -5,32 +5,35 @@
 <html>
 <head>
-  <title>unregister (Mongrel::URIClassifier)</title>
+  <title>new (Mongrel::URIClassifier)</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>/**
  * call-seq:
- *    uc.unregister(&quot;/someuri&quot;)
+ *    URIClassifier.new -&gt; URIClassifier
+ *
+ * Initializes a new URIClassifier 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's mostly used with URIs.
+ *
+ * It uses TST from http://www.octavian.org/cs/software.html 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.
  *
- * Yep, just removes this uri and it's handler from the trie.
  */
-VALUE URIClassifier_unregister(VALUE self, VALUE uri)
+VALUE URIClassifier_init(VALUE self)
 {
-  void *handler = NULL;
-  struct tst *tst = NULL;
-  DATA_GET(self, struct tst, tst);
-  handler = tst_delete((unsigned char *)StringValueCStr(uri), tst);
+  VALUE hash;
-  if(handler) {
-    rb_hash_delete(rb_ivar_get(self, id_handler_map), uri);
+  // we create an internal hash to protect stuff from the GC
+  hash = rb_hash_new();
+  rb_ivar_set(self, id_handler_map, hash);
-    return (VALUE)handler;
-  } else {
-    return Qnil;
-  }
+  return self;
 }</pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000093.html CHANGED

@@ -5,79 +5,47 @@
 <html>
 <head>
-  <title>resolve (Mongrel::URIClassifier)</title>
+  <title>register (Mongrel::URIClassifier)</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>/**
  * call-seq:
- *    uc.resolve(&quot;/someuri&quot;) -&gt; &quot;/someuri&quot;, &quot;&quot;, handler
- *    uc.resolve(&quot;/someuri/pathinfo&quot;) -&gt; &quot;/someuri&quot;, &quot;/pathinfo&quot;, handler
- *    uc.resolve(&quot;/notfound/orhere&quot;) -&gt; nil, nil, nil
- *    uc.resolve(&quot;/&quot;) -&gt; &quot;/&quot;, &quot;/&quot;, handler  # if uc.register(&quot;/&quot;, handler)
- *    uc.resolve(&quot;/path/from/root&quot;) -&gt; &quot;/&quot;, &quot;/path/from/root&quot;, handler  # if uc.register(&quot;/&quot;, handler)
- *
- * 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 HttpHandler).  If it doesn't find a handler registered at the longest
- * match then it returns nil,nil,nil.
+ *    uc.register(&quot;/someuri&quot;, SampleHandler.new) -&gt; nil
  *
- * Because the resolver uses a trie you are able to register a handler at *any* character
- * in the URI and it will be handled as long as it'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.
- *
- * 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's very efficient to do this only taking as long as the URI has
- * characters.
+ * Registers the SampleHandler (one for all requests) with the &quot;/someuri&quot;.
+ * When URIClassifier::resolve is called with &quot;/someuri&quot; it'll return
+ * SampleHandler immediately.  When called with &quot;/someuri/iwant&quot; it'll also
+ * return SomeHandler immediatly, with no additional searches, but it will
+ * return path info with &quot;/iwant&quot;.
  *
- * 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'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.
- *
- * It expects strings with no embedded '\0' characters.  Don't try other string-like stuff yet.
+ * 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's main advantage is that it works on prefixes, which
+ * is damn hard to get right with a Hash.
  */
-VALUE URIClassifier_resolve(VALUE self, VALUE uri)
+VALUE URIClassifier_register(VALUE self, VALUE uri, VALUE handler)
 {
-  void *handler = NULL;
-  int pref_len = 0;
+  int rc = 0;
+  void *ptr = NULL;
   struct tst *tst = NULL;
-  VALUE result;
-  unsigned char *uri_str = NULL;
   DATA_GET(self, struct tst, tst);
-  uri_str = (unsigned char *)StringValueCStr(uri);
-  handler = tst_search(uri_str, tst, &amp;pref_len);
-  // setup for multiple return values
-  result = rb_ary_new();
+  rc = tst_insert((unsigned char *)StringValueCStr(uri), (void *)handler , tst, 0, &amp;ptr);
-  if(handler) {
-    rb_ary_push(result, rb_str_substr (uri, 0, pref_len));
-    // compensate for a script_name=&quot;/&quot; where we need to add the &quot;/&quot; to path_info to keep it consistent
-    if(pref_len == 1 &amp;&amp; uri_str[0] == '/') {
-      // matches the root URI so we have to use the whole URI as the path_info
-      rb_ary_push(result, uri);
-    } else {
-      // matches a script so process like normal
-      rb_ary_push(result, rb_str_substr(uri, pref_len, RSTRING(uri)-&gt;len));
-    }
-    rb_ary_push(result, (VALUE)handler);
-  } else {
-    // not found so push back nothing
-    rb_ary_push(result, Qnil);
-    rb_ary_push(result, Qnil);
-    rb_ary_push(result, Qnil);
+  if(rc == TST_DUPLICATE_KEY) {
+    rb_raise(rb_eStandardError, &quot;Handler already registered with that name&quot;);
+  } else if(rc == TST_ERROR) {
+    rb_raise(rb_eStandardError, &quot;Memory error registering handler&quot;);
+  } else if(rc == TST_NULL_KEY) {
+    rb_raise(rb_eStandardError, &quot;URI was empty&quot;);
   }
+  rb_hash_aset(rb_ivar_get(self, id_handler_map), uri, handler);
-  return result;
+  return Qnil;
 }</pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000094.html ADDED

@@ -0,0 +1,36 @@
+<?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>unregister (Mongrel::URIClassifier)</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>/**
+ * call-seq:
+ *    uc.unregister(&quot;/someuri&quot;)
+ *
+ * Yep, just removes this uri and it's handler from the trie.
+ */
+VALUE URIClassifier_unregister(VALUE self, VALUE uri)
+{
+  void *handler = NULL;
+  struct tst *tst = NULL;
+  DATA_GET(self, struct tst, tst);
+  handler = tst_delete((unsigned char *)StringValueCStr(uri), tst);
+  if(handler) {
+    rb_hash_delete(rb_ivar_get(self, id_handler_map), uri);
+    return (VALUE)handler;
+  } else {
+    return Qnil;
+  }
+}</pre>
+</body>
+</html>

data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000095.html ADDED

@@ -0,0 +1,83 @@
+<?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>resolve (Mongrel::URIClassifier)</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>/**
+ * call-seq:
+ *    uc.resolve(&quot;/someuri&quot;) -&gt; &quot;/someuri&quot;, &quot;&quot;, handler
+ *    uc.resolve(&quot;/someuri/pathinfo&quot;) -&gt; &quot;/someuri&quot;, &quot;/pathinfo&quot;, handler
+ *    uc.resolve(&quot;/notfound/orhere&quot;) -&gt; nil, nil, nil
+ *    uc.resolve(&quot;/&quot;) -&gt; &quot;/&quot;, &quot;/&quot;, handler  # if uc.register(&quot;/&quot;, handler)
+ *    uc.resolve(&quot;/path/from/root&quot;) -&gt; &quot;/&quot;, &quot;/path/from/root&quot;, handler  # if uc.register(&quot;/&quot;, handler)
+ *
+ * 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 HttpHandler).  If it doesn't find a handler registered at the longest
+ * match then it returns nil,nil,nil.
+ *
+ * Because the resolver uses a trie you are able to register a handler at *any* character
+ * in the URI and it will be handled as long as it'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.
+ *
+ * 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's very efficient to do this only taking as long as the URI has
+ * characters.
+ *
+ * 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'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.
+ *
+ * It expects strings with no embedded '\0' characters.  Don't try other string-like stuff yet.
+ */
+VALUE URIClassifier_resolve(VALUE self, VALUE uri)
+{
+  void *handler = NULL;
+  int pref_len = 0;
+  struct tst *tst = NULL;
+  VALUE result;
+  unsigned char *uri_str = NULL;
+  DATA_GET(self, struct tst, tst);
+  uri_str = (unsigned char *)StringValueCStr(uri);
+  handler = tst_search(uri_str, tst, &amp;pref_len);
+  // setup for multiple return values
+  result = rb_ary_new();
+  if(handler) {
+    rb_ary_push(result, rb_str_substr (uri, 0, pref_len));
+    // compensate for a script_name=&quot;/&quot; where we need to add the &quot;/&quot; to path_info to keep it consistent
+    if(pref_len == 1 &amp;&amp; uri_str[0] == '/') {
+      // matches the root URI so we have to use the whole URI as the path_info
+      rb_ary_push(result, uri);
+    } else {
+      // matches a script so process like normal
+      rb_ary_push(result, rb_str_substr(uri, pref_len, RSTRING(uri)-&gt;len));
+    }
+    rb_ary_push(result, (VALUE)handler);
+  } else {
+    // not found so push back nothing
+    rb_ary_push(result, Qnil);
+    rb_ary_push(result, Qnil);
+    rb_ary_push(result, Qnil);
+  }
+  return result;
+}</pre>
+</body>
+</html>

data/doc/rdoc/classes/RequestLog/Access.html CHANGED

@@ -93,7 +93,7 @@ log when daemonized).
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000134">process</a>&nbsp;&nbsp;
+      <a href="#M000139">process</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -122,12 +122,12 @@ log when daemonized).
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000134" class="method-detail">
-        <a name="M000134"></a>
+      <div id="method-M000139" class="method-detail">
+        <a name="M000139"></a>
         <div class="method-heading">
-          <a href="Access.src/M000134.html" target="Code" class="method-signature"
-            onclick="popupCode('Access.src/M000134.html');return false;">
+          <a href="Access.src/M000139.html" target="Code" class="method-signature"
+            onclick="popupCode('Access.src/M000139.html');return false;">
           <span class="method-name">process</span><span class="method-args">(request,response)</span>
           </a>
         </div>

data/doc/rdoc/classes/RequestLog/Access.src/{M000134.html → M000139.html} RENAMED

File without changes

data/doc/rdoc/classes/RequestLog/Files.html CHANGED

@@ -86,7 +86,7 @@
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000135">process</a>&nbsp;&nbsp;
+      <a href="#M000140">process</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -115,12 +115,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000135" class="method-detail">
-        <a name="M000135"></a>
+      <div id="method-M000140" class="method-detail">
+        <a name="M000140"></a>
         <div class="method-heading">
-          <a href="Files.src/M000135.html" target="Code" class="method-signature"
-            onclick="popupCode('Files.src/M000135.html');return false;">
+          <a href="Files.src/M000140.html" target="Code" class="method-signature"
+            onclick="popupCode('Files.src/M000140.html');return false;">
           <span class="method-name">process</span><span class="method-args">(request, response)</span>
           </a>
         </div>

data/doc/rdoc/classes/RequestLog/Files.src/{M000135.html → M000140.html} RENAMED

File without changes

data/doc/rdoc/classes/RequestLog/Objects.html CHANGED

@@ -86,7 +86,7 @@
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000137">process</a>&nbsp;&nbsp;
+      <a href="#M000142">process</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -115,12 +115,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000137" class="method-detail">
-        <a name="M000137"></a>
+      <div id="method-M000142" class="method-detail">
+        <a name="M000142"></a>
         <div class="method-heading">
-          <a href="Objects.src/M000137.html" target="Code" class="method-signature"
-            onclick="popupCode('Objects.src/M000137.html');return false;">
+          <a href="Objects.src/M000142.html" target="Code" class="method-signature"
+            onclick="popupCode('Objects.src/M000142.html');return false;">
           <span class="method-name">process</span><span class="method-args">(request, response)</span>
           </a>
         </div>

data/doc/rdoc/classes/RequestLog/Objects.src/{M000137.html → M000142.html} RENAMED

File without changes

data/doc/rdoc/classes/RequestLog/Params.html CHANGED

@@ -86,7 +86,7 @@
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000138">process</a>&nbsp;&nbsp;
+      <a href="#M000143">process</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -115,12 +115,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000138" class="method-detail">
-        <a name="M000138"></a>
+      <div id="method-M000143" class="method-detail">
+        <a name="M000143"></a>
         <div class="method-heading">
-          <a href="Params.src/M000138.html" target="Code" class="method-signature"
-            onclick="popupCode('Params.src/M000138.html');return false;">
+          <a href="Params.src/M000143.html" target="Code" class="method-signature"
+            onclick="popupCode('Params.src/M000143.html');return false;">
           <span class="method-name">process</span><span class="method-args">(request, response)</span>
           </a>
         </div>

data/doc/rdoc/classes/RequestLog/Params.src/{M000138.html → M000143.html} RENAMED

File without changes

data/doc/rdoc/classes/RequestLog/Threads.html CHANGED

@@ -86,7 +86,7 @@
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000136">process</a>&nbsp;&nbsp;
+      <a href="#M000141">process</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -115,12 +115,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
-      <div id="method-M000136" class="method-detail">
-        <a name="M000136"></a>
+      <div id="method-M000141" class="method-detail">
+        <a name="M000141"></a>
         <div class="method-heading">
-          <a href="Threads.src/M000136.html" target="Code" class="method-signature"
-            onclick="popupCode('Threads.src/M000136.html');return false;">
+          <a href="Threads.src/M000141.html" target="Code" class="method-signature"
+            onclick="popupCode('Threads.src/M000141.html');return false;">
           <span class="method-name">process</span><span class="method-args">(request, response)</span>
           </a>
         </div>