docs(regen): updated javadocs from protoc update (#25)

googleapis · Dec 18, 2019 · 41d0c02 · 41d0c02
1 parent 2120b39
commit 41d0c02
Show file tree

Hide file tree

Showing 93 changed files with 2,286 additions and 114 deletions.
diff --git a/...o-google-cloud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricDecryptRequest.java b/...o-google-cloud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricDecryptRequest.java
@@ -42,6 +42,12 @@ private AsymmetricDecryptRequest() {
     ciphertext_ = com.google.protobuf.ByteString.EMPTY;
   }
 
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new AsymmetricDecryptRequest();
+  }
+
   @java.lang.Override
   public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
     return this.unknownFields;
@@ -55,7 +61,6 @@ private AsymmetricDecryptRequest(
     if (extensionRegistry == null) {
       throw new java.lang.NullPointerException();
     }
-    int mutable_bitField0_ = 0;
     com.google.protobuf.UnknownFieldSet.Builder unknownFields =
         com.google.protobuf.UnknownFieldSet.newBuilder();
     try {
@@ -123,6 +128,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * </pre>
    *
    * <code>string name = 1;</code>
+   *
+   * @return The name.
    */
   public java.lang.String getName() {
     java.lang.Object ref = name_;
@@ -144,6 +151,8 @@ public java.lang.String getName() {
    * </pre>
    *
    * <code>string name = 1;</code>
+   *
+   * @return The bytes for name.
    */
   public com.google.protobuf.ByteString getNameBytes() {
     java.lang.Object ref = name_;
@@ -168,6 +177,8 @@ public com.google.protobuf.ByteString getNameBytes() {
    * </pre>
    *
    * <code>bytes ciphertext = 3;</code>
+   *
+   * @return The ciphertext.
    */
   public com.google.protobuf.ByteString getCiphertext() {
     return ciphertext_;
@@ -515,6 +526,8 @@ public Builder mergeFrom(
      * </pre>
      *
      * <code>string name = 1;</code>
+     *
+     * @return The name.
      */
     public java.lang.String getName() {
       java.lang.Object ref = name_;
@@ -536,6 +549,8 @@ public java.lang.String getName() {
      * </pre>
      *
      * <code>string name = 1;</code>
+     *
+     * @return The bytes for name.
      */
     public com.google.protobuf.ByteString getNameBytes() {
       java.lang.Object ref = name_;
@@ -557,6 +572,9 @@ public com.google.protobuf.ByteString getNameBytes() {
      * </pre>
      *
      * <code>string name = 1;</code>
+     *
+     * @param value The name to set.
+     * @return This builder for chaining.
      */
     public Builder setName(java.lang.String value) {
       if (value == null) {
@@ -576,6 +594,8 @@ public Builder setName(java.lang.String value) {
      * </pre>
      *
      * <code>string name = 1;</code>
+     *
+     * @return This builder for chaining.
      */
     public Builder clearName() {
 
@@ -592,6 +612,9 @@ public Builder clearName() {
      * </pre>
      *
      * <code>string name = 1;</code>
+     *
+     * @param value The bytes for name to set.
+     * @return This builder for chaining.
      */
     public Builder setNameBytes(com.google.protobuf.ByteString value) {
       if (value == null) {
@@ -614,6 +637,8 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      * </pre>
      *
      * <code>bytes ciphertext = 3;</code>
+     *
+     * @return The ciphertext.
      */
     public com.google.protobuf.ByteString getCiphertext() {
       return ciphertext_;
@@ -627,6 +652,9 @@ public com.google.protobuf.ByteString getCiphertext() {
      * </pre>
      *
      * <code>bytes ciphertext = 3;</code>
+     *
+     * @param value The ciphertext to set.
+     * @return This builder for chaining.
      */
     public Builder setCiphertext(com.google.protobuf.ByteString value) {
       if (value == null) {
@@ -646,6 +674,8 @@ public Builder setCiphertext(com.google.protobuf.ByteString value) {
      * </pre>
      *
      * <code>bytes ciphertext = 3;</code>
+     *
+     * @return This builder for chaining.
      */
     public Builder clearCiphertext() {
 

diff --git a/...cloud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricDecryptRequestOrBuilder.java b/...cloud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricDecryptRequestOrBuilder.java
@@ -32,6 +32,8 @@ public interface AsymmetricDecryptRequestOrBuilder
    * </pre>
    *
    * <code>string name = 1;</code>
+   *
+   * @return The name.
    */
   java.lang.String getName();
   /**
@@ -43,6 +45,8 @@ public interface AsymmetricDecryptRequestOrBuilder
    * </pre>
    *
    * <code>string name = 1;</code>
+   *
+   * @return The bytes for name.
    */
   com.google.protobuf.ByteString getNameBytes();
 
@@ -55,6 +59,8 @@ public interface AsymmetricDecryptRequestOrBuilder
    * </pre>
    *
    * <code>bytes ciphertext = 3;</code>
+   *
+   * @return The ciphertext.
    */
   com.google.protobuf.ByteString getCiphertext();
 }
diff --git a/...-google-cloud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricDecryptResponse.java b/...-google-cloud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricDecryptResponse.java
@@ -41,6 +41,12 @@ private AsymmetricDecryptResponse() {
     plaintext_ = com.google.protobuf.ByteString.EMPTY;
   }
 
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new AsymmetricDecryptResponse();
+  }
+
   @java.lang.Override
   public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
     return this.unknownFields;
@@ -54,7 +60,6 @@ private AsymmetricDecryptResponse(
     if (extensionRegistry == null) {
       throw new java.lang.NullPointerException();
     }
-    int mutable_bitField0_ = 0;
     com.google.protobuf.UnknownFieldSet.Builder unknownFields =
         com.google.protobuf.UnknownFieldSet.newBuilder();
     try {
@@ -114,6 +119,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * </pre>
    *
    * <code>bytes plaintext = 1;</code>
+   *
+   * @return The plaintext.
    */
   public com.google.protobuf.ByteString getPlaintext() {
     return plaintext_;
@@ -445,6 +452,8 @@ public Builder mergeFrom(
      * </pre>
      *
      * <code>bytes plaintext = 1;</code>
+     *
+     * @return The plaintext.
      */
     public com.google.protobuf.ByteString getPlaintext() {
       return plaintext_;
@@ -457,6 +466,9 @@ public com.google.protobuf.ByteString getPlaintext() {
      * </pre>
      *
      * <code>bytes plaintext = 1;</code>
+     *
+     * @param value The plaintext to set.
+     * @return This builder for chaining.
      */
     public Builder setPlaintext(com.google.protobuf.ByteString value) {
       if (value == null) {
@@ -475,6 +487,8 @@ public Builder setPlaintext(com.google.protobuf.ByteString value) {
      * </pre>
      *
      * <code>bytes plaintext = 1;</code>
+     *
+     * @return This builder for chaining.
      */
     public Builder clearPlaintext() {
 

diff --git a/...loud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricDecryptResponseOrBuilder.java b/...loud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricDecryptResponseOrBuilder.java
@@ -31,6 +31,8 @@ public interface AsymmetricDecryptResponseOrBuilder
    * </pre>
    *
    * <code>bytes plaintext = 1;</code>
+   *
+   * @return The plaintext.
    */
   com.google.protobuf.ByteString getPlaintext();
 }
diff --git a/proto-google-cloud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricSignRequest.java b/proto-google-cloud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricSignRequest.java
@@ -41,6 +41,12 @@ private AsymmetricSignRequest() {
     name_ = "";
   }
 
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new AsymmetricSignRequest();
+  }
+
   @java.lang.Override
   public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
     return this.unknownFields;
@@ -54,7 +60,6 @@ private AsymmetricSignRequest(
     if (extensionRegistry == null) {
       throw new java.lang.NullPointerException();
     }
-    int mutable_bitField0_ = 0;
     com.google.protobuf.UnknownFieldSet.Builder unknownFields =
         com.google.protobuf.UnknownFieldSet.newBuilder();
     try {
@@ -131,6 +136,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * </pre>
    *
    * <code>string name = 1;</code>
+   *
+   * @return The name.
    */
   public java.lang.String getName() {
     java.lang.Object ref = name_;
@@ -151,6 +158,8 @@ public java.lang.String getName() {
    * </pre>
    *
    * <code>string name = 1;</code>
+   *
+   * @return The bytes for name.
    */
   public com.google.protobuf.ByteString getNameBytes() {
     java.lang.Object ref = name_;
@@ -176,6 +185,8 @@ public com.google.protobuf.ByteString getNameBytes() {
    * </pre>
    *
    * <code>.google.cloud.kms.v1.Digest digest = 3;</code>
+   *
+   * @return Whether the digest field is set.
    */
   public boolean hasDigest() {
     return digest_ != null;
@@ -190,6 +201,8 @@ public boolean hasDigest() {
    * </pre>
    *
    * <code>.google.cloud.kms.v1.Digest digest = 3;</code>
+   *
+   * @return The digest.
    */
   public com.google.cloud.kms.v1.Digest getDigest() {
     return digest_ == null ? com.google.cloud.kms.v1.Digest.getDefaultInstance() : digest_;
@@ -562,6 +575,8 @@ public Builder mergeFrom(
      * </pre>
      *
      * <code>string name = 1;</code>
+     *
+     * @return The name.
      */
     public java.lang.String getName() {
       java.lang.Object ref = name_;
@@ -582,6 +597,8 @@ public java.lang.String getName() {
      * </pre>
      *
      * <code>string name = 1;</code>
+     *
+     * @return The bytes for name.
      */
     public com.google.protobuf.ByteString getNameBytes() {
       java.lang.Object ref = name_;
@@ -602,6 +619,9 @@ public com.google.protobuf.ByteString getNameBytes() {
      * </pre>
      *
      * <code>string name = 1;</code>
+     *
+     * @param value The name to set.
+     * @return This builder for chaining.
      */
     public Builder setName(java.lang.String value) {
       if (value == null) {
@@ -620,6 +640,8 @@ public Builder setName(java.lang.String value) {
      * </pre>
      *
      * <code>string name = 1;</code>
+     *
+     * @return This builder for chaining.
      */
     public Builder clearName() {
 
@@ -635,6 +657,9 @@ public Builder clearName() {
      * </pre>
      *
      * <code>string name = 1;</code>
+     *
+     * @param value The bytes for name to set.
+     * @return This builder for chaining.
      */
     public Builder setNameBytes(com.google.protobuf.ByteString value) {
       if (value == null) {
@@ -663,6 +688,8 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      * </pre>
      *
      * <code>.google.cloud.kms.v1.Digest digest = 3;</code>
+     *
+     * @return Whether the digest field is set.
      */
     public boolean hasDigest() {
       return digestBuilder_ != null || digest_ != null;
@@ -677,6 +704,8 @@ public boolean hasDigest() {
      * </pre>
      *
      * <code>.google.cloud.kms.v1.Digest digest = 3;</code>
+     *
+     * @return The digest.
      */
     public com.google.cloud.kms.v1.Digest getDigest() {
       if (digestBuilder_ == null) {

diff --git a/...le-cloud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricSignRequestOrBuilder.java b/...le-cloud-kms-v1/src/main/java/com/google/cloud/kms/v1/AsymmetricSignRequestOrBuilder.java
@@ -31,6 +31,8 @@ public interface AsymmetricSignRequestOrBuilder
    * </pre>
    *
    * <code>string name = 1;</code>
+   *
+   * @return The name.
    */
   java.lang.String getName();
   /**
@@ -41,6 +43,8 @@ public interface AsymmetricSignRequestOrBuilder
    * </pre>
    *
    * <code>string name = 1;</code>
+   *
+   * @return The bytes for name.
    */
   com.google.protobuf.ByteString getNameBytes();
 
@@ -54,6 +58,8 @@ public interface AsymmetricSignRequestOrBuilder
    * </pre>
    *
    * <code>.google.cloud.kms.v1.Digest digest = 3;</code>
+   *
+   * @return Whether the digest field is set.
    */
   boolean hasDigest();
   /**
@@ -66,6 +72,8 @@ public interface AsymmetricSignRequestOrBuilder
    * </pre>
    *
    * <code>.google.cloud.kms.v1.Digest digest = 3;</code>
+   *
+   * @return The digest.
    */
   com.google.cloud.kms.v1.Digest getDigest();
   /**