svn commit: r1675075 [5/20] - in /httpcomponents/site/httpcomponents-asyncclient-4.1.x: ./ httpasyncclient-cache/ httpasyncclient-cache/apidocs/ httpasyncclient-cache/apidocs/org/apache/http/impl/client/cache/ httpasyncclient-cache/apidocs/org/apache/h...

[ol...@apache.org]

Modified: httpcomponents/site/httpcomponents-asyncclient-4.1.x/httpasyncclient-cache/xref/org/apache/http/impl/client/cache/CachingHttpAsyncClient.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-asyncclient-4.1.x/httpasyncclient-cache/xref/org/apache/http/impl/client/cache/CachingHttpAsyncClient.html?rev=1675075&r1=1675074&r2=1675075&view=diff
==============================================================================
--- httpcomponents/site/httpcomponents-asyncclient-4.1.x/httpasyncclient-cache/xref/org/apache/http/impl/client/cache/CachingHttpAsyncClient.html (original)
+++ httpcomponents/site/httpcomponents-asyncclient-4.1.x/httpasyncclient-cache/xref/org/apache/http/impl/client/cache/CachingHttpAsyncClient.html Tue Apr 21 09:46:17 2015
@@ -394,7 +394,7 @@
 <a class="jxr_linenumber" name="384" href="#384">384</a>                 &amp;&amp; !staleResponseNotAllowed(request, entry, now)
 <a class="jxr_linenumber" name="385" href="#385">385</a>                 &amp;&amp; <strong class="jxr_keyword">this</strong>.validityPolicy.mayReturnStaleWhileRevalidating(entry, now)) {
 <a class="jxr_linenumber" name="386" href="#386">386</a>                 <strong class="jxr_keyword">this</strong>.log.debug(<span class="jxr_string">"Serving stale with asynchronous revalidation"</span>);
-<a class="jxr_linenumber" name="387" href="#387">387</a>                 <strong class="jxr_keyword">final</strong> HttpResponse resp = <strong class="jxr_keyword">this</strong>.responseGenerator.generateResponse(entry);
+<a class="jxr_linenumber" name="387" href="#387">387</a>                 <strong class="jxr_keyword">final</strong> HttpResponse resp = <strong class="jxr_keyword">this</strong>.responseGenerator.generateResponse(request, entry);
 <a class="jxr_linenumber" name="388" href="#388">388</a>                 resp.addHeader(HeaderConstants.WARNING, <span class="jxr_string">"110 localhost \&quot;Response is stale\&quot;"</span>);
 <a class="jxr_linenumber" name="389" href="#389">389</a> 
 <a class="jxr_linenumber" name="390" href="#390">390</a>                 <strong class="jxr_keyword">this</strong>.asynchAsyncRevalidator.revalidateCacheEntry(target, request, clientContext, entry);
@@ -512,7 +512,7 @@
 <a class="jxr_linenumber" name="502" href="#502">502</a>     }
 <a class="jxr_linenumber" name="503" href="#503">503</a> 
 <a class="jxr_linenumber" name="504" href="#504">504</a>     <strong class="jxr_keyword">private</strong> HttpResponse generateCachedResponse(
-<a class="jxr_linenumber" name="505" href="#505">505</a>             <strong class="jxr_keyword">final</strong> HttpRequest request,
+<a class="jxr_linenumber" name="505" href="#505">505</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper request,
 <a class="jxr_linenumber" name="506" href="#506">506</a>             <strong class="jxr_keyword">final</strong> HttpCacheContext clientContext,
 <a class="jxr_linenumber" name="507" href="#507">507</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry entry,
 <a class="jxr_linenumber" name="508" href="#508">508</a>             <strong class="jxr_keyword">final</strong> Date now) {
@@ -521,7 +521,7 @@
 <a class="jxr_linenumber" name="511" href="#511">511</a>                 || request.containsHeader(HeaderConstants.IF_MODIFIED_SINCE)) {
 <a class="jxr_linenumber" name="512" href="#512">512</a>             cachedResponse = <strong class="jxr_keyword">this</strong>.responseGenerator.generateNotModifiedResponse(entry);
 <a class="jxr_linenumber" name="513" href="#513">513</a>         } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="514" href="#514">514</a>             cachedResponse = <strong class="jxr_keyword">this</strong>.responseGenerator.generateResponse(entry);
