$52 GRAYBYTE WORDPRESS FILE MANAGER $55

SERVER : premium201.web-hosting.com #1 SMP Wed Mar 26 12:08:09 UTC 2025
SERVER IP : 172.67.217.254 | ADMIN IP 216.73.216.180
OPTIONS : CRL = ON | WGT = ON | SDO = OFF | PKEX = OFF
DEACTIVATED : mail

/opt/cpanel/ea-ruby27/root/usr/share/gems/doc/rack-2.2.22/rdoc/Rack/

HOME
Current File : /opt/cpanel/ea-ruby27/root/usr/share/gems/doc/rack-2.2.22/rdoc/Rack//ConditionalGet.html
<!DOCTYPE html>

<html>
<head>
<meta charset="UTF-8">

<title>class Rack::ConditionalGet - rack-2.2.22 Documentation</title>

<script type="text/javascript">
  var rdoc_rel_prefix = "../";
  var index_rel_prefix = "../";
</script>

<script src="../js/navigation.js" defer></script>
<script src="../js/search.js" defer></script>
<script src="../js/search_index.js" defer></script>
<script src="../js/searcher.js" defer></script>
<script src="../js/darkfish.js" defer></script>

<link href="../css/fonts.css" rel="stylesheet">
<link href="../css/rdoc.css" rel="stylesheet">




<body id="top" role="document" class="class">
<nav role="navigation">
  <div id="project-navigation">
    <div id="home-section" role="region" title="Quick navigation" class="nav-section">
  <h2>
    <a href="../index.html" rel="home">Home</a>
  </h2>

  <div id="table-of-contents-navigation">
    <a href="../table_of_contents.html#pages">Pages</a>
    <a href="../table_of_contents.html#classes">Classes</a>
    <a href="../table_of_contents.html#methods">Methods</a>
  </div>
</div>

    <div id="search-section" role="search" class="project-section initially-hidden">
  <form action="#" method="get" accept-charset="utf-8">
    <div id="search-field-wrapper">
      <input id="search-field" role="combobox" aria-label="Search"
             aria-autocomplete="list" aria-controls="search-results"
             type="text" name="search" placeholder="Search" spellcheck="false"
             title="Type to search, Up and Down to navigate, Enter to load">
    </div>

    <ul id="search-results" aria-label="Search Results"
        aria-busy="false" aria-expanded="false"
        aria-atomic="false" class="initially-hidden"></ul>
  </form>
</div>

  </div>

  

  <div id="class-metadata">
    
    <div id="parent-class-section" class="nav-section">
  <h3>Parent</h3>

  
  <p class="link">Object
  
</div>

    
    
    <!-- Method Quickref -->
<div id="method-list-section" class="nav-section">
  <h3>Methods</h3>

  <ul class="link-list" role="directory">
    
    <li ><a href="#method-c-new">::new</a>
    
    <li ><a href="#method-i-call">#call</a>
    
    <li ><a href="#method-i-etag_matches-3F">#etag_matches?</a>
    
    <li ><a href="#method-i-fresh-3F">#fresh?</a>
    
    <li ><a href="#method-i-modified_since-3F">#modified_since?</a>
    
    <li ><a href="#method-i-to_rfc2822">#to_rfc2822</a>
    
  </ul>
</div>

  </div>
</nav>

<main role="main" aria-labelledby="class-Rack::ConditionalGet">
  <h1 id="class-Rack::ConditionalGet" class="class">
    class Rack::ConditionalGet
  </h1>

  <section class="description">
    
<p>Middleware that enables conditional GET using If-None-Match and If-Modified-Since. The application should set either or both of the Last-Modified or Etag response headers according to RFC 2616. When either of the conditions is met, the response body is set to be zero length and the response status is set to 304 Not Modified.</p>

<p>Applications that defer response body generation until the body&#39;s each message is received will avoid response body generation completely when a conditional GET matches.</p>

