---

aozarov · aozarov · commit baf9e48f761a · 2015-12-31T18:57:56.000-08:00
yaml --- r: 2111 b: refs/heads/pubsub-alpha c: 645f381 h: refs/heads/master i: 2109: 83c95ea 2107: db6cc2e 2103: c26a9e8 2095: 773b9fe 2079: eea926a 2047: 9b1d5b2
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: 2da16c7fbb99450b012e9924ee033d781833cc0f
+refs/heads/pubsub-alpha: 645f381695cf524d5ad4a0363576e329415979a2
 refs/heads/resource-manager: ebf4adc5ee835cd2086c4ac5b4e78d01a5a005a7
 refs/heads/update-datastore: 482954f2c5055231e5b3122ea91d2ba00ce8187c
 refs/tags/0.0.9: 22f1839238f66c39e67ed4dfdcd273b1ae2e8444
diff --git a/branches/pubsub-alpha/gcloud-java-bigquery/src/main/java/com/google/gcloud/bigquery/BaseTableInfo.java b/branches/pubsub-alpha/gcloud-java-bigquery/src/main/java/com/google/gcloud/bigquery/BaseTableInfo.java
@@ -94,6 +94,12 @@ public enum Type {
   private final Long expirationTime;
   private final Long lastModifiedTime;
 
+  /**
+   * Base builder for tables.
+   *
+   * @param <T> the table type.
+   * @param <B> the table builder.
+   */
   public abstract static class Builder<T extends BaseTableInfo, B extends Builder<T, B>> {
 
     private String etag;
diff --git a/branches/pubsub-alpha/gcloud-java-bigquery/src/main/java/com/google/gcloud/bigquery/JobInfo.java b/branches/pubsub-alpha/gcloud-java-bigquery/src/main/java/com/google/gcloud/bigquery/JobInfo.java
@@ -32,6 +32,8 @@
  * a table. Use {@link QueryJobInfo} for a job that runs a query.
  *
  * @see <a href="https://cloud.google.com/bigquery/docs/reference/v2/jobs">Jobs</a>
+ *
+ * @param <S> the statistics type.
  */
 public abstract class JobInfo<S extends JobStatistics> implements Serializable {
 
@@ -87,6 +89,13 @@ public enum WriteDisposition {
   private final S statistics;
   private final String userEmail;
 
+  /**
+   * Base builder for jobs.
+   *
+   * @param <T> the job type.
+   * @param <S> the job statistics type.
+   * @param <B> the job builder.
+   */
   public abstract static class Builder<T extends JobInfo, S extends JobStatistics,
       B extends Builder<T, S, B>> {
 
diff --git a/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/BaseService.java b/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/BaseService.java
@@ -16,6 +16,11 @@
 
 package com.google.gcloud;
 
+/**
+ * Base class for service objects.
+ *
+ * @param <OptionsT> the {@code ServiceOptions} subclass corresponding to the service.
+ */
 public abstract class BaseService<OptionsT extends ServiceOptions<?, ?, OptionsT>>
     implements Service<OptionsT> {
 
diff --git a/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/Page.java b/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/Page.java
@@ -40,6 +40,8 @@
  *   }
  *   page = page.nextPage();
  * }}</pre>
+ *
+ * @param <T> the value type that the page holds.
  */
 public interface Page<T> {
 
diff --git a/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/PageImpl.java b/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/PageImpl.java
@@ -25,6 +25,8 @@
 
 /**
  * Base implementation for Google Cloud paginated results.
+ *
+ * @param <T> the value type that the page holds.
  */
 public class PageImpl<T> implements Page<T>, Serializable {
 
@@ -34,6 +36,11 @@ public class PageImpl<T> implements Page<T>, Serializable {
   private final Iterable<T> results;
   private final NextPageFetcher<T> pageFetcher;
 
+  /**
+   * Interface for fetching the next page of results from the service.
+   *
+   * @param <T> the value type that the page holds.
+   */
   public interface NextPageFetcher<T> extends Serializable {
     Page<T> nextPage();
   }
diff --git a/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/Restorable.java b/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/Restorable.java
@@ -33,6 +33,8 @@
  * X restorableObj = state.restore();
  * ...
  * }</pre>
+ *
+ * @param <T> the restorable object's type.
  */
 public interface Restorable<T extends Restorable<T>> {
 
diff --git a/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/RestorableState.java b/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/RestorableState.java
@@ -22,6 +22,8 @@
  *
  * Implementations of this class must implement {@link java.io.Serializable} to ensure that the
  * state of a the object can be correctly serialized.
+ *
+ * @param <T> the restored object's type.
  */
 public interface RestorableState<T extends Restorable<T>> {
 
diff --git a/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/Service.java b/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/Service.java
@@ -16,6 +16,11 @@
 
 package com.google.gcloud;
 
+/**
+ * Interface for service objects.
+ *
+ * @param <OptionsT> the {@code ServiceOptions} subclass corresponding to the service.
+ */
 public interface Service<OptionsT extends ServiceOptions<?, ?, OptionsT>> {
   OptionsT options();
 }
diff --git a/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/ServiceFactory.java b/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/ServiceFactory.java
@@ -19,8 +19,11 @@
 /**
  * A base interface for all service factories.
  *
- * Implementation must provide a public no-arg constructor.
+ * <p>Implementation must provide a public no-arg constructor.
  * Loading of a factory implementation is done via {@link java.util.ServiceLoader}.
+ *
+ * @param <ServiceT> the service subclass.
+ * @param <ServiceOptionsT> the {@code ServiceOptions} subclass corresponding to the service.
  */
 @SuppressWarnings("rawtypes")
 public interface ServiceFactory<ServiceT extends Service, ServiceOptionsT extends ServiceOptions> {
diff --git a/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/ServiceOptions.java b/branches/pubsub-alpha/gcloud-java-core/src/main/java/com/google/gcloud/ServiceOptions.java
@@ -53,6 +53,13 @@
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
+/**
+ * Abstract class representing service options.
+ *
+ * @param <ServiceT> the service subclass.
+ * @param <ServiceRpcT> the spi-layer class corresponding to the service.
+ * @param <OptionsT> the {@code ServiceOptions} subclass corresponding to the service.
+ */
 public abstract class ServiceOptions<ServiceT extends Service<OptionsT>, ServiceRpcT,
     OptionsT extends ServiceOptions<ServiceT, ServiceRpcT, OptionsT>> implements Serializable {
 
@@ -150,6 +157,14 @@ private Object readResolve() throws ObjectStreamException {
     }
   }
 
+  /**
+   * Builder for {@code ServiceOptions}.
+   *
+   * @param <ServiceT> the service subclass.
+   * @param <ServiceRpcT> the spi-layer class corresponding to the service.
+   * @param <OptionsT> the {@code ServiceOptions} subclass corresponding to the service.
+   * @param <B> the {@code ServiceOptions} builder.
+   */
   protected abstract static class Builder<ServiceT extends Service<OptionsT>, ServiceRpcT,
       OptionsT extends ServiceOptions<ServiceT, ServiceRpcT, OptionsT>,
       B extends Builder<ServiceT, ServiceRpcT, OptionsT, B>> {
diff --git a/branches/pubsub-alpha/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/BaseKey.java b/branches/pubsub-alpha/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/BaseKey.java
@@ -31,15 +31,20 @@
 /**
  * Base class for keys.
  */
-abstract class BaseKey extends Serializable<DatastoreV1.Key> {
+public abstract class BaseKey extends Serializable<DatastoreV1.Key> {
 
   private static final long serialVersionUID = -4671243265877410635L;
 
   private final transient String projectId;
   private final transient String namespace;
   private final transient ImmutableList<PathElement> path;
 
-  abstract static class Builder<B extends Builder<B>> {
+  /**
+   * Base class for key builders.
+   *
+   * @param <B> the key builder.
+   */
+  protected abstract static class Builder<B extends Builder<B>> {
 
     String projectId;
     String namespace;
diff --git a/branches/pubsub-alpha/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/StructuredQuery.java b/branches/pubsub-alpha/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/StructuredQuery.java
@@ -609,7 +609,13 @@ public static Projection first(String property) {
     }
   }
 
-  static class BaseBuilder<V, B extends BaseBuilder<V, B>> {
+  /**
+   * Base class for StructuredQuery builders.
+   *
+   * @param <V> the type of result the query returns.
+   * @param <B> the query builder.
+   */
+  protected static class BaseBuilder<V, B extends BaseBuilder<V, B>> {
 
     private final ResultType<V> resultType;
     private String namespace;
diff --git a/branches/pubsub-alpha/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/ValueBuilder.java b/branches/pubsub-alpha/gcloud-java-datastore/src/main/java/com/google/gcloud/datastore/ValueBuilder.java
@@ -18,6 +18,10 @@
 
 /**
  * A common interface for Value builders.
+ *
+ * @param <V> the data type that the {@code Value} object holds.
+ * @param <P> the value type.
+ * @param <B> the value type's associated builder.
  */
 public interface ValueBuilder<V, P extends Value<V>, B extends ValueBuilder<V, P, B>> {
 

Original file line number	Diff line number	Diff line change
`@@ -22,6 +22,8 @@`
`22`	`22`	`*`
`23`	`23`	`* Implementations of this class must implement {@link java.io.Serializable} to ensure that the`
`24`	`24`	`* state of a the object can be correctly serialized.`
	`25`	`+ *`
	`26`	`+ * @param <T> the restored object's type.`
`25`	`27`	`*/`
`26`	`28`	`public interface RestorableState<T extends Restorable<T>> {`
`27`	`29`