Add GetExpirationTimes() to HttpResponseHeader.

net/http/http_response_headers.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef NET_HTTP_HTTP_RESPONSE_HEADERS_H_
 #define NET_HTTP_HTTP_RESPONSE_HEADERS_H_
 
 #include <stddef.h>
 #include <stdint.h>
 
@@ skipping 12 matching lines @@
 class Pickle;
 class PickleIterator;
 class Time;
 class TimeDelta;
 }
 
 namespace net {
 
 class HttpByteRange;
 
-enum ValidationType {
-  VALIDATION_NONE,          // The resource is fresh.
-  VALIDATION_ASYNCHRONOUS,  // The resource requires async revalidation.
-  VALIDATION_SYNCHRONOUS    // The resource requires sync revalidation.
-};
-
 // HttpResponseHeaders: parses and holds HTTP response headers.
 class NET_EXPORT HttpResponseHeaders
     : public base::RefCountedThreadSafe<HttpResponseHeaders> {
  public:
   // Persist options.
   typedef int PersistOptions;
   static const PersistOptions PERSIST_RAW = -1;  // Raw, unparsed headers.
   static const PersistOptions PERSIST_ALL = 0;  // Parsed headers.
   static const PersistOptions PERSIST_SANS_COOKIES = 1 << 0;
   static const PersistOptions PERSIST_SANS_CHALLENGES = 1 << 1;
   static const PersistOptions PERSIST_SANS_HOP_BY_HOP = 1 << 2;
   static const PersistOptions PERSIST_SANS_NON_CACHEABLE = 1 << 3;
   static const PersistOptions PERSIST_SANS_RANGES = 1 << 4;
   static const PersistOptions PERSIST_SANS_SECURITY_STATE = 1 << 5;
 
-  struct FreshnessLifetimes {
+  struct ExpirationTimes {
+    base::Time GetFreshnessExpiry() const {
+      return corrected_response_time + freshness_lifetime;
+    }
+
+    base::Time GetStalenessExpiry() const {
+      return corrected_response_time + staleness_lifetime;
+    }
+
+    // The |base::Time::Now()| value for which this request would have an age of
+    // exactly zero. You can subtract this from |base::Time::Now()| to get the
+    // current age.
+    base::Time corrected_response_time;
+
     // How long the resource will be fresh for.
-    base::TimeDelta freshness;
+    base::TimeDelta freshness_lifetime;
+
     // How long after becoming not fresh that the resource will be stale but
     // usable (if async revalidation is enabled).
-    base::TimeDelta staleness;
+    base::TimeDelta staleness_lifetime;
   };
 
   static const char kContentRange[];
 
   // Parses the given raw_headers.  raw_headers should be formatted thus:
   // includes the http status response line, each line is \0-terminated, and
   // it's terminated by an empty line (ie, 2 \0s in a row).
   // (Note that line continuations should have already been joined;
   // see HttpUtil::AssembleRawHeaders)
   //
@@ skipping 148 matching lines @@
   bool GetCharset(std::string* charset) const;
 
   // Returns true if this response corresponds to a redirect.  The target
   // location of the redirect is optionally returned if location is non-null.
   bool IsRedirect(std::string* location) const;
 
   // Returns true if the HTTP response code passed in corresponds to a
   // redirect.
   static bool IsRedirectResponseCode(int response_code);
 
-  // Returns VALIDATION_NONE if the response can be reused without
-  // validation. VALIDATION_ASYNCHRONOUS means the response can be re-used, but
-  // asynchronous revalidation must be performed. VALIDATION_SYNCHRONOUS means
-  // that the result cannot be reused without revalidation.
-  // The result is relative to the current_time parameter, which is
-  // a parameter to support unit testing.  The request_time parameter indicates
-  // the time at which the request was made that resulted in this response,
-  // which was received at response_time.
-  ValidationType RequiresValidation(const base::Time& request_time,
-                                    const base::Time& response_time,
-                                    const base::Time& current_time) const;
+  // Returns an ExpirationTimes struct which can be used to calculate the
+  // freshness and stale-white-revalidate status of this response. The values in
+  // the ExpirationTimes struct do not depend on the current time, so they can
+  // be stored and used later as well.
+  ExpirationTimes GetExpirationTimes(const base::Time& request_time,
+                                     const base::Time& response_time) const;
 
   // Calculates the amount of time the server claims the response is fresh from
   // the time the response was generated.  See section 13.2.4 of RFC 2616.  See
   // RequiresValidation for a description of the response_time parameter.  See
   // the definition of FreshnessLifetimes above for the meaning of the return
   // value.  See RFC 5861 section 3 for the definition of
   // stale-while-revalidate.
-  FreshnessLifetimes GetFreshnessLifetimes(
-      const base::Time& response_time) const;
-
-  // Returns the age of the response.  See section 13.2.3 of RFC 2616.
-  // See RequiresValidation for a description of this method's parameters.
-  base::TimeDelta GetCurrentAge(const base::Time& request_time,
-                                const base::Time& response_time,
-                                const base::Time& current_time) const;
+  void CalculateLifetimes(const base::Time& response_time,
+                          base::TimeDelta* out_freshness_lifetime,
+                          base::TimeDelta* out_staleness_lifetime) const;
 
   // The following methods extract values from the response headers.  If a
   // value is not present, or is invalid, then false is returned.  Otherwise,
   // true is returned and the out param is assigned to the corresponding value.
   bool GetMaxAgeValue(base::TimeDelta* value) const;
   bool GetAgeValue(base::TimeDelta* value) const;
   bool GetDateValue(base::Time* value) const;
   bool GetLastModifiedValue(base::Time* value) const;
   bool GetExpiresValue(base::Time* value) const;
   bool GetStaleWhileRevalidateValue(base::TimeDelta* value) const;
@@ skipping 158 matching lines @@
 
   // The normalized http version (consistent with what GetStatusLine() returns).
   HttpVersion http_version_;
 
   DISALLOW_COPY_AND_ASSIGN(HttpResponseHeaders);
 };
 
 }  // namespace net
 
 #endif  // NET_HTTP_HTTP_RESPONSE_HEADERS_H_