RubyGems - mongrel - Versions diffs - 0.3.13.4 → 1.0 - Mend

mongrel 0.3.13.4 → 1.0

Files changed (256) hide show

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

@@ -5,35 +5,14 @@
 <html>
 <head>
-  <title>new (Mongrel::URIClassifier)</title>
+  <title>uris (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:
- *    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.
- *
- */
-VALUE URIClassifier_init(VALUE self)
-{
-  VALUE hash;
-  // we create an internal hash to protect stuff from the GC
-  hash = rb_hash_new();
-  rb_ivar_set(self, id_handler_map, hash);
-  return self;
-}</pre>
+  <pre>    <span class="ruby-comment cmt"># File lib/mongrel.rb, line 44</span>
+44:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">uris</span>
+45:       <span class="ruby-ivar">@handler_map</span>.<span class="ruby-identifier">keys</span>
+46:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000088.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 49</span>
+49:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">inspect</span>
+50:       <span class="ruby-ivar">@handler_map</span>.<span class="ruby-identifier">inspect</span>
+51:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000089.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/M000090.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;);
   }
-  return result;
+  rb_hash_aset(rb_ivar_get(self, id_handler_map), uri, handler);
+  return Qnil;
 }</pre>
 </body>
 </html>

data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000091.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/M000092.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/MongrelDbg.html CHANGED

@@ -80,11 +80,11 @@
       <h3 class="section-bar">Methods</h3>
       <div class="name-list">
-      <a href="#M000007">begin_trace</a>&nbsp;&nbsp;
-      <a href="#M000005">configure</a>&nbsp;&nbsp;
-      <a href="#M000008">end_trace</a>&nbsp;&nbsp;
-      <a href="#M000006">trace</a>&nbsp;&nbsp;
-      <a href="#M000009">tracing?</a>&nbsp;&nbsp;
+      <a href="#M000009">begin_trace</a>&nbsp;&nbsp;
+      <a href="#M000007">configure</a>&nbsp;&nbsp;
+      <a href="#M000010">end_trace</a>&nbsp;&nbsp;
+      <a href="#M000008">trace</a>&nbsp;&nbsp;
+      <a href="#M000011">tracing?</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -124,12 +124,12 @@
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
-      <div id="method-M000007" class="method-detail">
-        <a name="M000007"></a>
+      <div id="method-M000009" class="method-detail">
+        <a name="M000009"></a>
         <div class="method-heading">
-          <a href="MongrelDbg.src/M000007.html" target="Code" class="method-signature"
-            onclick="popupCode('MongrelDbg.src/M000007.html');return false;">
+          <a href="MongrelDbg.src/M000009.html" target="Code" class="method-signature"
+            onclick="popupCode('MongrelDbg.src/M000009.html');return false;">
           <span class="method-name">begin_trace</span><span class="method-args">(target)</span>
           </a>
         </div>
@@ -138,12 +138,12 @@
         </div>
       </div>
-      <div id="method-M000005" class="method-detail">
-        <a name="M000005"></a>
+      <div id="method-M000007" class="method-detail">
+        <a name="M000007"></a>
         <div class="method-heading">
-          <a href="MongrelDbg.src/M000005.html" target="Code" class="method-signature"
-            onclick="popupCode('MongrelDbg.src/M000005.html');return false;">
+          <a href="MongrelDbg.src/M000007.html" target="Code" class="method-signature"
+            onclick="popupCode('MongrelDbg.src/M000007.html');return false;">
           <span class="method-name">configure</span><span class="method-args">(log_dir = File.join(&quot;log&quot;,&quot;mongrel_debug&quot;))</span>
           </a>
         </div>
@@ -152,12 +152,12 @@
         </div>
       </div>
-      <div id="method-M000008" class="method-detail">
-        <a name="M000008"></a>
+      <div id="method-M000010" class="method-detail">
+        <a name="M000010"></a>
         <div class="method-heading">
-          <a href="MongrelDbg.src/M000008.html" target="Code" class="method-signature"
-            onclick="popupCode('MongrelDbg.src/M000008.html');return false;">
+          <a href="MongrelDbg.src/M000010.html" target="Code" class="method-signature"
+            onclick="popupCode('MongrelDbg.src/M000010.html');return false;">
           <span class="method-name">end_trace</span><span class="method-args">(target)</span>
           </a>
         </div>
@@ -166,12 +166,12 @@
         </div>
       </div>
-      <div id="method-M000006" class="method-detail">
-        <a name="M000006"></a>
+      <div id="method-M000008" class="method-detail">
+        <a name="M000008"></a>
         <div class="method-heading">
-          <a href="MongrelDbg.src/M000006.html" target="Code" class="method-signature"
-            onclick="popupCode('MongrelDbg.src/M000006.html');return false;">
+          <a href="MongrelDbg.src/M000008.html" target="Code" class="method-signature"
+            onclick="popupCode('MongrelDbg.src/M000008.html');return false;">
           <span class="method-name">trace</span><span class="method-args">(target, message)</span>
           </a>
         </div>
@@ -180,12 +180,12 @@
         </div>
       </div>
-      <div id="method-M000009" class="method-detail">
-        <a name="M000009"></a>
+      <div id="method-M000011" class="method-detail">
+        <a name="M000011"></a>
         <div class="method-heading">
-          <a href="MongrelDbg.src/M000009.html" target="Code" class="method-signature"
-            onclick="popupCode('MongrelDbg.src/M000009.html');return false;">
+          <a href="MongrelDbg.src/M000011.html" target="Code" class="method-signature"
+            onclick="popupCode('MongrelDbg.src/M000011.html');return false;">
           <span class="method-name">tracing?</span><span class="method-args">(target)</span>
           </a>
         </div>