<p>Adapted from Michael Klishin&#39;s Merb implementation: <a href="https://github.com/wycats/merb/blob/master/merb-core/lib/merb-core/rack/middleware/conditional_get.rb">github.com/wycats/merb/blob/master/merb-core/lib/merb-core/rack/middleware/conditional_get.rb</a></p>

  </section>

  
  <section id="5Buntitled-5D" class="documentation-section">
    

    

    

    

    
     <section id="public-class-5Buntitled-5D-method-details" class="method-section">
       <header>
         <h3>Public Class Methods</h3>
       </header>

    
      <div id="method-c-new" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">new</span><span
            class="method-args">(app)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          
          
          

          
          <div class="method-source-code" id="new-source">
            <pre><span class="ruby-comment"># File lib/rack/conditional_get.rb, line 18</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">initialize</span>(<span class="ruby-identifier">app</span>)
  <span class="ruby-ivar">@app</span> = <span class="ruby-identifier">app</span>
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
    </section>
  
     <section id="public-instance-5Buntitled-5D-method-details" class="method-section">
       <header>
         <h3>Public Instance Methods</h3>
       </header>

    
      <div id="method-i-call" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">call</span><span
            class="method-args">(env)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>Return empty 304 response if the response has not been modified since the last request.</p>
          
          

          
          <div class="method-source-code" id="call-source">
            <pre><span class="ruby-comment"># File lib/rack/conditional_get.rb, line 24</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">call</span>(<span class="ruby-identifier">env</span>)
  <span class="ruby-keyword">case</span> <span class="ruby-identifier">env</span>[<span class="ruby-constant">REQUEST_METHOD</span>]
  <span class="ruby-keyword">when</span> <span class="ruby-string">&quot;GET&quot;</span>, <span class="ruby-string">&quot;HEAD&quot;</span>
    <span class="ruby-identifier">status</span>, <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">body</span> = <span class="ruby-ivar">@app</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">env</span>)
    <span class="ruby-identifier">headers</span> = <span class="ruby-constant">Utils</span><span class="ruby-operator">::</span><span class="ruby-constant">HeaderHash</span>[<span class="ruby-identifier">headers</span>]
    <span class="ruby-keyword">if</span> <span class="ruby-identifier">status</span> <span class="ruby-operator">==</span> <span class="ruby-value">200</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">fresh?</span>(<span class="ruby-identifier">env</span>, <span class="ruby-identifier">headers</span>)
      <span class="ruby-identifier">status</span> = <span class="ruby-value">304</span>
      <span class="ruby-identifier">headers</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-constant">CONTENT_TYPE</span>)
      <span class="ruby-identifier">headers</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-constant">CONTENT_LENGTH</span>)
      <span class="ruby-identifier">original_body</span> = <span class="ruby-identifier">body</span>
      <span class="ruby-identifier">body</span> = <span class="ruby-constant">Rack</span><span class="ruby-operator">::</span><span class="ruby-constant">BodyProxy</span>.<span class="ruby-identifier">new</span>([]) <span class="ruby-keyword">do</span>
        <span class="ruby-identifier">original_body</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">original_body</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:close</span>)
      <span class="ruby-keyword">end</span>
    <span class="ruby-keyword">end</span>
    [<span class="ruby-identifier">status</span>, <span class="ruby-identifier">headers</span>, <span class="ruby-identifier">body</span>]
  <span class="ruby-keyword">else</span>
    <span class="ruby-ivar">@app</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">env</span>)
  <span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
    </section>
  
     <section id="private-instance-5Buntitled-5D-method-details" class="method-section">
       <header>
         <h3>Private Instance Methods</h3>
       </header>

    
      <div id="method-i-etag_matches-3F" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">etag_matches?</span><span
            class="method-args">(none_match, headers)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>Whether the <a href="ETag.html"><code>ETag</code></a> response header matches the If-None-Match request header. If so, the request has not been modified.</p>
          
          

          
          <div class="method-source-code" id="etag_matches-3F-source">
            <pre><span class="ruby-comment"># File lib/rack/conditional_get.rb, line 59</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">etag_matches?</span>(<span class="ruby-identifier">none_match</span>, <span class="ruby-identifier">headers</span>)
  <span class="ruby-identifier">headers</span>[<span class="ruby-string">&#39;ETag&#39;</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">none_match</span>
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-fresh-3F" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">fresh?</span><span
            class="method-args">(env, headers)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>Return whether the response has not been modified since the last request.</p>
          
          

          
          <div class="method-source-code" id="fresh-3F-source">
            <pre><span class="ruby-comment"># File lib/rack/conditional_get.rb, line 48</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">fresh?</span>(<span class="ruby-identifier">env</span>, <span class="ruby-identifier">headers</span>)
  <span class="ruby-comment"># If-None-Match has priority over If-Modified-Since per RFC 7232</span>
  <span class="ruby-keyword">if</span> <span class="ruby-identifier">none_match</span> = <span class="ruby-identifier">env</span>[<span class="ruby-string">&#39;HTTP_IF_NONE_MATCH&#39;</span>]
    <span class="ruby-identifier">etag_matches?</span>(<span class="ruby-identifier">none_match</span>, <span class="ruby-identifier">headers</span>)
  <span class="ruby-keyword">elsif</span> (<span class="ruby-identifier">modified_since</span> = <span class="ruby-identifier">env</span>[<span class="ruby-string">&#39;HTTP_IF_MODIFIED_SINCE&#39;</span>]) <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">modified_since</span> = <span class="ruby-identifier">to_rfc2822</span>(<span class="ruby-identifier">modified_since</span>))
    <span class="ruby-identifier">modified_since?</span>(<span class="ruby-identifier">modified_since</span>, <span class="ruby-identifier">headers</span>)
  <span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-modified_since-3F" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">modified_since?</span><span
            class="method-args">(modified_since, headers)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>Whether the Last-Modified response header matches the If-Modified-Since request header.  If so, the request has not been modified.</p>
          
          

          
          <div class="method-source-code" id="modified_since-3F-source">
            <pre><span class="ruby-comment"># File lib/rack/conditional_get.rb, line 65</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">modified_since?</span>(<span class="ruby-identifier">modified_since</span>, <span class="ruby-identifier">headers</span>)
  <span class="ruby-identifier">last_modified</span> = <span class="ruby-identifier">to_rfc2822</span>(<span class="ruby-identifier">headers</span>[<span class="ruby-string">&#39;Last-Modified&#39;</span>]) <span class="ruby-keyword">and</span>
    <span class="ruby-identifier">modified_since</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-identifier">last_modified</span>
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
      <div id="method-i-to_rfc2822" class="method-detail ">
        
        <div class="method-heading">
          <span class="method-name">to_rfc2822</span><span
            class="method-args">(since)</span>
          
          <span class="method-click-advice">click to toggle source</span>
          
        </div>
        

        <div class="method-description">
          
          <p>Return a Time object for the given string (which should be in RFC2822 format), or nil if the string cannot be parsed.</p>
          
          

          
          <div class="method-source-code" id="to_rfc2822-source">
            <pre><span class="ruby-comment"># File lib/rack/conditional_get.rb, line 72</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">to_rfc2822</span>(<span class="ruby-identifier">since</span>)
  <span class="ruby-comment"># shortest possible valid date is the obsolete: 1 Nov 97 09:55 A</span>
  <span class="ruby-comment"># anything shorter is invalid, this avoids exceptions for common cases</span>
  <span class="ruby-comment"># most common being the empty string</span>
  <span class="ruby-keyword">if</span> <span class="ruby-identifier">since</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">since</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-value">16</span>
    <span class="ruby-comment"># NOTE: there is no trivial way to write this in a non exception way</span>
    <span class="ruby-comment">#   _rfc2822 returns a hash but is not that usable</span>
    <span class="ruby-constant">Time</span>.<span class="ruby-identifier">rfc2822</span>(<span class="ruby-identifier">since</span>) <span class="ruby-keyword">rescue</span> <span class="ruby-keyword">nil</span>
  <span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
          </div>
          
        </div>

        

        
      </div>

    
    </section>
  
  </section>

</main>


<footer id="validator-badges" role="contentinfo">
  <p><a href="https://validator.w3.org/check/referer">Validate</a>
  <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.1.1.
  <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
</footer>


Current_dir [ NOT WRITEABLE ] Document_root [ NOT WRITEABLE ]

[ Back ]
NAME
SIZE
LAST TOUCH
USER
CAN-I?
FUNCTIONS
..
--
14 Mar 2026 8.32 AM
root / root
0755
Auth
--
14 Mar 2026 8.32 AM
root / root
0755
Chunked
--
14 Mar 2026 8.32 AM
root / root
0755
Deflater
--
14 Mar 2026 8.32 AM
root / root
0755
Directory
--
14 Mar 2026 8.32 AM
root / root
0755
Events
--
14 Mar 2026 8.32 AM
root / root
0755
Files
--
14 Mar 2026 8.32 AM
root / root
0755
Handler
--
14 Mar 2026 8.32 AM
root / root
0755
Lint
--
14 Mar 2026 8.32 AM
root / root
0755
MockRequest
--
14 Mar 2026 8.32 AM
root / root
0755
MockResponse
--
14 Mar 2026 8.32 AM
root / root
0755
Multipart
--
14 Mar 2026 8.32 AM
root / root
0755
QueryParser
--
14 Mar 2026 8.32 AM
root / root
0755
Reloader
--
14 Mar 2026 8.32 AM
root / root
0755
Request
--
14 Mar 2026 8.32 AM
root / root
0755
Response
--
14 Mar 2026 8.32 AM
root / root
0755
Server
--
14 Mar 2026 8.32 AM
root / root
0755
Session
--
14 Mar 2026 8.32 AM
root / root
0755
Utils
--
14 Mar 2026 8.32 AM
root / root
0755
Auth.html
2.382 KB
20 Feb 2026 12.28 PM
root / root
0644
BodyProxy.html
9.983 KB
20 Feb 2026 12.28 PM
root / root
0644
Builder.html
38.075 KB
20 Feb 2026 12.28 PM
root / root
0644
Cascade.html
12.236 KB
20 Feb 2026 12.28 PM
root / root
0644
Chunked.html
10.397 KB
20 Feb 2026 12.28 PM
root / root
0644
CommonLogger.html
14.288 KB
20 Feb 2026 12.28 PM
root / root
0644
ConditionalGet.html
15.24 KB
20 Feb 2026 12.28 PM
root / root
0644
Config.html
5.855 KB
20 Feb 2026 12.28 PM
root / root
0644
ContentLength.html
7.805 KB
20 Feb 2026 12.28 PM
root / root
0644
ContentType.html
6.741 KB
20 Feb 2026 12.28 PM
root / root
0644
Deflater.html
16.407 KB
20 Feb 2026 12.28 PM
root / root
0644
Directory.html
27.379 KB
20 Feb 2026 12.28 PM
root / root
0644
ETag.html
14.999 KB
20 Feb 2026 12.28 PM
root / root
0644
Events.html
17.782 KB
20 Feb 2026 12.28 PM
root / root
0644
File.html
25.358 KB
20 Feb 2026 12.28 PM
root / root
0644
Files.html
25.362 KB
20 Feb 2026 12.28 PM
root / root
0644
ForwardRequest.html
6.744 KB
20 Feb 2026 12.28 PM
root / root
0644
Handler.html
14.406 KB
20 Feb 2026 12.28 PM
root / root
0644
Head.html
6.182 KB
20 Feb 2026 12.28 PM
root / root
0644
Lint.html
4.007 KB
20 Feb 2026 12.28 PM
root / root
0644
Lobster.html
7.828 KB
20 Feb 2026 12.28 PM
root / root
0644
Lock.html
7.633 KB
20 Feb 2026 12.28 PM
root / root
0644
Logger.html
5.773 KB
20 Feb 2026 12.28 PM
root / root
0644
MediaType.html
9.959 KB
20 Feb 2026 12.28 PM
root / root
0644
MethodOverride.html
11.556 KB
20 Feb 2026 12.28 PM
root / root
0644
Mime.html
13.642 KB
20 Feb 2026 12.28 PM
root / root
0644
MockRequest.html
29.98 KB
20 Feb 2026 12.28 PM
root / root
0644
MockResponse.html
21.321 KB
20 Feb 2026 12.28 PM
root / root
0644
Multipart.html
11.131 KB
20 Feb 2026 12.28 PM
root / root
0644
NullLogger.html
26.914 KB
20 Feb 2026 12.28 PM
root / root
0644
QueryParser.html
34.353 KB
20 Feb 2026 12.28 PM
root / root
0644
Recursive.html
10.012 KB
20 Feb 2026 12.28 PM
root / root
0644
RegexpExtensions.html
3.931 KB
20 Feb 2026 12.28 PM
root / root
0644
Reloader.html
10.95 KB
20 Feb 2026 12.28 PM
root / root
0644
Request.html
9.893 KB
20 Feb 2026 12.28 PM
root / root
0644
Response.html
26.613 KB
20 Feb 2026 12.28 PM
root / root
0644
RewindableInput.html
16.698 KB
20 Feb 2026 12.28 PM
root / root
0644
Runtime.html
6.829 KB
20 Feb 2026 12.28 PM
root / root
0644
Sendfile.html
22.708 KB
20 Feb 2026 12.28 PM
root / root
0644
Server.html
52.996 KB
20 Feb 2026 12.28 PM
root / root
0644
Session.html
2.606 KB
20 Feb 2026 12.28 PM
root / root
0644
ShowExceptions.html
18.029 KB
20 Feb 2026 12.28 PM
root / root
0644
ShowStatus.html
8.986 KB
20 Feb 2026 12.28 PM
root / root
0644
Static.html
25.858 KB
20 Feb 2026 12.28 PM
root / root
0644
TempfileReaper.html
6.389 KB
20 Feb 2026 12.28 PM
root / root
0644
URLMap.html
16.275 KB
20 Feb 2026 12.28 PM
root / root
0644
Utils.html
73.896 KB
20 Feb 2026 12.28 PM
root / root
0644

GRAYBYTE WORDPRESS FILE MANAGER @ 2025 CONTACT ME
Static GIF