Add getter docs for service objects

tcoffee-google · tcoffee-google · commit 9148401d1978 · 2017-06-08T12:20:36.000-07:00
Fixes #2115.
diff --git a/google-cloud-core/src/main/java/com/google/cloud/ServiceOptions.java b/google-cloud-core/src/main/java/com/google/cloud/ServiceOptions.java
@@ -420,6 +420,10 @@ protected static String getServiceAccountProjectId() {
   }
 
 
+  /**
+   * Returns a Service object for the current service. For instance, when using Google Cloud
+   * Storage, it returns a {@link com.google.cloud.storage.Storage} object.
+   */
   @SuppressWarnings("unchecked")
   public ServiceT getService() {
     if (service == null) {
@@ -429,6 +433,10 @@ public ServiceT getService() {
   }
 
 
+  /**
+   * Returns a Service RPC object for the current service. For instance, when using Google Cloud
+   * Storage, it returns a {@link com.google.cloud.storage.spi.StorageRpc} object.
+   */
   @SuppressWarnings("unchecked")
   public ServiceRpc getRpc() {
     if (rpc == null) {
