---

mziccard · mziccard · commit 381e89d4414f · 2015-11-11T15:40:43.000+01:00
yaml --- r: 1919 b: refs/heads/pubsub-alpha c: 9608e61 h: refs/heads/master i: 1917: 2dd01b6 1915: 967cbc6 1911: 2597e5a 1903: a79561d 1887: 820e7b2 1855: 5228324 1791: 25b23bb
diff --git a/[refs] b/[refs]
@@ -3,7 +3,7 @@ refs/heads/master: 689bbb466df4b2d5d2483d6edb8ac5c7c7f7c6fa
 refs/heads/travis: e21ee7b88a5edc3f3d8c71f90c3fc32abf7e8dd6
 refs/heads/gh-pages: 4e0561bb4504bf647db669a14417b2b2c87ba45d
 refs/heads/bigquery: 762fa5830e6c398c0396177e3e7fd243bd62cfc3
-refs/heads/pubsub-alpha: e2a4500e57e7dd458223cff5020e990539795828
+refs/heads/pubsub-alpha: 9608e61fe5228de7c4faddb9e9c4a850eda69611
 refs/heads/resource-manager: ebf4adc5ee835cd2086c4ac5b4e78d01a5a005a7
 refs/heads/update-datastore: 482954f2c5055231e5b3122ea91d2ba00ce8187c
 refs/tags/0.0.9: 22f1839238f66c39e67ed4dfdcd273b1ae2e8444
diff --git a/branches/pubsub-alpha/gcloud-java-storage/src/main/java/com/google/gcloud/storage/Cors.java b/branches/pubsub-alpha/gcloud-java-storage/src/main/java/com/google/gcloud/storage/Cors.java
@@ -33,6 +33,9 @@
 
 /**
  * Cross-Origin Resource Sharing (CORS) configuration for a bucket.
+ *
+ * @see <a href="https://cloud.google.com/storage/docs/cross-origin">
+ *     Cross-Origin Resource Sharing (CORS)</a>
  */
 public final class Cors implements Serializable {
 
@@ -57,6 +60,9 @@ public Bucket.Cors apply(Cors cors) {
   private final ImmutableList<Origin> origins;
   private final ImmutableList<String> responseHeaders;
 
+  /**
+   * Class for a CORS origin.
+   */
   public static final class Origin implements Serializable {
 
     private static final long serialVersionUID = -4447958124895577993L;
@@ -69,10 +75,16 @@ private Origin(String value) {
       this.value = checkNotNull(value);
     }
 
+    /**
+     * Returns an {@code Origin} object for all possible origins.
+     */
     public static Origin any() {
       return ANY;
     }
 
+    /**
+     * Returns an {@code Origin} object for the given scheme, host and port.
+     */
     public static Origin of(String scheme, String host, int port) {
       try {
         return of(new URI(scheme, null, host, port, null, null, null).toString());
@@ -81,6 +93,9 @@ public static Origin of(String scheme, String host, int port) {
       }
     }
 
+    /**
+     * Creates an {@code Origin} object for the provided value.
+     */
     public static Origin of(String value) {
       if (ANY_URI.equals(value)) {
         return any();
@@ -111,6 +126,9 @@ public String value() {
     }
   }
 
+  /**
+   * CORS configuration builder.
+   */
   public static final class Builder {
 
     private Integer maxAgeSeconds;
@@ -120,26 +138,42 @@ public static final class Builder {
 
     private Builder() {}
 
+    /**
+     * Sets the max time in seconds in which a client can issue requests before sending a new
+     * preflight request.
+     */
     public Builder maxAgeSeconds(Integer maxAgeSeconds) {
       this.maxAgeSeconds = maxAgeSeconds;
       return this;
     }
 
+    /**
+     * Sets the HTTP methods supported by this CORS configuration.
+     */
     public Builder methods(Iterable<HttpMethod> methods) {
       this.methods = methods != null ? ImmutableList.copyOf(methods) : null;
       return this;
     }
 
+    /**
+     * Sets the origins for this CORS configuration.
+     */
     public Builder origins(Iterable<Origin> origins) {
       this.origins = origins != null ? ImmutableList.copyOf(origins) : null;
       return this;
     }
 
+    /**
+     * Sets the response headers supported by this CORS configuration.
+     */
     public Builder responseHeaders(Iterable<String> headers) {
       this.responseHeaders = headers != null ? ImmutableList.copyOf(headers) : null;
       return this;
     }
 
+    /**
+     * Creates a CORS configuration.
+     */
     public Cors build() {
       return new Cors(this);
     }
@@ -152,22 +186,38 @@ private Cors(Builder builder) {
     this.responseHeaders = builder.responseHeaders;
   }
 
+  /**
+   * Returns the max time in seconds in which a client can issue requests before sending a new
+   * preflight request.
+   */
   public Integer maxAgeSeconds() {
     return maxAgeSeconds;
   }
 
+  /**
+   * Returns the HTTP methods supported by this CORS configuration.
+   */
   public List<HttpMethod> methods() {
     return methods;
   }
 
+  /**
+   * Returns the origins in this CORS configuration.
+   */
   public List<Origin> origins() {
     return origins;
   }
 
+  /**
+   * Returns the response headers supported by this CORS configuration.
+   */
   public List<String> responseHeaders() {
     return responseHeaders;
   }
 
+  /**
+   * Returns a builder for this CORS configuration.
+   */
   public Builder toBuilder() {
     return builder()
         .maxAgeSeconds(maxAgeSeconds)
@@ -193,6 +243,9 @@ public boolean equals(Object obj) {
         && Objects.equals(responseHeaders, other.responseHeaders);
   }
 
+  /**
+   * Returns a CORS configuration builder.
+   */
   public static Builder builder() {
     return new Builder();
   }
