$20 GRAYBYTE WORDPRESS FILE MANAGER $44

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

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

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

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

<title>class Rack::ConditionalGet - rack-2.2.23 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
..
--
30 Apr 2026 9.02 AM
root / root
0755
Auth
--
30 Apr 2026 9.02 AM
root / root
0755
Chunked
--
30 Apr 2026 9.02 AM
root / root
0755
Deflater
--
30 Apr 2026 9.02 AM
root / root
0755
Directory
--
30 Apr 2026 9.02 AM
root / root
0755
Events
--
30 Apr 2026 9.02 AM
root / root
0755
Files
--
30 Apr 2026 9.02 AM
root / root
0755
Handler
--
30 Apr 2026 9.02 AM
root / root
0755
Lint
--
30 Apr 2026 9.02 AM
root / root
0755
MockRequest
--
30 Apr 2026 9.02 AM
root / root
0755
MockResponse
--
30 Apr 2026 9.02 AM
root / root
0755
Multipart
--
30 Apr 2026 9.02 AM
root / root
0755
QueryParser
--
30 Apr 2026 9.02 AM
root / root
0755
Reloader
--
30 Apr 2026 9.02 AM
root / root
0755
Request
--
30 Apr 2026 9.02 AM
root / root
0755
Response
--
30 Apr 2026 9.02 AM
root / root
0755
Server
--
30 Apr 2026 9.02 AM
root / root
0755
Session
--
30 Apr 2026 9.02 AM
root / root
0755
Utils
--
30 Apr 2026 9.02 AM
root / root
0755
Auth.html
2.382 KB
8 Apr 2026 4.48 PM
root / root
0644
BodyProxy.html
9.983 KB
8 Apr 2026 4.48 PM
root / root
0644
Builder.html
38.075 KB
8 Apr 2026 4.48 PM
root / root
0644
Cascade.html
12.236 KB
8 Apr 2026 4.48 PM
root / root
0644
Chunked.html
10.397 KB
8 Apr 2026 4.48 PM
root / root
0644
CommonLogger.html
14.288 KB
8 Apr 2026 4.48 PM
root / root
0644
ConditionalGet.html
15.24 KB
8 Apr 2026 4.48 PM
root / root
0644
Config.html
5.855 KB
8 Apr 2026 4.48 PM
root / root
0644
ContentLength.html
7.805 KB
8 Apr 2026 4.48 PM
root / root
0644
ContentType.html
6.741 KB
8 Apr 2026 4.48 PM
root / root
0644
Deflater.html
16.407 KB
8 Apr 2026 4.48 PM
root / root
0644
Directory.html
27.379 KB
8 Apr 2026 4.48 PM
root / root
0644
ETag.html
14.999 KB
8 Apr 2026 4.48 PM
root / root
0644
Events.html
17.782 KB
8 Apr 2026 4.48 PM
root / root
0644
File.html
25.362 KB
8 Apr 2026 4.48 PM
root / root
0644
Files.html
25.366 KB
8 Apr 2026 4.48 PM
root / root
0644
ForwardRequest.html
6.744 KB
8 Apr 2026 4.48 PM
root / root
0644
Handler.html
14.406 KB
8 Apr 2026 4.48 PM
root / root
0644
Head.html
6.182 KB
8 Apr 2026 4.48 PM
root / root
0644
Lint.html
4.007 KB
8 Apr 2026 4.48 PM
root / root
0644
Lobster.html
7.828 KB
8 Apr 2026 4.48 PM
root / root
0644
Lock.html
7.633 KB
8 Apr 2026 4.48 PM
root / root
0644
Logger.html
5.773 KB
8 Apr 2026 4.48 PM
root / root
0644
MediaType.html
9.959 KB
8 Apr 2026 4.48 PM
root / root
0644
MethodOverride.html
11.556 KB
8 Apr 2026 4.48 PM
root / root
0644
Mime.html
13.642 KB
8 Apr 2026 4.48 PM
root / root
0644
MockRequest.html
29.98 KB
8 Apr 2026 4.48 PM
root / root
0644
MockResponse.html
21.321 KB
8 Apr 2026 4.48 PM
root / root
0644
Multipart.html
11.131 KB
8 Apr 2026 4.48 PM
root / root
0644
NullLogger.html
26.914 KB
8 Apr 2026 4.48 PM
root / root
0644
QueryParser.html
34.353 KB
8 Apr 2026 4.48 PM
root / root
0644
Recursive.html
10.012 KB
8 Apr 2026 4.49 PM
root / root
0644
RegexpExtensions.html
3.931 KB
8 Apr 2026 4.49 PM
root / root
0644
Reloader.html
10.95 KB
8 Apr 2026 4.49 PM
root / root
0644
Request.html
9.893 KB
8 Apr 2026 4.49 PM
root / root
0644
Response.html
26.613 KB
8 Apr 2026 4.49 PM
root / root
0644
RewindableInput.html
16.698 KB
8 Apr 2026 4.49 PM
root / root
0644
Runtime.html
6.829 KB
8 Apr 2026 4.49 PM
root / root
0644
Sendfile.html
22.732 KB
8 Apr 2026 4.49 PM
root / root
0644
Server.html
52.996 KB
8 Apr 2026 4.49 PM
root / root
0644
Session.html
2.606 KB
8 Apr 2026 4.49 PM
root / root
0644
ShowExceptions.html
18.029 KB
8 Apr 2026 4.49 PM
root / root
0644
ShowStatus.html
8.986 KB
8 Apr 2026 4.49 PM
root / root
0644
Static.html
26.895 KB
8 Apr 2026 4.49 PM
root / root
0644
TempfileReaper.html
6.389 KB
8 Apr 2026 4.49 PM
root / root
0644
URLMap.html
16.275 KB
8 Apr 2026 4.49 PM
root / root
0644
Utils.html
76.764 KB
8 Apr 2026 4.49 PM
root / root
0644

GRAYBYTE WORDPRESS FILE MANAGER @ 2026 CONTACT ME
Static GIF Static GIF