+<a class="jxr_linenumber" name="514" href="#514">514</a>             cachedResponse = <strong class="jxr_keyword">this</strong>.responseGenerator.generateResponse(request, entry);
 <a class="jxr_linenumber" name="515" href="#515">515</a>         }
 <a class="jxr_linenumber" name="516" href="#516">516</a>         setResponseStatus(clientContext, CacheResponseStatus.CACHE_HIT);
 <a class="jxr_linenumber" name="517" href="#517">517</a>         <strong class="jxr_keyword">if</strong> (<strong class="jxr_keyword">this</strong>.validityPolicy.getStalenessSecs(entry, now) &gt; 0L) {
@@ -531,14 +531,14 @@
 <a class="jxr_linenumber" name="521" href="#521">521</a>     }
 <a class="jxr_linenumber" name="522" href="#522">522</a> 
 <a class="jxr_linenumber" name="523" href="#523">523</a>     <strong class="jxr_keyword">private</strong> HttpResponse handleRevalidationFailure(
-<a class="jxr_linenumber" name="524" href="#524">524</a>             <strong class="jxr_keyword">final</strong> HttpRequest request,
+<a class="jxr_linenumber" name="524" href="#524">524</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper request,
 <a class="jxr_linenumber" name="525" href="#525">525</a>             <strong class="jxr_keyword">final</strong> HttpCacheContext clientContext,
 <a class="jxr_linenumber" name="526" href="#526">526</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry entry,
 <a class="jxr_linenumber" name="527" href="#527">527</a>             <strong class="jxr_keyword">final</strong> Date now) {
 <a class="jxr_linenumber" name="528" href="#528">528</a>         <strong class="jxr_keyword">if</strong> (staleResponseNotAllowed(request, entry, now)) {
 <a class="jxr_linenumber" name="529" href="#529">529</a>             <strong class="jxr_keyword">return</strong> generateGatewayTimeout(clientContext);
 <a class="jxr_linenumber" name="530" href="#530">530</a>         }
-<a class="jxr_linenumber" name="531" href="#531">531</a>         <strong class="jxr_keyword">return</strong> unvalidatedCacheHit(clientContext, entry);
+<a class="jxr_linenumber" name="531" href="#531">531</a>         <strong class="jxr_keyword">return</strong> unvalidatedCacheHit(clientContext, request, entry);
 <a class="jxr_linenumber" name="532" href="#532">532</a>     }
 <a class="jxr_linenumber" name="533" href="#533">533</a> 
 <a class="jxr_linenumber" name="534" href="#534">534</a>     <strong class="jxr_keyword">private</strong> HttpResponse generateGatewayTimeout(<strong class="jxr_keyword">final</strong> HttpCacheContext clientContext) {
@@ -549,475 +549,476 @@
 <a class="jxr_linenumber" name="539" href="#539">539</a> 
 <a class="jxr_linenumber" name="540" href="#540">540</a>     <strong class="jxr_keyword">private</strong> HttpResponse unvalidatedCacheHit(
 <a class="jxr_linenumber" name="541" href="#541">541</a>             <strong class="jxr_keyword">final</strong> HttpCacheContext clientContext,
-<a class="jxr_linenumber" name="542" href="#542">542</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry entry) {
-<a class="jxr_linenumber" name="543" href="#543">543</a>         <strong class="jxr_keyword">final</strong> HttpResponse cachedResponse = <strong class="jxr_keyword">this</strong>.responseGenerator.generateResponse(entry);
-<a class="jxr_linenumber" name="544" href="#544">544</a>         setResponseStatus(clientContext, CacheResponseStatus.CACHE_HIT);
-<a class="jxr_linenumber" name="545" href="#545">545</a>         cachedResponse.addHeader(HeaderConstants.WARNING, <span class="jxr_string">"111 localhost \&quot;Revalidation failed\&quot;"</span>);
-<a class="jxr_linenumber" name="546" href="#546">546</a>         <strong class="jxr_keyword">return</strong> cachedResponse;
-<a class="jxr_linenumber" name="547" href="#547">547</a>     }
-<a class="jxr_linenumber" name="548" href="#548">548</a> 
-<a class="jxr_linenumber" name="549" href="#549">549</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> staleResponseNotAllowed(
-<a class="jxr_linenumber" name="550" href="#550">550</a>             <strong class="jxr_keyword">final</strong> HttpRequest request,
-<a class="jxr_linenumber" name="551" href="#551">551</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry entry,
-<a class="jxr_linenumber" name="552" href="#552">552</a>             <strong class="jxr_keyword">final</strong> Date now) {
-<a class="jxr_linenumber" name="553" href="#553">553</a>         <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">this</strong>.validityPolicy.mustRevalidate(entry)
-<a class="jxr_linenumber" name="554" href="#554">554</a>             || (isSharedCache() &amp;&amp; <strong class="jxr_keyword">this</strong>.validityPolicy.proxyRevalidate(entry))
-<a class="jxr_linenumber" name="555" href="#555">555</a>             || explicitFreshnessRequest(request, entry, now);
-<a class="jxr_linenumber" name="556" href="#556">556</a>     }
-<a class="jxr_linenumber" name="557" href="#557">557</a> 
-<a class="jxr_linenumber" name="558" href="#558">558</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> mayCallBackend(<strong class="jxr_keyword">final</strong> HttpRequest request) {
-<a class="jxr_linenumber" name="559" href="#559">559</a>         <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">final</strong> Header h: request.getHeaders(HeaderConstants.CACHE_CONTROL)) {
-<a class="jxr_linenumber" name="560" href="#560">560</a>             <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">final</strong> HeaderElement elt : h.getElements()) {
-<a class="jxr_linenumber" name="561" href="#561">561</a>                 <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"only-if-cached"</span>.equals(elt.getName())) {
-<a class="jxr_linenumber" name="562" href="#562">562</a>                     <strong class="jxr_keyword">this</strong>.log.debug(<span class="jxr_string">"Request marked only-if-cached"</span>);
-<a class="jxr_linenumber" name="563" href="#563">563</a>                     <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="564" href="#564">564</a>                 }
-<a class="jxr_linenumber" name="565" href="#565">565</a>             }
-<a class="jxr_linenumber" name="566" href="#566">566</a>         }
-<a class="jxr_linenumber" name="567" href="#567">567</a>         <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="568" href="#568">568</a>     }
-<a class="jxr_linenumber" name="569" href="#569">569</a> 
-<a class="jxr_linenumber" name="570" href="#570">570</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> explicitFreshnessRequest(
-<a class="jxr_linenumber" name="571" href="#571">571</a>             <strong class="jxr_keyword">final</strong> HttpRequest request,
-<a class="jxr_linenumber" name="572" href="#572">572</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry entry,
-<a class="jxr_linenumber" name="573" href="#573">573</a>             <strong class="jxr_keyword">final</strong> Date now) {
-<a class="jxr_linenumber" name="574" href="#574">574</a>         <strong class="jxr_keyword">for</strong>(<strong class="jxr_keyword">final</strong> Header h : request.getHeaders(HeaderConstants.CACHE_CONTROL)) {
-<a class="jxr_linenumber" name="575" href="#575">575</a>             <strong class="jxr_keyword">for</strong>(<strong class="jxr_keyword">final</strong> HeaderElement elt : h.getElements()) {
-<a class="jxr_linenumber" name="576" href="#576">576</a>                 <strong class="jxr_keyword">if</strong> (HeaderConstants.CACHE_CONTROL_MAX_STALE.equals(elt.getName())) {
-<a class="jxr_linenumber" name="577" href="#577">577</a>                     <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="578" href="#578">578</a>                         <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> maxstale = Integer.parseInt(elt.getValue());
-<a class="jxr_linenumber" name="579" href="#579">579</a>                         <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">long</strong> age = <strong class="jxr_keyword">this</strong>.validityPolicy.getCurrentAgeSecs(entry, now);
-<a class="jxr_linenumber" name="580" href="#580">580</a>                         <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">long</strong> lifetime = <strong class="jxr_keyword">this</strong>.validityPolicy.getFreshnessLifetimeSecs(entry);
-<a class="jxr_linenumber" name="581" href="#581">581</a>                         <strong class="jxr_keyword">if</strong> (age - lifetime &gt; maxstale) {
-<a class="jxr_linenumber" name="582" href="#582">582</a>                             <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="583" href="#583">583</a>                         }
-<a class="jxr_linenumber" name="584" href="#584">584</a>                     } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> NumberFormatException nfe) {
-<a class="jxr_linenumber" name="585" href="#585">585</a>                         <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="586" href="#586">586</a>                     }
-<a class="jxr_linenumber" name="587" href="#587">587</a>                 } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (HeaderConstants.CACHE_CONTROL_MIN_FRESH.equals(elt.getName())
-<a class="jxr_linenumber" name="588" href="#588">588</a>                             || HeaderConstants.CACHE_CONTROL_MAX_AGE.equals(elt.getName())) {
-<a class="jxr_linenumber" name="589" href="#589">589</a>                     <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="590" href="#590">590</a>                 }
-<a class="jxr_linenumber" name="591" href="#591">591</a>             }
-<a class="jxr_linenumber" name="592" href="#592">592</a>         }
-<a class="jxr_linenumber" name="593" href="#593">593</a>         <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="594" href="#594">594</a>     }
-<a class="jxr_linenumber" name="595" href="#595">595</a> 
-<a class="jxr_linenumber" name="596" href="#596">596</a>     <strong class="jxr_keyword">private</strong> String generateViaHeader(<strong class="jxr_keyword">final</strong> HttpMessage msg) {
-<a class="jxr_linenumber" name="597" href="#597">597</a> 
-<a class="jxr_linenumber" name="598" href="#598">598</a>         <strong class="jxr_keyword">final</strong> ProtocolVersion pv = msg.getProtocolVersion();
-<a class="jxr_linenumber" name="599" href="#599">599</a>         <strong class="jxr_keyword">final</strong> String existingEntry = viaHeaders.get(pv);
-<a class="jxr_linenumber" name="600" href="#600">600</a>         <strong class="jxr_keyword">if</strong> (existingEntry != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="601" href="#601">601</a>             <strong class="jxr_keyword">return</strong> existingEntry;
-<a class="jxr_linenumber" name="602" href="#602">602</a>         }
-<a class="jxr_linenumber" name="603" href="#603">603</a> 
-<a class="jxr_linenumber" name="604" href="#604">604</a>         <strong class="jxr_keyword">final</strong> VersionInfo vi = VersionInfo.loadVersionInfo(<span class="jxr_string">"org.apache.http.client"</span>, getClass().getClassLoader());
-<a class="jxr_linenumber" name="605" href="#605">605</a>         <strong class="jxr_keyword">final</strong> String release = (vi != <strong class="jxr_keyword">null</strong>) ? vi.getRelease() : VersionInfo.UNAVAILABLE;
-<a class="jxr_linenumber" name="606" href="#606">606</a> 
-<a class="jxr_linenumber" name="607" href="#607">607</a>         <strong class="jxr_keyword">final</strong> String value;
-<a class="jxr_linenumber" name="608" href="#608">608</a>         <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"http"</span>.equalsIgnoreCase(pv.getProtocol())) {
-<a class="jxr_linenumber" name="609" href="#609">609</a>             value = String.format(<span class="jxr_string">"%d.%d localhost (Apache-HttpClient/%s (cache))"</span>, pv.getMajor(), pv.getMinor(),
-<a class="jxr_linenumber" name="610" href="#610">610</a>                     release);
-<a class="jxr_linenumber" name="611" href="#611">611</a>         } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="612" href="#612">612</a>             value = String.format(<span class="jxr_string">"%s/%d.%d localhost (Apache-HttpClient/%s (cache))"</span>, pv.getProtocol(), pv.getMajor(),
-<a class="jxr_linenumber" name="613" href="#613">613</a>                     pv.getMinor(), release);
-<a class="jxr_linenumber" name="614" href="#614">614</a>         }
-<a class="jxr_linenumber" name="615" href="#615">615</a>         viaHeaders.put(pv, value);
-<a class="jxr_linenumber" name="616" href="#616">616</a> 
-<a class="jxr_linenumber" name="617" href="#617">617</a>         <strong class="jxr_keyword">return</strong> value;
-<a class="jxr_linenumber" name="618" href="#618">618</a>     }
-<a class="jxr_linenumber" name="619" href="#619">619</a> 
-<a class="jxr_linenumber" name="620" href="#620">620</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">void</strong> setResponseStatus(<strong class="jxr_keyword">final</strong> HttpCacheContext clientContext, <strong class="jxr_keyword">final</strong> CacheResponseStatus value) {
-<a class="jxr_linenumber" name="621" href="#621">621</a>         <strong class="jxr_keyword">if</strong> (clientContext != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="622" href="#622">622</a>             clientContext.setAttribute(HttpCacheContext.CACHE_RESPONSE_STATUS, value);
-<a class="jxr_linenumber" name="623" href="#623">623</a>         }
-<a class="jxr_linenumber" name="624" href="#624">624</a>     }
-<a class="jxr_linenumber" name="625" href="#625">625</a> 
-<a class="jxr_linenumber" name="626" href="#626">626</a>     <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="627" href="#627">627</a> <em class="jxr_javadoccomment">     * Reports whether this {@code CachingHttpClient} implementation</em>
-<a class="jxr_linenumber" name="628" href="#628">628</a> <em class="jxr_javadoccomment">     * supports byte-range requests as specified by the {@code Range}</em>
-<a class="jxr_linenumber" name="629" href="#629">629</a> <em class="jxr_javadoccomment">     * and {@code Content-Range} headers.</em>
-<a class="jxr_linenumber" name="630" href="#630">630</a> <em class="jxr_javadoccomment">     * @return {@code true} if byte-range requests are supported</em>
-<a class="jxr_linenumber" name="631" href="#631">631</a> <em class="jxr_javadoccomment">     */</em>
-<a class="jxr_linenumber" name="632" href="#632">632</a>     <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">boolean</strong> supportsRangeAndContentRangeHeaders() {
-<a class="jxr_linenumber" name="633" href="#633">633</a>         <strong class="jxr_keyword">return</strong> SUPPORTS_RANGE_AND_CONTENT_RANGE_HEADERS;
-<a class="jxr_linenumber" name="634" href="#634">634</a>     }
-<a class="jxr_linenumber" name="635" href="#635">635</a> 
-<a class="jxr_linenumber" name="636" href="#636">636</a>     <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="637" href="#637">637</a> <em class="jxr_javadoccomment">     * Reports whether this {@code CachingHttpClient} is configured as</em>
-<a class="jxr_linenumber" name="638" href="#638">638</a> <em class="jxr_javadoccomment">     * a shared (public) or non-shared (private) cache. See {@link</em>
-<a class="jxr_linenumber" name="639" href="#639">639</a> <em class="jxr_javadoccomment">     * CacheConfig#setSharedCache(boolean)}.</em>
-<a class="jxr_linenumber" name="640" href="#640">640</a> <em class="jxr_javadoccomment">     * @return {@code true} if we are behaving as a shared (public)</em>
-<a class="jxr_linenumber" name="641" href="#641">641</a> <em class="jxr_javadoccomment">     *   cache</em>
-<a class="jxr_linenumber" name="642" href="#642">642</a> <em class="jxr_javadoccomment">     */</em>
-<a class="jxr_linenumber" name="643" href="#643">643</a>     <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">boolean</strong> isSharedCache() {
-<a class="jxr_linenumber" name="644" href="#644">644</a>         <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">this</strong>.sharedCache;
-<a class="jxr_linenumber" name="645" href="#645">645</a>     }
-<a class="jxr_linenumber" name="646" href="#646">646</a> 
-<a class="jxr_linenumber" name="647" href="#647">647</a>     Date getCurrentDate() {
-<a class="jxr_linenumber" name="648" href="#648">648</a>         <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> Date();
-<a class="jxr_linenumber" name="649" href="#649">649</a>     }
-<a class="jxr_linenumber" name="650" href="#650">650</a> 
-<a class="jxr_linenumber" name="651" href="#651">651</a>     <strong class="jxr_keyword">boolean</strong> clientRequestsOurOptions(<strong class="jxr_keyword">final</strong> HttpRequest request) {
-<a class="jxr_linenumber" name="652" href="#652">652</a>         <strong class="jxr_keyword">final</strong> RequestLine line = request.getRequestLine();
-<a class="jxr_linenumber" name="653" href="#653">653</a> 
-<a class="jxr_linenumber" name="654" href="#654">654</a>         <strong class="jxr_keyword">if</strong> (!HeaderConstants.OPTIONS_METHOD.equals(line.getMethod())) {
-<a class="jxr_linenumber" name="655" href="#655">655</a>             <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="656" href="#656">656</a>         }
-<a class="jxr_linenumber" name="657" href="#657">657</a> 
-<a class="jxr_linenumber" name="658" href="#658">658</a>         <strong class="jxr_keyword">if</strong> (!<span class="jxr_string">"*"</span>.equals(line.getUri())) {
-<a class="jxr_linenumber" name="659" href="#659">659</a>             <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="660" href="#660">660</a>         }
-<a class="jxr_linenumber" name="661" href="#661">661</a>         <strong class="jxr_keyword">return</strong> <span class="jxr_string">"0"</span>.equals(request.getFirstHeader(HeaderConstants.MAX_FORWARDS).getValue());
-<a class="jxr_linenumber" name="662" href="#662">662</a>     }
-<a class="jxr_linenumber" name="663" href="#663">663</a> 
-<a class="jxr_linenumber" name="664" href="#664">664</a>     <strong class="jxr_keyword">void</strong> callBackend(
-<a class="jxr_linenumber" name="665" href="#665">665</a>             <strong class="jxr_keyword">final</strong> BasicFuture&lt;HttpResponse&gt; future,
-<a class="jxr_linenumber" name="666" href="#666">666</a>             <strong class="jxr_keyword">final</strong> HttpHost target,
-<a class="jxr_linenumber" name="667" href="#667">667</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper request,
-<a class="jxr_linenumber" name="668" href="#668">668</a>             <strong class="jxr_keyword">final</strong> HttpCacheContext clientContext) {
-<a class="jxr_linenumber" name="669" href="#669">669</a>         <strong class="jxr_keyword">final</strong> Date requestDate = getCurrentDate();
-<a class="jxr_linenumber" name="670" href="#670">670</a>         <strong class="jxr_keyword">this</strong>.log.trace(<span class="jxr_string">"Calling the backend"</span>);
-<a class="jxr_linenumber" name="671" href="#671">671</a> 
-<a class="jxr_linenumber" name="672" href="#672">672</a>         <strong class="jxr_keyword">final</strong> ChainedFutureCallback&lt;HttpResponse&gt; chainedFutureCallback = <strong class="jxr_keyword">new</strong> ChainedFutureCallback&lt;HttpResponse&gt;(future) {
-<a class="jxr_linenumber" name="673" href="#673">673</a> 
-<a class="jxr_linenumber" name="674" href="#674">674</a>             @Override
-<a class="jxr_linenumber" name="675" href="#675">675</a>             <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">void</strong> completed(<strong class="jxr_keyword">final</strong> HttpResponse httpResponse) {
-<a class="jxr_linenumber" name="676" href="#676">676</a>                 httpResponse.addHeader(HeaderConstants.VIA, generateViaHeader(httpResponse));
-<a class="jxr_linenumber" name="677" href="#677">677</a>                 <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="678" href="#678">678</a>                     <strong class="jxr_keyword">final</strong> CloseableHttpResponse backendResponse = handleBackendResponse(
-<a class="jxr_linenumber" name="679" href="#679">679</a>                             target, request, requestDate, getCurrentDate(),
-<a class="jxr_linenumber" name="680" href="#680">680</a>                             Proxies.enhanceResponse(httpResponse));
-<a class="jxr_linenumber" name="681" href="#681">681</a>                     <strong class="jxr_keyword">super</strong>.completed(backendResponse);
-<a class="jxr_linenumber" name="682" href="#682">682</a>                 } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> IOException e) {
-<a class="jxr_linenumber" name="683" href="#683">683</a>                     <strong class="jxr_keyword">super</strong>.failed(e);
-<a class="jxr_linenumber" name="684" href="#684">684</a>                 }
-<a class="jxr_linenumber" name="685" href="#685">685</a> 
-<a class="jxr_linenumber" name="686" href="#686">686</a>             }
-<a class="jxr_linenumber" name="687" href="#687">687</a> 
-<a class="jxr_linenumber" name="688" href="#688">688</a>         };
-<a class="jxr_linenumber" name="689" href="#689">689</a>         <strong class="jxr_keyword">this</strong>.backend.execute(target, request, clientContext, chainedFutureCallback);
-<a class="jxr_linenumber" name="690" href="#690">690</a>     }
-<a class="jxr_linenumber" name="691" href="#691">691</a> 
-<a class="jxr_linenumber" name="692" href="#692">692</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> revalidationResponseIsTooOld(
-<a class="jxr_linenumber" name="693" href="#693">693</a>             <strong class="jxr_keyword">final</strong> HttpResponse backendResponse,
-<a class="jxr_linenumber" name="694" href="#694">694</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry cacheEntry) {
-<a class="jxr_linenumber" name="695" href="#695">695</a>         <strong class="jxr_keyword">final</strong> Header entryDateHeader = cacheEntry.getFirstHeader(HTTP.DATE_HEADER);
-<a class="jxr_linenumber" name="696" href="#696">696</a>         <strong class="jxr_keyword">final</strong> Header responseDateHeader = backendResponse.getFirstHeader(HTTP.DATE_HEADER);
-<a class="jxr_linenumber" name="697" href="#697">697</a>         <strong class="jxr_keyword">if</strong> (entryDateHeader != <strong class="jxr_keyword">null</strong> &amp;&amp; responseDateHeader != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="698" href="#698">698</a>             <strong class="jxr_keyword">final</strong> Date entryDate = DateUtils.parseDate(entryDateHeader.getValue());
-<a class="jxr_linenumber" name="699" href="#699">699</a>             <strong class="jxr_keyword">final</strong> Date respDate = DateUtils.parseDate(responseDateHeader.getValue());
-<a class="jxr_linenumber" name="700" href="#700">700</a>             <strong class="jxr_keyword">if</strong> (respDate != <strong class="jxr_keyword">null</strong> &amp;&amp; respDate.before(entryDate)) {
-<a class="jxr_linenumber" name="701" href="#701">701</a>                 <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="702" href="#702">702</a>             }
-<a class="jxr_linenumber" name="703" href="#703">703</a>         }
-<a class="jxr_linenumber" name="704" href="#704">704</a>         <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="705" href="#705">705</a>     }
-<a class="jxr_linenumber" name="706" href="#706">706</a> 
-<a class="jxr_linenumber" name="707" href="#707">707</a>     <strong class="jxr_keyword">void</strong> negotiateResponseFromVariants(
-<a class="jxr_linenumber" name="708" href="#708">708</a>             <strong class="jxr_keyword">final</strong> BasicFuture&lt;HttpResponse&gt; future,
-<a class="jxr_linenumber" name="709" href="#709">709</a>             <strong class="jxr_keyword">final</strong> HttpHost target,
-<a class="jxr_linenumber" name="710" href="#710">710</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper request,
-<a class="jxr_linenumber" name="711" href="#711">711</a>             <strong class="jxr_keyword">final</strong> HttpCacheContext clientContext,
-<a class="jxr_linenumber" name="712" href="#712">712</a>             <strong class="jxr_keyword">final</strong> Map&lt;String, Variant&gt; variants) {
-<a class="jxr_linenumber" name="713" href="#713">713</a>         <strong class="jxr_keyword">final</strong> HttpRequest conditionalRequest = <strong class="jxr_keyword">this</strong>.conditionalRequestBuilder.buildConditionalRequestFromVariants(request, variants);
-<a class="jxr_linenumber" name="714" href="#714">714</a> 
-<a class="jxr_linenumber" name="715" href="#715">715</a>         <strong class="jxr_keyword">final</strong> Date requestDate = getCurrentDate();
-<a class="jxr_linenumber" name="716" href="#716">716</a> 
-<a class="jxr_linenumber" name="717" href="#717">717</a>         <strong class="jxr_keyword">final</strong> ChainedFutureCallback&lt;HttpResponse&gt; chainedFutureCallback = <strong class="jxr_keyword">new</strong> ChainedFutureCallback&lt;HttpResponse&gt;(future) {
-<a class="jxr_linenumber" name="718" href="#718">718</a> 
-<a class="jxr_linenumber" name="719" href="#719">719</a>             @Override
-<a class="jxr_linenumber" name="720" href="#720">720</a>             <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">void</strong> completed(<strong class="jxr_keyword">final</strong> HttpResponse httpResponse) {
-<a class="jxr_linenumber" name="721" href="#721">721</a>                 <strong class="jxr_keyword">final</strong> Date responseDate = getCurrentDate();
-<a class="jxr_linenumber" name="722" href="#722">722</a> 
-<a class="jxr_linenumber" name="723" href="#723">723</a>                 httpResponse.addHeader(HeaderConstants.VIA, generateViaHeader(httpResponse));
-<a class="jxr_linenumber" name="724" href="#724">724</a> 
-<a class="jxr_linenumber" name="725" href="#725">725</a>                 <strong class="jxr_keyword">if</strong> (httpResponse.getStatusLine().getStatusCode() != HttpStatus.SC_NOT_MODIFIED) {
-<a class="jxr_linenumber" name="726" href="#726">726</a>                     <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="727" href="#727">727</a>                         future.completed(handleBackendResponse(
-<a class="jxr_linenumber" name="728" href="#728">728</a>                                 target, request, requestDate, responseDate,
-<a class="jxr_linenumber" name="729" href="#729">729</a>                                 Proxies.enhanceResponse(httpResponse)));
-<a class="jxr_linenumber" name="730" href="#730">730</a>                         <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="731" href="#731">731</a>                     } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> IOException e) {
-<a class="jxr_linenumber" name="732" href="#732">732</a>                         future.failed(e);
-<a class="jxr_linenumber" name="733" href="#733">733</a>                         <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="734" href="#734">734</a>                     }
-<a class="jxr_linenumber" name="735" href="#735">735</a>                 }
-<a class="jxr_linenumber" name="736" href="#736">736</a> 
-<a class="jxr_linenumber" name="737" href="#737">737</a>                 <strong class="jxr_keyword">final</strong> Header resultEtagHeader = httpResponse.getFirstHeader(HeaderConstants.ETAG);
-<a class="jxr_linenumber" name="738" href="#738">738</a>                 <strong class="jxr_keyword">if</strong> (resultEtagHeader == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="739" href="#739">739</a>                     CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.log.warn(<span class="jxr_string">"304 response did not contain ETag"</span>);
-<a class="jxr_linenumber" name="740" href="#740">740</a>                     callBackend(future, target, request, clientContext);
-<a class="jxr_linenumber" name="741" href="#741">741</a>                     <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="742" href="#742">742</a>                 }
-<a class="jxr_linenumber" name="743" href="#743">743</a> 
-<a class="jxr_linenumber" name="744" href="#744">744</a>                 <strong class="jxr_keyword">final</strong> String resultEtag = resultEtagHeader.getValue();
-<a class="jxr_linenumber" name="745" href="#745">745</a>                 <strong class="jxr_keyword">final</strong> Variant matchingVariant = variants.get(resultEtag);
-<a class="jxr_linenumber" name="746" href="#746">746</a>                 <strong class="jxr_keyword">if</strong> (matchingVariant == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="747" href="#747">747</a>                     CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.log.debug(<span class="jxr_string">"304 response did not contain ETag matching one sent in If-None-Match"</span>);
-<a class="jxr_linenumber" name="748" href="#748">748</a>                     callBackend(future, target, request, clientContext);
-<a class="jxr_linenumber" name="749" href="#749">749</a>                 }
-<a class="jxr_linenumber" name="750" href="#750">750</a> 
-<a class="jxr_linenumber" name="751" href="#751">751</a>                 <strong class="jxr_keyword">final</strong> HttpCacheEntry matchedEntry = matchingVariant.getEntry();
-<a class="jxr_linenumber" name="752" href="#752">752</a> 
-<a class="jxr_linenumber" name="753" href="#753">753</a>                 <strong class="jxr_keyword">if</strong> (revalidationResponseIsTooOld(httpResponse, matchedEntry)) {
-<a class="jxr_linenumber" name="754" href="#754">754</a>                     EntityUtils.consumeQuietly(httpResponse.getEntity());
-<a class="jxr_linenumber" name="755" href="#755">755</a>                     retryRequestUnconditionally(future, target, request, clientContext, matchedEntry);
-<a class="jxr_linenumber" name="756" href="#756">756</a>                     <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="757" href="#757">757</a>                 }
-<a class="jxr_linenumber" name="758" href="#758">758</a> 
-<a class="jxr_linenumber" name="759" href="#759">759</a>                 recordCacheUpdate(clientContext);
-<a class="jxr_linenumber" name="760" href="#760">760</a> 
-<a class="jxr_linenumber" name="761" href="#761">761</a>                 <strong class="jxr_keyword">final</strong> HttpCacheEntry responseEntry = getUpdatedVariantEntry(target,
-<a class="jxr_linenumber" name="762" href="#762">762</a>                         conditionalRequest, requestDate, responseDate, httpResponse,
-<a class="jxr_linenumber" name="763" href="#763">763</a>                         matchingVariant, matchedEntry);
-<a class="jxr_linenumber" name="764" href="#764">764</a> 
-<a class="jxr_linenumber" name="765" href="#765">765</a>                 <strong class="jxr_keyword">final</strong> HttpResponse resp = CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.responseGenerator.generateResponse(responseEntry);
-<a class="jxr_linenumber" name="766" href="#766">766</a>                 tryToUpdateVariantMap(target, request, matchingVariant);
-<a class="jxr_linenumber" name="767" href="#767">767</a> 
-<a class="jxr_linenumber" name="768" href="#768">768</a>                 <strong class="jxr_keyword">if</strong> (shouldSendNotModifiedResponse(request, responseEntry)) {
-<a class="jxr_linenumber" name="769" href="#769">769</a>                     future.completed(CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.responseGenerator.generateNotModifiedResponse(responseEntry));
-<a class="jxr_linenumber" name="770" href="#770">770</a>                     <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="771" href="#771">771</a>                 }
-<a class="jxr_linenumber" name="772" href="#772">772</a> 
-<a class="jxr_linenumber" name="773" href="#773">773</a>                 future.completed(resp);
-<a class="jxr_linenumber" name="774" href="#774">774</a>             }
-<a class="jxr_linenumber" name="775" href="#775">775</a> 
-<a class="jxr_linenumber" name="776" href="#776">776</a>         };
-<a class="jxr_linenumber" name="777" href="#777">777</a> 
-<a class="jxr_linenumber" name="778" href="#778">778</a>         <strong class="jxr_keyword">this</strong>.backend.execute(target, conditionalRequest, clientContext, chainedFutureCallback);
-<a class="jxr_linenumber" name="779" href="#779">779</a>     }
-<a class="jxr_linenumber" name="780" href="#780">780</a> 
-<a class="jxr_linenumber" name="781" href="#781">781</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">void</strong> retryRequestUnconditionally(
-<a class="jxr_linenumber" name="782" href="#782">782</a>             <strong class="jxr_keyword">final</strong> BasicFuture&lt;HttpResponse&gt; future,
-<a class="jxr_linenumber" name="783" href="#783">783</a>             <strong class="jxr_keyword">final</strong> HttpHost target,
-<a class="jxr_linenumber" name="784" href="#784">784</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper request,
-<a class="jxr_linenumber" name="785" href="#785">785</a>             <strong class="jxr_keyword">final</strong> HttpCacheContext clientContext,
-<a class="jxr_linenumber" name="786" href="#786">786</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry matchedEntry) {
-<a class="jxr_linenumber" name="787" href="#787">787</a>         <strong class="jxr_keyword">final</strong> HttpRequestWrapper unconditional = <strong class="jxr_keyword">this</strong>.conditionalRequestBuilder
-<a class="jxr_linenumber" name="788" href="#788">788</a>             .buildUnconditionalRequest(request, matchedEntry);
-<a class="jxr_linenumber" name="789" href="#789">789</a>         callBackend(future, target, unconditional, clientContext);
-<a class="jxr_linenumber" name="790" href="#790">790</a>     }
-<a class="jxr_linenumber" name="791" href="#791">791</a> 
-<a class="jxr_linenumber" name="792" href="#792">792</a>     <strong class="jxr_keyword">private</strong> HttpCacheEntry getUpdatedVariantEntry(
-<a class="jxr_linenumber" name="793" href="#793">793</a>             <strong class="jxr_keyword">final</strong> HttpHost target,
-<a class="jxr_linenumber" name="794" href="#794">794</a>             <strong class="jxr_keyword">final</strong> HttpRequest conditionalRequest,
-<a class="jxr_linenumber" name="795" href="#795">795</a>             <strong class="jxr_keyword">final</strong> Date requestDate,
-<a class="jxr_linenumber" name="796" href="#796">796</a>             <strong class="jxr_keyword">final</strong> Date responseDate,
-<a class="jxr_linenumber" name="797" href="#797">797</a>             <strong class="jxr_keyword">final</strong> HttpResponse backendResponse,
-<a class="jxr_linenumber" name="798" href="#798">798</a>             <strong class="jxr_keyword">final</strong> Variant matchingVariant,
-<a class="jxr_linenumber" name="799" href="#799">799</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry matchedEntry) {
-<a class="jxr_linenumber" name="800" href="#800">800</a>         HttpCacheEntry responseEntry = matchedEntry;
-<a class="jxr_linenumber" name="801" href="#801">801</a>         <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="802" href="#802">802</a>             responseEntry = <strong class="jxr_keyword">this</strong>.responseCache.updateVariantCacheEntry(target, conditionalRequest,
-<a class="jxr_linenumber" name="803" href="#803">803</a>                     matchedEntry, backendResponse, requestDate, responseDate, matchingVariant.getCacheKey());
-<a class="jxr_linenumber" name="804" href="#804">804</a>         } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> IOException ioe) {
-<a class="jxr_linenumber" name="805" href="#805">805</a>             <strong class="jxr_keyword">this</strong>.log.warn(<span class="jxr_string">"Could not update cache entry"</span>, ioe);
-<a class="jxr_linenumber" name="806" href="#806">806</a>         }
-<a class="jxr_linenumber" name="807" href="#807">807</a>         <strong class="jxr_keyword">return</strong> responseEntry;
-<a class="jxr_linenumber" name="808" href="#808">808</a>     }
-<a class="jxr_linenumber" name="809" href="#809">809</a> 
-<a class="jxr_linenumber" name="810" href="#810">810</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">void</strong> tryToUpdateVariantMap(
-<a class="jxr_linenumber" name="811" href="#811">811</a>             <strong class="jxr_keyword">final</strong> HttpHost target,
-<a class="jxr_linenumber" name="812" href="#812">812</a>             <strong class="jxr_keyword">final</strong> HttpRequest request,
-<a class="jxr_linenumber" name="813" href="#813">813</a>             <strong class="jxr_keyword">final</strong> Variant matchingVariant) {
-<a class="jxr_linenumber" name="814" href="#814">814</a>         <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="815" href="#815">815</a>             <strong class="jxr_keyword">this</strong>.responseCache.reuseVariantEntryFor(target, request, matchingVariant);
-<a class="jxr_linenumber" name="816" href="#816">816</a>         } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> IOException ioe) {
-<a class="jxr_linenumber" name="817" href="#817">817</a>             <strong class="jxr_keyword">this</strong>.log.warn(<span class="jxr_string">"Could not update cache entry to reuse variant"</span>, ioe);
-<a class="jxr_linenumber" name="818" href="#818">818</a>         }
-<a class="jxr_linenumber" name="819" href="#819">819</a>     }
-<a class="jxr_linenumber" name="820" href="#820">820</a> 
-<a class="jxr_linenumber" name="821" href="#821">821</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> shouldSendNotModifiedResponse(
-<a class="jxr_linenumber" name="822" href="#822">822</a>             <strong class="jxr_keyword">final</strong> HttpRequest request,
-<a class="jxr_linenumber" name="823" href="#823">823</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry responseEntry) {
-<a class="jxr_linenumber" name="824" href="#824">824</a>         <strong class="jxr_keyword">return</strong> (<strong class="jxr_keyword">this</strong>.suitabilityChecker.isConditional(request)
-<a class="jxr_linenumber" name="825" href="#825">825</a>                 &amp;&amp; <strong class="jxr_keyword">this</strong>.suitabilityChecker.allConditionalsMatch(request, responseEntry, <strong class="jxr_keyword">new</strong> Date()));
-<a class="jxr_linenumber" name="826" href="#826">826</a>     }
-<a class="jxr_linenumber" name="827" href="#827">827</a> 
-<a class="jxr_linenumber" name="828" href="#828">828</a>     <strong class="jxr_keyword">void</strong> revalidateCacheEntry(
-<a class="jxr_linenumber" name="829" href="#829">829</a>             <strong class="jxr_keyword">final</strong> BasicFuture&lt;HttpResponse&gt; future,
-<a class="jxr_linenumber" name="830" href="#830">830</a>             <strong class="jxr_keyword">final</strong> HttpHost target,
-<a class="jxr_linenumber" name="831" href="#831">831</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper request,
-<a class="jxr_linenumber" name="832" href="#832">832</a>             <strong class="jxr_keyword">final</strong> HttpCacheContext clientContext,
-<a class="jxr_linenumber" name="833" href="#833">833</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry cacheEntry) <strong class="jxr_keyword">throws</strong> ProtocolException {
-<a class="jxr_linenumber" name="834" href="#834">834</a> 
-<a class="jxr_linenumber" name="835" href="#835">835</a>         <strong class="jxr_keyword">final</strong> HttpRequestWrapper conditionalRequest = <strong class="jxr_keyword">this</strong>.conditionalRequestBuilder.buildConditionalRequest(request, cacheEntry);
-<a class="jxr_linenumber" name="836" href="#836">836</a>         <strong class="jxr_keyword">final</strong> Date requestDate = getCurrentDate();
-<a class="jxr_linenumber" name="837" href="#837">837</a> 
-<a class="jxr_linenumber" name="838" href="#838">838</a>         <strong class="jxr_keyword">final</strong> ChainedFutureCallback&lt;HttpResponse&gt; chainedFutureCallback = <strong class="jxr_keyword">new</strong> ChainedFutureCallback&lt;HttpResponse&gt;(future) {
-<a class="jxr_linenumber" name="839" href="#839">839</a> 
-<a class="jxr_linenumber" name="840" href="#840">840</a>             @Override
-<a class="jxr_linenumber" name="841" href="#841">841</a>             <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">void</strong> completed(<strong class="jxr_keyword">final</strong> HttpResponse httpResponse) {
-<a class="jxr_linenumber" name="842" href="#842">842</a>                 <strong class="jxr_keyword">final</strong> Date responseDate = getCurrentDate();
-<a class="jxr_linenumber" name="843" href="#843">843</a> 
-<a class="jxr_linenumber" name="844" href="#844">844</a>                 <strong class="jxr_keyword">if</strong> (revalidationResponseIsTooOld(httpResponse, cacheEntry)) {
-<a class="jxr_linenumber" name="845" href="#845">845</a>                     <strong class="jxr_keyword">final</strong> HttpRequest unconditional = CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.conditionalRequestBuilder.buildUnconditionalRequest(request, cacheEntry);
-<a class="jxr_linenumber" name="846" href="#846">846</a>                     <strong class="jxr_keyword">final</strong> Date innerRequestDate = getCurrentDate();
-<a class="jxr_linenumber" name="847" href="#847">847</a> 
-<a class="jxr_linenumber" name="848" href="#848">848</a>                     <strong class="jxr_keyword">final</strong> ChainedFutureCallback&lt;HttpResponse&gt; chainedFutureCallback2 = <strong class="jxr_keyword">new</strong> ChainedFutureCallback&lt;HttpResponse&gt;(future) {
-<a class="jxr_linenumber" name="849" href="#849">849</a> 
-<a class="jxr_linenumber" name="850" href="#850">850</a>                         @Override
-<a class="jxr_linenumber" name="851" href="#851">851</a>                         <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">void</strong> completed(<strong class="jxr_keyword">final</strong> HttpResponse innerHttpResponse) {
-<a class="jxr_linenumber" name="852" href="#852">852</a>                             <strong class="jxr_keyword">final</strong> Date innerResponseDate = getCurrentDate();
-<a class="jxr_linenumber" name="853" href="#853">853</a>                             revalidateCacheEntryCompleted(future,
-<a class="jxr_linenumber" name="854" href="#854">854</a>                                     target, request, clientContext, cacheEntry,
-<a class="jxr_linenumber" name="855" href="#855">855</a>                                     conditionalRequest, innerRequestDate,
-<a class="jxr_linenumber" name="856" href="#856">856</a>                                     innerHttpResponse, innerResponseDate);
-<a class="jxr_linenumber" name="857" href="#857">857</a>                         }
-<a class="jxr_linenumber" name="858" href="#858">858</a> 
-<a class="jxr_linenumber" name="859" href="#859">859</a>                     };
-<a class="jxr_linenumber" name="860" href="#860">860</a>                     CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.backend.execute(
-<a class="jxr_linenumber" name="861" href="#861">861</a>                             target, unconditional, clientContext, chainedFutureCallback2);
-<a class="jxr_linenumber" name="862" href="#862">862</a>                 }
-<a class="jxr_linenumber" name="863" href="#863">863</a> 
-<a class="jxr_linenumber" name="864" href="#864">864</a>                 revalidateCacheEntryCompleted(future,
-<a class="jxr_linenumber" name="865" href="#865">865</a>                         target, request, clientContext, cacheEntry,
-<a class="jxr_linenumber" name="866" href="#866">866</a>                         conditionalRequest, requestDate,
-<a class="jxr_linenumber" name="867" href="#867">867</a>                         httpResponse, responseDate);
-<a class="jxr_linenumber" name="868" href="#868">868</a>             }
-<a class="jxr_linenumber" name="869" href="#869">869</a> 
-<a class="jxr_linenumber" name="870" href="#870">870</a>         };
-<a class="jxr_linenumber" name="871" href="#871">871</a> 
-<a class="jxr_linenumber" name="872" href="#872">872</a>         <strong class="jxr_keyword">this</strong>.backend.execute(target, conditionalRequest, clientContext, chainedFutureCallback);
-<a class="jxr_linenumber" name="873" href="#873">873</a>     }
-<a class="jxr_linenumber" name="874" href="#874">874</a> 
-<a class="jxr_linenumber" name="875" href="#875">875</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">void</strong> revalidateCacheEntryCompleted(
-<a class="jxr_linenumber" name="876" href="#876">876</a>             <strong class="jxr_keyword">final</strong> BasicFuture&lt;HttpResponse&gt; future,
-<a class="jxr_linenumber" name="877" href="#877">877</a>             <strong class="jxr_keyword">final</strong> HttpHost target,
-<a class="jxr_linenumber" name="878" href="#878">878</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper request,
-<a class="jxr_linenumber" name="879" href="#879">879</a>             <strong class="jxr_keyword">final</strong> HttpCacheContext clientContext,
-<a class="jxr_linenumber" name="880" href="#880">880</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry cacheEntry,
-<a class="jxr_linenumber" name="881" href="#881">881</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper conditionalRequest,
-<a class="jxr_linenumber" name="882" href="#882">882</a>             <strong class="jxr_keyword">final</strong> Date requestDate,
-<a class="jxr_linenumber" name="883" href="#883">883</a>             <strong class="jxr_keyword">final</strong> HttpResponse httpResponse,
-<a class="jxr_linenumber" name="884" href="#884">884</a>             <strong class="jxr_keyword">final</strong> Date responseDate) {
-<a class="jxr_linenumber" name="885" href="#885">885</a> 
-<a class="jxr_linenumber" name="886" href="#886">886</a>         httpResponse.addHeader(HeaderConstants.VIA, generateViaHeader(httpResponse));
-<a class="jxr_linenumber" name="887" href="#887">887</a> 
-<a class="jxr_linenumber" name="888" href="#888">888</a>         <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> statusCode = httpResponse.getStatusLine().getStatusCode();
-<a class="jxr_linenumber" name="889" href="#889">889</a>         <strong class="jxr_keyword">if</strong> (statusCode == HttpStatus.SC_NOT_MODIFIED || statusCode == HttpStatus.SC_OK) {
-<a class="jxr_linenumber" name="890" href="#890">890</a>             recordCacheUpdate(clientContext);
-<a class="jxr_linenumber" name="891" href="#891">891</a>         }
-<a class="jxr_linenumber" name="892" href="#892">892</a> 
-<a class="jxr_linenumber" name="893" href="#893">893</a>         <strong class="jxr_keyword">if</strong> (statusCode == HttpStatus.SC_NOT_MODIFIED) {
-<a class="jxr_linenumber" name="894" href="#894">894</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry updatedEntry;
-<a class="jxr_linenumber" name="895" href="#895">895</a>             <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="896" href="#896">896</a>                 updatedEntry = CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.responseCache.updateCacheEntry(target, request, cacheEntry,
-<a class="jxr_linenumber" name="897" href="#897">897</a>                         httpResponse, requestDate, responseDate);
-<a class="jxr_linenumber" name="898" href="#898">898</a>             } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> IOException e) {
-<a class="jxr_linenumber" name="899" href="#899">899</a>                 future.failed(e);
-<a class="jxr_linenumber" name="900" href="#900">900</a>                 <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="901" href="#901">901</a>             }
-<a class="jxr_linenumber" name="902" href="#902">902</a>             <strong class="jxr_keyword">if</strong> (CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.suitabilityChecker.isConditional(request)
-<a class="jxr_linenumber" name="903" href="#903">903</a>                     &amp;&amp; CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.suitabilityChecker.allConditionalsMatch(request, updatedEntry, <strong class="jxr_keyword">new</strong> Date())) {
-<a class="jxr_linenumber" name="904" href="#904">904</a>                 future.completed(CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.responseGenerator.generateNotModifiedResponse(updatedEntry));
-<a class="jxr_linenumber" name="905" href="#905">905</a>                 <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="906" href="#906">906</a>             }
-<a class="jxr_linenumber" name="907" href="#907">907</a>             future.completed(CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.responseGenerator.generateResponse(updatedEntry));
-<a class="jxr_linenumber" name="908" href="#908">908</a>             <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="909" href="#909">909</a>         }
-<a class="jxr_linenumber" name="910" href="#910">910</a> 
-<a class="jxr_linenumber" name="911" href="#911">911</a>         <strong class="jxr_keyword">if</strong> (staleIfErrorAppliesTo(statusCode)
-<a class="jxr_linenumber" name="912" href="#912">912</a>             &amp;&amp; !staleResponseNotAllowed(request, cacheEntry, getCurrentDate())
-<a class="jxr_linenumber" name="913" href="#913">913</a>             &amp;&amp; CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.validityPolicy.mayReturnStaleIfError(request, cacheEntry, responseDate)) {
-<a class="jxr_linenumber" name="914" href="#914">914</a>             <strong class="jxr_keyword">final</strong> HttpResponse cachedResponse = CachingHttpAsyncClient.<strong class="jxr_keyword">this</strong>.responseGenerator.generateResponse(cacheEntry);
-<a class="jxr_linenumber" name="915" href="#915">915</a>             cachedResponse.addHeader(HeaderConstants.WARNING, <span class="jxr_string">"110 localhost \&quot;Response is stale\&quot;"</span>);
-<a class="jxr_linenumber" name="916" href="#916">916</a>             future.completed(cachedResponse);
-<a class="jxr_linenumber" name="917" href="#917">917</a>             <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="918" href="#918">918</a>         }
-<a class="jxr_linenumber" name="919" href="#919">919</a> 
-<a class="jxr_linenumber" name="920" href="#920">920</a>         <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="921" href="#921">921</a>             <strong class="jxr_keyword">final</strong> CloseableHttpResponse backendResponse = handleBackendResponse(
-<a class="jxr_linenumber" name="922" href="#922">922</a>                     target, conditionalRequest, requestDate, responseDate,
-<a class="jxr_linenumber" name="923" href="#923">923</a>                     Proxies.enhanceResponse(httpResponse));
-<a class="jxr_linenumber" name="924" href="#924">924</a>             future.completed(backendResponse);
-<a class="jxr_linenumber" name="925" href="#925">925</a>         } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> IOException e) {
-<a class="jxr_linenumber" name="926" href="#926">926</a>             future.failed(e);
-<a class="jxr_linenumber" name="927" href="#927">927</a>         }
-<a class="jxr_linenumber" name="928" href="#928">928</a>     }
-<a class="jxr_linenumber" name="929" href="#929">929</a> 
-<a class="jxr_linenumber" name="930" href="#930">930</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> staleIfErrorAppliesTo(<strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> statusCode) {
-<a class="jxr_linenumber" name="931" href="#931">931</a>         <strong class="jxr_keyword">return</strong> statusCode == HttpStatus.SC_INTERNAL_SERVER_ERROR
-<a class="jxr_linenumber" name="932" href="#932">932</a>                 || statusCode == HttpStatus.SC_BAD_GATEWAY
-<a class="jxr_linenumber" name="933" href="#933">933</a>                 || statusCode == HttpStatus.SC_SERVICE_UNAVAILABLE
-<a class="jxr_linenumber" name="934" href="#934">934</a>                 || statusCode == HttpStatus.SC_GATEWAY_TIMEOUT;
-<a class="jxr_linenumber" name="935" href="#935">935</a>     }
-<a class="jxr_linenumber" name="936" href="#936">936</a> 
-<a class="jxr_linenumber" name="937" href="#937">937</a>     CloseableHttpResponse handleBackendResponse(
-<a class="jxr_linenumber" name="938" href="#938">938</a>             <strong class="jxr_keyword">final</strong> HttpHost target,
-<a class="jxr_linenumber" name="939" href="#939">939</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper request,
-<a class="jxr_linenumber" name="940" href="#940">940</a>             <strong class="jxr_keyword">final</strong> Date requestDate,
-<a class="jxr_linenumber" name="941" href="#941">941</a>             <strong class="jxr_keyword">final</strong> Date responseDate,
-<a class="jxr_linenumber" name="942" href="#942">942</a>             <strong class="jxr_keyword">final</strong> CloseableHttpResponse backendResponse) <strong class="jxr_keyword">throws</strong> IOException {
-<a class="jxr_linenumber" name="943" href="#943">943</a> 
-<a class="jxr_linenumber" name="944" href="#944">944</a>         <strong class="jxr_keyword">this</strong>.log.debug(<span class="jxr_string">"Handling Backend response"</span>);
-<a class="jxr_linenumber" name="945" href="#945">945</a>         <strong class="jxr_keyword">this</strong>.responseCompliance.ensureProtocolCompliance(request, backendResponse);
-<a class="jxr_linenumber" name="946" href="#946">946</a> 
-<a class="jxr_linenumber" name="947" href="#947">947</a>         <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">boolean</strong> cacheable = <strong class="jxr_keyword">this</strong>.responseCachingPolicy.isResponseCacheable(request, backendResponse);
-<a class="jxr_linenumber" name="948" href="#948">948</a>         <strong class="jxr_keyword">this</strong>.responseCache.flushInvalidatedCacheEntriesFor(target, request, backendResponse);
-<a class="jxr_linenumber" name="949" href="#949">949</a>         <strong class="jxr_keyword">if</strong> (cacheable &amp;&amp;
-<a class="jxr_linenumber" name="950" href="#950">950</a>             !alreadyHaveNewerCacheEntry(target, request, backendResponse)) {
-<a class="jxr_linenumber" name="951" href="#951">951</a>             storeRequestIfModifiedSinceFor304Response(request, backendResponse);
-<a class="jxr_linenumber" name="952" href="#952">952</a>             <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">this</strong>.responseCache.cacheAndReturnResponse(target, request, backendResponse, requestDate,
-<a class="jxr_linenumber" name="953" href="#953">953</a>                     responseDate);
-<a class="jxr_linenumber" name="954" href="#954">954</a>         }
-<a class="jxr_linenumber" name="955" href="#955">955</a>         <strong class="jxr_keyword">if</strong> (!cacheable) {
-<a class="jxr_linenumber" name="956" href="#956">956</a>             <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="957" href="#957">957</a>                 <strong class="jxr_keyword">this</strong>.responseCache.flushCacheEntriesFor(target, request);
-<a class="jxr_linenumber" name="958" href="#958">958</a>             } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> IOException ioe) {
-<a class="jxr_linenumber" name="959" href="#959">959</a>                 <strong class="jxr_keyword">this</strong>.log.warn(<span class="jxr_string">"Unable to flush invalid cache entries"</span>, ioe);
-<a class="jxr_linenumber" name="960" href="#960">960</a>             }
-<a class="jxr_linenumber" name="961" href="#961">961</a>         }
-<a class="jxr_linenumber" name="962" href="#962">962</a>         <strong class="jxr_keyword">return</strong> backendResponse;
-<a class="jxr_linenumber" name="963" href="#963">963</a>     }
-<a class="jxr_linenumber" name="964" href="#964">964</a> 
-<a class="jxr_linenumber" name="965" href="#965">965</a>     <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="966" href="#966">966</a> <em class="jxr_javadoccomment">     * For 304 Not modified responses, adds a "Last-Modified" header with the</em>
-<a class="jxr_linenumber" name="967" href="#967">967</a> <em class="jxr_javadoccomment">     * value of the "If-Modified-Since" header passed in the request. This</em>
-<a class="jxr_linenumber" name="968" href="#968">968</a> <em class="jxr_javadoccomment">     * header is required to be able to reuse match the cache entry for</em>
-<a class="jxr_linenumber" name="969" href="#969">969</a> <em class="jxr_javadoccomment">     * subsequent requests but as defined in http specifications it is not</em>
-<a class="jxr_linenumber" name="970" href="#970">970</a> <em class="jxr_javadoccomment">     * included in 304 responses by backend servers. This header will not be</em>
-<a class="jxr_linenumber" name="971" href="#971">971</a> <em class="jxr_javadoccomment">     * included in the resulting response.</em>
-<a class="jxr_linenumber" name="972" href="#972">972</a> <em class="jxr_javadoccomment">     */</em>
-<a class="jxr_linenumber" name="973" href="#973">973</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">void</strong> storeRequestIfModifiedSinceFor304Response(
-<a class="jxr_linenumber" name="974" href="#974">974</a>             <strong class="jxr_keyword">final</strong> HttpRequest request,
-<a class="jxr_linenumber" name="975" href="#975">975</a>             <strong class="jxr_keyword">final</strong> HttpResponse backendResponse) {
-<a class="jxr_linenumber" name="976" href="#976">976</a>         <strong class="jxr_keyword">if</strong> (backendResponse.getStatusLine().getStatusCode() == HttpStatus.SC_NOT_MODIFIED) {
-<a class="jxr_linenumber" name="977" href="#977">977</a>             <strong class="jxr_keyword">final</strong> Header h = request.getFirstHeader(<span class="jxr_string">"If-Modified-Since"</span>);
-<a class="jxr_linenumber" name="978" href="#978">978</a>             <strong class="jxr_keyword">if</strong> (h != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="979" href="#979">979</a>                 backendResponse.addHeader(<span class="jxr_string">"Last-Modified"</span>, h.getValue());
-<a class="jxr_linenumber" name="980" href="#980">980</a>             }
-<a class="jxr_linenumber" name="981" href="#981">981</a>         }
-<a class="jxr_linenumber" name="982" href="#982">982</a>     }
-<a class="jxr_linenumber" name="983" href="#983">983</a> 
-<a class="jxr_linenumber" name="984" href="#984">984</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> alreadyHaveNewerCacheEntry(
-<a class="jxr_linenumber" name="985" href="#985">985</a>             <strong class="jxr_keyword">final</strong> HttpHost target,
-<a class="jxr_linenumber" name="986" href="#986">986</a>             <strong class="jxr_keyword">final</strong> HttpRequest request,
-<a class="jxr_linenumber" name="987" href="#987">987</a>             <strong class="jxr_keyword">final</strong> HttpResponse backendResponse) {
-<a class="jxr_linenumber" name="988" href="#988">988</a>         HttpCacheEntry existing = <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="989" href="#989">989</a>         <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="990" href="#990">990</a>             existing = <strong class="jxr_keyword">this</strong>.responseCache.getCacheEntry(target, request);
-<a class="jxr_linenumber" name="991" href="#991">991</a>         } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> IOException ioe) {
-<a class="jxr_linenumber" name="992" href="#992">992</a>             <em class="jxr_comment">// nop</em>
-<a class="jxr_linenumber" name="993" href="#993">993</a>         }
-<a class="jxr_linenumber" name="994" href="#994">994</a>         <strong class="jxr_keyword">if</strong> (existing == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="995" href="#995">995</a>             <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="996" href="#996">996</a>         }
-<a class="jxr_linenumber" name="997" href="#997">997</a>         <strong class="jxr_keyword">final</strong> Header entryDateHeader = existing.getFirstHeader(HTTP.DATE_HEADER);
-<a class="jxr_linenumber" name="998" href="#998">998</a>         <strong class="jxr_keyword">if</strong> (entryDateHeader == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="999" href="#999">999</a>             <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="1000" href="#1000">1000</a>         }
-<a class="jxr_linenumber" name="1001" href="#1001">1001</a>         <strong class="jxr_keyword">final</strong> Header responseDateHeader = backendResponse.getFirstHeader(HTTP.DATE_HEADER);
-<a class="jxr_linenumber" name="1002" href="#1002">1002</a>         <strong class="jxr_keyword">if</strong> (responseDateHeader == <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="1003" href="#1003">1003</a>             <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="1004" href="#1004">1004</a>         }
-<a class="jxr_linenumber" name="1005" href="#1005">1005</a>         <strong class="jxr_keyword">final</strong> Date entryDate = DateUtils.parseDate(entryDateHeader.getValue());
-<a class="jxr_linenumber" name="1006" href="#1006">1006</a>         <strong class="jxr_keyword">final</strong> Date responseDate = DateUtils.parseDate(responseDateHeader.getValue());
-<a class="jxr_linenumber" name="1007" href="#1007">1007</a>         <strong class="jxr_keyword">return</strong> responseDate != <strong class="jxr_keyword">null</strong> &amp;&amp; responseDate.before(entryDate);
-<a class="jxr_linenumber" name="1008" href="#1008">1008</a>     }
-<a class="jxr_linenumber" name="1009" href="#1009">1009</a> 
-<a class="jxr_linenumber" name="1010" href="#1010">1010</a> }
+<a class="jxr_linenumber" name="542" href="#542">542</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper request,
+<a class="jxr_linenumber" name="543" href="#543">543</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry entry) {
+<a class="jxr_linenumber" name="544" href="#544">544</a>         <strong class="jxr_keyword">final</strong> HttpResponse cachedResponse = <strong class="jxr_keyword">this</strong>.responseGenerator.generateResponse(request, entry);
+<a class="jxr_linenumber" name="545" href="#545">545</a>         setResponseStatus(clientContext, CacheResponseStatus.CACHE_HIT);
+<a class="jxr_linenumber" name="546" href="#546">546</a>         cachedResponse.addHeader(HeaderConstants.WARNING, <span class="jxr_string">"111 localhost \&quot;Revalidation failed\&quot;"</span>);
+<a class="jxr_linenumber" name="547" href="#547">547</a>         <strong class="jxr_keyword">return</strong> cachedResponse;
+<a class="jxr_linenumber" name="548" href="#548">548</a>     }
+<a class="jxr_linenumber" name="549" href="#549">549</a> 
+<a class="jxr_linenumber" name="550" href="#550">550</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> staleResponseNotAllowed(
+<a class="jxr_linenumber" name="551" href="#551">551</a>             <strong class="jxr_keyword">final</strong> HttpRequest request,
+<a class="jxr_linenumber" name="552" href="#552">552</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry entry,
+<a class="jxr_linenumber" name="553" href="#553">553</a>             <strong class="jxr_keyword">final</strong> Date now) {
+<a class="jxr_linenumber" name="554" href="#554">554</a>         <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">this</strong>.validityPolicy.mustRevalidate(entry)
+<a class="jxr_linenumber" name="555" href="#555">555</a>             || (isSharedCache() &amp;&amp; <strong class="jxr_keyword">this</strong>.validityPolicy.proxyRevalidate(entry))
+<a class="jxr_linenumber" name="556" href="#556">556</a>             || explicitFreshnessRequest(request, entry, now);
+<a class="jxr_linenumber" name="557" href="#557">557</a>     }
+<a class="jxr_linenumber" name="558" href="#558">558</a> 
+<a class="jxr_linenumber" name="559" href="#559">559</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> mayCallBackend(<strong class="jxr_keyword">final</strong> HttpRequest request) {
+<a class="jxr_linenumber" name="560" href="#560">560</a>         <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">final</strong> Header h: request.getHeaders(HeaderConstants.CACHE_CONTROL)) {
+<a class="jxr_linenumber" name="561" href="#561">561</a>             <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">final</strong> HeaderElement elt : h.getElements()) {
+<a class="jxr_linenumber" name="562" href="#562">562</a>                 <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"only-if-cached"</span>.equals(elt.getName())) {
+<a class="jxr_linenumber" name="563" href="#563">563</a>                     <strong class="jxr_keyword">this</strong>.log.debug(<span class="jxr_string">"Request marked only-if-cached"</span>);
+<a class="jxr_linenumber" name="564" href="#564">564</a>                     <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="565" href="#565">565</a>                 }
+<a class="jxr_linenumber" name="566" href="#566">566</a>             }
+<a class="jxr_linenumber" name="567" href="#567">567</a>         }
+<a class="jxr_linenumber" name="568" href="#568">568</a>         <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="569" href="#569">569</a>     }
+<a class="jxr_linenumber" name="570" href="#570">570</a> 
+<a class="jxr_linenumber" name="571" href="#571">571</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> explicitFreshnessRequest(
+<a class="jxr_linenumber" name="572" href="#572">572</a>             <strong class="jxr_keyword">final</strong> HttpRequest request,
+<a class="jxr_linenumber" name="573" href="#573">573</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry entry,
+<a class="jxr_linenumber" name="574" href="#574">574</a>             <strong class="jxr_keyword">final</strong> Date now) {
+<a class="jxr_linenumber" name="575" href="#575">575</a>         <strong class="jxr_keyword">for</strong>(<strong class="jxr_keyword">final</strong> Header h : request.getHeaders(HeaderConstants.CACHE_CONTROL)) {
+<a class="jxr_linenumber" name="576" href="#576">576</a>             <strong class="jxr_keyword">for</strong>(<strong class="jxr_keyword">final</strong> HeaderElement elt : h.getElements()) {
+<a class="jxr_linenumber" name="577" href="#577">577</a>                 <strong class="jxr_keyword">if</strong> (HeaderConstants.CACHE_CONTROL_MAX_STALE.equals(elt.getName())) {
+<a class="jxr_linenumber" name="578" href="#578">578</a>                     <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="579" href="#579">579</a>                         <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">int</strong> maxstale = Integer.parseInt(elt.getValue());
+<a class="jxr_linenumber" name="580" href="#580">580</a>                         <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">long</strong> age = <strong class="jxr_keyword">this</strong>.validityPolicy.getCurrentAgeSecs(entry, now);
+<a class="jxr_linenumber" name="581" href="#581">581</a>                         <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">long</strong> lifetime = <strong class="jxr_keyword">this</strong>.validityPolicy.getFreshnessLifetimeSecs(entry);
+<a class="jxr_linenumber" name="582" href="#582">582</a>                         <strong class="jxr_keyword">if</strong> (age - lifetime &gt; maxstale) {
+<a class="jxr_linenumber" name="583" href="#583">583</a>                             <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="584" href="#584">584</a>                         }
+<a class="jxr_linenumber" name="585" href="#585">585</a>                     } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> NumberFormatException nfe) {
+<a class="jxr_linenumber" name="586" href="#586">586</a>                         <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="587" href="#587">587</a>                     }
+<a class="jxr_linenumber" name="588" href="#588">588</a>                 } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (HeaderConstants.CACHE_CONTROL_MIN_FRESH.equals(elt.getName())
+<a class="jxr_linenumber" name="589" href="#589">589</a>                             || HeaderConstants.CACHE_CONTROL_MAX_AGE.equals(elt.getName())) {
+<a class="jxr_linenumber" name="590" href="#590">590</a>                     <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="591" href="#591">591</a>                 }
+<a class="jxr_linenumber" name="592" href="#592">592</a>             }
+<a class="jxr_linenumber" name="593" href="#593">593</a>         }
+<a class="jxr_linenumber" name="594" href="#594">594</a>         <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="595" href="#595">595</a>     }
+<a class="jxr_linenumber" name="596" href="#596">596</a> 
+<a class="jxr_linenumber" name="597" href="#597">597</a>     <strong class="jxr_keyword">private</strong> String generateViaHeader(<strong class="jxr_keyword">final</strong> HttpMessage msg) {
+<a class="jxr_linenumber" name="598" href="#598">598</a> 
+<a class="jxr_linenumber" name="599" href="#599">599</a>         <strong class="jxr_keyword">final</strong> ProtocolVersion pv = msg.getProtocolVersion();
+<a class="jxr_linenumber" name="600" href="#600">600</a>         <strong class="jxr_keyword">final</strong> String existingEntry = viaHeaders.get(pv);
+<a class="jxr_linenumber" name="601" href="#601">601</a>         <strong class="jxr_keyword">if</strong> (existingEntry != <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="602" href="#602">602</a>             <strong class="jxr_keyword">return</strong> existingEntry;
+<a class="jxr_linenumber" name="603" href="#603">603</a>         }
+<a class="jxr_linenumber" name="604" href="#604">604</a> 
+<a class="jxr_linenumber" name="605" href="#605">605</a>         <strong class="jxr_keyword">final</strong> VersionInfo vi = VersionInfo.loadVersionInfo(<span class="jxr_string">"org.apache.http.client"</span>, getClass().getClassLoader());
+<a class="jxr_linenumber" name="606" href="#606">606</a>         <strong class="jxr_keyword">final</strong> String release = (vi != <strong class="jxr_keyword">null</strong>) ? vi.getRelease() : VersionInfo.UNAVAILABLE;
+<a class="jxr_linenumber" name="607" href="#607">607</a> 
+<a class="jxr_linenumber" name="608" href="#608">608</a>         <strong class="jxr_keyword">final</strong> String value;
+<a class="jxr_linenumber" name="609" href="#609">609</a>         <strong class="jxr_keyword">if</strong> (<span class="jxr_string">"http"</span>.equalsIgnoreCase(pv.getProtocol())) {
+<a class="jxr_linenumber" name="610" href="#610">610</a>             value = String.format(<span class="jxr_string">"%d.%d localhost (Apache-HttpClient/%s (cache))"</span>, pv.getMajor(), pv.getMinor(),
+<a class="jxr_linenumber" name="611" href="#611">611</a>                     release);
+<a class="jxr_linenumber" name="612" href="#612">612</a>         } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="613" href="#613">613</a>             value = String.format(<span class="jxr_string">"%s/%d.%d localhost (Apache-HttpClient/%s (cache))"</span>, pv.getProtocol(), pv.getMajor(),
+<a class="jxr_linenumber" name="614" href="#614">614</a>                     pv.getMinor(), release);
+<a class="jxr_linenumber" name="615" href="#615">615</a>         }
+<a class="jxr_linenumber" name="616" href="#616">616</a>         viaHeaders.put(pv, value);
+<a class="jxr_linenumber" name="617" href="#617">617</a> 
+<a class="jxr_linenumber" name="618" href="#618">618</a>         <strong class="jxr_keyword">return</strong> value;
+<a class="jxr_linenumber" name="619" href="#619">619</a>     }
+<a class="jxr_linenumber" name="620" href="#620">620</a> 
+<a class="jxr_linenumber" name="621" href="#621">621</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">void</strong> setResponseStatus(<strong class="jxr_keyword">final</strong> HttpCacheContext clientContext, <strong class="jxr_keyword">final</strong> CacheResponseStatus value) {
+<a class="jxr_linenumber" name="622" href="#622">622</a>         <strong class="jxr_keyword">if</strong> (clientContext != <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="623" href="#623">623</a>             clientContext.setAttribute(HttpCacheContext.CACHE_RESPONSE_STATUS, value);
+<a class="jxr_linenumber" name="624" href="#624">624</a>         }
+<a class="jxr_linenumber" name="625" href="#625">625</a>     }
+<a class="jxr_linenumber" name="626" href="#626">626</a> 
+<a class="jxr_linenumber" name="627" href="#627">627</a>     <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="628" href="#628">628</a> <em class="jxr_javadoccomment">     * Reports whether this {@code CachingHttpClient} implementation</em>
+<a class="jxr_linenumber" name="629" href="#629">629</a> <em class="jxr_javadoccomment">     * supports byte-range requests as specified by the {@code Range}</em>
+<a class="jxr_linenumber" name="630" href="#630">630</a> <em class="jxr_javadoccomment">     * and {@code Content-Range} headers.</em>
+<a class="jxr_linenumber" name="631" href="#631">631</a> <em class="jxr_javadoccomment">     * @return {@code true} if byte-range requests are supported</em>
+<a class="jxr_linenumber" name="632" href="#632">632</a> <em class="jxr_javadoccomment">     */</em>
+<a class="jxr_linenumber" name="633" href="#633">633</a>     <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">boolean</strong> supportsRangeAndContentRangeHeaders() {
+<a class="jxr_linenumber" name="634" href="#634">634</a>         <strong class="jxr_keyword">return</strong> SUPPORTS_RANGE_AND_CONTENT_RANGE_HEADERS;
+<a class="jxr_linenumber" name="635" href="#635">635</a>     }
+<a class="jxr_linenumber" name="636" href="#636">636</a> 
+<a class="jxr_linenumber" name="637" href="#637">637</a>     <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="638" href="#638">638</a> <em class="jxr_javadoccomment">     * Reports whether this {@code CachingHttpClient} is configured as</em>
+<a class="jxr_linenumber" name="639" href="#639">639</a> <em class="jxr_javadoccomment">     * a shared (public) or non-shared (private) cache. See {@link</em>
+<a class="jxr_linenumber" name="640" href="#640">640</a> <em class="jxr_javadoccomment">     * CacheConfig#setSharedCache(boolean)}.</em>
+<a class="jxr_linenumber" name="641" href="#641">641</a> <em class="jxr_javadoccomment">     * @return {@code true} if we are behaving as a shared (public)</em>
+<a class="jxr_linenumber" name="642" href="#642">642</a> <em class="jxr_javadoccomment">     *   cache</em>
+<a class="jxr_linenumber" name="643" href="#643">643</a> <em class="jxr_javadoccomment">     */</em>
+<a class="jxr_linenumber" name="644" href="#644">644</a>     <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">boolean</strong> isSharedCache() {
+<a class="jxr_linenumber" name="645" href="#645">645</a>         <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">this</strong>.sharedCache;
+<a class="jxr_linenumber" name="646" href="#646">646</a>     }
+<a class="jxr_linenumber" name="647" href="#647">647</a> 
+<a class="jxr_linenumber" name="648" href="#648">648</a>     Date getCurrentDate() {
+<a class="jxr_linenumber" name="649" href="#649">649</a>         <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> Date();
+<a class="jxr_linenumber" name="650" href="#650">650</a>     }
+<a class="jxr_linenumber" name="651" href="#651">651</a> 
+<a class="jxr_linenumber" name="652" href="#652">652</a>     <strong class="jxr_keyword">boolean</strong> clientRequestsOurOptions(<strong class="jxr_keyword">final</strong> HttpRequest request) {
+<a class="jxr_linenumber" name="653" href="#653">653</a>         <strong class="jxr_keyword">final</strong> RequestLine line = request.getRequestLine();
+<a class="jxr_linenumber" name="654" href="#654">654</a> 
+<a class="jxr_linenumber" name="655" href="#655">655</a>         <strong class="jxr_keyword">if</strong> (!HeaderConstants.OPTIONS_METHOD.equals(line.getMethod())) {
+<a class="jxr_linenumber" name="656" href="#656">656</a>             <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="657" href="#657">657</a>         }
+<a class="jxr_linenumber" name="658" href="#658">658</a> 
+<a class="jxr_linenumber" name="659" href="#659">659</a>         <strong class="jxr_keyword">if</strong> (!<span class="jxr_string">"*"</span>.equals(line.getUri())) {
+<a class="jxr_linenumber" name="660" href="#660">660</a>             <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="661" href="#661">661</a>         }
+<a class="jxr_linenumber" name="662" href="#662">662</a>         <strong class="jxr_keyword">return</strong> <span class="jxr_string">"0"</span>.equals(request.getFirstHeader(HeaderConstants.MAX_FORWARDS).getValue());
+<a class="jxr_linenumber" name="663" href="#663">663</a>     }
+<a class="jxr_linenumber" name="664" href="#664">664</a> 
+<a class="jxr_linenumber" name="665" href="#665">665</a>     <strong class="jxr_keyword">void</strong> callBackend(
+<a class="jxr_linenumber" name="666" href="#666">666</a>             <strong class="jxr_keyword">final</strong> BasicFuture&lt;HttpResponse&gt; future,
+<a class="jxr_linenumber" name="667" href="#667">667</a>             <strong class="jxr_keyword">final</strong> HttpHost target,
+<a class="jxr_linenumber" name="668" href="#668">668</a>             <strong class="jxr_keyword">final</strong> HttpRequestWrapper request,
+<a class="jxr_linenumber" name="669" href="#669">669</a>             <strong class="jxr_keyword">final</strong> HttpCacheContext clientContext) {
+<a class="jxr_linenumber" name="670" href="#670">670</a>         <strong class="jxr_keyword">final</strong> Date requestDate = getCurrentDate();
+<a class="jxr_linenumber" name="671" href="#671">671</a>         <strong class="jxr_keyword">this</strong>.log.trace(<span class="jxr_string">"Calling the backend"</span>);
+<a class="jxr_linenumber" name="672" href="#672">672</a> 
+<a class="jxr_linenumber" name="673" href="#673">673</a>         <strong class="jxr_keyword">final</strong> ChainedFutureCallback&lt;HttpResponse&gt; chainedFutureCallback = <strong class="jxr_keyword">new</strong> ChainedFutureCallback&lt;HttpResponse&gt;(future) {
+<a class="jxr_linenumber" name="674" href="#674">674</a> 
+<a class="jxr_linenumber" name="675" href="#675">675</a>             @Override
+<a class="jxr_linenumber" name="676" href="#676">676</a>             <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">void</strong> completed(<strong class="jxr_keyword">final</strong> HttpResponse httpResponse) {
+<a class="jxr_linenumber" name="677" href="#677">677</a>                 httpResponse.addHeader(HeaderConstants.VIA, generateViaHeader(httpResponse));
+<a class="jxr_linenumber" name="678" href="#678">678</a>                 <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="679" href="#679">679</a>                     <strong class="jxr_keyword">final</strong> CloseableHttpResponse backendResponse = handleBackendResponse(
+<a class="jxr_linenumber" name="680" href="#680">680</a>                             target, request, requestDate, getCurrentDate(),
+<a class="jxr_linenumber" name="681" href="#681">681</a>                             Proxies.enhanceResponse(httpResponse));
+<a class="jxr_linenumber" name="682" href="#682">682</a>                     <strong class="jxr_keyword">super</strong>.completed(backendResponse);
+<a class="jxr_linenumber" name="683" href="#683">683</a>                 } <strong class="jxr_keyword">catch</strong> (<strong class="jxr_keyword">final</strong> IOException e) {
+<a class="jxr_linenumber" name="684" href="#684">684</a>                     <strong class="jxr_keyword">super</strong>.failed(e);
+<a class="jxr_linenumber" name="685" href="#685">685</a>                 }
+<a class="jxr_linenumber" name="686" href="#686">686</a> 
+<a class="jxr_linenumber" name="687" href="#687">687</a>             }
+<a class="jxr_linenumber" name="688" href="#688">688</a> 
+<a class="jxr_linenumber" name="689" href="#689">689</a>         };
+<a class="jxr_linenumber" name="690" href="#690">690</a>         <strong class="jxr_keyword">this</strong>.backend.execute(target, request, clientContext, chainedFutureCallback);
+<a class="jxr_linenumber" name="691" href="#691">691</a>     }
+<a class="jxr_linenumber" name="692" href="#692">692</a> 
+<a class="jxr_linenumber" name="693" href="#693">693</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">boolean</strong> revalidationResponseIsTooOld(
+<a class="jxr_linenumber" name="694" href="#694">694</a>             <strong class="jxr_keyword">final</strong> HttpResponse backendResponse,
+<a class="jxr_linenumber" name="695" href="#695">695</a>             <strong class="jxr_keyword">final</strong> HttpCacheEntry cacheEntry) {
+<a class="jxr_linenumber" name="696" href="#696">696</a>         <strong class="jxr_keyword">final</strong> Header entryDateHeader = cacheEntry.getFirstHeader(HTTP.DATE_HEADER);
+<a class="jxr_linenumber" name="697" href="#697">697</a>         <strong class="jxr_keyword">final</strong> Header responseDateHeader = backendResponse.getFirstHeader(HTTP.DATE_HEADER);
+<a class="jxr_linenumber" name="698" href="#698">698</a>         <strong class="jxr_keyword">if</strong> (entryDateHeader != <strong class="jxr_keyword">null</strong> &amp;&amp; responseDateHeader != <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="699" href="#699">699</a>             <strong class="jxr_keyword">final</strong> Date entryDate = DateUtils.parseDate(entryDateHeader.getValue());
+<a class="jxr_linenumber" name="700" href="#700">700</a>             <strong class="jxr_keyword">final</strong> Date respDate = DateUtils.parseDate(responseDateHeader.getValue());
+<a class="jxr_linenumber" name="701" href="#701">701</a>             <strong class="jxr_keyword">if</strong> (respDate != <strong class="jxr_keyword">null</strong> &amp;&amp; respDate.before(entryDate)) {
+<a class="jxr_linenumber" name="702" href="#702">702</a>                 <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="703" href="#703">703</a>             }

[... 312 lines stripped ...]