http: Add the "Age" cache header checking

ngmiceli-g · ngmiceli-g · commit afc64622d39d · 2013-02-14T12:27:04.000-05:00
https://codereview.appspot.com/7322070/
diff --git a/google-http-client/src/main/java/com/google/api/client/http/HttpHeaders.java b/google-http-client/src/main/java/com/google/api/client/http/HttpHeaders.java
@@ -168,6 +168,10 @@ public HttpHeaders() {
   @Key("WWW-Authenticate")
   private List<String> authenticate;
 
+  /** {@code "Age"} header. */
+  @Key("Age")
+  private List<Long> age;
+
   @Override
   public HttpHeaders clone() {
     return (HttpHeaders) super.clone();
@@ -804,6 +808,30 @@ public HttpHeaders setAuthenticate(String authenticate) {
     return this;
   }
 
+  /**
+   * Returns the first {@code "Age"} header or {@code null} for none.
+   *
+   * @since 1.14
+   */
+  public final Long getAge() {
+    return getFirstHeaderValue(age);
+  }
+
+  /**
+   * Sets the {@code "Age"} header or {@code null} for none.
+   *
+   * <p>
+   * Overriding is only supported for the purpose of calling the super implementation and changing
+   * the return type, but nothing else.
+   * </p>
+   *
+   * @since 1.14
+   */
+  public HttpHeaders setAge(Long age) {
+    this.age = getAsList(age);
+    return this;
+  }
+
   /**
    * Sets the {@link #authorization} header as specified in <a
    * href="http://tools.ietf.org/html/rfc2617#section-2">Basic Authentication Scheme</a>.
diff --git a/google-http-client/src/test/java/com/google/api/client/http/HttpHeadersTest.java b/google-http-client/src/test/java/com/google/api/client/http/HttpHeadersTest.java
@@ -234,6 +234,16 @@ public static class SlugHeaders extends HttpHeaders {
     String slug;
   }
 
+  public void testParseAge() throws Exception {
+    MockLowLevelHttpResponse httpResponse = new MockLowLevelHttpResponse()
+        .setHeaderNames(Arrays.asList("Age"))
+        .setHeaderValues(Arrays.asList("3456"));
+
+    HttpHeaders httpHeaders = new HttpHeaders();
+    httpHeaders.fromHttpResponse(httpResponse, null);
+    assertEquals(3456L, httpHeaders.getAge().longValue());
+  }
+
   public void testFromHttpResponse_normalFlow() throws Exception {
     MockLowLevelHttpResponse httpResponse = new MockLowLevelHttpResponse().setHeaderNames(
         Arrays.asList("Content-Type", "Slug"))
