diff --git a/showcase/gapic-showcase/pom.xml b/showcase/gapic-showcase/pom.xml index 5ad115cb78..84947ccf66 100644 --- a/showcase/gapic-showcase/pom.xml +++ b/showcase/gapic-showcase/pom.xml @@ -42,6 +42,7 @@ bazel run + --experimental_proto_descriptor_sets_include_source_info //showcase:verify_gapic @@ -70,6 +71,7 @@ bazelisk run + --experimental_proto_descriptor_sets_include_source_info //showcase:update_gapic diff --git a/showcase/grpc-gapic-showcase-v1beta1/pom.xml b/showcase/grpc-gapic-showcase-v1beta1/pom.xml index 8e5f2a09ee..af1bf89017 100644 --- a/showcase/grpc-gapic-showcase-v1beta1/pom.xml +++ b/showcase/grpc-gapic-showcase-v1beta1/pom.xml @@ -37,6 +37,7 @@ bazel run + --experimental_proto_descriptor_sets_include_source_info //showcase:verify_grpc @@ -65,6 +66,7 @@ bazelisk run + --experimental_proto_descriptor_sets_include_source_info //showcase:update_grpc diff --git a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/ComplianceGrpc.java b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/ComplianceGrpc.java index 7ae908a4af..f7369c33f1 100644 --- a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/ComplianceGrpc.java +++ b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/ComplianceGrpc.java @@ -3,6 +3,11 @@ import static io.grpc.MethodDescriptor.generateFullMethodName; /** + * 
+ * This service is used to test that GAPICs implement various REST-related features correctly. This mostly means transcoding proto3 requests to REST format
+ * correctly for various types of HTTP annotations, but it also includes verifying that unknown (numeric) enums received by clients can be round-tripped
+ * correctly.
+ *
*/ @javax.annotation.Generated( value = "by gRPC proto compiler", @@ -370,10 +375,19 @@ public ComplianceFutureStub newStub(io.grpc.Channel channel, io.grpc.CallOptions } /** + * 
+   * This service is used to test that GAPICs implement various REST-related features correctly. This mostly means transcoding proto3 requests to REST format
+   * correctly for various types of HTTP annotations, but it also includes verifying that unknown (numeric) enums received by clients can be round-tripped
+   * correctly.
+   *
*/ public interface AsyncService { /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending the entire request object in the REST body.
+     *
*/ default void repeatDataBody(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -381,6 +395,11 @@ default void repeatDataBody(com.google.showcase.v1beta1.RepeatRequest request, } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending the a message-type field in the REST body. Per AIP-127, only
+     * top-level, non-repeated fields can be sent this way.
+     *
*/ default void repeatDataBodyInfo(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -388,6 +407,10 @@ default void repeatDataBodyInfo(com.google.showcase.v1beta1.RepeatRequest reques } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending all request fields as query parameters.
+     *
*/ default void repeatDataQuery(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -395,6 +418,11 @@ default void repeatDataQuery(com.google.showcase.v1beta1.RepeatRequest request, } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending some parameters as "simple" path variables (i.e., of the form
+     * "/bar/{foo}" rather than "/{foo=bar/*}"), and the rest as query parameters.
+     *
*/ default void repeatDataSimplePath(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -402,6 +430,9 @@ default void repeatDataSimplePath(com.google.showcase.v1beta1.RepeatRequest requ } /** + * 
+     * Same as RepeatDataSimplePath, but with a path resource.
+     *
*/ default void repeatDataPathResource(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -409,6 +440,9 @@ default void repeatDataPathResource(com.google.showcase.v1beta1.RepeatRequest re } /** + * 
+     * Same as RepeatDataSimplePath, but with a trailing resource.
+     *
*/ default void repeatDataPathTrailingResource(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -416,6 +450,9 @@ default void repeatDataPathTrailingResource(com.google.showcase.v1beta1.RepeatRe } /** + * 
+     * This method echoes the ComplianceData request, using the HTTP PUT method.
+     *
*/ default void repeatDataBodyPut(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -423,6 +460,9 @@ default void repeatDataBodyPut(com.google.showcase.v1beta1.RepeatRequest request } /** + * 
+     * This method echoes the ComplianceData request, using the HTTP PATCH method.
+     *
*/ default void repeatDataBodyPatch(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -430,6 +470,13 @@ default void repeatDataBodyPatch(com.google.showcase.v1beta1.RepeatRequest reque } /** + * 
+     * This method requests an enum value from the server. Depending on the contents of EnumRequest, the enum value returned will be a known enum declared in the
+     * .proto file, or a made-up enum value the is unknown to the client. To verify that clients can round-trip unknown enum vaues they receive, use the
+     * response from this RPC as the request to VerifyEnum()
+     * The values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run (this is needed for
+     * VerifyEnum() to work) but are not guaranteed to be the same across separate Showcase server runs.
+     *
*/ default void getEnum(com.google.showcase.v1beta1.EnumRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -437,6 +484,13 @@ default void getEnum(com.google.showcase.v1beta1.EnumRequest request, } /** + * 
+     * This method is used to verify that clients can round-trip enum values, which is particularly important for unknown enum values over REST. VerifyEnum()
+     * verifies that its request, which is presumably the response that the client previously got to a GetEnum(), contains the correct data. If so, it responds
+     * with the same EnumResponse; otherwise, the RPC errors.
+     * This works because the values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run,
+     * although they are not guaranteed to be the same across separate Showcase server runs.
+     *
*/ default void verifyEnum(com.google.showcase.v1beta1.EnumResponse request, io.grpc.stub.StreamObserver responseObserver) { @@ -446,6 +500,11 @@ default void verifyEnum(com.google.showcase.v1beta1.EnumResponse request, /** * Base class for the server implementation of the service Compliance. + * 
+   * This service is used to test that GAPICs implement various REST-related features correctly. This mostly means transcoding proto3 requests to REST format
+   * correctly for various types of HTTP annotations, but it also includes verifying that unknown (numeric) enums received by clients can be round-tripped
+   * correctly.
+   *
*/ public static abstract class ComplianceImplBase implements io.grpc.BindableService, AsyncService { @@ -457,6 +516,11 @@ public static abstract class ComplianceImplBase /** * A stub to allow clients to do asynchronous rpc calls to service Compliance. + * 
+   * This service is used to test that GAPICs implement various REST-related features correctly. This mostly means transcoding proto3 requests to REST format
+   * correctly for various types of HTTP annotations, but it also includes verifying that unknown (numeric) enums received by clients can be round-tripped
+   * correctly.
+   *
*/ public static final class ComplianceStub extends io.grpc.stub.AbstractAsyncStub { @@ -472,6 +536,10 @@ protected ComplianceStub build( } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending the entire request object in the REST body.
+     *
*/ public void repeatDataBody(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -480,6 +548,11 @@ public void repeatDataBody(com.google.showcase.v1beta1.RepeatRequest request, } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending the a message-type field in the REST body. Per AIP-127, only
+     * top-level, non-repeated fields can be sent this way.
+     *
*/ public void repeatDataBodyInfo(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -488,6 +561,10 @@ public void repeatDataBodyInfo(com.google.showcase.v1beta1.RepeatRequest request } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending all request fields as query parameters.
+     *
*/ public void repeatDataQuery(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -496,6 +573,11 @@ public void repeatDataQuery(com.google.showcase.v1beta1.RepeatRequest request, } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending some parameters as "simple" path variables (i.e., of the form
+     * "/bar/{foo}" rather than "/{foo=bar/*}"), and the rest as query parameters.
+     *
*/ public void repeatDataSimplePath(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -504,6 +586,9 @@ public void repeatDataSimplePath(com.google.showcase.v1beta1.RepeatRequest reque } /** + * 
+     * Same as RepeatDataSimplePath, but with a path resource.
+     *
*/ public void repeatDataPathResource(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -512,6 +597,9 @@ public void repeatDataPathResource(com.google.showcase.v1beta1.RepeatRequest req } /** + * 
+     * Same as RepeatDataSimplePath, but with a trailing resource.
+     *
*/ public void repeatDataPathTrailingResource(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -520,6 +608,9 @@ public void repeatDataPathTrailingResource(com.google.showcase.v1beta1.RepeatReq } /** + * 
+     * This method echoes the ComplianceData request, using the HTTP PUT method.
+     *
*/ public void repeatDataBodyPut(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -528,6 +619,9 @@ public void repeatDataBodyPut(com.google.showcase.v1beta1.RepeatRequest request, } /** + * 
+     * This method echoes the ComplianceData request, using the HTTP PATCH method.
+     *
*/ public void repeatDataBodyPatch(com.google.showcase.v1beta1.RepeatRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -536,6 +630,13 @@ public void repeatDataBodyPatch(com.google.showcase.v1beta1.RepeatRequest reques } /** + * 
+     * This method requests an enum value from the server. Depending on the contents of EnumRequest, the enum value returned will be a known enum declared in the
+     * .proto file, or a made-up enum value the is unknown to the client. To verify that clients can round-trip unknown enum vaues they receive, use the
+     * response from this RPC as the request to VerifyEnum()
+     * The values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run (this is needed for
+     * VerifyEnum() to work) but are not guaranteed to be the same across separate Showcase server runs.
+     *
*/ public void getEnum(com.google.showcase.v1beta1.EnumRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -544,6 +645,13 @@ public void getEnum(com.google.showcase.v1beta1.EnumRequest request, } /** + * 
+     * This method is used to verify that clients can round-trip enum values, which is particularly important for unknown enum values over REST. VerifyEnum()
+     * verifies that its request, which is presumably the response that the client previously got to a GetEnum(), contains the correct data. If so, it responds
+     * with the same EnumResponse; otherwise, the RPC errors.
+     * This works because the values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run,
+     * although they are not guaranteed to be the same across separate Showcase server runs.
+     *
*/ public void verifyEnum(com.google.showcase.v1beta1.EnumResponse request, io.grpc.stub.StreamObserver responseObserver) { @@ -554,6 +662,11 @@ public void verifyEnum(com.google.showcase.v1beta1.EnumResponse request, /** * A stub to allow clients to do synchronous rpc calls to service Compliance. + * 
+   * This service is used to test that GAPICs implement various REST-related features correctly. This mostly means transcoding proto3 requests to REST format
+   * correctly for various types of HTTP annotations, but it also includes verifying that unknown (numeric) enums received by clients can be round-tripped
+   * correctly.
+   *
*/ public static final class ComplianceBlockingStub extends io.grpc.stub.AbstractBlockingStub { @@ -569,6 +682,10 @@ protected ComplianceBlockingStub build( } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending the entire request object in the REST body.
+     *
*/ public com.google.showcase.v1beta1.RepeatResponse repeatDataBody(com.google.showcase.v1beta1.RepeatRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -576,6 +693,11 @@ public com.google.showcase.v1beta1.RepeatResponse repeatDataBody(com.google.show } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending the a message-type field in the REST body. Per AIP-127, only
+     * top-level, non-repeated fields can be sent this way.
+     *
*/ public com.google.showcase.v1beta1.RepeatResponse repeatDataBodyInfo(com.google.showcase.v1beta1.RepeatRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -583,6 +705,10 @@ public com.google.showcase.v1beta1.RepeatResponse repeatDataBodyInfo(com.google. } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending all request fields as query parameters.
+     *
*/ public com.google.showcase.v1beta1.RepeatResponse repeatDataQuery(com.google.showcase.v1beta1.RepeatRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -590,6 +716,11 @@ public com.google.showcase.v1beta1.RepeatResponse repeatDataQuery(com.google.sho } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending some parameters as "simple" path variables (i.e., of the form
+     * "/bar/{foo}" rather than "/{foo=bar/*}"), and the rest as query parameters.
+     *
*/ public com.google.showcase.v1beta1.RepeatResponse repeatDataSimplePath(com.google.showcase.v1beta1.RepeatRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -597,6 +728,9 @@ public com.google.showcase.v1beta1.RepeatResponse repeatDataSimplePath(com.googl } /** + * 
+     * Same as RepeatDataSimplePath, but with a path resource.
+     *
*/ public com.google.showcase.v1beta1.RepeatResponse repeatDataPathResource(com.google.showcase.v1beta1.RepeatRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -604,6 +738,9 @@ public com.google.showcase.v1beta1.RepeatResponse repeatDataPathResource(com.goo } /** + * 
+     * Same as RepeatDataSimplePath, but with a trailing resource.
+     *
*/ public com.google.showcase.v1beta1.RepeatResponse repeatDataPathTrailingResource(com.google.showcase.v1beta1.RepeatRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -611,6 +748,9 @@ public com.google.showcase.v1beta1.RepeatResponse repeatDataPathTrailingResource } /** + * 
+     * This method echoes the ComplianceData request, using the HTTP PUT method.
+     *
*/ public com.google.showcase.v1beta1.RepeatResponse repeatDataBodyPut(com.google.showcase.v1beta1.RepeatRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -618,6 +758,9 @@ public com.google.showcase.v1beta1.RepeatResponse repeatDataBodyPut(com.google.s } /** + * 
+     * This method echoes the ComplianceData request, using the HTTP PATCH method.
+     *
*/ public com.google.showcase.v1beta1.RepeatResponse repeatDataBodyPatch(com.google.showcase.v1beta1.RepeatRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -625,6 +768,13 @@ public com.google.showcase.v1beta1.RepeatResponse repeatDataBodyPatch(com.google } /** + * 
+     * This method requests an enum value from the server. Depending on the contents of EnumRequest, the enum value returned will be a known enum declared in the
+     * .proto file, or a made-up enum value the is unknown to the client. To verify that clients can round-trip unknown enum vaues they receive, use the
+     * response from this RPC as the request to VerifyEnum()
+     * The values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run (this is needed for
+     * VerifyEnum() to work) but are not guaranteed to be the same across separate Showcase server runs.
+     *
*/ public com.google.showcase.v1beta1.EnumResponse getEnum(com.google.showcase.v1beta1.EnumRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -632,6 +782,13 @@ public com.google.showcase.v1beta1.EnumResponse getEnum(com.google.showcase.v1be } /** + * 
+     * This method is used to verify that clients can round-trip enum values, which is particularly important for unknown enum values over REST. VerifyEnum()
+     * verifies that its request, which is presumably the response that the client previously got to a GetEnum(), contains the correct data. If so, it responds
+     * with the same EnumResponse; otherwise, the RPC errors.
+     * This works because the values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run,
+     * although they are not guaranteed to be the same across separate Showcase server runs.
+     *
*/ public com.google.showcase.v1beta1.EnumResponse verifyEnum(com.google.showcase.v1beta1.EnumResponse request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -641,6 +798,11 @@ public com.google.showcase.v1beta1.EnumResponse verifyEnum(com.google.showcase.v /** * A stub to allow clients to do ListenableFuture-style rpc calls to service Compliance. + * 
+   * This service is used to test that GAPICs implement various REST-related features correctly. This mostly means transcoding proto3 requests to REST format
+   * correctly for various types of HTTP annotations, but it also includes verifying that unknown (numeric) enums received by clients can be round-tripped
+   * correctly.
+   *
*/ public static final class ComplianceFutureStub extends io.grpc.stub.AbstractFutureStub { @@ -656,6 +818,10 @@ protected ComplianceFutureStub build( } /** + * 
+     * This method echoes the ComplianceData request. This method exercises
+     * sending the entire request object in the REST body.
+     *
*/ public com.google.common.util.concurrent.ListenableFuture repeatDataBody( com.google.showcase.v1beta1.RepeatRequest request) { @@ -664,6 +830,11 @@ public com.google.common.util.concurrent.ListenableFuture + * This method echoes the ComplianceData request. This method exercises + * sending the a message-type field in the REST body. Per AIP-127, only + * top-level, non-repeated fields can be sent this way. + * */ public com.google.common.util.concurrent.ListenableFuture repeatDataBodyInfo( com.google.showcase.v1beta1.RepeatRequest request) { @@ -672,6 +843,10 @@ public com.google.common.util.concurrent.ListenableFuture + * This method echoes the ComplianceData request. This method exercises + * sending all request fields as query parameters. + * */ public com.google.common.util.concurrent.ListenableFuture repeatDataQuery( com.google.showcase.v1beta1.RepeatRequest request) { @@ -680,6 +855,11 @@ public com.google.common.util.concurrent.ListenableFuture + * This method echoes the ComplianceData request. This method exercises + * sending some parameters as "simple" path variables (i.e., of the form + * "/bar/{foo}" rather than "/{foo=bar/*}"), and the rest as query parameters. + * */ public com.google.common.util.concurrent.ListenableFuture repeatDataSimplePath( com.google.showcase.v1beta1.RepeatRequest request) { @@ -688,6 +868,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Same as RepeatDataSimplePath, but with a path resource. + * */ public com.google.common.util.concurrent.ListenableFuture repeatDataPathResource( com.google.showcase.v1beta1.RepeatRequest request) { @@ -696,6 +879,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Same as RepeatDataSimplePath, but with a trailing resource. + * */ public com.google.common.util.concurrent.ListenableFuture repeatDataPathTrailingResource( com.google.showcase.v1beta1.RepeatRequest request) { @@ -704,6 +890,9 @@ public com.google.common.util.concurrent.ListenableFuture + * This method echoes the ComplianceData request, using the HTTP PUT method. + * */ public com.google.common.util.concurrent.ListenableFuture repeatDataBodyPut( com.google.showcase.v1beta1.RepeatRequest request) { @@ -712,6 +901,9 @@ public com.google.common.util.concurrent.ListenableFuture + * This method echoes the ComplianceData request, using the HTTP PATCH method. + * */ public com.google.common.util.concurrent.ListenableFuture repeatDataBodyPatch( com.google.showcase.v1beta1.RepeatRequest request) { @@ -720,6 +912,13 @@ public com.google.common.util.concurrent.ListenableFuture + * This method requests an enum value from the server. Depending on the contents of EnumRequest, the enum value returned will be a known enum declared in the + * .proto file, or a made-up enum value the is unknown to the client. To verify that clients can round-trip unknown enum vaues they receive, use the + * response from this RPC as the request to VerifyEnum() + * The values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run (this is needed for + * VerifyEnum() to work) but are not guaranteed to be the same across separate Showcase server runs. + * */ public com.google.common.util.concurrent.ListenableFuture getEnum( com.google.showcase.v1beta1.EnumRequest request) { @@ -728,6 +927,13 @@ public com.google.common.util.concurrent.ListenableFuture + * This method is used to verify that clients can round-trip enum values, which is particularly important for unknown enum values over REST. VerifyEnum() + * verifies that its request, which is presumably the response that the client previously got to a GetEnum(), contains the correct data. If so, it responds + * with the same EnumResponse; otherwise, the RPC errors. + * This works because the values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run, + * although they are not guaranteed to be the same across separate Showcase server runs. + * */ public com.google.common.util.concurrent.ListenableFuture verifyEnum( com.google.showcase.v1beta1.EnumResponse request) { diff --git a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/EchoGrpc.java b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/EchoGrpc.java index 9c495e57f6..2084c1ff33 100644 --- a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/EchoGrpc.java +++ b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/EchoGrpc.java @@ -3,6 +3,15 @@ import static io.grpc.MethodDescriptor.generateFullMethodName; /** + * 
+ * This service is used showcase the four main types of rpcs - unary, server
+ * side streaming, client side streaming, and bidirectional streaming. This
+ * service also exposes methods that explicitly implement server delay, and
+ * paginated calls. Set the 'showcase-trailer' metadata key on any method
+ * to have the values echoed in the response trailers. Set the 
+ * 'x-goog-request-params' metadata key on any method to have the values
+ * echoed in the response headers.
+ *
*/ @javax.annotation.Generated( value = "by gRPC proto compiler", @@ -339,10 +348,22 @@ public EchoFutureStub newStub(io.grpc.Channel channel, io.grpc.CallOptions callO } /** + * 
+   * This service is used showcase the four main types of rpcs - unary, server
+   * side streaming, client side streaming, and bidirectional streaming. This
+   * service also exposes methods that explicitly implement server delay, and
+   * paginated calls. Set the 'showcase-trailer' metadata key on any method
+   * to have the values echoed in the response trailers. Set the 
+   * 'x-goog-request-params' metadata key on any method to have the values
+   * echoed in the response headers.
+   *
*/ public interface AsyncService { /** + * 
+     * This method simply echoes the request. This method showcases unary RPCs.
+     *
*/ default void echo(com.google.showcase.v1beta1.EchoRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -350,6 +371,10 @@ default void echo(com.google.showcase.v1beta1.EchoRequest request, } /** + * 
+     * This method splits the given content into words and will pass each word back
+     * through the stream. This method showcases server-side streaming RPCs.
+     *
*/ default void expand(com.google.showcase.v1beta1.ExpandRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -357,6 +382,11 @@ default void expand(com.google.showcase.v1beta1.ExpandRequest request, } /** + * 
+     * This method will collect the words given to it. When the stream is closed
+     * by the client, this method will return the a concatenation of the strings
+     * passed to it. This method showcases client-side streaming RPCs.
+     *
*/ default io.grpc.stub.StreamObserver collect( io.grpc.stub.StreamObserver responseObserver) { @@ -364,6 +394,11 @@ default io.grpc.stub.StreamObserver col } /** + * 
+     * This method, upon receiving a request on the stream, will pass the same
+     * content back on the stream. This method showcases bidirectional
+     * streaming RPCs.
+     *
*/ default io.grpc.stub.StreamObserver chat( io.grpc.stub.StreamObserver responseObserver) { @@ -371,6 +406,10 @@ default io.grpc.stub.StreamObserver cha } /** + * 
+     * This is similar to the Expand method but instead of returning a stream of
+     * expanded words, this method returns a paged list of expanded words.
+     *
*/ default void pagedExpand(com.google.showcase.v1beta1.PagedExpandRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -378,6 +417,11 @@ default void pagedExpand(com.google.showcase.v1beta1.PagedExpandRequest request, } /** + * 
+     * This is similar to the PagedExpand except that it uses
+     * max_results instead of page_size, as some legacy APIs still
+     * do. New APIs should NOT use this pattern.
+     *
*/ default void pagedExpandLegacy(com.google.showcase.v1beta1.PagedExpandLegacyRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -385,6 +429,13 @@ default void pagedExpandLegacy(com.google.showcase.v1beta1.PagedExpandLegacyRequ } /** + * 
+     * This method returns a map containing lists of words that appear in the input, keyed by their
+     * initial character. The only words returned are the ones included in the current page,
+     * as determined by page_token and page_size, which both refer to the word indices in the
+     * input. This paging result consisting of a map of lists is a pattern used by some legacy
+     * APIs. New APIs should NOT use this pattern.
+     *
*/ default void pagedExpandLegacyMapped(com.google.showcase.v1beta1.PagedExpandRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -392,6 +443,10 @@ default void pagedExpandLegacyMapped(com.google.showcase.v1beta1.PagedExpandRequ } /** + * 
+     * This method will wait for the requested amount of time and then return.
+     * This method showcases how a client handles a request timeout.
+     *
*/ default void wait(com.google.showcase.v1beta1.WaitRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -399,6 +454,11 @@ default void wait(com.google.showcase.v1beta1.WaitRequest request, } /** + * 
+     * This method will block (wait) for the requested amount of time
+     * and then return the response or error.
+     * This method showcases how a client handles delays or retries.
+     *
*/ default void block(com.google.showcase.v1beta1.BlockRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -408,6 +468,15 @@ default void block(com.google.showcase.v1beta1.BlockRequest request, /** * Base class for the server implementation of the service Echo. + * 
+   * This service is used showcase the four main types of rpcs - unary, server
+   * side streaming, client side streaming, and bidirectional streaming. This
+   * service also exposes methods that explicitly implement server delay, and
+   * paginated calls. Set the 'showcase-trailer' metadata key on any method
+   * to have the values echoed in the response trailers. Set the 
+   * 'x-goog-request-params' metadata key on any method to have the values
+   * echoed in the response headers.
+   *
*/ public static abstract class EchoImplBase implements io.grpc.BindableService, AsyncService { @@ -419,6 +488,15 @@ public static abstract class EchoImplBase /** * A stub to allow clients to do asynchronous rpc calls to service Echo. + * 
+   * This service is used showcase the four main types of rpcs - unary, server
+   * side streaming, client side streaming, and bidirectional streaming. This
+   * service also exposes methods that explicitly implement server delay, and
+   * paginated calls. Set the 'showcase-trailer' metadata key on any method
+   * to have the values echoed in the response trailers. Set the 
+   * 'x-goog-request-params' metadata key on any method to have the values
+   * echoed in the response headers.
+   *
*/ public static final class EchoStub extends io.grpc.stub.AbstractAsyncStub { @@ -434,6 +512,9 @@ protected EchoStub build( } /** + * 
+     * This method simply echoes the request. This method showcases unary RPCs.
+     *
*/ public void echo(com.google.showcase.v1beta1.EchoRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -442,6 +523,10 @@ public void echo(com.google.showcase.v1beta1.EchoRequest request, } /** + * 
+     * This method splits the given content into words and will pass each word back
+     * through the stream. This method showcases server-side streaming RPCs.
+     *
*/ public void expand(com.google.showcase.v1beta1.ExpandRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -450,6 +535,11 @@ public void expand(com.google.showcase.v1beta1.ExpandRequest request, } /** + * 
+     * This method will collect the words given to it. When the stream is closed
+     * by the client, this method will return the a concatenation of the strings
+     * passed to it. This method showcases client-side streaming RPCs.
+     *
*/ public io.grpc.stub.StreamObserver collect( io.grpc.stub.StreamObserver responseObserver) { @@ -458,6 +548,11 @@ public io.grpc.stub.StreamObserver coll } /** + * 
+     * This method, upon receiving a request on the stream, will pass the same
+     * content back on the stream. This method showcases bidirectional
+     * streaming RPCs.
+     *
*/ public io.grpc.stub.StreamObserver chat( io.grpc.stub.StreamObserver responseObserver) { @@ -466,6 +561,10 @@ public io.grpc.stub.StreamObserver chat } /** + * 
+     * This is similar to the Expand method but instead of returning a stream of
+     * expanded words, this method returns a paged list of expanded words.
+     *
*/ public void pagedExpand(com.google.showcase.v1beta1.PagedExpandRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -474,6 +573,11 @@ public void pagedExpand(com.google.showcase.v1beta1.PagedExpandRequest request, } /** + * 
+     * This is similar to the PagedExpand except that it uses
+     * max_results instead of page_size, as some legacy APIs still
+     * do. New APIs should NOT use this pattern.
+     *
*/ public void pagedExpandLegacy(com.google.showcase.v1beta1.PagedExpandLegacyRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -482,6 +586,13 @@ public void pagedExpandLegacy(com.google.showcase.v1beta1.PagedExpandLegacyReque } /** + * 
+     * This method returns a map containing lists of words that appear in the input, keyed by their
+     * initial character. The only words returned are the ones included in the current page,
+     * as determined by page_token and page_size, which both refer to the word indices in the
+     * input. This paging result consisting of a map of lists is a pattern used by some legacy
+     * APIs. New APIs should NOT use this pattern.
+     *
*/ public void pagedExpandLegacyMapped(com.google.showcase.v1beta1.PagedExpandRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -490,6 +601,10 @@ public void pagedExpandLegacyMapped(com.google.showcase.v1beta1.PagedExpandReque } /** + * 
+     * This method will wait for the requested amount of time and then return.
+     * This method showcases how a client handles a request timeout.
+     *
*/ public void wait(com.google.showcase.v1beta1.WaitRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -498,6 +613,11 @@ public void wait(com.google.showcase.v1beta1.WaitRequest request, } /** + * 
+     * This method will block (wait) for the requested amount of time
+     * and then return the response or error.
+     * This method showcases how a client handles delays or retries.
+     *
*/ public void block(com.google.showcase.v1beta1.BlockRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -508,6 +628,15 @@ public void block(com.google.showcase.v1beta1.BlockRequest request, /** * A stub to allow clients to do synchronous rpc calls to service Echo. + * 
+   * This service is used showcase the four main types of rpcs - unary, server
+   * side streaming, client side streaming, and bidirectional streaming. This
+   * service also exposes methods that explicitly implement server delay, and
+   * paginated calls. Set the 'showcase-trailer' metadata key on any method
+   * to have the values echoed in the response trailers. Set the 
+   * 'x-goog-request-params' metadata key on any method to have the values
+   * echoed in the response headers.
+   *
*/ public static final class EchoBlockingStub extends io.grpc.stub.AbstractBlockingStub { @@ -523,6 +652,9 @@ protected EchoBlockingStub build( } /** + * 
+     * This method simply echoes the request. This method showcases unary RPCs.
+     *
*/ public com.google.showcase.v1beta1.EchoResponse echo(com.google.showcase.v1beta1.EchoRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -530,6 +662,10 @@ public com.google.showcase.v1beta1.EchoResponse echo(com.google.showcase.v1beta1 } /** + * 
+     * This method splits the given content into words and will pass each word back
+     * through the stream. This method showcases server-side streaming RPCs.
+     *
*/ public java.util.Iterator expand( com.google.showcase.v1beta1.ExpandRequest request) { @@ -538,6 +674,10 @@ public java.util.Iterator expand( } /** + * 
+     * This is similar to the Expand method but instead of returning a stream of
+     * expanded words, this method returns a paged list of expanded words.
+     *
*/ public com.google.showcase.v1beta1.PagedExpandResponse pagedExpand(com.google.showcase.v1beta1.PagedExpandRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -545,6 +685,11 @@ public com.google.showcase.v1beta1.PagedExpandResponse pagedExpand(com.google.sh } /** + * 
+     * This is similar to the PagedExpand except that it uses
+     * max_results instead of page_size, as some legacy APIs still
+     * do. New APIs should NOT use this pattern.
+     *
*/ public com.google.showcase.v1beta1.PagedExpandResponse pagedExpandLegacy(com.google.showcase.v1beta1.PagedExpandLegacyRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -552,6 +697,13 @@ public com.google.showcase.v1beta1.PagedExpandResponse pagedExpandLegacy(com.goo } /** + * 
+     * This method returns a map containing lists of words that appear in the input, keyed by their
+     * initial character. The only words returned are the ones included in the current page,
+     * as determined by page_token and page_size, which both refer to the word indices in the
+     * input. This paging result consisting of a map of lists is a pattern used by some legacy
+     * APIs. New APIs should NOT use this pattern.
+     *
*/ public com.google.showcase.v1beta1.PagedExpandLegacyMappedResponse pagedExpandLegacyMapped(com.google.showcase.v1beta1.PagedExpandRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -559,6 +711,10 @@ public com.google.showcase.v1beta1.PagedExpandLegacyMappedResponse pagedExpandLe } /** + * 
+     * This method will wait for the requested amount of time and then return.
+     * This method showcases how a client handles a request timeout.
+     *
*/ public com.google.longrunning.Operation wait(com.google.showcase.v1beta1.WaitRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -566,6 +722,11 @@ public com.google.longrunning.Operation wait(com.google.showcase.v1beta1.WaitReq } /** + * 
+     * This method will block (wait) for the requested amount of time
+     * and then return the response or error.
+     * This method showcases how a client handles delays or retries.
+     *
*/ public com.google.showcase.v1beta1.BlockResponse block(com.google.showcase.v1beta1.BlockRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -575,6 +736,15 @@ public com.google.showcase.v1beta1.BlockResponse block(com.google.showcase.v1bet /** * A stub to allow clients to do ListenableFuture-style rpc calls to service Echo. + * 
+   * This service is used showcase the four main types of rpcs - unary, server
+   * side streaming, client side streaming, and bidirectional streaming. This
+   * service also exposes methods that explicitly implement server delay, and
+   * paginated calls. Set the 'showcase-trailer' metadata key on any method
+   * to have the values echoed in the response trailers. Set the 
+   * 'x-goog-request-params' metadata key on any method to have the values
+   * echoed in the response headers.
+   *
*/ public static final class EchoFutureStub extends io.grpc.stub.AbstractFutureStub { @@ -590,6 +760,9 @@ protected EchoFutureStub build( } /** + * 
+     * This method simply echoes the request. This method showcases unary RPCs.
+     *
*/ public com.google.common.util.concurrent.ListenableFuture echo( com.google.showcase.v1beta1.EchoRequest request) { @@ -598,6 +771,10 @@ public com.google.common.util.concurrent.ListenableFuture + * This is similar to the Expand method but instead of returning a stream of + * expanded words, this method returns a paged list of expanded words. + * */ public com.google.common.util.concurrent.ListenableFuture pagedExpand( com.google.showcase.v1beta1.PagedExpandRequest request) { @@ -606,6 +783,11 @@ public com.google.common.util.concurrent.ListenableFuture + * This is similar to the PagedExpand except that it uses + * max_results instead of page_size, as some legacy APIs still + * do. New APIs should NOT use this pattern. + * */ public com.google.common.util.concurrent.ListenableFuture pagedExpandLegacy( com.google.showcase.v1beta1.PagedExpandLegacyRequest request) { @@ -614,6 +796,13 @@ public com.google.common.util.concurrent.ListenableFuture + * This method returns a map containing lists of words that appear in the input, keyed by their + * initial character. The only words returned are the ones included in the current page, + * as determined by page_token and page_size, which both refer to the word indices in the + * input. This paging result consisting of a map of lists is a pattern used by some legacy + * APIs. New APIs should NOT use this pattern. + * */ public com.google.common.util.concurrent.ListenableFuture pagedExpandLegacyMapped( com.google.showcase.v1beta1.PagedExpandRequest request) { @@ -622,6 +811,10 @@ public com.google.common.util.concurrent.ListenableFuture + * This method will wait for the requested amount of time and then return. + * This method showcases how a client handles a request timeout. + * */ public com.google.common.util.concurrent.ListenableFuture wait( com.google.showcase.v1beta1.WaitRequest request) { @@ -630,6 +823,11 @@ public com.google.common.util.concurrent.ListenableFuture + * This method will block (wait) for the requested amount of time + * and then return the response or error. + * This method showcases how a client handles delays or retries. + * */ public com.google.common.util.concurrent.ListenableFuture block( com.google.showcase.v1beta1.BlockRequest request) { diff --git a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/IdentityGrpc.java b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/IdentityGrpc.java index 20af65d81c..32874ee8e3 100644 --- a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/IdentityGrpc.java +++ b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/IdentityGrpc.java @@ -3,6 +3,9 @@ import static io.grpc.MethodDescriptor.generateFullMethodName; /** + * 
+ * A simple identity service.
+ *
*/ @javax.annotation.Generated( value = "by gRPC proto compiler", @@ -215,10 +218,16 @@ public IdentityFutureStub newStub(io.grpc.Channel channel, io.grpc.CallOptions c } /** + * 
+   * A simple identity service.
+   *
*/ public interface AsyncService { /** + * 
+     * Creates a user.
+     *
*/ default void createUser(com.google.showcase.v1beta1.CreateUserRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -226,6 +235,9 @@ default void createUser(com.google.showcase.v1beta1.CreateUserRequest request, } /** + * 
+     * Retrieves the User with the given uri.
+     *
*/ default void getUser(com.google.showcase.v1beta1.GetUserRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -233,6 +245,9 @@ default void getUser(com.google.showcase.v1beta1.GetUserRequest request, } /** + * 
+     * Updates a user.
+     *
*/ default void updateUser(com.google.showcase.v1beta1.UpdateUserRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -240,6 +255,9 @@ default void updateUser(com.google.showcase.v1beta1.UpdateUserRequest request, } /** + * 
+     * Deletes a user, their profile, and all of their authored messages.
+     *
*/ default void deleteUser(com.google.showcase.v1beta1.DeleteUserRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -247,6 +265,9 @@ default void deleteUser(com.google.showcase.v1beta1.DeleteUserRequest request, } /** + * 
+     * Lists all users.
+     *
*/ default void listUsers(com.google.showcase.v1beta1.ListUsersRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -256,6 +277,9 @@ default void listUsers(com.google.showcase.v1beta1.ListUsersRequest request, /** * Base class for the server implementation of the service Identity. + * 
+   * A simple identity service.
+   *
*/ public static abstract class IdentityImplBase implements io.grpc.BindableService, AsyncService { @@ -267,6 +291,9 @@ public static abstract class IdentityImplBase /** * A stub to allow clients to do asynchronous rpc calls to service Identity. + * 
+   * A simple identity service.
+   *
*/ public static final class IdentityStub extends io.grpc.stub.AbstractAsyncStub { @@ -282,6 +309,9 @@ protected IdentityStub build( } /** + * 
+     * Creates a user.
+     *
*/ public void createUser(com.google.showcase.v1beta1.CreateUserRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -290,6 +320,9 @@ public void createUser(com.google.showcase.v1beta1.CreateUserRequest request, } /** + * 
+     * Retrieves the User with the given uri.
+     *
*/ public void getUser(com.google.showcase.v1beta1.GetUserRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -298,6 +331,9 @@ public void getUser(com.google.showcase.v1beta1.GetUserRequest request, } /** + * 
+     * Updates a user.
+     *
*/ public void updateUser(com.google.showcase.v1beta1.UpdateUserRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -306,6 +342,9 @@ public void updateUser(com.google.showcase.v1beta1.UpdateUserRequest request, } /** + * 
+     * Deletes a user, their profile, and all of their authored messages.
+     *
*/ public void deleteUser(com.google.showcase.v1beta1.DeleteUserRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -314,6 +353,9 @@ public void deleteUser(com.google.showcase.v1beta1.DeleteUserRequest request, } /** + * 
+     * Lists all users.
+     *
*/ public void listUsers(com.google.showcase.v1beta1.ListUsersRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -324,6 +366,9 @@ public void listUsers(com.google.showcase.v1beta1.ListUsersRequest request, /** * A stub to allow clients to do synchronous rpc calls to service Identity. + * 
+   * A simple identity service.
+   *
*/ public static final class IdentityBlockingStub extends io.grpc.stub.AbstractBlockingStub { @@ -339,6 +384,9 @@ protected IdentityBlockingStub build( } /** + * 
+     * Creates a user.
+     *
*/ public com.google.showcase.v1beta1.User createUser(com.google.showcase.v1beta1.CreateUserRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -346,6 +394,9 @@ public com.google.showcase.v1beta1.User createUser(com.google.showcase.v1beta1.C } /** + * 
+     * Retrieves the User with the given uri.
+     *
*/ public com.google.showcase.v1beta1.User getUser(com.google.showcase.v1beta1.GetUserRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -353,6 +404,9 @@ public com.google.showcase.v1beta1.User getUser(com.google.showcase.v1beta1.GetU } /** + * 
+     * Updates a user.
+     *
*/ public com.google.showcase.v1beta1.User updateUser(com.google.showcase.v1beta1.UpdateUserRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -360,6 +414,9 @@ public com.google.showcase.v1beta1.User updateUser(com.google.showcase.v1beta1.U } /** + * 
+     * Deletes a user, their profile, and all of their authored messages.
+     *
*/ public com.google.protobuf.Empty deleteUser(com.google.showcase.v1beta1.DeleteUserRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -367,6 +424,9 @@ public com.google.protobuf.Empty deleteUser(com.google.showcase.v1beta1.DeleteUs } /** + * 
+     * Lists all users.
+     *
*/ public com.google.showcase.v1beta1.ListUsersResponse listUsers(com.google.showcase.v1beta1.ListUsersRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -376,6 +436,9 @@ public com.google.showcase.v1beta1.ListUsersResponse listUsers(com.google.showca /** * A stub to allow clients to do ListenableFuture-style rpc calls to service Identity. + * 
+   * A simple identity service.
+   *
*/ public static final class IdentityFutureStub extends io.grpc.stub.AbstractFutureStub { @@ -391,6 +454,9 @@ protected IdentityFutureStub build( } /** + * 
+     * Creates a user.
+     *
*/ public com.google.common.util.concurrent.ListenableFuture createUser( com.google.showcase.v1beta1.CreateUserRequest request) { @@ -399,6 +465,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Retrieves the User with the given uri. + * */ public com.google.common.util.concurrent.ListenableFuture getUser( com.google.showcase.v1beta1.GetUserRequest request) { @@ -407,6 +476,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Updates a user. + * */ public com.google.common.util.concurrent.ListenableFuture updateUser( com.google.showcase.v1beta1.UpdateUserRequest request) { @@ -415,6 +487,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Deletes a user, their profile, and all of their authored messages. + * */ public com.google.common.util.concurrent.ListenableFuture deleteUser( com.google.showcase.v1beta1.DeleteUserRequest request) { @@ -423,6 +498,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Lists all users. + * */ public com.google.common.util.concurrent.ListenableFuture listUsers( com.google.showcase.v1beta1.ListUsersRequest request) { diff --git a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/MessagingGrpc.java b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/MessagingGrpc.java index c509c57d1a..3e5c74b8c2 100644 --- a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/MessagingGrpc.java +++ b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/MessagingGrpc.java @@ -3,6 +3,11 @@ import static io.grpc.MethodDescriptor.generateFullMethodName; /** + * 
+ * A simple messaging service that implements chat rooms and profile posts.
+ * This messaging service showcases the features that API clients
+ * generated by gapic-generators implement.
+ *
*/ @javax.annotation.Generated( value = "by gRPC proto compiler", @@ -494,10 +499,18 @@ public MessagingFutureStub newStub(io.grpc.Channel channel, io.grpc.CallOptions } /** + * 
+   * A simple messaging service that implements chat rooms and profile posts.
+   * This messaging service showcases the features that API clients
+   * generated by gapic-generators implement.
+   *
*/ public interface AsyncService { /** + * 
+     * Creates a room.
+     *
*/ default void createRoom(com.google.showcase.v1beta1.CreateRoomRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -505,6 +518,9 @@ default void createRoom(com.google.showcase.v1beta1.CreateRoomRequest request, } /** + * 
+     * Retrieves the Room with the given resource name.
+     *
*/ default void getRoom(com.google.showcase.v1beta1.GetRoomRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -512,6 +528,9 @@ default void getRoom(com.google.showcase.v1beta1.GetRoomRequest request, } /** + * 
+     * Updates a room.
+     *
*/ default void updateRoom(com.google.showcase.v1beta1.UpdateRoomRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -519,6 +538,9 @@ default void updateRoom(com.google.showcase.v1beta1.UpdateRoomRequest request, } /** + * 
+     * Deletes a room and all of its blurbs.
+     *
*/ default void deleteRoom(com.google.showcase.v1beta1.DeleteRoomRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -526,6 +548,9 @@ default void deleteRoom(com.google.showcase.v1beta1.DeleteRoomRequest request, } /** + * 
+     * Lists all chat rooms.
+     *
*/ default void listRooms(com.google.showcase.v1beta1.ListRoomsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -533,6 +558,11 @@ default void listRooms(com.google.showcase.v1beta1.ListRoomsRequest request, } /** + * 
+     * Creates a blurb. If the parent is a room, the blurb is understood to be a
+     * message in that room. If the parent is a profile, the blurb is understood
+     * to be a post on the profile.
+     *
*/ default void createBlurb(com.google.showcase.v1beta1.CreateBlurbRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -540,6 +570,9 @@ default void createBlurb(com.google.showcase.v1beta1.CreateBlurbRequest request, } /** + * 
+     * Retrieves the Blurb with the given resource name.
+     *
*/ default void getBlurb(com.google.showcase.v1beta1.GetBlurbRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -547,6 +580,9 @@ default void getBlurb(com.google.showcase.v1beta1.GetBlurbRequest request, } /** + * 
+     * Updates a blurb.
+     *
*/ default void updateBlurb(com.google.showcase.v1beta1.UpdateBlurbRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -554,6 +590,9 @@ default void updateBlurb(com.google.showcase.v1beta1.UpdateBlurbRequest request, } /** + * 
+     * Deletes a blurb.
+     *
*/ default void deleteBlurb(com.google.showcase.v1beta1.DeleteBlurbRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -561,6 +600,10 @@ default void deleteBlurb(com.google.showcase.v1beta1.DeleteBlurbRequest request, } /** + * 
+     * Lists blurbs for a specific chat room or user profile depending on the
+     * parent resource name.
+     *
*/ default void listBlurbs(com.google.showcase.v1beta1.ListBlurbsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -568,6 +611,11 @@ default void listBlurbs(com.google.showcase.v1beta1.ListBlurbsRequest request, } /** + * 
+     * This method searches through all blurbs across all rooms and profiles
+     * for blurbs containing to words found in the query. Only posts that
+     * contain an exact match of a queried word will be returned.
+     *
*/ default void searchBlurbs(com.google.showcase.v1beta1.SearchBlurbsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -575,6 +623,10 @@ default void searchBlurbs(com.google.showcase.v1beta1.SearchBlurbsRequest reques } /** + * 
+     * This returns a stream that emits the blurbs that are created for a
+     * particular chat room or user profile.
+     *
*/ default void streamBlurbs(com.google.showcase.v1beta1.StreamBlurbsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -582,6 +634,10 @@ default void streamBlurbs(com.google.showcase.v1beta1.StreamBlurbsRequest reques } /** + * 
+     * This is a stream to create multiple blurbs. If an invalid blurb is
+     * requested to be created, the stream will close with an error.
+     *
*/ default io.grpc.stub.StreamObserver sendBlurbs( io.grpc.stub.StreamObserver responseObserver) { @@ -589,6 +645,12 @@ default io.grpc.stub.StreamObserver + * This method starts a bidirectional stream that receives all blurbs that + * are being created after the stream has started and sends requests to create + * blurbs. If an invalid blurb is requested to be created, the stream will + * close with an error. + * */ default io.grpc.stub.StreamObserver connect( io.grpc.stub.StreamObserver responseObserver) { @@ -598,6 +660,11 @@ default io.grpc.stub.StreamObserver /** * Base class for the server implementation of the service Messaging. + * 
+   * A simple messaging service that implements chat rooms and profile posts.
+   * This messaging service showcases the features that API clients
+   * generated by gapic-generators implement.
+   *
*/ public static abstract class MessagingImplBase implements io.grpc.BindableService, AsyncService { @@ -609,6 +676,11 @@ public static abstract class MessagingImplBase /** * A stub to allow clients to do asynchronous rpc calls to service Messaging. + * 
+   * A simple messaging service that implements chat rooms and profile posts.
+   * This messaging service showcases the features that API clients
+   * generated by gapic-generators implement.
+   *
*/ public static final class MessagingStub extends io.grpc.stub.AbstractAsyncStub { @@ -624,6 +696,9 @@ protected MessagingStub build( } /** + * 
+     * Creates a room.
+     *
*/ public void createRoom(com.google.showcase.v1beta1.CreateRoomRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -632,6 +707,9 @@ public void createRoom(com.google.showcase.v1beta1.CreateRoomRequest request, } /** + * 
+     * Retrieves the Room with the given resource name.
+     *
*/ public void getRoom(com.google.showcase.v1beta1.GetRoomRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -640,6 +718,9 @@ public void getRoom(com.google.showcase.v1beta1.GetRoomRequest request, } /** + * 
+     * Updates a room.
+     *
*/ public void updateRoom(com.google.showcase.v1beta1.UpdateRoomRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -648,6 +729,9 @@ public void updateRoom(com.google.showcase.v1beta1.UpdateRoomRequest request, } /** + * 
+     * Deletes a room and all of its blurbs.
+     *
*/ public void deleteRoom(com.google.showcase.v1beta1.DeleteRoomRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -656,6 +740,9 @@ public void deleteRoom(com.google.showcase.v1beta1.DeleteRoomRequest request, } /** + * 
+     * Lists all chat rooms.
+     *
*/ public void listRooms(com.google.showcase.v1beta1.ListRoomsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -664,6 +751,11 @@ public void listRooms(com.google.showcase.v1beta1.ListRoomsRequest request, } /** + * 
+     * Creates a blurb. If the parent is a room, the blurb is understood to be a
+     * message in that room. If the parent is a profile, the blurb is understood
+     * to be a post on the profile.
+     *
*/ public void createBlurb(com.google.showcase.v1beta1.CreateBlurbRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -672,6 +764,9 @@ public void createBlurb(com.google.showcase.v1beta1.CreateBlurbRequest request, } /** + * 
+     * Retrieves the Blurb with the given resource name.
+     *
*/ public void getBlurb(com.google.showcase.v1beta1.GetBlurbRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -680,6 +775,9 @@ public void getBlurb(com.google.showcase.v1beta1.GetBlurbRequest request, } /** + * 
+     * Updates a blurb.
+     *
*/ public void updateBlurb(com.google.showcase.v1beta1.UpdateBlurbRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -688,6 +786,9 @@ public void updateBlurb(com.google.showcase.v1beta1.UpdateBlurbRequest request, } /** + * 
+     * Deletes a blurb.
+     *
*/ public void deleteBlurb(com.google.showcase.v1beta1.DeleteBlurbRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -696,6 +797,10 @@ public void deleteBlurb(com.google.showcase.v1beta1.DeleteBlurbRequest request, } /** + * 
+     * Lists blurbs for a specific chat room or user profile depending on the
+     * parent resource name.
+     *
*/ public void listBlurbs(com.google.showcase.v1beta1.ListBlurbsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -704,6 +809,11 @@ public void listBlurbs(com.google.showcase.v1beta1.ListBlurbsRequest request, } /** + * 
+     * This method searches through all blurbs across all rooms and profiles
+     * for blurbs containing to words found in the query. Only posts that
+     * contain an exact match of a queried word will be returned.
+     *
*/ public void searchBlurbs(com.google.showcase.v1beta1.SearchBlurbsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -712,6 +822,10 @@ public void searchBlurbs(com.google.showcase.v1beta1.SearchBlurbsRequest request } /** + * 
+     * This returns a stream that emits the blurbs that are created for a
+     * particular chat room or user profile.
+     *
*/ public void streamBlurbs(com.google.showcase.v1beta1.StreamBlurbsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -720,6 +834,10 @@ public void streamBlurbs(com.google.showcase.v1beta1.StreamBlurbsRequest request } /** + * 
+     * This is a stream to create multiple blurbs. If an invalid blurb is
+     * requested to be created, the stream will close with an error.
+     *
*/ public io.grpc.stub.StreamObserver sendBlurbs( io.grpc.stub.StreamObserver responseObserver) { @@ -728,6 +846,12 @@ public io.grpc.stub.StreamObserver + * This method starts a bidirectional stream that receives all blurbs that + * are being created after the stream has started and sends requests to create + * blurbs. If an invalid blurb is requested to be created, the stream will + * close with an error. + * */ public io.grpc.stub.StreamObserver connect( io.grpc.stub.StreamObserver responseObserver) { @@ -738,6 +862,11 @@ public io.grpc.stub.StreamObserver c /** * A stub to allow clients to do synchronous rpc calls to service Messaging. + * 
+   * A simple messaging service that implements chat rooms and profile posts.
+   * This messaging service showcases the features that API clients
+   * generated by gapic-generators implement.
+   *
*/ public static final class MessagingBlockingStub extends io.grpc.stub.AbstractBlockingStub { @@ -753,6 +882,9 @@ protected MessagingBlockingStub build( } /** + * 
+     * Creates a room.
+     *
*/ public com.google.showcase.v1beta1.Room createRoom(com.google.showcase.v1beta1.CreateRoomRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -760,6 +892,9 @@ public com.google.showcase.v1beta1.Room createRoom(com.google.showcase.v1beta1.C } /** + * 
+     * Retrieves the Room with the given resource name.
+     *
*/ public com.google.showcase.v1beta1.Room getRoom(com.google.showcase.v1beta1.GetRoomRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -767,6 +902,9 @@ public com.google.showcase.v1beta1.Room getRoom(com.google.showcase.v1beta1.GetR } /** + * 
+     * Updates a room.
+     *
*/ public com.google.showcase.v1beta1.Room updateRoom(com.google.showcase.v1beta1.UpdateRoomRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -774,6 +912,9 @@ public com.google.showcase.v1beta1.Room updateRoom(com.google.showcase.v1beta1.U } /** + * 
+     * Deletes a room and all of its blurbs.
+     *
*/ public com.google.protobuf.Empty deleteRoom(com.google.showcase.v1beta1.DeleteRoomRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -781,6 +922,9 @@ public com.google.protobuf.Empty deleteRoom(com.google.showcase.v1beta1.DeleteRo } /** + * 
+     * Lists all chat rooms.
+     *
*/ public com.google.showcase.v1beta1.ListRoomsResponse listRooms(com.google.showcase.v1beta1.ListRoomsRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -788,6 +932,11 @@ public com.google.showcase.v1beta1.ListRoomsResponse listRooms(com.google.showca } /** + * 
+     * Creates a blurb. If the parent is a room, the blurb is understood to be a
+     * message in that room. If the parent is a profile, the blurb is understood
+     * to be a post on the profile.
+     *
*/ public com.google.showcase.v1beta1.Blurb createBlurb(com.google.showcase.v1beta1.CreateBlurbRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -795,6 +944,9 @@ public com.google.showcase.v1beta1.Blurb createBlurb(com.google.showcase.v1beta1 } /** + * 
+     * Retrieves the Blurb with the given resource name.
+     *
*/ public com.google.showcase.v1beta1.Blurb getBlurb(com.google.showcase.v1beta1.GetBlurbRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -802,6 +954,9 @@ public com.google.showcase.v1beta1.Blurb getBlurb(com.google.showcase.v1beta1.Ge } /** + * 
+     * Updates a blurb.
+     *
*/ public com.google.showcase.v1beta1.Blurb updateBlurb(com.google.showcase.v1beta1.UpdateBlurbRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -809,6 +964,9 @@ public com.google.showcase.v1beta1.Blurb updateBlurb(com.google.showcase.v1beta1 } /** + * 
+     * Deletes a blurb.
+     *
*/ public com.google.protobuf.Empty deleteBlurb(com.google.showcase.v1beta1.DeleteBlurbRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -816,6 +974,10 @@ public com.google.protobuf.Empty deleteBlurb(com.google.showcase.v1beta1.DeleteB } /** + * 
+     * Lists blurbs for a specific chat room or user profile depending on the
+     * parent resource name.
+     *
*/ public com.google.showcase.v1beta1.ListBlurbsResponse listBlurbs(com.google.showcase.v1beta1.ListBlurbsRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -823,6 +985,11 @@ public com.google.showcase.v1beta1.ListBlurbsResponse listBlurbs(com.google.show } /** + * 
+     * This method searches through all blurbs across all rooms and profiles
+     * for blurbs containing to words found in the query. Only posts that
+     * contain an exact match of a queried word will be returned.
+     *
*/ public com.google.longrunning.Operation searchBlurbs(com.google.showcase.v1beta1.SearchBlurbsRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -830,6 +997,10 @@ public com.google.longrunning.Operation searchBlurbs(com.google.showcase.v1beta1 } /** + * 
+     * This returns a stream that emits the blurbs that are created for a
+     * particular chat room or user profile.
+     *
*/ public java.util.Iterator streamBlurbs( com.google.showcase.v1beta1.StreamBlurbsRequest request) { @@ -840,6 +1011,11 @@ public java.util.Iterator stre /** * A stub to allow clients to do ListenableFuture-style rpc calls to service Messaging. + * 
+   * A simple messaging service that implements chat rooms and profile posts.
+   * This messaging service showcases the features that API clients
+   * generated by gapic-generators implement.
+   *
*/ public static final class MessagingFutureStub extends io.grpc.stub.AbstractFutureStub { @@ -855,6 +1031,9 @@ protected MessagingFutureStub build( } /** + * 
+     * Creates a room.
+     *
*/ public com.google.common.util.concurrent.ListenableFuture createRoom( com.google.showcase.v1beta1.CreateRoomRequest request) { @@ -863,6 +1042,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Retrieves the Room with the given resource name. + * */ public com.google.common.util.concurrent.ListenableFuture getRoom( com.google.showcase.v1beta1.GetRoomRequest request) { @@ -871,6 +1053,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Updates a room. + * */ public com.google.common.util.concurrent.ListenableFuture updateRoom( com.google.showcase.v1beta1.UpdateRoomRequest request) { @@ -879,6 +1064,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Deletes a room and all of its blurbs. + * */ public com.google.common.util.concurrent.ListenableFuture deleteRoom( com.google.showcase.v1beta1.DeleteRoomRequest request) { @@ -887,6 +1075,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Lists all chat rooms. + * */ public com.google.common.util.concurrent.ListenableFuture listRooms( com.google.showcase.v1beta1.ListRoomsRequest request) { @@ -895,6 +1086,11 @@ public com.google.common.util.concurrent.ListenableFuture + * Creates a blurb. If the parent is a room, the blurb is understood to be a + * message in that room. If the parent is a profile, the blurb is understood + * to be a post on the profile. + * */ public com.google.common.util.concurrent.ListenableFuture createBlurb( com.google.showcase.v1beta1.CreateBlurbRequest request) { @@ -903,6 +1099,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Retrieves the Blurb with the given resource name. + * */ public com.google.common.util.concurrent.ListenableFuture getBlurb( com.google.showcase.v1beta1.GetBlurbRequest request) { @@ -911,6 +1110,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Updates a blurb. + * */ public com.google.common.util.concurrent.ListenableFuture updateBlurb( com.google.showcase.v1beta1.UpdateBlurbRequest request) { @@ -919,6 +1121,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Deletes a blurb. + * */ public com.google.common.util.concurrent.ListenableFuture deleteBlurb( com.google.showcase.v1beta1.DeleteBlurbRequest request) { @@ -927,6 +1132,10 @@ public com.google.common.util.concurrent.ListenableFuture + * Lists blurbs for a specific chat room or user profile depending on the + * parent resource name. + * */ public com.google.common.util.concurrent.ListenableFuture listBlurbs( com.google.showcase.v1beta1.ListBlurbsRequest request) { @@ -935,6 +1144,11 @@ public com.google.common.util.concurrent.ListenableFuture + * This method searches through all blurbs across all rooms and profiles + * for blurbs containing to words found in the query. Only posts that + * contain an exact match of a queried word will be returned. + * */ public com.google.common.util.concurrent.ListenableFuture searchBlurbs( com.google.showcase.v1beta1.SearchBlurbsRequest request) { diff --git a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/SequenceServiceGrpc.java b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/SequenceServiceGrpc.java index acb83bf8c5..bc33638347 100644 --- a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/SequenceServiceGrpc.java +++ b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/SequenceServiceGrpc.java @@ -250,6 +250,9 @@ public SequenceServiceFutureStub newStub(io.grpc.Channel channel, io.grpc.CallOp public interface AsyncService { /** + * 
+     * Creates a sequence.
+     *
*/ default void createSequence(com.google.showcase.v1beta1.CreateSequenceRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -257,6 +260,9 @@ default void createSequence(com.google.showcase.v1beta1.CreateSequenceRequest re } /** + * 
+     * Creates a sequence.
+     *
*/ default void createStreamingSequence(com.google.showcase.v1beta1.CreateStreamingSequenceRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -264,6 +270,9 @@ default void createStreamingSequence(com.google.showcase.v1beta1.CreateStreaming } /** + * 
+     * Retrieves a sequence.
+     *
*/ default void getSequenceReport(com.google.showcase.v1beta1.GetSequenceReportRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -271,6 +280,9 @@ default void getSequenceReport(com.google.showcase.v1beta1.GetSequenceReportRequ } /** + * 
+     * Retrieves a sequence.
+     *
*/ default void getStreamingSequenceReport(com.google.showcase.v1beta1.GetStreamingSequenceReportRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -278,6 +290,9 @@ default void getStreamingSequenceReport(com.google.showcase.v1beta1.GetStreaming } /** + * 
+     * Attempts a sequence.
+     *
*/ default void attemptSequence(com.google.showcase.v1beta1.AttemptSequenceRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -285,6 +300,9 @@ default void attemptSequence(com.google.showcase.v1beta1.AttemptSequenceRequest } /** + * 
+     * Attempts a streaming sequence.
+     *
*/ default void attemptStreamingSequence(com.google.showcase.v1beta1.AttemptStreamingSequenceRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -320,6 +338,9 @@ protected SequenceServiceStub build( } /** + * 
+     * Creates a sequence.
+     *
*/ public void createSequence(com.google.showcase.v1beta1.CreateSequenceRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -328,6 +349,9 @@ public void createSequence(com.google.showcase.v1beta1.CreateSequenceRequest req } /** + * 
+     * Creates a sequence.
+     *
*/ public void createStreamingSequence(com.google.showcase.v1beta1.CreateStreamingSequenceRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -336,6 +360,9 @@ public void createStreamingSequence(com.google.showcase.v1beta1.CreateStreamingS } /** + * 
+     * Retrieves a sequence.
+     *
*/ public void getSequenceReport(com.google.showcase.v1beta1.GetSequenceReportRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -344,6 +371,9 @@ public void getSequenceReport(com.google.showcase.v1beta1.GetSequenceReportReque } /** + * 
+     * Retrieves a sequence.
+     *
*/ public void getStreamingSequenceReport(com.google.showcase.v1beta1.GetStreamingSequenceReportRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -352,6 +382,9 @@ public void getStreamingSequenceReport(com.google.showcase.v1beta1.GetStreamingS } /** + * 
+     * Attempts a sequence.
+     *
*/ public void attemptSequence(com.google.showcase.v1beta1.AttemptSequenceRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -360,6 +393,9 @@ public void attemptSequence(com.google.showcase.v1beta1.AttemptSequenceRequest r } /** + * 
+     * Attempts a streaming sequence.
+     *
*/ public void attemptStreamingSequence(com.google.showcase.v1beta1.AttemptStreamingSequenceRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -385,6 +421,9 @@ protected SequenceServiceBlockingStub build( } /** + * 
+     * Creates a sequence.
+     *
*/ public com.google.showcase.v1beta1.Sequence createSequence(com.google.showcase.v1beta1.CreateSequenceRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -392,6 +431,9 @@ public com.google.showcase.v1beta1.Sequence createSequence(com.google.showcase.v } /** + * 
+     * Creates a sequence.
+     *
*/ public com.google.showcase.v1beta1.StreamingSequence createStreamingSequence(com.google.showcase.v1beta1.CreateStreamingSequenceRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -399,6 +441,9 @@ public com.google.showcase.v1beta1.StreamingSequence createStreamingSequence(com } /** + * 
+     * Retrieves a sequence.
+     *
*/ public com.google.showcase.v1beta1.SequenceReport getSequenceReport(com.google.showcase.v1beta1.GetSequenceReportRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -406,6 +451,9 @@ public com.google.showcase.v1beta1.SequenceReport getSequenceReport(com.google.s } /** + * 
+     * Retrieves a sequence.
+     *
*/ public com.google.showcase.v1beta1.StreamingSequenceReport getStreamingSequenceReport(com.google.showcase.v1beta1.GetStreamingSequenceReportRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -413,6 +461,9 @@ public com.google.showcase.v1beta1.StreamingSequenceReport getStreamingSequenceR } /** + * 
+     * Attempts a sequence.
+     *
*/ public com.google.protobuf.Empty attemptSequence(com.google.showcase.v1beta1.AttemptSequenceRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -420,6 +471,9 @@ public com.google.protobuf.Empty attemptSequence(com.google.showcase.v1beta1.Att } /** + * 
+     * Attempts a streaming sequence.
+     *
*/ public java.util.Iterator attemptStreamingSequence( com.google.showcase.v1beta1.AttemptStreamingSequenceRequest request) { @@ -445,6 +499,9 @@ protected SequenceServiceFutureStub build( } /** + * 
+     * Creates a sequence.
+     *
*/ public com.google.common.util.concurrent.ListenableFuture createSequence( com.google.showcase.v1beta1.CreateSequenceRequest request) { @@ -453,6 +510,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Creates a sequence. + * */ public com.google.common.util.concurrent.ListenableFuture createStreamingSequence( com.google.showcase.v1beta1.CreateStreamingSequenceRequest request) { @@ -461,6 +521,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Retrieves a sequence. + * */ public com.google.common.util.concurrent.ListenableFuture getSequenceReport( com.google.showcase.v1beta1.GetSequenceReportRequest request) { @@ -469,6 +532,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Retrieves a sequence. + * */ public com.google.common.util.concurrent.ListenableFuture getStreamingSequenceReport( com.google.showcase.v1beta1.GetStreamingSequenceReportRequest request) { @@ -477,6 +543,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Attempts a sequence. + * */ public com.google.common.util.concurrent.ListenableFuture attemptSequence( com.google.showcase.v1beta1.AttemptSequenceRequest request) { diff --git a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/TestingGrpc.java b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/TestingGrpc.java index 642eed0b7b..185eb2868f 100644 --- a/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/TestingGrpc.java +++ b/showcase/grpc-gapic-showcase-v1beta1/src/main/java/com/google/showcase/v1beta1/TestingGrpc.java @@ -3,6 +3,10 @@ import static io.grpc.MethodDescriptor.generateFullMethodName; /** + * 
+ * A service to facilitate running discrete sets of tests
+ * against Showcase.
+ *
*/ @javax.annotation.Generated( value = "by gRPC proto compiler", @@ -308,10 +312,17 @@ public TestingFutureStub newStub(io.grpc.Channel channel, io.grpc.CallOptions ca } /** + * 
+   * A service to facilitate running discrete sets of tests
+   * against Showcase.
+   *
*/ public interface AsyncService { /** + * 
+     * Creates a new testing session.
+     *
*/ default void createSession(com.google.showcase.v1beta1.CreateSessionRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -319,6 +330,9 @@ default void createSession(com.google.showcase.v1beta1.CreateSessionRequest requ } /** + * 
+     * Gets a testing session.
+     *
*/ default void getSession(com.google.showcase.v1beta1.GetSessionRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -326,6 +340,9 @@ default void getSession(com.google.showcase.v1beta1.GetSessionRequest request, } /** + * 
+     * Lists the current test sessions.
+     *
*/ default void listSessions(com.google.showcase.v1beta1.ListSessionsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -333,6 +350,9 @@ default void listSessions(com.google.showcase.v1beta1.ListSessionsRequest reques } /** + * 
+     * Delete a test session.
+     *
*/ default void deleteSession(com.google.showcase.v1beta1.DeleteSessionRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -340,6 +360,11 @@ default void deleteSession(com.google.showcase.v1beta1.DeleteSessionRequest requ } /** + * 
+     * Report on the status of a session.
+     * This generates a report detailing which tests have been completed,
+     * and an overall rollup.
+     *
*/ default void reportSession(com.google.showcase.v1beta1.ReportSessionRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -347,6 +372,9 @@ default void reportSession(com.google.showcase.v1beta1.ReportSessionRequest requ } /** + * 
+     * List the tests of a sessesion.
+     *
*/ default void listTests(com.google.showcase.v1beta1.ListTestsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -354,6 +382,12 @@ default void listTests(com.google.showcase.v1beta1.ListTestsRequest request, } /** + * 
+     * Explicitly decline to implement a test.
+     * This removes the test from subsequent `ListTests` calls, and
+     * attempting to do the test will error.
+     * This method will error if attempting to delete a required test.
+     *
*/ default void deleteTest(com.google.showcase.v1beta1.DeleteTestRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -361,6 +395,11 @@ default void deleteTest(com.google.showcase.v1beta1.DeleteTestRequest request, } /** + * 
+     * Register a response to a test.
+     * In cases where a test involves registering a final answer at the
+     * end of the test, this method provides the means to do so.
+     *
*/ default void verifyTest(com.google.showcase.v1beta1.VerifyTestRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -370,6 +409,10 @@ default void verifyTest(com.google.showcase.v1beta1.VerifyTestRequest request, /** * Base class for the server implementation of the service Testing. + * 
+   * A service to facilitate running discrete sets of tests
+   * against Showcase.
+   *
*/ public static abstract class TestingImplBase implements io.grpc.BindableService, AsyncService { @@ -381,6 +424,10 @@ public static abstract class TestingImplBase /** * A stub to allow clients to do asynchronous rpc calls to service Testing. + * 
+   * A service to facilitate running discrete sets of tests
+   * against Showcase.
+   *
*/ public static final class TestingStub extends io.grpc.stub.AbstractAsyncStub { @@ -396,6 +443,9 @@ protected TestingStub build( } /** + * 
+     * Creates a new testing session.
+     *
*/ public void createSession(com.google.showcase.v1beta1.CreateSessionRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -404,6 +454,9 @@ public void createSession(com.google.showcase.v1beta1.CreateSessionRequest reque } /** + * 
+     * Gets a testing session.
+     *
*/ public void getSession(com.google.showcase.v1beta1.GetSessionRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -412,6 +465,9 @@ public void getSession(com.google.showcase.v1beta1.GetSessionRequest request, } /** + * 
+     * Lists the current test sessions.
+     *
*/ public void listSessions(com.google.showcase.v1beta1.ListSessionsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -420,6 +476,9 @@ public void listSessions(com.google.showcase.v1beta1.ListSessionsRequest request } /** + * 
+     * Delete a test session.
+     *
*/ public void deleteSession(com.google.showcase.v1beta1.DeleteSessionRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -428,6 +487,11 @@ public void deleteSession(com.google.showcase.v1beta1.DeleteSessionRequest reque } /** + * 
+     * Report on the status of a session.
+     * This generates a report detailing which tests have been completed,
+     * and an overall rollup.
+     *
*/ public void reportSession(com.google.showcase.v1beta1.ReportSessionRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -436,6 +500,9 @@ public void reportSession(com.google.showcase.v1beta1.ReportSessionRequest reque } /** + * 
+     * List the tests of a sessesion.
+     *
*/ public void listTests(com.google.showcase.v1beta1.ListTestsRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -444,6 +511,12 @@ public void listTests(com.google.showcase.v1beta1.ListTestsRequest request, } /** + * 
+     * Explicitly decline to implement a test.
+     * This removes the test from subsequent `ListTests` calls, and
+     * attempting to do the test will error.
+     * This method will error if attempting to delete a required test.
+     *
*/ public void deleteTest(com.google.showcase.v1beta1.DeleteTestRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -452,6 +525,11 @@ public void deleteTest(com.google.showcase.v1beta1.DeleteTestRequest request, } /** + * 
+     * Register a response to a test.
+     * In cases where a test involves registering a final answer at the
+     * end of the test, this method provides the means to do so.
+     *
*/ public void verifyTest(com.google.showcase.v1beta1.VerifyTestRequest request, io.grpc.stub.StreamObserver responseObserver) { @@ -462,6 +540,10 @@ public void verifyTest(com.google.showcase.v1beta1.VerifyTestRequest request, /** * A stub to allow clients to do synchronous rpc calls to service Testing. + * 
+   * A service to facilitate running discrete sets of tests
+   * against Showcase.
+   *
*/ public static final class TestingBlockingStub extends io.grpc.stub.AbstractBlockingStub { @@ -477,6 +559,9 @@ protected TestingBlockingStub build( } /** + * 
+     * Creates a new testing session.
+     *
*/ public com.google.showcase.v1beta1.Session createSession(com.google.showcase.v1beta1.CreateSessionRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -484,6 +569,9 @@ public com.google.showcase.v1beta1.Session createSession(com.google.showcase.v1b } /** + * 
+     * Gets a testing session.
+     *
*/ public com.google.showcase.v1beta1.Session getSession(com.google.showcase.v1beta1.GetSessionRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -491,6 +579,9 @@ public com.google.showcase.v1beta1.Session getSession(com.google.showcase.v1beta } /** + * 
+     * Lists the current test sessions.
+     *
*/ public com.google.showcase.v1beta1.ListSessionsResponse listSessions(com.google.showcase.v1beta1.ListSessionsRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -498,6 +589,9 @@ public com.google.showcase.v1beta1.ListSessionsResponse listSessions(com.google. } /** + * 
+     * Delete a test session.
+     *
*/ public com.google.protobuf.Empty deleteSession(com.google.showcase.v1beta1.DeleteSessionRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -505,6 +599,11 @@ public com.google.protobuf.Empty deleteSession(com.google.showcase.v1beta1.Delet } /** + * 
+     * Report on the status of a session.
+     * This generates a report detailing which tests have been completed,
+     * and an overall rollup.
+     *
*/ public com.google.showcase.v1beta1.ReportSessionResponse reportSession(com.google.showcase.v1beta1.ReportSessionRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -512,6 +611,9 @@ public com.google.showcase.v1beta1.ReportSessionResponse reportSession(com.googl } /** + * 
+     * List the tests of a sessesion.
+     *
*/ public com.google.showcase.v1beta1.ListTestsResponse listTests(com.google.showcase.v1beta1.ListTestsRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -519,6 +621,12 @@ public com.google.showcase.v1beta1.ListTestsResponse listTests(com.google.showca } /** + * 
+     * Explicitly decline to implement a test.
+     * This removes the test from subsequent `ListTests` calls, and
+     * attempting to do the test will error.
+     * This method will error if attempting to delete a required test.
+     *
*/ public com.google.protobuf.Empty deleteTest(com.google.showcase.v1beta1.DeleteTestRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -526,6 +634,11 @@ public com.google.protobuf.Empty deleteTest(com.google.showcase.v1beta1.DeleteTe } /** + * 
+     * Register a response to a test.
+     * In cases where a test involves registering a final answer at the
+     * end of the test, this method provides the means to do so.
+     *
*/ public com.google.showcase.v1beta1.VerifyTestResponse verifyTest(com.google.showcase.v1beta1.VerifyTestRequest request) { return io.grpc.stub.ClientCalls.blockingUnaryCall( @@ -535,6 +648,10 @@ public com.google.showcase.v1beta1.VerifyTestResponse verifyTest(com.google.show /** * A stub to allow clients to do ListenableFuture-style rpc calls to service Testing. + * 
+   * A service to facilitate running discrete sets of tests
+   * against Showcase.
+   *
*/ public static final class TestingFutureStub extends io.grpc.stub.AbstractFutureStub { @@ -550,6 +667,9 @@ protected TestingFutureStub build( } /** + * 
+     * Creates a new testing session.
+     *
*/ public com.google.common.util.concurrent.ListenableFuture createSession( com.google.showcase.v1beta1.CreateSessionRequest request) { @@ -558,6 +678,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Gets a testing session. + * */ public com.google.common.util.concurrent.ListenableFuture getSession( com.google.showcase.v1beta1.GetSessionRequest request) { @@ -566,6 +689,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Lists the current test sessions. + * */ public com.google.common.util.concurrent.ListenableFuture listSessions( com.google.showcase.v1beta1.ListSessionsRequest request) { @@ -574,6 +700,9 @@ public com.google.common.util.concurrent.ListenableFuture + * Delete a test session. + * */ public com.google.common.util.concurrent.ListenableFuture deleteSession( com.google.showcase.v1beta1.DeleteSessionRequest request) { @@ -582,6 +711,11 @@ public com.google.common.util.concurrent.ListenableFuture + * Report on the status of a session. + * This generates a report detailing which tests have been completed, + * and an overall rollup. + * */ public com.google.common.util.concurrent.ListenableFuture reportSession( com.google.showcase.v1beta1.ReportSessionRequest request) { @@ -590,6 +724,9 @@ public com.google.common.util.concurrent.ListenableFuture + * List the tests of a sessesion. + * */ public com.google.common.util.concurrent.ListenableFuture listTests( com.google.showcase.v1beta1.ListTestsRequest request) { @@ -598,6 +735,12 @@ public com.google.common.util.concurrent.ListenableFuture + * Explicitly decline to implement a test. + * This removes the test from subsequent `ListTests` calls, and + * attempting to do the test will error. + * This method will error if attempting to delete a required test. + * */ public com.google.common.util.concurrent.ListenableFuture deleteTest( com.google.showcase.v1beta1.DeleteTestRequest request) { @@ -606,6 +749,11 @@ public com.google.common.util.concurrent.ListenableFuture + * Register a response to a test. + * In cases where a test involves registering a final answer at the + * end of the test, this method provides the means to do so. + * */ public com.google.common.util.concurrent.ListenableFuture verifyTest( com.google.showcase.v1beta1.VerifyTestRequest request) { diff --git a/showcase/proto-gapic-showcase-v1beta1/pom.xml b/showcase/proto-gapic-showcase-v1beta1/pom.xml index 12fc9507a1..2c9438793f 100644 --- a/showcase/proto-gapic-showcase-v1beta1/pom.xml +++ b/showcase/proto-gapic-showcase-v1beta1/pom.xml @@ -37,6 +37,7 @@ bazelisk run + --experimental_proto_descriptor_sets_include_source_info //showcase:verify_proto @@ -65,6 +66,7 @@ bazel run + --experimental_proto_descriptor_sets_include_source_info //showcase:update_proto