Merge pull request googleapis#13 from garrettjonesgoogle/master

Adding javadoc and uploadArchives task, bumping to 0.0.0

build.gradle

@@ -3,9 +3,11 @@ apply plugin: 'maven'
 apply plugin: 'eclipse'
 apply plugin: 'idea'
 apply plugin: 'jacoco'
+apply plugin: 'signing'
 
 group = "com.google.api"
-version = "0.0.0-SNAPSHOT"
+archivesBaseName = "gax"
+version = "0.0.0"
 
 // Dependencies
 // ------------
@@ -64,16 +66,25 @@ task sourcesJar(type: Jar, dependsOn: classes) {
   from sourceSets.main.allSource
 }
 
-artifacts {
-  archives sourcesJar
+// JavaDoc
+// -------
+
+task javadocJar(type: Jar) {
+  classifier = 'javadoc'
+  from javadoc
+}
+
+javadoc.options {
+  encoding = 'UTF-8'
+  links 'https://docs.oracle.com/javase/8/docs/api/'
 }
 
 // Test Logging
 // ------------
 
 test {
   testLogging {
-      events "passed", "skipped", "failed", "standardOut", "standardError"
+    events "passed", "skipped", "failed", "standardOut", "standardError"
   }
 }
 
@@ -139,3 +150,61 @@ tasks.cleanEclipseJdt {
       file('.factorypath')
   }
 }
+
+// Publishing
+// ----------
+
+artifacts {
+  archives javadocJar, sourcesJar
+}
+
+signing {
+  sign configurations.archives
+}
+
+uploadArchives {
+  repositories {
+    mavenDeployer {
+      beforeDeployment { MavenDeployment deployment -> signing.signPom(deployment) }
+
+      repository(url: "https://oss.sonatype.org/service/local/staging/deploy/maven2/") {
+        authentication(userName: ossrhUsername, password: ossrhPassword)
+      }
+
+      snapshotRepository(url: "https://oss.sonatype.org/content/repositories/snapshots/") {
+        authentication(userName: ossrhUsername, password: ossrhPassword)
+      }
+
+      pom.project {
+        name 'GAX (Google Api eXtensions)'
+        packaging 'jar'
+        artifactId 'gax'
+        description 'Google Api eXtensions'
+        url 'https://github.com/googleapis'
+
+        scm {
+          url 'https://github.com/googleapis/gax-java'
+          connection 'scm:svn:https://github.com/googleapis/gax-java.git'
+        }
+
+        licenses {
+          license {
+            name 'BSD'
+            url 'https://github.com/googleapis/gax-java/blob/master/LICENSE'
+          }
+        }
+
+        developers {
+          developer {
+            id 'GoogleAPIs'
+            name 'GoogleAPIs'
+            email '[email protected]'
+            url 'https://github.com/googleapis'
+            organization 'Google, Inc.'
+            organizationUrl 'https://www.google.com'
+          }
+        }
+      }
+    }
+  }
+}

src/main/java/com/google/api/gax/bundling/BundlingThreshold.java

@@ -44,7 +44,7 @@ public interface BundlingThreshold<E> {
   void accumulate(E e);
 
   /**
-   * @returns whether the threshold has been reached.
+   * @return whether the threshold has been reached.
    */
   boolean isThresholdReached();
 

src/main/java/com/google/api/gax/bundling/ThresholdBundler.java

@@ -128,7 +128,7 @@ public void flush() {
    * Remove all currently contained elements, regardless of whether they have triggered any
    * thresholds. All elements are placed into 'bundle'.
    *
-   * @returns the number of items added to 'bundle'.
+   * @return the number of items added to 'bundle'.
    */
   public int drainTo(Collection<? super E> bundle) {
     final Lock lock = this.lock;

src/main/java/com/google/api/gax/core/RetryParams.java

@@ -35,7 +35,7 @@
 
 /**
  * {@code RetryParams} encapsulates a retry strategy used by
- * {@link com.google.api.gax.grpc.ApiCallable#retrying(RetryParams)}.
+ * {@link com.google.api.gax.grpc.ApiCallable#retrying(RetryParams, ScheduledExecutorService)}.
  */
 @AutoValue
 public abstract class RetryParams {

src/main/java/com/google/api/gax/grpc/ApiCallable.java

@@ -136,10 +136,10 @@ public void onSuccess(ResponseT result) {
   }
 
   /**
-   * Same as {@link #asyncCall(RequestT, StreamObserver)}, with null {@link io.grpc.Channel} and
+   * Same as {@link #asyncCall(CallContext, StreamObserver)}, with null {@link io.grpc.Channel} and
    * default {@link io.grpc.CallOptions}.
    *
-   * @param context {@link com.google.api.gax.grpc.CallContext} to make the call with
+   * @param request request
    * @param observer Observer to interact with the result
    */
   public void asyncCall(RequestT request, StreamObserver<ResponseT> observer) {

src/main/java/com/google/api/gax/protobuf/PathTemplate.java

@@ -55,7 +55,7 @@
 /**
  * Represents a path template.
  *
- * <p>Templates use the syntax of the API platform; see the protobuf of {@link HttpRule} for
+ * <p>Templates use the syntax of the API platform; see the protobuf of HttpRule for
  * details. A template consists of a sequence of literals, wildcards, and variable bindings,
  * where each binding can have a sub-path. A string representation can be parsed into an
  * instance of {@link PathTemplate}, which can then be used to perform matching and instantiation.
@@ -70,7 +70,7 @@
  * <pre>
  *   PathTemplate template = PathTemplate.create("v1/shelves/{shelf}/books/{book}");
  *   assert template.match("v2/shelves"} == false
- *   Map&lt;String, String> values = template.match("v1/shelves/s1/books/b1");
+ *   Map&lt;String, String&gt; values = template.match("v1/shelves/s1/books/b1");
  *   assert values.equals(ImmutableMap.of("shelf", s1", "book", "b1");
  *   assert template.instantiate(values).equals("v1/shelves/s1/books/b1");
  * </pre>
@@ -89,7 +89,7 @@
  * <pre>
  *   PathTemplate template = PathTemplate.create("shelves/*&#47;books/*"};
  *   assert template.match("shelves/books/b1") == null;
- *   Map&lt;String, String> values = template.match("v1/shelves/s1/books/b1");
+ *   Map&lt;String, String&gt; values = template.match("v1/shelves/s1/books/b1");
  *   assert values.equals(ImmutableMap.of("$0", s1", "$1", "b1");
  * </pre>
  *
@@ -210,7 +210,7 @@ String separator() {
 
   /**
    * Creates a path template from a string. The string must satisfy the syntax
-   * of path templates of the API platform; see {@link HttpRule}'s proto source.
+   * of path templates of the API platform; see HttpRule's proto source.
    *
    * @throws ValidationException if there are errors while parsing the template.
    */