diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/ClientLibraryPackageInfoComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/ClientLibraryPackageInfoComposer.java index 5bd24bdbd0f0..25e0bf8cbdb6 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/ClientLibraryPackageInfoComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/ClientLibraryPackageInfoComposer.java @@ -105,7 +105,7 @@ private static CommentStatement createPackageInfoJavadoc(GapicContext context) { ServiceClientHeaderSampleComposer.composeClassHeaderSample( service, clientType, context.resourceNames(), context.messages()); javaDocCommentBuilder.addSampleCode( - SampleCodeWriter.writeInlineSample(packageInfoSampleCode.body())); + SampleCodeWriter.writeInlineSample(packageInfoSampleCode)); } return CommentStatement.withComment(javaDocCommentBuilder.build()); diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/CommentComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/CommentComposer.java index 498320731fa9..7e1433d03467 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/CommentComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/CommentComposer.java @@ -19,6 +19,7 @@ import com.google.api.generator.engine.ast.LineComment; import com.google.api.generator.engine.ast.Statement; import com.google.common.base.Strings; +import com.google.common.collect.ImmutableList; import java.util.Arrays; import java.util.Calendar; import java.util.List; @@ -63,7 +64,7 @@ public class CommentComposer { CommentStatement.withComment( LineComment.withComment(AUTO_GENERATED_METHOD_DISCLAIMER_STRING)); - public static final List AUTO_GENERATED_SAMPLE_COMMENT = + public static final List AUTO_GENERATED_SAMPLE_COMMENT_BASE = Arrays.asList( CommentStatement.withComment( LineComment.withComment( @@ -80,6 +81,22 @@ public class CommentComposer { LineComment.withComment( "https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library"))); + public static final List CLIENT_LIFECYCLE_COMMENT = + Arrays.asList( + CommentStatement.withComment( + LineComment.withComment( + "- The samples create a client that can be re-used for multiple requests\n" + + " and are expected to be long-lived.\n" + + " The clients should be resource managed properly and eventually closed.\n" + + "For more information on client lifecycle, see\n" + + "https://docs.cloud.google.com/java/docs/client-lifecycle"))); + + public static final List AUTO_GENERATED_SAMPLE_COMMENT = + ImmutableList.builder() + .addAll(AUTO_GENERATED_SAMPLE_COMMENT_BASE) + .addAll(CLIENT_LIFECYCLE_COMMENT) + .build(); + // This environment variable is mainly used to override the current year to a fixed year in tests // so we don't have to update golden tests every year. // This does not work for golden integration tests that are generated from Bazel rules. Because diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java index 913ffd0f5c75..f502176e95df 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java @@ -233,9 +233,9 @@ protected List createClassHeaderComments( return ServiceClientCommentComposer.createClassHeaderComments( methodVariantsForClientHeader, service, - SampleCodeWriter.writeInlineSample(classMethodSampleCode.body()), - SampleCodeWriter.writeInlineSample(credentialsSampleCode.body()), - SampleCodeWriter.writeInlineSample(endpointSampleCode.body()), + SampleCodeWriter.writeInlineSample(classMethodSampleCode), + SampleCodeWriter.writeInlineSample(credentialsSampleCode), + SampleCodeWriter.writeInlineSample(endpointSampleCode), null, null, null); @@ -797,7 +797,7 @@ private static List createMethodVariants( if (methodSample.isPresent()) { samples.add(methodSample.get()); methodDocSample = - Optional.of(SampleCodeWriter.writeInlineSample(methodSample.get().body())); + Optional.of(SampleCodeWriter.writeInlineSample(methodSample.get())); } MethodDefinition.Builder methodVariantBuilder = @@ -876,7 +876,7 @@ private static MethodDefinition createMethodDefaultMethod( if (defaultMethodSample.isPresent()) { samples.add(defaultMethodSample.get()); defaultMethodDocSample = - Optional.of(SampleCodeWriter.writeInlineSample(defaultMethodSample.get().body())); + Optional.of(SampleCodeWriter.writeInlineSample(defaultMethodSample.get())); } MethodInvocationExpr callableMethodExpr = @@ -1043,7 +1043,7 @@ private static MethodDefinition createCallableMethod( Optional sampleDocCode = Optional.empty(); if (sampleCode.isPresent()) { samples.add(sampleCode.get()); - sampleDocCode = Optional.of(SampleCodeWriter.writeInlineSample(sampleCode.get().body())); + sampleDocCode = Optional.of(SampleCodeWriter.writeInlineSample(sampleCode.get())); } MethodDefinition.Builder methodDefBuilder = MethodDefinition.builder(); diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceSettingsClassComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceSettingsClassComposer.java index e117097b1094..c6f40e9a8b13 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceSettingsClassComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceSettingsClassComposer.java @@ -30,6 +30,7 @@ import com.google.api.gax.rpc.StubSettings; import com.google.api.gax.rpc.TransportChannelProvider; import com.google.api.gax.rpc.UnaryCallSettings; +import com.google.api.generator.gapic.composer.comment.CommentComposer; import com.google.api.generator.engine.ast.AnnotationNode; import com.google.api.generator.engine.ast.CastExpr; import com.google.api.generator.engine.ast.ClassDefinition; @@ -169,7 +170,7 @@ private static List createClassHeaderComments( Optional docSampleCode = Optional.empty(); if (sampleCode.isPresent()) { samples.add(sampleCode.get()); - docSampleCode = Optional.of(SampleCodeWriter.writeInlineSample(sampleCode.get().body())); + docSampleCode = Optional.of(SampleCodeWriter.writeInlineSample(sampleCode.get(), CommentComposer.AUTO_GENERATED_SAMPLE_COMMENT_BASE)); } // Create a sample for a LRO method using LRO-specific RetrySettings, if one exists in the // service. @@ -188,7 +189,7 @@ private static List createClassHeaderComments( if (lroSampleCode.isPresent()) { samples.add(lroSampleCode.get()); lroDocSampleCode = - Optional.of(SampleCodeWriter.writeInlineSample(lroSampleCode.get().body())); + Optional.of(SampleCodeWriter.writeInlineSample(lroSampleCode.get(), CommentComposer.AUTO_GENERATED_SAMPLE_COMMENT_BASE)); } return SettingsCommentComposer.createClassHeaderComments( diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceStubSettingsClassComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceStubSettingsClassComposer.java index 698fd50a2982..be4dc71d9982 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceStubSettingsClassComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceStubSettingsClassComposer.java @@ -14,6 +14,7 @@ package com.google.api.generator.gapic.composer.common; +import com.google.api.generator.gapic.composer.comment.CommentComposer; import com.google.api.MonitoredResourceDescriptor; import com.google.api.core.ApiFunction; import com.google.api.core.ApiFuture; @@ -459,7 +460,7 @@ private static List createClassHeaderComments( Optional docSampleCode = Optional.empty(); if (sampleCode.isPresent()) { samples.add(sampleCode.get()); - docSampleCode = Optional.of(SampleCodeWriter.writeInlineSample(sampleCode.get().body())); + docSampleCode = Optional.of(SampleCodeWriter.writeInlineSample(sampleCode.get(), CommentComposer.AUTO_GENERATED_SAMPLE_COMMENT_BASE)); } // Create a sample for a LRO method using LRO-specific RetrySettings, if one exists in the // service. @@ -478,7 +479,7 @@ private static List createClassHeaderComments( if (lroSampleCode.isPresent()) { samples.add(lroSampleCode.get()); lroDocSampleCode = - Optional.of(SampleCodeWriter.writeInlineSample(lroSampleCode.get().body())); + Optional.of(SampleCodeWriter.writeInlineSample(lroSampleCode.get(), CommentComposer.AUTO_GENERATED_SAMPLE_COMMENT_BASE)); } return SettingsCommentComposer.createClassHeaderComments( diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/grpcrest/ServiceClientClassComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/grpcrest/ServiceClientClassComposer.java index 3710f6949221..e63d29c9dc7d 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/grpcrest/ServiceClientClassComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/grpcrest/ServiceClientClassComposer.java @@ -75,10 +75,10 @@ protected List createClassHeaderComments( return ServiceClientCommentComposer.createClassHeaderComments( grpcRpcsToJavaMethodNames, service, - SampleCodeWriter.writeInlineSample(classMethodSampleCode.body()), - SampleCodeWriter.writeInlineSample(credentialsSampleCode.body()), - SampleCodeWriter.writeInlineSample(endpointSampleCode.body()), - SampleCodeWriter.writeInlineSample(transportSampleCode.body()), + SampleCodeWriter.writeInlineSample(classMethodSampleCode), + SampleCodeWriter.writeInlineSample(credentialsSampleCode), + SampleCodeWriter.writeInlineSample(endpointSampleCode), + SampleCodeWriter.writeInlineSample(transportSampleCode), "gRPC", "REST (HTTP1.1/JSON)"); } diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SampleCodeWriter.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SampleCodeWriter.java index 8a12e14a97cd..91d1f7b35211 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SampleCodeWriter.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SampleCodeWriter.java @@ -30,10 +30,22 @@ public static String writeInlineSample(List statements) { return write(SampleComposer.composeInlineSample(statements)); } + public static String writeInlineSample(Sample sample) { + return write(SampleComposer.composeInlineSample(sample)); + } + + public static String writeInlineSample(Sample sample, List sampleComment) { + return write(SampleComposer.composeInlineSample(sample, sampleComment)); + } + public static String writeExecutableSample(Sample sample, String packkage) { return write(SampleComposer.composeExecutableSample(sample, packkage)); } + public static String writeExecutableSample(Sample sample, String packkage, List sampleComment) { + return write(SampleComposer.composeExecutableSample(sample, packkage, sampleComment)); + } + @VisibleForTesting public static String write(Statement... statement) { return write(Arrays.asList(statement)); diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SampleComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SampleComposer.java index 86eb187fd17b..839dca1a9fbd 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SampleComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SampleComposer.java @@ -41,15 +41,27 @@ static List composeInlineSample(List sampleBody) { return bodyWithComment(CommentComposer.AUTO_GENERATED_SAMPLE_COMMENT, sampleBody); } + static List composeInlineSample(Sample sample) { + return composeInlineSample(sample, CommentComposer.AUTO_GENERATED_SAMPLE_COMMENT); + } + + static List composeInlineSample(Sample sample, List sampleComment) { + return bodyWithComment(sampleComment, sample.body()); + } + // "Executable" meaning it includes the necessary code to execute java code, // still may require additional configuration to actually execute generated sample code static ClassDefinition composeExecutableSample(Sample sample, String pakkage) { + return composeExecutableSample(sample, pakkage, CommentComposer.AUTO_GENERATED_SAMPLE_COMMENT); + } + + static ClassDefinition composeExecutableSample(Sample sample, String pakkage, List sampleComment) { return createExecutableSample( sample.fileHeader(), pakkage, sample.name(), sample.variableAssignments(), - bodyWithComment(CommentComposer.AUTO_GENERATED_SAMPLE_COMMENT, sample.body()), + bodyWithComment(sampleComment, sample.body()), sample.regionTag()); } diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientCallableMethodSampleComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientCallableMethodSampleComposer.java index 342fab52ad16..36d5eb005b9e 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientCallableMethodSampleComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientCallableMethodSampleComposer.java @@ -402,14 +402,11 @@ public static Sample composeLroCallableMethod( .setIsAsynchronous(true) .setOverloadDisambiguation("LRO") .build(); - List body = - Arrays.asList( - TryCatchStatement.builder() - .setTryResourceExpr( - SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr)) - .setTryBody(bodyStatements) - .setIsSampleCode(true) - .build()); + List body = new ArrayList<>(); + body.add( + ExprStatement.withExpr( + SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr))); + body.addAll(bodyStatements); return Sample.builder().setBody(body).setRegionTag(regionTag).build(); } @@ -524,14 +521,11 @@ public static Sample composePagedCallableMethod( .setBody(Arrays.asList(lineCommentStatement)) .build(); bodyStatements.add(repeatedResponseForStatement); - List body = - Arrays.asList( - TryCatchStatement.builder() - .setTryResourceExpr( - SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr)) - .setTryBody(bodyStatements) - .setIsSampleCode(true) - .build()); + List body = new ArrayList<>(); + body.add( + ExprStatement.withExpr( + SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr))); + body.addAll(bodyStatements); RegionTag regionTag = RegionTag.builder() @@ -591,14 +585,11 @@ public static Sample composeRegularCallableMethod( regionTag = unaryOrLroCallable.regionTag(); } - List body = - Arrays.asList( - TryCatchStatement.builder() - .setTryResourceExpr( - SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr)) - .setTryBody(bodyStatements) - .setIsSampleCode(true) - .build()); + List body = new ArrayList<>(); + body.add( + ExprStatement.withExpr( + SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr))); + body.addAll(bodyStatements); return Sample.builder().setBody(body).setRegionTag(regionTag).build(); } @@ -653,14 +644,11 @@ public static Sample composeStreamCallableMethod( regionTag = streamClient.regionTag(); } - List body = - Arrays.asList( - TryCatchStatement.builder() - .setTryResourceExpr( - SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr)) - .setTryBody(bodyStatements) - .setIsSampleCode(true) - .build()); + List body = new ArrayList<>(); + body.add( + ExprStatement.withExpr( + SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr))); + body.addAll(bodyStatements); return Sample.builder().setBody(body).setRegionTag(regionTag).build(); } diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientHeaderSampleComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientHeaderSampleComposer.java index c4e38e24a388..386c0e31d588 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientHeaderSampleComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientHeaderSampleComposer.java @@ -135,14 +135,11 @@ public static Sample composeShowcaseMethodSample( regionTag = unaryRpc.regionTag(); } - List body = - Arrays.asList( - TryCatchStatement.builder() - .setTryResourceExpr( - SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr)) - .setTryBody(bodyStatements) - .setIsSampleCode(true) - .build()); + List body = new ArrayList<>(); + body.add( + ExprStatement.withExpr( + SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr))); + body.addAll(bodyStatements); return Sample.builder().setBody(body).setRegionTag(regionTag).build(); } diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientMethodSampleComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientMethodSampleComposer.java index 311ebab5ac30..b94f455f27f7 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientMethodSampleComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientMethodSampleComposer.java @@ -59,14 +59,11 @@ public static Sample composeEmptyServiceSample(TypeNode clientType, Service serv RegionTag regionTag = RegionTag.builder().setServiceName(service.name()).setRpcName("emtpy").build(); - List body = - Arrays.asList( - TryCatchStatement.builder() - .setTryResourceExpr( - SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr)) - .setTryBody(bodyStatements) - .setIsSampleCode(true) - .build()); + List body = new ArrayList<>(); + body.add( + ExprStatement.withExpr( + SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr))); + body.addAll(bodyStatements); return Sample.builder().setBody(body).setRegionTag(regionTag).setIsCanonical(true).build(); } @@ -127,14 +124,11 @@ public static Sample composeCanonicalSample( regionTag = unaryRpc.regionTag(); } - List body = - Arrays.asList( - TryCatchStatement.builder() - .setTryResourceExpr( - SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr)) - .setTryBody(bodyStatements) - .setIsSampleCode(true) - .build()); + List body = new ArrayList<>(); + body.add( + ExprStatement.withExpr( + SampleComposerUtil.assignClientVariableWithCreateMethodExpr(clientVarExpr))); + body.addAll(bodyStatements); return Sample.builder().setBody(body).setRegionTag(regionTag).setIsCanonical(true).build(); } diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SettingsSampleComposer.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SettingsSampleComposer.java index 57d396847e34..b8e8d70b74bb 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SettingsSampleComposer.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/samplecode/SettingsSampleComposer.java @@ -243,7 +243,12 @@ public static Optional composeSettingsSample( .setServiceName(classType.reference().name()) .setRpcName(methodNameOpt.get()) .build(); - return Optional.of(Sample.builder().setBody(statements).setRegionTag(regionTag).build()); + return Optional.of( + Sample.builder() + .setBody(statements) + .setRegionTag(regionTag) + + .build()); } public static Optional composeLroSettingsSample( @@ -434,6 +439,11 @@ public static Optional composeLroSettingsSample( .setServiceName(classType.reference().name()) .setRpcName(methodNameOpt.get()) .build(); - return Optional.of(Sample.builder().setBody(statements).setRegionTag(regionTag).build()); + return Optional.of( + Sample.builder() + .setBody(statements) + .setRegionTag(regionTag) + + .build()); } } diff --git a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Sample.java b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Sample.java index 27a999853add..dadb5e693884 100644 --- a/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Sample.java +++ b/sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Sample.java @@ -39,6 +39,8 @@ public abstract class Sample { public abstract boolean isCanonical(); + + public static Builder builder() { return new AutoValue_Sample.Builder() .setBody(ImmutableList.of()) @@ -88,6 +90,8 @@ public abstract static class Builder { public abstract Builder setIsCanonical(boolean isCanonical); + + abstract Builder setName(String name); abstract Sample autoBuild(); diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden index 9a8f46553d49..a7e7b2a709f4 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden @@ -20,11 +20,14 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (NestedMessageServiceClient nestedMessageServiceClient = - * NestedMessageServiceClient.create()) { - * Outer.Middle request = Outer.Middle.newBuilder().setX(120).build(); - * Outer.Middle.Inner response = nestedMessageServiceClient.nestedMessageMethod(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * NestedMessageServiceClient nestedMessageServiceClient = NestedMessageServiceClient.create(); + * Outer.Middle request = Outer.Middle.newBuilder().setX(120).build(); + * Outer.Middle.Inner response = nestedMessageServiceClient.nestedMessageMethod(request); * } * *

Note: close() needs to be called on the NestedMessageServiceClient object to clean up @@ -71,6 +74,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * NestedMessageServiceSettings nestedMessageServiceSettings = * NestedMessageServiceSettings.newBuilder() * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) @@ -87,6 +95,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * NestedMessageServiceSettings nestedMessageServiceSettings = * NestedMessageServiceSettings.newBuilder().setEndpoint(myEndpoint).build(); * NestedMessageServiceClient nestedMessageServiceClient = @@ -155,11 +168,14 @@ public class NestedMessageServiceClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (NestedMessageServiceClient nestedMessageServiceClient = - * NestedMessageServiceClient.create()) { - * Outer.Middle request = Outer.Middle.newBuilder().setX(120).build(); - * Outer.Middle.Inner response = nestedMessageServiceClient.nestedMessageMethod(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * NestedMessageServiceClient nestedMessageServiceClient = NestedMessageServiceClient.create(); + * Outer.Middle request = Outer.Middle.newBuilder().setX(120).build(); + * Outer.Middle.Inner response = nestedMessageServiceClient.nestedMessageMethod(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -179,14 +195,17 @@ public class NestedMessageServiceClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (NestedMessageServiceClient nestedMessageServiceClient = - * NestedMessageServiceClient.create()) { - * Outer.Middle request = Outer.Middle.newBuilder().setX(120).build(); - * ApiFuture future = - * nestedMessageServiceClient.nestedMessageMethodCallable().futureCall(request); - * // Do something. - * Outer.Middle.Inner response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * NestedMessageServiceClient nestedMessageServiceClient = NestedMessageServiceClient.create(); + * Outer.Middle request = Outer.Middle.newBuilder().setX(120).build(); + * ApiFuture future = + * nestedMessageServiceClient.nestedMessageMethodCallable().futureCall(request); + * // Do something. + * Outer.Middle.Inner response = future.get(); * } */ public final UnaryCallable nestedMessageMethodCallable() { diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/goldens/ShowcaseWithEchoPackageInfo.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/goldens/ShowcaseWithEchoPackageInfo.golden index a2c213eb1163..8496e56f0f37 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/goldens/ShowcaseWithEchoPackageInfo.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/goldens/ShowcaseWithEchoPackageInfo.golden @@ -16,9 +16,13 @@ * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoResponse response = echoClient.echo(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoResponse response = echoClient.echo(); * } */ @Generated("by gapic-generator-java") diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden index 13e54850392c..8e1b651f2631 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden @@ -21,11 +21,15 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (BookshopClient bookshopClient = BookshopClient.create()) { - * int booksCount = 1618425911; - * List books = new ArrayList<>(); - * Book response = bookshopClient.getBook(booksCount, books); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * BookshopClient bookshopClient = BookshopClient.create(); + * int booksCount = 1618425911; + * List books = new ArrayList<>(); + * Book response = bookshopClient.getBook(booksCount, books); * } * *

Note: close() needs to be called on the BookshopClient object to clean up resources such as @@ -76,6 +80,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * BookshopSettings bookshopSettings = * BookshopSettings.newBuilder() * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) @@ -91,6 +100,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * BookshopSettings bookshopSettings = * BookshopSettings.newBuilder().setEndpoint(myEndpoint).build(); * BookshopClient bookshopClient = BookshopClient.create(bookshopSettings); @@ -157,11 +171,15 @@ public class BookshopClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (BookshopClient bookshopClient = BookshopClient.create()) { - * int booksCount = 1618425911; - * List books = new ArrayList<>(); - * Book response = bookshopClient.getBook(booksCount, books); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * BookshopClient bookshopClient = BookshopClient.create(); + * int booksCount = 1618425911; + * List books = new ArrayList<>(); + * Book response = bookshopClient.getBook(booksCount, books); * } * * @param booksCount @@ -184,11 +202,15 @@ public class BookshopClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (BookshopClient bookshopClient = BookshopClient.create()) { - * String booksList = "booksList2-1119589686"; - * List books = new ArrayList<>(); - * Book response = bookshopClient.getBook(booksList, books); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * BookshopClient bookshopClient = BookshopClient.create(); + * String booksList = "booksList2-1119589686"; + * List books = new ArrayList<>(); + * Book response = bookshopClient.getBook(booksList, books); * } * * @param booksList @@ -211,15 +233,19 @@ public class BookshopClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (BookshopClient bookshopClient = BookshopClient.create()) { - * GetBookRequest request = - * GetBookRequest.newBuilder() - * .setBooksCount1(1618425911) - * .setBooksList2("booksList2-1119589686") - * .addAllBooks3(new ArrayList()) - * .build(); - * Book response = bookshopClient.getBook(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * BookshopClient bookshopClient = BookshopClient.create(); + * GetBookRequest request = + * GetBookRequest.newBuilder() + * .setBooksCount1(1618425911) + * .setBooksList2("booksList2-1119589686") + * .addAllBooks3(new ArrayList()) + * .build(); + * Book response = bookshopClient.getBook(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -239,17 +265,21 @@ public class BookshopClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (BookshopClient bookshopClient = BookshopClient.create()) { - * GetBookRequest request = - * GetBookRequest.newBuilder() - * .setBooksCount1(1618425911) - * .setBooksList2("booksList2-1119589686") - * .addAllBooks3(new ArrayList()) - * .build(); - * ApiFuture future = bookshopClient.getBookCallable().futureCall(request); - * // Do something. - * Book response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * BookshopClient bookshopClient = BookshopClient.create(); + * GetBookRequest request = + * GetBookRequest.newBuilder() + * .setBooksCount1(1618425911) + * .setBooksList2("booksList2-1119589686") + * .addAllBooks3(new ArrayList()) + * .build(); + * ApiFuture future = bookshopClient.getBookCallable().futureCall(request); + * // Do something. + * Book response = future.get(); * } */ public final UnaryCallable getBookCallable() { diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden index aec12869e407..7b8751c3c155 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden @@ -20,10 +20,14 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create()) { - * FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); - * deprecatedServiceClient.fastFibonacci(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create(); + * FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); + * deprecatedServiceClient.fastFibonacci(request); * } * *

Note: close() needs to be called on the DeprecatedServiceClient object to clean up resources @@ -84,6 +88,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * DeprecatedServiceSettings deprecatedServiceSettings = * DeprecatedServiceSettings.newBuilder() * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) @@ -100,6 +109,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * DeprecatedServiceSettings deprecatedServiceSettings = * DeprecatedServiceSettings.newBuilder().setEndpoint(myEndpoint).build(); * DeprecatedServiceClient deprecatedServiceClient = @@ -171,10 +185,14 @@ public class DeprecatedServiceClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create()) { - * FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); - * deprecatedServiceClient.fastFibonacci(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create(); + * FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); + * deprecatedServiceClient.fastFibonacci(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -194,12 +212,16 @@ public class DeprecatedServiceClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create()) { - * FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); - * ApiFuture future = deprecatedServiceClient.fastFibonacciCallable().futureCall(request); - * // Do something. - * future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create(); + * FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); + * ApiFuture future = deprecatedServiceClient.fastFibonacciCallable().futureCall(request); + * // Do something. + * future.get(); * } */ public final UnaryCallable fastFibonacciCallable() { @@ -216,10 +238,14 @@ public class DeprecatedServiceClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create()) { - * FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); - * deprecatedServiceClient.slowFibonacci(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create(); + * FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); + * deprecatedServiceClient.slowFibonacci(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -241,12 +267,16 @@ public class DeprecatedServiceClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create()) { - * FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); - * ApiFuture future = deprecatedServiceClient.slowFibonacciCallable().futureCall(request); - * // Do something. - * future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create(); + * FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); + * ApiFuture future = deprecatedServiceClient.slowFibonacciCallable().futureCall(request); + * // Do something. + * future.get(); * } * * @deprecated This method is deprecated and will be removed in the next major version update. diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden index 612111aea0df..403909b5baf1 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden @@ -44,9 +44,13 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoResponse response = echoClient.echo(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoResponse response = echoClient.echo(); * } * *

Note: close() needs to be called on the EchoClient object to clean up resources such as @@ -239,6 +243,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * EchoSettings echoSettings = * EchoSettings.newBuilder() * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) @@ -254,6 +263,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * EchoSettings echoSettings = EchoSettings.newBuilder().setEndpoint(myEndpoint).build(); * EchoClient echoClient = EchoClient.create(echoSettings); * } @@ -330,9 +344,13 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoResponse response = echoClient.echo(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoResponse response = echoClient.echo(); * } * * @param request The request object containing all of the parameters for the API call. @@ -353,10 +371,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * ResourceName parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); - * EchoResponse response = echoClient.echo(parent); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * ResourceName parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); + * EchoResponse response = echoClient.echo(parent); * } * * @param parent @@ -378,10 +400,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * Status error = Status.newBuilder().build(); - * EchoResponse response = echoClient.echo(error); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * Status error = Status.newBuilder().build(); + * EchoResponse response = echoClient.echo(error); * } * * @param error @@ -402,10 +428,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * FoobarName name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); - * EchoResponse response = echoClient.echo(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * FoobarName name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); + * EchoResponse response = echoClient.echo(name); * } * * @param name @@ -427,10 +457,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * String content = "content951530617"; - * EchoResponse response = echoClient.echo(content); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * String content = "content951530617"; + * EchoResponse response = echoClient.echo(content); * } * * @param content @@ -451,10 +485,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * String name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); - * EchoResponse response = echoClient.echo(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * String name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); + * EchoResponse response = echoClient.echo(name); * } * * @param name @@ -475,10 +513,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * String parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); - * EchoResponse response = echoClient.echo(parent); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * String parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); + * EchoResponse response = echoClient.echo(parent); * } * * @param parent @@ -499,11 +541,15 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * String content = "content951530617"; - * Severity severity = Severity.forNumber(0); - * EchoResponse response = echoClient.echo(content, severity); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * String content = "content951530617"; + * Severity severity = Severity.forNumber(0); + * EchoResponse response = echoClient.echo(content, severity); * } * * @param content @@ -526,16 +572,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * EchoResponse response = echoClient.echo(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * EchoResponse response = echoClient.echo(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -555,18 +605,22 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * ApiFuture future = echoClient.echoCallable().futureCall(request); - * // Do something. - * EchoResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * ApiFuture future = echoClient.echoCallable().futureCall(request); + * // Do something. + * EchoResponse response = future.get(); * } */ public final UnaryCallable echoCallable() { @@ -583,13 +637,17 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * ExpandRequest request = - * ExpandRequest.newBuilder().setContent("content951530617").setInfo("info3237038").build(); - * ServerStream stream = echoClient.expandCallable().call(request); - * for (EchoResponse response : stream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * ExpandRequest request = + * ExpandRequest.newBuilder().setContent("content951530617").setInfo("info3237038").build(); + * ServerStream stream = echoClient.expandCallable().call(request); + * for (EchoResponse response : stream) { + * // Do something when a response is received. * } * } */ @@ -607,35 +665,39 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * ApiStreamObserver responseObserver = - * new ApiStreamObserver() { - * {@literal @}Override - * public void onNext(EchoResponse response) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * ApiStreamObserver responseObserver = + * new ApiStreamObserver() { + * {@literal @}Override + * public void onNext(EchoResponse response) { + * // Do something when a response is received. + * } * - * {@literal @}Override - * public void onError(Throwable t) { - * // Add error-handling - * } + * {@literal @}Override + * public void onError(Throwable t) { + * // Add error-handling + * } * - * {@literal @}Override - * public void onCompleted() { - * // Do something when complete. - * } - * }; - * ApiStreamObserver requestObserver = - * echoClient.collect().clientStreamingCall(responseObserver); - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * requestObserver.onNext(request); - * } + * {@literal @}Override + * public void onCompleted() { + * // Do something when complete. + * } + * }; + * ApiStreamObserver requestObserver = + * echoClient.collect().clientStreamingCall(responseObserver); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * requestObserver.onNext(request); * } */ public final ClientStreamingCallable collectCallable() { @@ -652,19 +714,23 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * BidiStream bidiStream = echoClient.chatCallable().call(); - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * bidiStream.send(request); - * for (EchoResponse response : bidiStream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * BidiStream bidiStream = echoClient.chatCallable().call(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * bidiStream.send(request); + * for (EchoResponse response : bidiStream) { + * // Do something when a response is received. * } * } */ @@ -682,19 +748,23 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * BidiStream bidiStream = echoClient.chatAgainCallable().call(); - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * bidiStream.send(request); - * for (EchoResponse response : bidiStream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * BidiStream bidiStream = echoClient.chatAgainCallable().call(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * bidiStream.send(request); + * for (EchoResponse response : bidiStream) { + * // Do something when a response is received. * } * } */ @@ -712,16 +782,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * for (EchoResponse element : echoClient.pagedExpand(request).iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * for (EchoResponse element : echoClient.pagedExpand(request).iterateAll()) { + * // doThingsWith(element); * } * } * @@ -742,18 +816,22 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * ApiFuture future = echoClient.pagedExpandPagedCallable().futureCall(request); - * // Do something. - * for (EchoResponse element : future.get().iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * ApiFuture future = echoClient.pagedExpandPagedCallable().futureCall(request); + * // Do something. + * for (EchoResponse element : future.get().iterateAll()) { + * // doThingsWith(element); * } * } */ @@ -772,24 +850,28 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * while (true) { - * PagedExpandResponse response = echoClient.pagedExpandCallable().call(request); - * for (EchoResponse element : response.getResponsesList()) { - * // doThingsWith(element); - * } - * String nextPageToken = response.getNextPageToken(); - * if (!Strings.isNullOrEmpty(nextPageToken)) { - * request = request.toBuilder().setPageToken(nextPageToken).build(); - * } else { - * break; - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * while (true) { + * PagedExpandResponse response = echoClient.pagedExpandCallable().call(request); + * for (EchoResponse element : response.getResponsesList()) { + * // doThingsWith(element); + * } + * String nextPageToken = response.getNextPageToken(); + * if (!Strings.isNullOrEmpty(nextPageToken)) { + * request = request.toBuilder().setPageToken(nextPageToken).build(); + * } else { + * break; * } * } * } @@ -808,10 +890,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * for (EchoResponse element : echoClient.simplePagedExpand().iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * for (EchoResponse element : echoClient.simplePagedExpand().iterateAll()) { + * // doThingsWith(element); * } * } * @@ -833,16 +919,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * for (EchoResponse element : echoClient.simplePagedExpand(request).iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * for (EchoResponse element : echoClient.simplePagedExpand(request).iterateAll()) { + * // doThingsWith(element); * } * } * @@ -863,19 +953,23 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * ApiFuture future = - * echoClient.simplePagedExpandPagedCallable().futureCall(request); - * // Do something. - * for (EchoResponse element : future.get().iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * ApiFuture future = + * echoClient.simplePagedExpandPagedCallable().futureCall(request); + * // Do something. + * for (EchoResponse element : future.get().iterateAll()) { + * // doThingsWith(element); * } * } */ @@ -894,24 +988,28 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * while (true) { - * PagedExpandResponse response = echoClient.simplePagedExpandCallable().call(request); - * for (EchoResponse element : response.getResponsesList()) { - * // doThingsWith(element); - * } - * String nextPageToken = response.getNextPageToken(); - * if (!Strings.isNullOrEmpty(nextPageToken)) { - * request = request.toBuilder().setPageToken(nextPageToken).build(); - * } else { - * break; - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * while (true) { + * PagedExpandResponse response = echoClient.simplePagedExpandCallable().call(request); + * for (EchoResponse element : response.getResponsesList()) { + * // doThingsWith(element); + * } + * String nextPageToken = response.getNextPageToken(); + * if (!Strings.isNullOrEmpty(nextPageToken)) { + * request = request.toBuilder().setPageToken(nextPageToken).build(); + * } else { + * break; * } * } * } @@ -930,10 +1028,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * Duration ttl = Duration.newBuilder().build(); - * WaitResponse response = echoClient.waitAsync(ttl).get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * Duration ttl = Duration.newBuilder().build(); + * WaitResponse response = echoClient.waitAsync(ttl).get(); * } * * @param ttl @@ -954,10 +1056,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * Timestamp endTime = Timestamp.newBuilder().build(); - * WaitResponse response = echoClient.waitAsync(endTime).get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * Timestamp endTime = Timestamp.newBuilder().build(); + * WaitResponse response = echoClient.waitAsync(endTime).get(); * } * * @param endTime @@ -978,10 +1084,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * WaitRequest request = WaitRequest.newBuilder().build(); - * WaitResponse response = echoClient.waitAsync(request).get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * WaitRequest request = WaitRequest.newBuilder().build(); + * WaitResponse response = echoClient.waitAsync(request).get(); * } * * @param request The request object containing all of the parameters for the API call. @@ -1001,13 +1111,17 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * WaitRequest request = WaitRequest.newBuilder().build(); - * OperationFuture future = - * echoClient.waitOperationCallable().futureCall(request); - * // Do something. - * WaitResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * WaitRequest request = WaitRequest.newBuilder().build(); + * OperationFuture future = + * echoClient.waitOperationCallable().futureCall(request); + * // Do something. + * WaitResponse response = future.get(); * } */ public final OperationCallable waitOperationCallable() { @@ -1024,12 +1138,16 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * WaitRequest request = WaitRequest.newBuilder().build(); - * ApiFuture future = echoClient.waitCallable().futureCall(request); - * // Do something. - * Operation response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * WaitRequest request = WaitRequest.newBuilder().build(); + * ApiFuture future = echoClient.waitCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); * } */ public final UnaryCallable waitCallable() { @@ -1046,10 +1164,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * BlockRequest request = BlockRequest.newBuilder().build(); - * BlockResponse response = echoClient.block(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * BlockRequest request = BlockRequest.newBuilder().build(); + * BlockResponse response = echoClient.block(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1069,12 +1191,16 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * BlockRequest request = BlockRequest.newBuilder().build(); - * ApiFuture future = echoClient.blockCallable().futureCall(request); - * // Do something. - * BlockResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * BlockRequest request = BlockRequest.newBuilder().build(); + * ApiFuture future = echoClient.blockCallable().futureCall(request); + * // Do something. + * BlockResponse response = future.get(); * } */ public final UnaryCallable blockCallable() { @@ -1091,16 +1217,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * Object response = echoClient.collideName(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * Object response = echoClient.collideName(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1120,18 +1250,22 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * ApiFuture future = echoClient.collideNameCallable().futureCall(request); - * // Do something. - * Object response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * ApiFuture future = echoClient.collideNameCallable().futureCall(request); + * // Do something. + * Object response = future.get(); * } */ public final UnaryCallable collideNameCallable() { @@ -1148,15 +1282,19 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandLegacyRequest request = - * PagedExpandLegacyRequest.newBuilder() - * .setContent("content951530617") - * .setMaxResults(1128457243) - * .setPageToken("pageToken873572522") - * .build(); - * PagedExpandResponse response = echoClient.pagedExpandLegacy(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandLegacyRequest request = + * PagedExpandLegacyRequest.newBuilder() + * .setContent("content951530617") + * .setMaxResults(1128457243) + * .setPageToken("pageToken873572522") + * .build(); + * PagedExpandResponse response = echoClient.pagedExpandLegacy(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1176,18 +1314,22 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandLegacyRequest request = - * PagedExpandLegacyRequest.newBuilder() - * .setContent("content951530617") - * .setMaxResults(1128457243) - * .setPageToken("pageToken873572522") - * .build(); - * ApiFuture future = - * echoClient.pagedExpandLegacyCallable().futureCall(request); - * // Do something. - * PagedExpandResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandLegacyRequest request = + * PagedExpandLegacyRequest.newBuilder() + * .setContent("content951530617") + * .setMaxResults(1128457243) + * .setPageToken("pageToken873572522") + * .build(); + * ApiFuture future = + * echoClient.pagedExpandLegacyCallable().futureCall(request); + * // Do something. + * PagedExpandResponse response = future.get(); * } */ public final UnaryCallable diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoServiceSelectiveGapicClient.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoServiceSelectiveGapicClient.golden index 731ebe1834bf..6023821bf454 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoServiceSelectiveGapicClient.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoServiceSelectiveGapicClient.golden @@ -22,11 +22,14 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * EchoResponse response = - * echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * EchoResponse response = echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(); * } * *

Note: close() needs to be called on the EchoServiceShouldGeneratePartialUsualClient object to @@ -129,6 +132,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * EchoServiceShouldGeneratePartialUsualSettings echoServiceShouldGeneratePartialUsualSettings = * EchoServiceShouldGeneratePartialUsualSettings.newBuilder() * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) @@ -146,6 +154,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * EchoServiceShouldGeneratePartialUsualSettings echoServiceShouldGeneratePartialUsualSettings = * EchoServiceShouldGeneratePartialUsualSettings.newBuilder().setEndpoint(myEndpoint).build(); * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = @@ -225,11 +238,14 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * EchoResponse response = - * echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * EchoResponse response = echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(); * } * * @param request The request object containing all of the parameters for the API call. @@ -250,12 +266,16 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * FoobarName name = FoobarName.of("[PROJECT]", "[FOOBAR]"); - * EchoResponse response = - * echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * FoobarName name = FoobarName.of("[PROJECT]", "[FOOBAR]"); + * EchoResponse response = + * echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(name); * } * * @param name @@ -277,12 +297,16 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * String name = FoobarName.of("[PROJECT]", "[FOOBAR]").toString(); - * EchoResponse response = - * echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * String name = FoobarName.of("[PROJECT]", "[FOOBAR]").toString(); + * EchoResponse response = + * echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(name); * } * * @param name @@ -303,17 +327,21 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * EchoResponse response = - * echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * EchoResponse response = + * echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -333,21 +361,25 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * ApiFuture future = - * echoServiceShouldGeneratePartialUsualClient - * .echoShouldGenerateAsUsualCallable() - * .futureCall(request); - * // Do something. - * EchoResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * ApiFuture future = + * echoServiceShouldGeneratePartialUsualClient + * .echoShouldGenerateAsUsualCallable() + * .futureCall(request); + * // Do something. + * EchoResponse response = future.get(); * } */ public final UnaryCallable echoShouldGenerateAsUsualCallable() { @@ -364,20 +396,24 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * BidiStream bidiStream = - * echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsUsualCallable().call(); - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * bidiStream.send(request); - * for (EchoResponse response : bidiStream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * BidiStream bidiStream = + * echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsUsualCallable().call(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * bidiStream.send(request); + * for (EchoResponse response : bidiStream) { + * // Do something when a response is received. * } * } */ @@ -396,22 +432,24 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * BidiStream bidiStream = - * echoServiceShouldGeneratePartialUsualClient - * .chatAgainShouldGenerateAsUsualCallable() - * .call(); - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * bidiStream.send(request); - * for (EchoResponse response : bidiStream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * BidiStream bidiStream = + * echoServiceShouldGeneratePartialUsualClient.chatAgainShouldGenerateAsUsualCallable().call(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * bidiStream.send(request); + * for (EchoResponse response : bidiStream) { + * // Do something when a response is received. * } * } */ @@ -430,11 +468,15 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * EchoResponse response = - * echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * EchoResponse response = + * echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(); * } * *

Warning: This method is for internal use only. Please do not use it directly. @@ -458,12 +500,16 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * FoobarName name = FoobarName.of("[PROJECT]", "[FOOBAR]"); - * EchoResponse response = - * echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * FoobarName name = FoobarName.of("[PROJECT]", "[FOOBAR]"); + * EchoResponse response = + * echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(name); * } * *

Warning: This method is for internal use only. Please do not use it directly. @@ -488,12 +534,16 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * String name = FoobarName.of("[PROJECT]", "[FOOBAR]").toString(); - * EchoResponse response = - * echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * String name = FoobarName.of("[PROJECT]", "[FOOBAR]").toString(); + * EchoResponse response = + * echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(name); * } * *

Warning: This method is for internal use only. Please do not use it directly. @@ -517,17 +567,21 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * EchoResponse response = - * echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * EchoResponse response = + * echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(request); * } * *

Warning: This method is for internal use only. Please do not use it directly. @@ -550,21 +604,25 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * ApiFuture future = - * echoServiceShouldGeneratePartialUsualClient - * .chatShouldGenerateAsInternalCallable() - * .futureCall(request); - * // Do something. - * EchoResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * ApiFuture future = + * echoServiceShouldGeneratePartialUsualClient + * .chatShouldGenerateAsInternalCallable() + * .futureCall(request); + * // Do something. + * EchoResponse response = future.get(); * } * *

Warning: This method is for internal use only. Please do not use it directly. @@ -584,20 +642,24 @@ public class EchoServiceShouldGeneratePartialUsualClient implements BackgroundRe * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - * EchoServiceShouldGeneratePartialUsualClient.create()) { - * BidiStream bidiStream = - * echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsInternalCallable().call(); - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - * .setFoobar(Foobar.newBuilder().build()) - * .build(); - * bidiStream.send(request); - * for (EchoResponse response : bidiStream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + * EchoServiceShouldGeneratePartialUsualClient.create(); + * BidiStream bidiStream = + * echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsInternalCallable().call(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + * .setFoobar(Foobar.newBuilder().build()) + * .build(); + * bidiStream.send(request); + * for (EchoResponse response : bidiStream) { + * // Do something when a response is received. * } * } * diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden index efb41dc308f5..4840657bbb42 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden @@ -29,12 +29,16 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * String parent = UserName.of("[USER]").toString(); - * String displayName = "displayName1714148973"; - * String email = "email96619420"; - * User response = identityClient.createUser(parent, displayName, email); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * String parent = UserName.of("[USER]").toString(); + * String displayName = "displayName1714148973"; + * String email = "email96619420"; + * User response = identityClient.createUser(parent, displayName, email); * } * *

Note: close() needs to be called on the IdentityClient object to clean up resources such as @@ -153,6 +157,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * IdentitySettings identitySettings = * IdentitySettings.newBuilder() * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) @@ -168,6 +177,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * IdentitySettings identitySettings = * IdentitySettings.newBuilder().setEndpoint(myEndpoint).build(); * IdentityClient identityClient = IdentityClient.create(identitySettings); @@ -234,12 +248,16 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * String parent = UserName.of("[USER]").toString(); - * String displayName = "displayName1714148973"; - * String email = "email96619420"; - * User response = identityClient.createUser(parent, displayName, email); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * String parent = UserName.of("[USER]").toString(); + * String displayName = "displayName1714148973"; + * String email = "email96619420"; + * User response = identityClient.createUser(parent, displayName, email); * } * * @param parent @@ -266,18 +284,22 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * String parent = UserName.of("[USER]").toString(); - * String displayName = "displayName1714148973"; - * String email = "email96619420"; - * int age = 96511; - * String nickname = "nickname70690926"; - * boolean enableNotifications = true; - * double heightFeet = -1032737338; - * User response = - * identityClient.createUser( - * parent, displayName, email, age, nickname, enableNotifications, heightFeet); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * String parent = UserName.of("[USER]").toString(); + * String displayName = "displayName1714148973"; + * String email = "email96619420"; + * int age = 96511; + * String nickname = "nickname70690926"; + * boolean enableNotifications = true; + * double heightFeet = -1032737338; + * User response = + * identityClient.createUser( + * parent, displayName, email, age, nickname, enableNotifications, heightFeet); * } * * @param parent @@ -323,30 +345,34 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * String parent = UserName.of("[USER]").toString(); - * String displayName = "displayName1714148973"; - * String email = "email96619420"; - * String hobbyName = "hobbyName882586493"; - * String songName = "songName1535136064"; - * int weeklyFrequency = 1572999966; - * String companyName = "companyName-508582744"; - * String title = "title110371416"; - * String subject = "subject-1867885268"; - * String artistName = "artistName629723762"; - * User response = - * identityClient.createUser( - * parent, - * displayName, - * email, - * hobbyName, - * songName, - * weeklyFrequency, - * companyName, - * title, - * subject, - * artistName); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * String parent = UserName.of("[USER]").toString(); + * String displayName = "displayName1714148973"; + * String email = "email96619420"; + * String hobbyName = "hobbyName882586493"; + * String songName = "songName1535136064"; + * int weeklyFrequency = 1572999966; + * String companyName = "companyName-508582744"; + * String title = "title110371416"; + * String subject = "subject-1867885268"; + * String artistName = "artistName629723762"; + * User response = + * identityClient.createUser( + * parent, + * displayName, + * email, + * hobbyName, + * songName, + * weeklyFrequency, + * companyName, + * title, + * subject, + * artistName); * } * * @param parent @@ -413,14 +439,18 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * CreateUserRequest request = - * CreateUserRequest.newBuilder() - * .setParent(UserName.of("[USER]").toString()) - * .setUser(User.newBuilder().build()) - * .build(); - * User response = identityClient.createUser(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * CreateUserRequest request = + * CreateUserRequest.newBuilder() + * .setParent(UserName.of("[USER]").toString()) + * .setUser(User.newBuilder().build()) + * .build(); + * User response = identityClient.createUser(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -440,16 +470,20 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * CreateUserRequest request = - * CreateUserRequest.newBuilder() - * .setParent(UserName.of("[USER]").toString()) - * .setUser(User.newBuilder().build()) - * .build(); - * ApiFuture future = identityClient.createUserCallable().futureCall(request); - * // Do something. - * User response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * CreateUserRequest request = + * CreateUserRequest.newBuilder() + * .setParent(UserName.of("[USER]").toString()) + * .setUser(User.newBuilder().build()) + * .build(); + * ApiFuture future = identityClient.createUserCallable().futureCall(request); + * // Do something. + * User response = future.get(); * } */ public final UnaryCallable createUserCallable() { @@ -466,10 +500,14 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * UserName name = UserName.of("[USER]"); - * User response = identityClient.getUser(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * UserName name = UserName.of("[USER]"); + * User response = identityClient.getUser(name); * } * * @param name @@ -491,10 +529,14 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * String name = UserName.of("[USER]").toString(); - * User response = identityClient.getUser(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * String name = UserName.of("[USER]").toString(); + * User response = identityClient.getUser(name); * } * * @param name @@ -515,11 +557,15 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * GetUserRequest request = - * GetUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); - * User response = identityClient.getUser(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * GetUserRequest request = + * GetUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); + * User response = identityClient.getUser(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -539,13 +585,17 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * GetUserRequest request = - * GetUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); - * ApiFuture future = identityClient.getUserCallable().futureCall(request); - * // Do something. - * User response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * GetUserRequest request = + * GetUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); + * ApiFuture future = identityClient.getUserCallable().futureCall(request); + * // Do something. + * User response = future.get(); * } */ public final UnaryCallable getUserCallable() { @@ -562,11 +612,15 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * UpdateUserRequest request = - * UpdateUserRequest.newBuilder().setUser(User.newBuilder().build()).build(); - * User response = identityClient.updateUser(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * UpdateUserRequest request = + * UpdateUserRequest.newBuilder().setUser(User.newBuilder().build()).build(); + * User response = identityClient.updateUser(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -586,13 +640,17 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * UpdateUserRequest request = - * UpdateUserRequest.newBuilder().setUser(User.newBuilder().build()).build(); - * ApiFuture future = identityClient.updateUserCallable().futureCall(request); - * // Do something. - * User response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * UpdateUserRequest request = + * UpdateUserRequest.newBuilder().setUser(User.newBuilder().build()).build(); + * ApiFuture future = identityClient.updateUserCallable().futureCall(request); + * // Do something. + * User response = future.get(); * } */ public final UnaryCallable updateUserCallable() { @@ -609,10 +667,14 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * UserName name = UserName.of("[USER]"); - * identityClient.deleteUser(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * UserName name = UserName.of("[USER]"); + * identityClient.deleteUser(name); * } * * @param name @@ -634,10 +696,14 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * String name = UserName.of("[USER]").toString(); - * identityClient.deleteUser(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * String name = UserName.of("[USER]").toString(); + * identityClient.deleteUser(name); * } * * @param name @@ -658,11 +724,15 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * DeleteUserRequest request = - * DeleteUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); - * identityClient.deleteUser(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * DeleteUserRequest request = + * DeleteUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); + * identityClient.deleteUser(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -682,13 +752,17 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * DeleteUserRequest request = - * DeleteUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); - * ApiFuture future = identityClient.deleteUserCallable().futureCall(request); - * // Do something. - * future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * DeleteUserRequest request = + * DeleteUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); + * ApiFuture future = identityClient.deleteUserCallable().futureCall(request); + * // Do something. + * future.get(); * } */ public final UnaryCallable deleteUserCallable() { @@ -705,15 +779,19 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * ListUsersRequest request = - * ListUsersRequest.newBuilder() - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * for (User element : identityClient.listUsers(request).iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * ListUsersRequest request = + * ListUsersRequest.newBuilder() + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * for (User element : identityClient.listUsers(request).iterateAll()) { + * // doThingsWith(element); * } * } * @@ -734,17 +812,21 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * ListUsersRequest request = - * ListUsersRequest.newBuilder() - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * ApiFuture future = identityClient.listUsersPagedCallable().futureCall(request); - * // Do something. - * for (User element : future.get().iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * ListUsersRequest request = + * ListUsersRequest.newBuilder() + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * ApiFuture future = identityClient.listUsersPagedCallable().futureCall(request); + * // Do something. + * for (User element : future.get().iterateAll()) { + * // doThingsWith(element); * } * } */ @@ -762,23 +844,27 @@ public class IdentityClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (IdentityClient identityClient = IdentityClient.create()) { - * ListUsersRequest request = - * ListUsersRequest.newBuilder() - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * while (true) { - * ListUsersResponse response = identityClient.listUsersCallable().call(request); - * for (User element : response.getUsersList()) { - * // doThingsWith(element); - * } - * String nextPageToken = response.getNextPageToken(); - * if (!Strings.isNullOrEmpty(nextPageToken)) { - * request = request.toBuilder().setPageToken(nextPageToken).build(); - * } else { - * break; - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * IdentityClient identityClient = IdentityClient.create(); + * ListUsersRequest request = + * ListUsersRequest.newBuilder() + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * while (true) { + * ListUsersResponse response = identityClient.listUsersCallable().call(request); + * for (User element : response.getUsersList()) { + * // doThingsWith(element); + * } + * String nextPageToken = response.getNextPageToken(); + * if (!Strings.isNullOrEmpty(nextPageToken)) { + * request = request.toBuilder().setPageToken(nextPageToken).build(); + * } else { + * break; * } * } * } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden index 359ba586244e..9a7db5816f2e 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden @@ -37,11 +37,15 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * String displayName = "displayName1714148973"; - * String description = "description-1724546052"; - * Room response = messagingClient.createRoom(displayName, description); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * String displayName = "displayName1714148973"; + * String description = "description-1724546052"; + * Room response = messagingClient.createRoom(displayName, description); * } * *

Note: close() needs to be called on the MessagingClient object to clean up resources such as @@ -303,6 +307,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * MessagingSettings messagingSettings = * MessagingSettings.newBuilder() * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) @@ -318,6 +327,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * MessagingSettings messagingSettings = * MessagingSettings.newBuilder().setEndpoint(myEndpoint).build(); * MessagingClient messagingClient = MessagingClient.create(messagingSettings); @@ -395,11 +409,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * String displayName = "displayName1714148973"; - * String description = "description-1724546052"; - * Room response = messagingClient.createRoom(displayName, description); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * String displayName = "displayName1714148973"; + * String description = "description-1724546052"; + * Room response = messagingClient.createRoom(displayName, description); * } * * @param displayName @@ -425,11 +443,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * CreateRoomRequest request = - * CreateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); - * Room response = messagingClient.createRoom(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * CreateRoomRequest request = + * CreateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); + * Room response = messagingClient.createRoom(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -449,13 +471,17 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * CreateRoomRequest request = - * CreateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); - * ApiFuture future = messagingClient.createRoomCallable().futureCall(request); - * // Do something. - * Room response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * CreateRoomRequest request = + * CreateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); + * ApiFuture future = messagingClient.createRoomCallable().futureCall(request); + * // Do something. + * Room response = future.get(); * } */ public final UnaryCallable createRoomCallable() { @@ -472,10 +498,14 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * RoomName name = RoomName.of("[ROOM]"); - * Room response = messagingClient.getRoom(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * RoomName name = RoomName.of("[ROOM]"); + * Room response = messagingClient.getRoom(name); * } * * @param name @@ -497,10 +527,14 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * String name = RoomName.of("[ROOM]").toString(); - * Room response = messagingClient.getRoom(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * String name = RoomName.of("[ROOM]").toString(); + * Room response = messagingClient.getRoom(name); * } * * @param name @@ -521,11 +555,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * GetRoomRequest request = - * GetRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); - * Room response = messagingClient.getRoom(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * GetRoomRequest request = + * GetRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); + * Room response = messagingClient.getRoom(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -545,13 +583,17 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * GetRoomRequest request = - * GetRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); - * ApiFuture future = messagingClient.getRoomCallable().futureCall(request); - * // Do something. - * Room response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * GetRoomRequest request = + * GetRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); + * ApiFuture future = messagingClient.getRoomCallable().futureCall(request); + * // Do something. + * Room response = future.get(); * } */ public final UnaryCallable getRoomCallable() { @@ -568,11 +610,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * UpdateRoomRequest request = - * UpdateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); - * Room response = messagingClient.updateRoom(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * UpdateRoomRequest request = + * UpdateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); + * Room response = messagingClient.updateRoom(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -592,13 +638,17 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * UpdateRoomRequest request = - * UpdateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); - * ApiFuture future = messagingClient.updateRoomCallable().futureCall(request); - * // Do something. - * Room response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * UpdateRoomRequest request = + * UpdateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); + * ApiFuture future = messagingClient.updateRoomCallable().futureCall(request); + * // Do something. + * Room response = future.get(); * } */ public final UnaryCallable updateRoomCallable() { @@ -615,10 +665,14 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * RoomName name = RoomName.of("[ROOM]"); - * messagingClient.deleteRoom(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * RoomName name = RoomName.of("[ROOM]"); + * messagingClient.deleteRoom(name); * } * * @param name @@ -640,10 +694,14 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * String name = RoomName.of("[ROOM]").toString(); - * messagingClient.deleteRoom(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * String name = RoomName.of("[ROOM]").toString(); + * messagingClient.deleteRoom(name); * } * * @param name @@ -664,11 +722,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * DeleteRoomRequest request = - * DeleteRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); - * messagingClient.deleteRoom(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * DeleteRoomRequest request = + * DeleteRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); + * messagingClient.deleteRoom(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -688,13 +750,17 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * DeleteRoomRequest request = - * DeleteRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); - * ApiFuture future = messagingClient.deleteRoomCallable().futureCall(request); - * // Do something. - * future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * DeleteRoomRequest request = + * DeleteRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); + * ApiFuture future = messagingClient.deleteRoomCallable().futureCall(request); + * // Do something. + * future.get(); * } */ public final UnaryCallable deleteRoomCallable() { @@ -711,15 +777,19 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * ListRoomsRequest request = - * ListRoomsRequest.newBuilder() - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * for (Room element : messagingClient.listRooms(request).iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * ListRoomsRequest request = + * ListRoomsRequest.newBuilder() + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * for (Room element : messagingClient.listRooms(request).iterateAll()) { + * // doThingsWith(element); * } * } * @@ -740,17 +810,21 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * ListRoomsRequest request = - * ListRoomsRequest.newBuilder() - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * ApiFuture future = messagingClient.listRoomsPagedCallable().futureCall(request); - * // Do something. - * for (Room element : future.get().iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * ListRoomsRequest request = + * ListRoomsRequest.newBuilder() + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * ApiFuture future = messagingClient.listRoomsPagedCallable().futureCall(request); + * // Do something. + * for (Room element : future.get().iterateAll()) { + * // doThingsWith(element); * } * } */ @@ -768,23 +842,27 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * ListRoomsRequest request = - * ListRoomsRequest.newBuilder() - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * while (true) { - * ListRoomsResponse response = messagingClient.listRoomsCallable().call(request); - * for (Room element : response.getRoomsList()) { - * // doThingsWith(element); - * } - * String nextPageToken = response.getNextPageToken(); - * if (!Strings.isNullOrEmpty(nextPageToken)) { - * request = request.toBuilder().setPageToken(nextPageToken).build(); - * } else { - * break; - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * ListRoomsRequest request = + * ListRoomsRequest.newBuilder() + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * while (true) { + * ListRoomsResponse response = messagingClient.listRoomsCallable().call(request); + * for (Room element : response.getRoomsList()) { + * // doThingsWith(element); + * } + * String nextPageToken = response.getNextPageToken(); + * if (!Strings.isNullOrEmpty(nextPageToken)) { + * request = request.toBuilder().setPageToken(nextPageToken).build(); + * } else { + * break; * } * } * } @@ -803,11 +881,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * ProfileName parent = ProfileName.of("[USER]"); - * ByteString image = ByteString.EMPTY; - * Blurb response = messagingClient.createBlurb(parent, image); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * ProfileName parent = ProfileName.of("[USER]"); + * ByteString image = ByteString.EMPTY; + * Blurb response = messagingClient.createBlurb(parent, image); * } * * @param parent @@ -833,11 +915,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * ProfileName parent = ProfileName.of("[USER]"); - * String text = "text3556653"; - * Blurb response = messagingClient.createBlurb(parent, text); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * ProfileName parent = ProfileName.of("[USER]"); + * String text = "text3556653"; + * Blurb response = messagingClient.createBlurb(parent, text); * } * * @param parent @@ -863,11 +949,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * RoomName parent = RoomName.of("[ROOM]"); - * ByteString image = ByteString.EMPTY; - * Blurb response = messagingClient.createBlurb(parent, image); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * RoomName parent = RoomName.of("[ROOM]"); + * ByteString image = ByteString.EMPTY; + * Blurb response = messagingClient.createBlurb(parent, image); * } * * @param parent @@ -893,11 +983,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * RoomName parent = RoomName.of("[ROOM]"); - * String text = "text3556653"; - * Blurb response = messagingClient.createBlurb(parent, text); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * RoomName parent = RoomName.of("[ROOM]"); + * String text = "text3556653"; + * Blurb response = messagingClient.createBlurb(parent, text); * } * * @param parent @@ -923,11 +1017,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * String parent = ProfileName.of("[USER]").toString(); - * ByteString image = ByteString.EMPTY; - * Blurb response = messagingClient.createBlurb(parent, image); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * String parent = ProfileName.of("[USER]").toString(); + * ByteString image = ByteString.EMPTY; + * Blurb response = messagingClient.createBlurb(parent, image); * } * * @param parent @@ -953,11 +1051,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * String parent = ProfileName.of("[USER]").toString(); - * String text = "text3556653"; - * Blurb response = messagingClient.createBlurb(parent, text); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * String parent = ProfileName.of("[USER]").toString(); + * String text = "text3556653"; + * Blurb response = messagingClient.createBlurb(parent, text); * } * * @param parent @@ -983,14 +1085,18 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * CreateBlurbRequest request = - * CreateBlurbRequest.newBuilder() - * .setParent(ProfileName.of("[USER]").toString()) - * .setBlurb(Blurb.newBuilder().build()) - * .build(); - * Blurb response = messagingClient.createBlurb(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * CreateBlurbRequest request = + * CreateBlurbRequest.newBuilder() + * .setParent(ProfileName.of("[USER]").toString()) + * .setBlurb(Blurb.newBuilder().build()) + * .build(); + * Blurb response = messagingClient.createBlurb(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1010,16 +1116,20 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * CreateBlurbRequest request = - * CreateBlurbRequest.newBuilder() - * .setParent(ProfileName.of("[USER]").toString()) - * .setBlurb(Blurb.newBuilder().build()) - * .build(); - * ApiFuture future = messagingClient.createBlurbCallable().futureCall(request); - * // Do something. - * Blurb response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * CreateBlurbRequest request = + * CreateBlurbRequest.newBuilder() + * .setParent(ProfileName.of("[USER]").toString()) + * .setBlurb(Blurb.newBuilder().build()) + * .build(); + * ApiFuture future = messagingClient.createBlurbCallable().futureCall(request); + * // Do something. + * Blurb response = future.get(); * } */ public final UnaryCallable createBlurbCallable() { @@ -1036,10 +1146,14 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * BlurbName name = BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]"); - * Blurb response = messagingClient.getBlurb(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * BlurbName name = BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]"); + * Blurb response = messagingClient.getBlurb(name); * } * * @param name @@ -1061,11 +1175,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * String name = - * BlurbName.ofUserLegacyUserBlurbName("[USER]", "[LEGACY_USER]", "[BLURB]").toString(); - * Blurb response = messagingClient.getBlurb(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * String name = + * BlurbName.ofUserLegacyUserBlurbName("[USER]", "[LEGACY_USER]", "[BLURB]").toString(); + * Blurb response = messagingClient.getBlurb(name); * } * * @param name @@ -1086,13 +1204,17 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * GetBlurbRequest request = - * GetBlurbRequest.newBuilder() - * .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) - * .build(); - * Blurb response = messagingClient.getBlurb(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * GetBlurbRequest request = + * GetBlurbRequest.newBuilder() + * .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) + * .build(); + * Blurb response = messagingClient.getBlurb(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1112,15 +1234,19 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * GetBlurbRequest request = - * GetBlurbRequest.newBuilder() - * .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) - * .build(); - * ApiFuture future = messagingClient.getBlurbCallable().futureCall(request); - * // Do something. - * Blurb response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * GetBlurbRequest request = + * GetBlurbRequest.newBuilder() + * .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) + * .build(); + * ApiFuture future = messagingClient.getBlurbCallable().futureCall(request); + * // Do something. + * Blurb response = future.get(); * } */ public final UnaryCallable getBlurbCallable() { @@ -1137,11 +1263,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * UpdateBlurbRequest request = - * UpdateBlurbRequest.newBuilder().setBlurb(Blurb.newBuilder().build()).build(); - * Blurb response = messagingClient.updateBlurb(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * UpdateBlurbRequest request = + * UpdateBlurbRequest.newBuilder().setBlurb(Blurb.newBuilder().build()).build(); + * Blurb response = messagingClient.updateBlurb(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1161,13 +1291,17 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * UpdateBlurbRequest request = - * UpdateBlurbRequest.newBuilder().setBlurb(Blurb.newBuilder().build()).build(); - * ApiFuture future = messagingClient.updateBlurbCallable().futureCall(request); - * // Do something. - * Blurb response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * UpdateBlurbRequest request = + * UpdateBlurbRequest.newBuilder().setBlurb(Blurb.newBuilder().build()).build(); + * ApiFuture future = messagingClient.updateBlurbCallable().futureCall(request); + * // Do something. + * Blurb response = future.get(); * } */ public final UnaryCallable updateBlurbCallable() { @@ -1184,10 +1318,14 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * BlurbName name = BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]"); - * messagingClient.deleteBlurb(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * BlurbName name = BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]"); + * messagingClient.deleteBlurb(name); * } * * @param name @@ -1209,11 +1347,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * String name = - * BlurbName.ofUserLegacyUserBlurbName("[USER]", "[LEGACY_USER]", "[BLURB]").toString(); - * messagingClient.deleteBlurb(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * String name = + * BlurbName.ofUserLegacyUserBlurbName("[USER]", "[LEGACY_USER]", "[BLURB]").toString(); + * messagingClient.deleteBlurb(name); * } * * @param name @@ -1234,13 +1376,17 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * DeleteBlurbRequest request = - * DeleteBlurbRequest.newBuilder() - * .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) - * .build(); - * messagingClient.deleteBlurb(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * DeleteBlurbRequest request = + * DeleteBlurbRequest.newBuilder() + * .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) + * .build(); + * messagingClient.deleteBlurb(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1260,15 +1406,19 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * DeleteBlurbRequest request = - * DeleteBlurbRequest.newBuilder() - * .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) - * .build(); - * ApiFuture future = messagingClient.deleteBlurbCallable().futureCall(request); - * // Do something. - * future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * DeleteBlurbRequest request = + * DeleteBlurbRequest.newBuilder() + * .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) + * .build(); + * ApiFuture future = messagingClient.deleteBlurbCallable().futureCall(request); + * // Do something. + * future.get(); * } */ public final UnaryCallable deleteBlurbCallable() { @@ -1285,11 +1435,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * ProfileName parent = ProfileName.of("[USER]"); - * for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * ProfileName parent = ProfileName.of("[USER]"); + * for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { + * // doThingsWith(element); * } * } * @@ -1312,11 +1466,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * RoomName parent = RoomName.of("[ROOM]"); - * for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * RoomName parent = RoomName.of("[ROOM]"); + * for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { + * // doThingsWith(element); * } * } * @@ -1339,11 +1497,15 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * String parent = ProfileName.of("[USER]").toString(); - * for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * String parent = ProfileName.of("[USER]").toString(); + * for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { + * // doThingsWith(element); * } * } * @@ -1365,16 +1527,20 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * ListBlurbsRequest request = - * ListBlurbsRequest.newBuilder() - * .setParent(ProfileName.of("[USER]").toString()) - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * for (Blurb element : messagingClient.listBlurbs(request).iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * ListBlurbsRequest request = + * ListBlurbsRequest.newBuilder() + * .setParent(ProfileName.of("[USER]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * for (Blurb element : messagingClient.listBlurbs(request).iterateAll()) { + * // doThingsWith(element); * } * } * @@ -1395,18 +1561,22 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * ListBlurbsRequest request = - * ListBlurbsRequest.newBuilder() - * .setParent(ProfileName.of("[USER]").toString()) - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * ApiFuture future = messagingClient.listBlurbsPagedCallable().futureCall(request); - * // Do something. - * for (Blurb element : future.get().iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * ListBlurbsRequest request = + * ListBlurbsRequest.newBuilder() + * .setParent(ProfileName.of("[USER]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * ApiFuture future = messagingClient.listBlurbsPagedCallable().futureCall(request); + * // Do something. + * for (Blurb element : future.get().iterateAll()) { + * // doThingsWith(element); * } * } */ @@ -1424,24 +1594,28 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * ListBlurbsRequest request = - * ListBlurbsRequest.newBuilder() - * .setParent(ProfileName.of("[USER]").toString()) - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * while (true) { - * ListBlurbsResponse response = messagingClient.listBlurbsCallable().call(request); - * for (Blurb element : response.getBlurbsList()) { - * // doThingsWith(element); - * } - * String nextPageToken = response.getNextPageToken(); - * if (!Strings.isNullOrEmpty(nextPageToken)) { - * request = request.toBuilder().setPageToken(nextPageToken).build(); - * } else { - * break; - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * ListBlurbsRequest request = + * ListBlurbsRequest.newBuilder() + * .setParent(ProfileName.of("[USER]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * while (true) { + * ListBlurbsResponse response = messagingClient.listBlurbsCallable().call(request); + * for (Blurb element : response.getBlurbsList()) { + * // doThingsWith(element); + * } + * String nextPageToken = response.getNextPageToken(); + * if (!Strings.isNullOrEmpty(nextPageToken)) { + * request = request.toBuilder().setPageToken(nextPageToken).build(); + * } else { + * break; * } * } * } @@ -1460,10 +1634,14 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * String query = "query107944136"; - * SearchBlurbsResponse response = messagingClient.searchBlurbsAsync(query).get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * String query = "query107944136"; + * SearchBlurbsResponse response = messagingClient.searchBlurbsAsync(query).get(); * } * * @param query @@ -1485,16 +1663,20 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * SearchBlurbsRequest request = - * SearchBlurbsRequest.newBuilder() - * .setQuery("query107944136") - * .setParent(ProfileName.of("[USER]").toString()) - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * SearchBlurbsResponse response = messagingClient.searchBlurbsAsync(request).get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * SearchBlurbsRequest request = + * SearchBlurbsRequest.newBuilder() + * .setQuery("query107944136") + * .setParent(ProfileName.of("[USER]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * SearchBlurbsResponse response = messagingClient.searchBlurbsAsync(request).get(); * } * * @param request The request object containing all of the parameters for the API call. @@ -1515,19 +1697,23 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * SearchBlurbsRequest request = - * SearchBlurbsRequest.newBuilder() - * .setQuery("query107944136") - * .setParent(ProfileName.of("[USER]").toString()) - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * OperationFuture future = - * messagingClient.searchBlurbsOperationCallable().futureCall(request); - * // Do something. - * SearchBlurbsResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * SearchBlurbsRequest request = + * SearchBlurbsRequest.newBuilder() + * .setQuery("query107944136") + * .setParent(ProfileName.of("[USER]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * OperationFuture future = + * messagingClient.searchBlurbsOperationCallable().futureCall(request); + * // Do something. + * SearchBlurbsResponse response = future.get(); * } */ public final OperationCallable @@ -1545,18 +1731,22 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * SearchBlurbsRequest request = - * SearchBlurbsRequest.newBuilder() - * .setQuery("query107944136") - * .setParent(ProfileName.of("[USER]").toString()) - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * ApiFuture future = messagingClient.searchBlurbsCallable().futureCall(request); - * // Do something. - * Operation response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * SearchBlurbsRequest request = + * SearchBlurbsRequest.newBuilder() + * .setQuery("query107944136") + * .setParent(ProfileName.of("[USER]").toString()) + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * ApiFuture future = messagingClient.searchBlurbsCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); * } */ public final UnaryCallable searchBlurbsCallable() { @@ -1573,14 +1763,18 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * StreamBlurbsRequest request = - * StreamBlurbsRequest.newBuilder().setName(ProfileName.of("[USER]").toString()).build(); - * ServerStream stream = - * messagingClient.streamBlurbsCallable().call(request); - * for (StreamBlurbsResponse response : stream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * StreamBlurbsRequest request = + * StreamBlurbsRequest.newBuilder().setName(ProfileName.of("[USER]").toString()).build(); + * ServerStream stream = + * messagingClient.streamBlurbsCallable().call(request); + * for (StreamBlurbsResponse response : stream) { + * // Do something when a response is received. * } * } */ @@ -1599,33 +1793,37 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * ApiStreamObserver responseObserver = - * new ApiStreamObserver() { - * {@literal @}Override - * public void onNext(SendBlurbsResponse response) { - * // Do something when a response is received. - * } - * - * {@literal @}Override - * public void onError(Throwable t) { - * // Add error-handling - * } - * - * {@literal @}Override - * public void onCompleted() { - * // Do something when complete. - * } - * }; - * ApiStreamObserver requestObserver = - * messagingClient.sendBlurbs().clientStreamingCall(responseObserver); - * CreateBlurbRequest request = - * CreateBlurbRequest.newBuilder() - * .setParent(ProfileName.of("[USER]").toString()) - * .setBlurb(Blurb.newBuilder().build()) - * .build(); - * requestObserver.onNext(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * ApiStreamObserver responseObserver = + * new ApiStreamObserver() { + * {@literal @}Override + * public void onNext(SendBlurbsResponse response) { + * // Do something when a response is received. + * } + * + * {@literal @}Override + * public void onError(Throwable t) { + * // Add error-handling + * } + * + * {@literal @}Override + * public void onCompleted() { + * // Do something when complete. + * } + * }; + * ApiStreamObserver requestObserver = + * messagingClient.sendBlurbs().clientStreamingCall(responseObserver); + * CreateBlurbRequest request = + * CreateBlurbRequest.newBuilder() + * .setParent(ProfileName.of("[USER]").toString()) + * .setBlurb(Blurb.newBuilder().build()) + * .build(); + * requestObserver.onNext(request); * } */ public final ClientStreamingCallable @@ -1643,14 +1841,18 @@ public class MessagingClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (MessagingClient messagingClient = MessagingClient.create()) { - * BidiStream bidiStream = - * messagingClient.connectCallable().call(); - * ConnectRequest request = ConnectRequest.newBuilder().build(); - * bidiStream.send(request); - * for (StreamBlurbsResponse response : bidiStream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * MessagingClient messagingClient = MessagingClient.create(); + * BidiStream bidiStream = + * messagingClient.connectCallable().call(); + * ConnectRequest request = ConnectRequest.newBuilder().build(); + * bidiStream.send(request); + * for (StreamBlurbsResponse response : bidiStream) { + * // Do something when a response is received. * } * } */ diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/AsyncGetBook.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/AsyncGetBook.golden index 94239b0ccb5d..6212019d2475 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/AsyncGetBook.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/AsyncGetBook.golden @@ -35,17 +35,21 @@ public class AsyncGetBook { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (BookshopClient bookshopClient = BookshopClient.create()) { - GetBookRequest request = - GetBookRequest.newBuilder() - .setBooksCount1(1618425911) - .setBooksList2("booksList2-1119589686") - .addAllBooks3(new ArrayList()) - .build(); - ApiFuture future = bookshopClient.getBookCallable().futureCall(request); - // Do something. - Book response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + BookshopClient bookshopClient = BookshopClient.create(); + GetBookRequest request = + GetBookRequest.newBuilder() + .setBooksCount1(1618425911) + .setBooksList2("booksList2-1119589686") + .addAllBooks3(new ArrayList()) + .build(); + ApiFuture future = bookshopClient.getBookCallable().futureCall(request); + // Do something. + Book response = future.get(); } } // [END goldensample_generated_Bookshop_GetBook_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncCreateSetCredentialsProvider.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncCreateSetCredentialsProvider.golden index 1743583f3a15..f7a6b1de87a8 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncCreateSetCredentialsProvider.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncCreateSetCredentialsProvider.golden @@ -34,6 +34,11 @@ public class SyncCreateSetCredentialsProvider { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle BookshopSettings bookshopSettings = BookshopSettings.newBuilder() .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncCreateSetEndpoint.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncCreateSetEndpoint.golden index 021437279afd..bf46cb56a8af 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncCreateSetEndpoint.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncCreateSetEndpoint.golden @@ -33,6 +33,11 @@ public class SyncCreateSetEndpoint { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle BookshopSettings bookshopSettings = BookshopSettings.newBuilder().setEndpoint(myEndpoint).build(); BookshopClient bookshopClient = BookshopClient.create(bookshopSettings); diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBook.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBook.golden index 7d3b2bcbeb13..5392b610a209 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBook.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBook.golden @@ -34,15 +34,19 @@ public class SyncGetBook { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (BookshopClient bookshopClient = BookshopClient.create()) { - GetBookRequest request = - GetBookRequest.newBuilder() - .setBooksCount1(1618425911) - .setBooksList2("booksList2-1119589686") - .addAllBooks3(new ArrayList()) - .build(); - Book response = bookshopClient.getBook(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + BookshopClient bookshopClient = BookshopClient.create(); + GetBookRequest request = + GetBookRequest.newBuilder() + .setBooksCount1(1618425911) + .setBooksList2("booksList2-1119589686") + .addAllBooks3(new ArrayList()) + .build(); + Book response = bookshopClient.getBook(request); } } // [END goldensample_generated_Bookshop_GetBook_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBookIntListbook.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBookIntListbook.golden index 7a6f9db7ab51..6db40010ec1d 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBookIntListbook.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBookIntListbook.golden @@ -34,11 +34,15 @@ public class SyncGetBookIntListbook { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (BookshopClient bookshopClient = BookshopClient.create()) { - int booksCount = 1618425911; - List books = new ArrayList<>(); - Book response = bookshopClient.getBook(booksCount, books); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + BookshopClient bookshopClient = BookshopClient.create(); + int booksCount = 1618425911; + List books = new ArrayList<>(); + Book response = bookshopClient.getBook(booksCount, books); } } // [END goldensample_generated_Bookshop_GetBook_IntListbook_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBookStringListbook.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBookStringListbook.golden index a2d3ceaabaaf..ee4d4beb7e69 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBookStringListbook.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/bookshopclient/SyncGetBookStringListbook.golden @@ -34,11 +34,15 @@ public class SyncGetBookStringListbook { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (BookshopClient bookshopClient = BookshopClient.create()) { - String booksList = "booksList2-1119589686"; - List books = new ArrayList<>(); - Book response = bookshopClient.getBook(booksList, books); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + BookshopClient bookshopClient = BookshopClient.create(); + String booksList = "booksList2-1119589686"; + List books = new ArrayList<>(); + Book response = bookshopClient.getBook(booksList, books); } } // [END goldensample_generated_Bookshop_GetBook_StringListbook_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/AsyncFastFibonacci.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/AsyncFastFibonacci.golden index dbe0565f8fe5..1b04bc7d7acc 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/AsyncFastFibonacci.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/AsyncFastFibonacci.golden @@ -34,12 +34,16 @@ public class AsyncFastFibonacci { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create()) { - FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); - ApiFuture future = deprecatedServiceClient.fastFibonacciCallable().futureCall(request); - // Do something. - future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create(); + FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); + ApiFuture future = deprecatedServiceClient.fastFibonacciCallable().futureCall(request); + // Do something. + future.get(); } } // [END goldensample_generated_DeprecatedService_FastFibonacci_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/AsyncSlowFibonacci.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/AsyncSlowFibonacci.golden index 1c2973890eb8..313e5f9463c5 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/AsyncSlowFibonacci.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/AsyncSlowFibonacci.golden @@ -34,12 +34,16 @@ public class AsyncSlowFibonacci { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create()) { - FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); - ApiFuture future = deprecatedServiceClient.slowFibonacciCallable().futureCall(request); - // Do something. - future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create(); + FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); + ApiFuture future = deprecatedServiceClient.slowFibonacciCallable().futureCall(request); + // Do something. + future.get(); } } // [END goldensample_generated_DeprecatedService_SlowFibonacci_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncCreateSetCredentialsProvider.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncCreateSetCredentialsProvider.golden index 6b530479adc2..3701fe09f734 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncCreateSetCredentialsProvider.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncCreateSetCredentialsProvider.golden @@ -34,6 +34,11 @@ public class SyncCreateSetCredentialsProvider { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle DeprecatedServiceSettings deprecatedServiceSettings = DeprecatedServiceSettings.newBuilder() .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncCreateSetEndpoint.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncCreateSetEndpoint.golden index d688b1c89dc5..0971780c821d 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncCreateSetEndpoint.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncCreateSetEndpoint.golden @@ -33,6 +33,11 @@ public class SyncCreateSetEndpoint { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle DeprecatedServiceSettings deprecatedServiceSettings = DeprecatedServiceSettings.newBuilder().setEndpoint(myEndpoint).build(); DeprecatedServiceClient deprecatedServiceClient = diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncFastFibonacci.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncFastFibonacci.golden index e65a153f67ac..cba081238747 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncFastFibonacci.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncFastFibonacci.golden @@ -33,10 +33,14 @@ public class SyncFastFibonacci { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create()) { - FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); - deprecatedServiceClient.fastFibonacci(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create(); + FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); + deprecatedServiceClient.fastFibonacci(request); } } // [END goldensample_generated_DeprecatedService_FastFibonacci_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncSlowFibonacci.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncSlowFibonacci.golden index 84c260ec2822..6b861c353ec5 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncSlowFibonacci.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/deprecatedserviceclient/SyncSlowFibonacci.golden @@ -33,10 +33,14 @@ public class SyncSlowFibonacci { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create()) { - FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); - deprecatedServiceClient.slowFibonacci(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + DeprecatedServiceClient deprecatedServiceClient = DeprecatedServiceClient.create(); + FibonacciRequest request = FibonacciRequest.newBuilder().setValue(111972721).build(); + deprecatedServiceClient.slowFibonacci(request); } } // [END goldensample_generated_DeprecatedService_SlowFibonacci_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncBlock.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncBlock.golden index eab80046e53c..1e64144423f8 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncBlock.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncBlock.golden @@ -34,12 +34,16 @@ public class AsyncBlock { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - BlockRequest request = BlockRequest.newBuilder().build(); - ApiFuture future = echoClient.blockCallable().futureCall(request); - // Do something. - BlockResponse response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + BlockRequest request = BlockRequest.newBuilder().build(); + ApiFuture future = echoClient.blockCallable().futureCall(request); + // Do something. + BlockResponse response = future.get(); } } // [END goldensample_generated_Echo_Block_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncChat.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncChat.golden index e4730a1d9a26..9750a913090f 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncChat.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncChat.golden @@ -37,19 +37,23 @@ public class AsyncChat { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - BidiStream bidiStream = echoClient.chatCallable().call(); - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setSeverity(Severity.forNumber(0)) - .setFoobar(Foobar.newBuilder().build()) - .build(); - bidiStream.send(request); - for (EchoResponse response : bidiStream) { - // Do something when a response is received. - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + BidiStream bidiStream = echoClient.chatCallable().call(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setSeverity(Severity.forNumber(0)) + .setFoobar(Foobar.newBuilder().build()) + .build(); + bidiStream.send(request); + for (EchoResponse response : bidiStream) { + // Do something when a response is received. } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncChatAgain.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncChatAgain.golden index 423a7c38d256..dcf3fe5ac8c4 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncChatAgain.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncChatAgain.golden @@ -37,19 +37,23 @@ public class AsyncChatAgain { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - BidiStream bidiStream = echoClient.chatAgainCallable().call(); - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setSeverity(Severity.forNumber(0)) - .setFoobar(Foobar.newBuilder().build()) - .build(); - bidiStream.send(request); - for (EchoResponse response : bidiStream) { - // Do something when a response is received. - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + BidiStream bidiStream = echoClient.chatAgainCallable().call(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setSeverity(Severity.forNumber(0)) + .setFoobar(Foobar.newBuilder().build()) + .build(); + bidiStream.send(request); + for (EchoResponse response : bidiStream) { + // Do something when a response is received. } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncCollect.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncCollect.golden index d750b9290bba..694ea5f78808 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncCollect.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncCollect.golden @@ -37,35 +37,39 @@ public class AsyncCollect { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - ApiStreamObserver responseObserver = - new ApiStreamObserver() { - @Override - public void onNext(EchoResponse response) { - // Do something when a response is received. - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + ApiStreamObserver responseObserver = + new ApiStreamObserver() { + @Override + public void onNext(EchoResponse response) { + // Do something when a response is received. + } - @Override - public void onError(Throwable t) { - // Add error-handling - } + @Override + public void onError(Throwable t) { + // Add error-handling + } - @Override - public void onCompleted() { - // Do something when complete. - } - }; - ApiStreamObserver requestObserver = - echoClient.collect().clientStreamingCall(responseObserver); - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setSeverity(Severity.forNumber(0)) - .setFoobar(Foobar.newBuilder().build()) - .build(); - requestObserver.onNext(request); - } + @Override + public void onCompleted() { + // Do something when complete. + } + }; + ApiStreamObserver requestObserver = + echoClient.collect().clientStreamingCall(responseObserver); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setSeverity(Severity.forNumber(0)) + .setFoobar(Foobar.newBuilder().build()) + .build(); + requestObserver.onNext(request); } } // [END goldensample_generated_Echo_Collect_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncCollideName.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncCollideName.golden index c25f9a7f945a..38b24ae7c521 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncCollideName.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncCollideName.golden @@ -37,18 +37,22 @@ public class AsyncCollideName { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setSeverity(Severity.forNumber(0)) - .setFoobar(Foobar.newBuilder().build()) - .build(); - ApiFuture future = echoClient.collideNameCallable().futureCall(request); - // Do something. - Object response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setSeverity(Severity.forNumber(0)) + .setFoobar(Foobar.newBuilder().build()) + .build(); + ApiFuture future = echoClient.collideNameCallable().futureCall(request); + // Do something. + Object response = future.get(); } } // [END goldensample_generated_Echo_CollideName_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncEcho.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncEcho.golden index 0fe243d58238..10d2a40bb5ad 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncEcho.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncEcho.golden @@ -37,18 +37,22 @@ public class AsyncEcho { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setSeverity(Severity.forNumber(0)) - .setFoobar(Foobar.newBuilder().build()) - .build(); - ApiFuture future = echoClient.echoCallable().futureCall(request); - // Do something. - EchoResponse response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setSeverity(Severity.forNumber(0)) + .setFoobar(Foobar.newBuilder().build()) + .build(); + ApiFuture future = echoClient.echoCallable().futureCall(request); + // Do something. + EchoResponse response = future.get(); } } // [END goldensample_generated_Echo_Echo_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncExpand.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncExpand.golden index c9f643ca7143..f9ebf640058f 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncExpand.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncExpand.golden @@ -34,13 +34,17 @@ public class AsyncExpand { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - ExpandRequest request = - ExpandRequest.newBuilder().setContent("content951530617").setInfo("info3237038").build(); - ServerStream stream = echoClient.expandCallable().call(request); - for (EchoResponse response : stream) { - // Do something when a response is received. - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + ExpandRequest request = + ExpandRequest.newBuilder().setContent("content951530617").setInfo("info3237038").build(); + ServerStream stream = echoClient.expandCallable().call(request); + for (EchoResponse response : stream) { + // Do something when a response is received. } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpand.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpand.golden index cf324c1945ab..e35b3d41f6d9 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpand.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpand.golden @@ -34,18 +34,22 @@ public class AsyncPagedExpand { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - PagedExpandRequest request = - PagedExpandRequest.newBuilder() - .setContent("content951530617") - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - ApiFuture future = echoClient.pagedExpandPagedCallable().futureCall(request); - // Do something. - for (EchoResponse element : future.get().iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + PagedExpandRequest request = + PagedExpandRequest.newBuilder() + .setContent("content951530617") + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + ApiFuture future = echoClient.pagedExpandPagedCallable().futureCall(request); + // Do something. + for (EchoResponse element : future.get().iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpandLegacy.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpandLegacy.golden index 04fdf3b93f2c..062398046d3c 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpandLegacy.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpandLegacy.golden @@ -34,18 +34,22 @@ public class AsyncPagedExpandLegacy { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - PagedExpandLegacyRequest request = - PagedExpandLegacyRequest.newBuilder() - .setContent("content951530617") - .setMaxResults(1128457243) - .setPageToken("pageToken873572522") - .build(); - ApiFuture future = - echoClient.pagedExpandLegacyCallable().futureCall(request); - // Do something. - PagedExpandResponse response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + PagedExpandLegacyRequest request = + PagedExpandLegacyRequest.newBuilder() + .setContent("content951530617") + .setMaxResults(1128457243) + .setPageToken("pageToken873572522") + .build(); + ApiFuture future = + echoClient.pagedExpandLegacyCallable().futureCall(request); + // Do something. + PagedExpandResponse response = future.get(); } } // [END goldensample_generated_Echo_PagedExpandLegacy_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpandPaged.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpandPaged.golden index 70c49d52758a..830d4708a60e 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpandPaged.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncPagedExpandPaged.golden @@ -35,24 +35,28 @@ public class AsyncPagedExpandPaged { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - PagedExpandRequest request = - PagedExpandRequest.newBuilder() - .setContent("content951530617") - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - while (true) { - PagedExpandResponse response = echoClient.pagedExpandCallable().call(request); - for (EchoResponse element : response.getResponsesList()) { - // doThingsWith(element); - } - String nextPageToken = response.getNextPageToken(); - if (!Strings.isNullOrEmpty(nextPageToken)) { - request = request.toBuilder().setPageToken(nextPageToken).build(); - } else { - break; - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + PagedExpandRequest request = + PagedExpandRequest.newBuilder() + .setContent("content951530617") + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + while (true) { + PagedExpandResponse response = echoClient.pagedExpandCallable().call(request); + for (EchoResponse element : response.getResponsesList()) { + // doThingsWith(element); + } + String nextPageToken = response.getNextPageToken(); + if (!Strings.isNullOrEmpty(nextPageToken)) { + request = request.toBuilder().setPageToken(nextPageToken).build(); + } else { + break; } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncSimplePagedExpand.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncSimplePagedExpand.golden index 308cb10bd296..1ee83046ce93 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncSimplePagedExpand.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncSimplePagedExpand.golden @@ -34,19 +34,23 @@ public class AsyncSimplePagedExpand { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - PagedExpandRequest request = - PagedExpandRequest.newBuilder() - .setContent("content951530617") - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - ApiFuture future = - echoClient.simplePagedExpandPagedCallable().futureCall(request); - // Do something. - for (EchoResponse element : future.get().iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + PagedExpandRequest request = + PagedExpandRequest.newBuilder() + .setContent("content951530617") + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + ApiFuture future = + echoClient.simplePagedExpandPagedCallable().futureCall(request); + // Do something. + for (EchoResponse element : future.get().iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncSimplePagedExpandPaged.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncSimplePagedExpandPaged.golden index 2f1be8aba179..5b8fba5e8cd0 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncSimplePagedExpandPaged.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncSimplePagedExpandPaged.golden @@ -35,24 +35,28 @@ public class AsyncSimplePagedExpandPaged { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - PagedExpandRequest request = - PagedExpandRequest.newBuilder() - .setContent("content951530617") - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - while (true) { - PagedExpandResponse response = echoClient.simplePagedExpandCallable().call(request); - for (EchoResponse element : response.getResponsesList()) { - // doThingsWith(element); - } - String nextPageToken = response.getNextPageToken(); - if (!Strings.isNullOrEmpty(nextPageToken)) { - request = request.toBuilder().setPageToken(nextPageToken).build(); - } else { - break; - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + PagedExpandRequest request = + PagedExpandRequest.newBuilder() + .setContent("content951530617") + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + while (true) { + PagedExpandResponse response = echoClient.simplePagedExpandCallable().call(request); + for (EchoResponse element : response.getResponsesList()) { + // doThingsWith(element); + } + String nextPageToken = response.getNextPageToken(); + if (!Strings.isNullOrEmpty(nextPageToken)) { + request = request.toBuilder().setPageToken(nextPageToken).build(); + } else { + break; } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncWait.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncWait.golden index d416fb42d06f..a2f64b317116 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncWait.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncWait.golden @@ -34,12 +34,16 @@ public class AsyncWait { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - WaitRequest request = WaitRequest.newBuilder().build(); - ApiFuture future = echoClient.waitCallable().futureCall(request); - // Do something. - Operation response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + WaitRequest request = WaitRequest.newBuilder().build(); + ApiFuture future = echoClient.waitCallable().futureCall(request); + // Do something. + Operation response = future.get(); } } // [END goldensample_generated_Echo_Wait_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncWaitLRO.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncWaitLRO.golden index 08b3dbe42d00..eb48929cbbe5 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncWaitLRO.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/AsyncWaitLRO.golden @@ -35,13 +35,17 @@ public class AsyncWaitLRO { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - WaitRequest request = WaitRequest.newBuilder().build(); - OperationFuture future = - echoClient.waitOperationCallable().futureCall(request); - // Do something. - WaitResponse response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + WaitRequest request = WaitRequest.newBuilder().build(); + OperationFuture future = + echoClient.waitOperationCallable().futureCall(request); + // Do something. + WaitResponse response = future.get(); } } // [END goldensample_generated_Echo_Wait_LRO_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncBlock.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncBlock.golden index fbb92823b123..ca702684005b 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncBlock.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncBlock.golden @@ -33,10 +33,14 @@ public class SyncBlock { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - BlockRequest request = BlockRequest.newBuilder().build(); - BlockResponse response = echoClient.block(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + BlockRequest request = BlockRequest.newBuilder().build(); + BlockResponse response = echoClient.block(request); } } // [END goldensample_generated_Echo_Block_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCollideName.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCollideName.golden index 47b8b4308662..62700749a6a2 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCollideName.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCollideName.golden @@ -36,16 +36,20 @@ public class SyncCollideName { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setSeverity(Severity.forNumber(0)) - .setFoobar(Foobar.newBuilder().build()) - .build(); - Object response = echoClient.collideName(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setSeverity(Severity.forNumber(0)) + .setFoobar(Foobar.newBuilder().build()) + .build(); + Object response = echoClient.collideName(request); } } // [END goldensample_generated_Echo_CollideName_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCreateSetCredentialsProvider.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCreateSetCredentialsProvider.golden index 4eb818756094..91004f3837b2 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCreateSetCredentialsProvider.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCreateSetCredentialsProvider.golden @@ -34,6 +34,11 @@ public class SyncCreateSetCredentialsProvider { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoSettings echoSettings = EchoSettings.newBuilder() .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCreateSetEndpoint.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCreateSetEndpoint.golden index 1f5a8f82aef7..69cfbda73865 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCreateSetEndpoint.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncCreateSetEndpoint.golden @@ -33,6 +33,11 @@ public class SyncCreateSetEndpoint { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoSettings echoSettings = EchoSettings.newBuilder().setEndpoint(myEndpoint).build(); EchoClient echoClient = EchoClient.create(echoSettings); } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEcho.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEcho.golden index e5de2abc5450..f3fda8fa9759 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEcho.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEcho.golden @@ -36,16 +36,20 @@ public class SyncEcho { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - .setSeverity(Severity.forNumber(0)) - .setFoobar(Foobar.newBuilder().build()) - .build(); - EchoResponse response = echoClient.echo(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + .setSeverity(Severity.forNumber(0)) + .setFoobar(Foobar.newBuilder().build()) + .build(); + EchoResponse response = echoClient.echo(request); } } // [END goldensample_generated_Echo_Echo_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoFoobarname.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoFoobarname.golden index 1ee28149d482..9510f23560dc 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoFoobarname.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoFoobarname.golden @@ -33,10 +33,14 @@ public class SyncEchoFoobarname { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - FoobarName name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); - EchoResponse response = echoClient.echo(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + FoobarName name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); + EchoResponse response = echoClient.echo(name); } } // [END goldensample_generated_Echo_Echo_Foobarname_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoNoargs.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoNoargs.golden index cc5dbeedb87a..abd21561db2a 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoNoargs.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoNoargs.golden @@ -32,9 +32,13 @@ public class SyncEchoNoargs { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - EchoResponse response = echoClient.echo(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + EchoResponse response = echoClient.echo(); } } // [END goldensample_generated_Echo_Echo_Noargs_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoResourcename.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoResourcename.golden index 5233fe9bdd25..f446d7557ab1 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoResourcename.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoResourcename.golden @@ -34,10 +34,14 @@ public class SyncEchoResourcename { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - ResourceName parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); - EchoResponse response = echoClient.echo(parent); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + ResourceName parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); + EchoResponse response = echoClient.echo(parent); } } // [END goldensample_generated_Echo_Echo_Resourcename_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoStatus.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoStatus.golden index 32a897cc33bc..b4a41483d215 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoStatus.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoStatus.golden @@ -33,10 +33,14 @@ public class SyncEchoStatus { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - Status error = Status.newBuilder().build(); - EchoResponse response = echoClient.echo(error); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + Status error = Status.newBuilder().build(); + EchoResponse response = echoClient.echo(error); } } // [END goldensample_generated_Echo_Echo_Status_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString.golden index 43b2a7c26ebd..13201d200fc3 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString.golden @@ -32,10 +32,14 @@ public class SyncEchoString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - String content = "content951530617"; - EchoResponse response = echoClient.echo(content); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + String content = "content951530617"; + EchoResponse response = echoClient.echo(content); } } // [END goldensample_generated_Echo_Echo_String_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString1.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString1.golden index 7e2c89d8ae7e..6b3e2ce58ebe 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString1.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString1.golden @@ -33,10 +33,14 @@ public class SyncEchoString1 { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - String name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); - EchoResponse response = echoClient.echo(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + String name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); + EchoResponse response = echoClient.echo(name); } } // [END goldensample_generated_Echo_Echo_String1_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString2.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString2.golden index cdf4a72efc06..a0d6340993b1 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString2.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoString2.golden @@ -33,10 +33,14 @@ public class SyncEchoString2 { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - String parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); - EchoResponse response = echoClient.echo(parent); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + String parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); + EchoResponse response = echoClient.echo(parent); } } // [END goldensample_generated_Echo_Echo_String2_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoStringSeverity.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoStringSeverity.golden index d6f42b862f44..9d8aa41e7f06 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoStringSeverity.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncEchoStringSeverity.golden @@ -33,11 +33,15 @@ public class SyncEchoStringSeverity { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - String content = "content951530617"; - Severity severity = Severity.forNumber(0); - EchoResponse response = echoClient.echo(content, severity); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + String content = "content951530617"; + Severity severity = Severity.forNumber(0); + EchoResponse response = echoClient.echo(content, severity); } } // [END goldensample_generated_Echo_Echo_StringSeverity_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncPagedExpand.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncPagedExpand.golden index ba092a99d4a0..12ff06fb244e 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncPagedExpand.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncPagedExpand.golden @@ -33,16 +33,20 @@ public class SyncPagedExpand { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - PagedExpandRequest request = - PagedExpandRequest.newBuilder() - .setContent("content951530617") - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - for (EchoResponse element : echoClient.pagedExpand(request).iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + PagedExpandRequest request = + PagedExpandRequest.newBuilder() + .setContent("content951530617") + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + for (EchoResponse element : echoClient.pagedExpand(request).iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncPagedExpandLegacy.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncPagedExpandLegacy.golden index 51a0bad09a91..7690d225873c 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncPagedExpandLegacy.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncPagedExpandLegacy.golden @@ -33,15 +33,19 @@ public class SyncPagedExpandLegacy { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - PagedExpandLegacyRequest request = - PagedExpandLegacyRequest.newBuilder() - .setContent("content951530617") - .setMaxResults(1128457243) - .setPageToken("pageToken873572522") - .build(); - PagedExpandResponse response = echoClient.pagedExpandLegacy(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + PagedExpandLegacyRequest request = + PagedExpandLegacyRequest.newBuilder() + .setContent("content951530617") + .setMaxResults(1128457243) + .setPageToken("pageToken873572522") + .build(); + PagedExpandResponse response = echoClient.pagedExpandLegacy(request); } } // [END goldensample_generated_Echo_PagedExpandLegacy_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncSimplePagedExpand.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncSimplePagedExpand.golden index 0e75e96f3a89..704d286e9595 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncSimplePagedExpand.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncSimplePagedExpand.golden @@ -33,16 +33,20 @@ public class SyncSimplePagedExpand { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - PagedExpandRequest request = - PagedExpandRequest.newBuilder() - .setContent("content951530617") - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - for (EchoResponse element : echoClient.simplePagedExpand(request).iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + PagedExpandRequest request = + PagedExpandRequest.newBuilder() + .setContent("content951530617") + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + for (EchoResponse element : echoClient.simplePagedExpand(request).iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncSimplePagedExpandNoargs.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncSimplePagedExpandNoargs.golden index dab3712556c7..cfbb9d1dfc11 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncSimplePagedExpandNoargs.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncSimplePagedExpandNoargs.golden @@ -32,10 +32,14 @@ public class SyncSimplePagedExpandNoargs { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - for (EchoResponse element : echoClient.simplePagedExpand().iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + for (EchoResponse element : echoClient.simplePagedExpand().iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWait.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWait.golden index 8e25a6f6e7ae..31b08a049301 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWait.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWait.golden @@ -33,10 +33,14 @@ public class SyncWait { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - WaitRequest request = WaitRequest.newBuilder().build(); - WaitResponse response = echoClient.waitAsync(request).get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + WaitRequest request = WaitRequest.newBuilder().build(); + WaitResponse response = echoClient.waitAsync(request).get(); } } // [END goldensample_generated_Echo_Wait_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWaitDuration.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWaitDuration.golden index 04d2f6c4b565..588c53b9cd0e 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWaitDuration.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWaitDuration.golden @@ -33,10 +33,14 @@ public class SyncWaitDuration { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - Duration ttl = Duration.newBuilder().build(); - WaitResponse response = echoClient.waitAsync(ttl).get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + Duration ttl = Duration.newBuilder().build(); + WaitResponse response = echoClient.waitAsync(ttl).get(); } } // [END goldensample_generated_Echo_Wait_Duration_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWaitTimestamp.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWaitTimestamp.golden index 4121227ddaf6..ce6750ce1144 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWaitTimestamp.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoclient/SyncWaitTimestamp.golden @@ -33,10 +33,14 @@ public class SyncWaitTimestamp { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoClient echoClient = EchoClient.create()) { - Timestamp endTime = Timestamp.newBuilder().build(); - WaitResponse response = echoClient.waitAsync(endTime).get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoClient echoClient = EchoClient.create(); + Timestamp endTime = Timestamp.newBuilder().build(); + WaitResponse response = echoClient.waitAsync(endTime).get(); } } // [END goldensample_generated_Echo_Wait_Timestamp_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatAgainShouldGenerateAsUsual.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatAgainShouldGenerateAsUsual.golden index e745bdb237ce..1f1c40f166f7 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatAgainShouldGenerateAsUsual.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatAgainShouldGenerateAsUsual.golden @@ -36,22 +36,24 @@ public class AsyncChatAgainShouldGenerateAsUsual { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - BidiStream bidiStream = - echoServiceShouldGeneratePartialUsualClient - .chatAgainShouldGenerateAsUsualCallable() - .call(); - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setFoobar(Foobar.newBuilder().build()) - .build(); - bidiStream.send(request); - for (EchoResponse response : bidiStream) { - // Do something when a response is received. - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + BidiStream bidiStream = + echoServiceShouldGeneratePartialUsualClient.chatAgainShouldGenerateAsUsualCallable().call(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setFoobar(Foobar.newBuilder().build()) + .build(); + bidiStream.send(request); + for (EchoResponse response : bidiStream) { + // Do something when a response is received. } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatShouldGenerateAsInternal.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatShouldGenerateAsInternal.golden index dca5a1b9f45d..d45b3a1be4c3 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatShouldGenerateAsInternal.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatShouldGenerateAsInternal.golden @@ -36,21 +36,25 @@ public class AsyncChatShouldGenerateAsInternal { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setFoobar(Foobar.newBuilder().build()) - .build(); - ApiFuture future = - echoServiceShouldGeneratePartialUsualClient - .chatShouldGenerateAsInternalCallable() - .futureCall(request); - // Do something. - EchoResponse response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setFoobar(Foobar.newBuilder().build()) + .build(); + ApiFuture future = + echoServiceShouldGeneratePartialUsualClient + .chatShouldGenerateAsInternalCallable() + .futureCall(request); + // Do something. + EchoResponse response = future.get(); } } // [END goldensample_generated_EchoServiceShouldGeneratePartialUsual_ChatShouldGenerateAsInternal_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatShouldGenerateAsUsual.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatShouldGenerateAsUsual.golden index 0cbc13407c7e..77fb097cced2 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatShouldGenerateAsUsual.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncChatShouldGenerateAsUsual.golden @@ -36,20 +36,24 @@ public class AsyncChatShouldGenerateAsUsual { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - BidiStream bidiStream = - echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsUsualCallable().call(); - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setFoobar(Foobar.newBuilder().build()) - .build(); - bidiStream.send(request); - for (EchoResponse response : bidiStream) { - // Do something when a response is received. - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + BidiStream bidiStream = + echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsUsualCallable().call(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setFoobar(Foobar.newBuilder().build()) + .build(); + bidiStream.send(request); + for (EchoResponse response : bidiStream) { + // Do something when a response is received. } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncEchoShouldGenerateAsInternal.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncEchoShouldGenerateAsInternal.golden index 64d8dd2a4c64..0a218f22e88c 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncEchoShouldGenerateAsInternal.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncEchoShouldGenerateAsInternal.golden @@ -36,20 +36,24 @@ public class AsyncEchoShouldGenerateAsInternal { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - BidiStream bidiStream = - echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsInternalCallable().call(); - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setFoobar(Foobar.newBuilder().build()) - .build(); - bidiStream.send(request); - for (EchoResponse response : bidiStream) { - // Do something when a response is received. - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + BidiStream bidiStream = + echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsInternalCallable().call(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setFoobar(Foobar.newBuilder().build()) + .build(); + bidiStream.send(request); + for (EchoResponse response : bidiStream) { + // Do something when a response is received. } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncEchoShouldGenerateAsUsual.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncEchoShouldGenerateAsUsual.golden index ec63a3c5879a..26fd549cba7d 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncEchoShouldGenerateAsUsual.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/AsyncEchoShouldGenerateAsUsual.golden @@ -36,21 +36,25 @@ public class AsyncEchoShouldGenerateAsUsual { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setFoobar(Foobar.newBuilder().build()) - .build(); - ApiFuture future = - echoServiceShouldGeneratePartialUsualClient - .echoShouldGenerateAsUsualCallable() - .futureCall(request); - // Do something. - EchoResponse response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setFoobar(Foobar.newBuilder().build()) + .build(); + ApiFuture future = + echoServiceShouldGeneratePartialUsualClient + .echoShouldGenerateAsUsualCallable() + .futureCall(request); + // Do something. + EchoResponse response = future.get(); } } // [END goldensample_generated_EchoServiceShouldGeneratePartialUsual_EchoShouldGenerateAsUsual_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternal.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternal.golden index 18017ebfc302..c6cd088747da 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternal.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternal.golden @@ -35,17 +35,21 @@ public class SyncChatShouldGenerateAsInternal { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setFoobar(Foobar.newBuilder().build()) - .build(); - EchoResponse response = - echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setFoobar(Foobar.newBuilder().build()) + .build(); + EchoResponse response = + echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(request); } } // [END goldensample_generated_EchoServiceShouldGeneratePartialUsual_ChatShouldGenerateAsInternal_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalFoobarname.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalFoobarname.golden index f217b8f4ef47..c04f937d4148 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalFoobarname.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalFoobarname.golden @@ -33,12 +33,16 @@ public class SyncChatShouldGenerateAsInternalFoobarname { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - FoobarName name = FoobarName.of("[PROJECT]", "[FOOBAR]"); - EchoResponse response = - echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + FoobarName name = FoobarName.of("[PROJECT]", "[FOOBAR]"); + EchoResponse response = + echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(name); } } // [END goldensample_generated_EchoServiceShouldGeneratePartialUsual_ChatShouldGenerateAsInternal_Foobarname_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalNoargs.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalNoargs.golden index 9b3c95e01785..52760316645b 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalNoargs.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalNoargs.golden @@ -32,11 +32,15 @@ public class SyncChatShouldGenerateAsInternalNoargs { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - EchoResponse response = - echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + EchoResponse response = + echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(); } } // [END goldensample_generated_EchoServiceShouldGeneratePartialUsual_ChatShouldGenerateAsInternal_Noargs_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalString.golden index 1a0216d16dce..70cbc02c6d1d 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncChatShouldGenerateAsInternalString.golden @@ -33,12 +33,16 @@ public class SyncChatShouldGenerateAsInternalString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - String name = FoobarName.of("[PROJECT]", "[FOOBAR]").toString(); - EchoResponse response = - echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + String name = FoobarName.of("[PROJECT]", "[FOOBAR]").toString(); + EchoResponse response = + echoServiceShouldGeneratePartialUsualClient.chatShouldGenerateAsInternal(name); } } // [END goldensample_generated_EchoServiceShouldGeneratePartialUsual_ChatShouldGenerateAsInternal_String_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncCreateSetCredentialsProvider.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncCreateSetCredentialsProvider.golden index 9ea2dc09f36f..e0ad4593556a 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncCreateSetCredentialsProvider.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncCreateSetCredentialsProvider.golden @@ -34,6 +34,11 @@ public class SyncCreateSetCredentialsProvider { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoServiceShouldGeneratePartialUsualSettings echoServiceShouldGeneratePartialUsualSettings = EchoServiceShouldGeneratePartialUsualSettings.newBuilder() .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncCreateSetEndpoint.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncCreateSetEndpoint.golden index 1b58cbe1003c..75934f8e7da0 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncCreateSetEndpoint.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncCreateSetEndpoint.golden @@ -33,6 +33,11 @@ public class SyncCreateSetEndpoint { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoServiceShouldGeneratePartialUsualSettings echoServiceShouldGeneratePartialUsualSettings = EchoServiceShouldGeneratePartialUsualSettings.newBuilder().setEndpoint(myEndpoint).build(); EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsual.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsual.golden index af978eee1e42..77a813bacb9f 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsual.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsual.golden @@ -35,17 +35,21 @@ public class SyncEchoShouldGenerateAsUsual { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - EchoRequest request = - EchoRequest.newBuilder() - .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) - .setFoobar(Foobar.newBuilder().build()) - .build(); - EchoResponse response = - echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + EchoRequest request = + EchoRequest.newBuilder() + .setName(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setParent(FoobarName.of("[PROJECT]", "[FOOBAR]").toString()) + .setFoobar(Foobar.newBuilder().build()) + .build(); + EchoResponse response = + echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(request); } } // [END goldensample_generated_EchoServiceShouldGeneratePartialUsual_EchoShouldGenerateAsUsual_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualFoobarname.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualFoobarname.golden index c2e469912a15..e0c3e5cab182 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualFoobarname.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualFoobarname.golden @@ -33,12 +33,16 @@ public class SyncEchoShouldGenerateAsUsualFoobarname { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - FoobarName name = FoobarName.of("[PROJECT]", "[FOOBAR]"); - EchoResponse response = - echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + FoobarName name = FoobarName.of("[PROJECT]", "[FOOBAR]"); + EchoResponse response = + echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(name); } } // [END goldensample_generated_EchoServiceShouldGeneratePartialUsual_EchoShouldGenerateAsUsual_Foobarname_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualNoargs.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualNoargs.golden index b080af1eb407..77c7e705ada1 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualNoargs.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualNoargs.golden @@ -32,11 +32,14 @@ public class SyncEchoShouldGenerateAsUsualNoargs { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - EchoResponse response = - echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + EchoResponse response = echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(); } } // [END goldensample_generated_EchoServiceShouldGeneratePartialUsual_EchoShouldGenerateAsUsual_Noargs_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualString.golden index e4142b60d3f9..67fb0f1d10e5 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/echoserviceselectivegapicclient/SyncEchoShouldGenerateAsUsualString.golden @@ -33,12 +33,16 @@ public class SyncEchoShouldGenerateAsUsualString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = - EchoServiceShouldGeneratePartialUsualClient.create()) { - String name = FoobarName.of("[PROJECT]", "[FOOBAR]").toString(); - EchoResponse response = - echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + EchoServiceShouldGeneratePartialUsualClient echoServiceShouldGeneratePartialUsualClient = + EchoServiceShouldGeneratePartialUsualClient.create(); + String name = FoobarName.of("[PROJECT]", "[FOOBAR]").toString(); + EchoResponse response = + echoServiceShouldGeneratePartialUsualClient.echoShouldGenerateAsUsual(name); } } // [END goldensample_generated_EchoServiceShouldGeneratePartialUsual_EchoShouldGenerateAsUsual_String_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncCreateUser.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncCreateUser.golden index 0a4e2fabc1cf..a1262a3cd353 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncCreateUser.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncCreateUser.golden @@ -35,16 +35,20 @@ public class AsyncCreateUser { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - CreateUserRequest request = - CreateUserRequest.newBuilder() - .setParent(UserName.of("[USER]").toString()) - .setUser(User.newBuilder().build()) - .build(); - ApiFuture future = identityClient.createUserCallable().futureCall(request); - // Do something. - User response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + CreateUserRequest request = + CreateUserRequest.newBuilder() + .setParent(UserName.of("[USER]").toString()) + .setUser(User.newBuilder().build()) + .build(); + ApiFuture future = identityClient.createUserCallable().futureCall(request); + // Do something. + User response = future.get(); } } // [END goldensample_generated_Identity_CreateUser_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncDeleteUser.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncDeleteUser.golden index b83b71205464..1d1746db28ef 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncDeleteUser.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncDeleteUser.golden @@ -35,13 +35,17 @@ public class AsyncDeleteUser { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - DeleteUserRequest request = - DeleteUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); - ApiFuture future = identityClient.deleteUserCallable().futureCall(request); - // Do something. - future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + DeleteUserRequest request = + DeleteUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); + ApiFuture future = identityClient.deleteUserCallable().futureCall(request); + // Do something. + future.get(); } } // [END goldensample_generated_Identity_DeleteUser_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncGetUser.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncGetUser.golden index aaac81aa05af..cdba9027fe42 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncGetUser.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncGetUser.golden @@ -35,13 +35,17 @@ public class AsyncGetUser { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - GetUserRequest request = - GetUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); - ApiFuture future = identityClient.getUserCallable().futureCall(request); - // Do something. - User response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + GetUserRequest request = + GetUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); + ApiFuture future = identityClient.getUserCallable().futureCall(request); + // Do something. + User response = future.get(); } } // [END goldensample_generated_Identity_GetUser_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncListUsers.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncListUsers.golden index 00dd35665fc5..6aa1a0e231d4 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncListUsers.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncListUsers.golden @@ -34,17 +34,21 @@ public class AsyncListUsers { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - ListUsersRequest request = - ListUsersRequest.newBuilder() - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - ApiFuture future = identityClient.listUsersPagedCallable().futureCall(request); - // Do something. - for (User element : future.get().iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + ListUsersRequest request = + ListUsersRequest.newBuilder() + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + ApiFuture future = identityClient.listUsersPagedCallable().futureCall(request); + // Do something. + for (User element : future.get().iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncListUsersPaged.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncListUsersPaged.golden index 820c403e3328..8a071f6d76d0 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncListUsersPaged.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncListUsersPaged.golden @@ -35,23 +35,27 @@ public class AsyncListUsersPaged { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - ListUsersRequest request = - ListUsersRequest.newBuilder() - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - while (true) { - ListUsersResponse response = identityClient.listUsersCallable().call(request); - for (User element : response.getUsersList()) { - // doThingsWith(element); - } - String nextPageToken = response.getNextPageToken(); - if (!Strings.isNullOrEmpty(nextPageToken)) { - request = request.toBuilder().setPageToken(nextPageToken).build(); - } else { - break; - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + ListUsersRequest request = + ListUsersRequest.newBuilder() + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + while (true) { + ListUsersResponse response = identityClient.listUsersCallable().call(request); + for (User element : response.getUsersList()) { + // doThingsWith(element); + } + String nextPageToken = response.getNextPageToken(); + if (!Strings.isNullOrEmpty(nextPageToken)) { + request = request.toBuilder().setPageToken(nextPageToken).build(); + } else { + break; } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncUpdateUser.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncUpdateUser.golden index 20023408585a..53ce6d6c2a6d 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncUpdateUser.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/AsyncUpdateUser.golden @@ -34,13 +34,17 @@ public class AsyncUpdateUser { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - UpdateUserRequest request = - UpdateUserRequest.newBuilder().setUser(User.newBuilder().build()).build(); - ApiFuture future = identityClient.updateUserCallable().futureCall(request); - // Do something. - User response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + UpdateUserRequest request = + UpdateUserRequest.newBuilder().setUser(User.newBuilder().build()).build(); + ApiFuture future = identityClient.updateUserCallable().futureCall(request); + // Do something. + User response = future.get(); } } // [END goldensample_generated_Identity_UpdateUser_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateSetCredentialsProvider.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateSetCredentialsProvider.golden index 222ed7a2eb87..1bbe672b88af 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateSetCredentialsProvider.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateSetCredentialsProvider.golden @@ -34,6 +34,11 @@ public class SyncCreateSetCredentialsProvider { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle IdentitySettings identitySettings = IdentitySettings.newBuilder() .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateSetEndpoint.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateSetEndpoint.golden index d61a0b2f9595..b25a0f7eb18d 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateSetEndpoint.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateSetEndpoint.golden @@ -33,6 +33,11 @@ public class SyncCreateSetEndpoint { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle IdentitySettings identitySettings = IdentitySettings.newBuilder().setEndpoint(myEndpoint).build(); IdentityClient identityClient = IdentityClient.create(identitySettings); diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUser.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUser.golden index c199e8ae8ff7..11f70b6ad790 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUser.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUser.golden @@ -34,14 +34,18 @@ public class SyncCreateUser { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - CreateUserRequest request = - CreateUserRequest.newBuilder() - .setParent(UserName.of("[USER]").toString()) - .setUser(User.newBuilder().build()) - .build(); - User response = identityClient.createUser(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + CreateUserRequest request = + CreateUserRequest.newBuilder() + .setParent(UserName.of("[USER]").toString()) + .setUser(User.newBuilder().build()) + .build(); + User response = identityClient.createUser(request); } } // [END goldensample_generated_Identity_CreateUser_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringString.golden index c607200a90cf..1a6dae6ff168 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringString.golden @@ -33,12 +33,16 @@ public class SyncCreateUserStringStringString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - String parent = UserName.of("[USER]").toString(); - String displayName = "displayName1714148973"; - String email = "email96619420"; - User response = identityClient.createUser(parent, displayName, email); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + String parent = UserName.of("[USER]").toString(); + String displayName = "displayName1714148973"; + String email = "email96619420"; + User response = identityClient.createUser(parent, displayName, email); } } // [END goldensample_generated_Identity_CreateUser_StringStringString_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringStringIntStringBooleanDouble.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringStringIntStringBooleanDouble.golden index f2fd7d1c2231..e059e2365337 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringStringIntStringBooleanDouble.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringStringIntStringBooleanDouble.golden @@ -33,18 +33,22 @@ public class SyncCreateUserStringStringStringIntStringBooleanDouble { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - String parent = UserName.of("[USER]").toString(); - String displayName = "displayName1714148973"; - String email = "email96619420"; - int age = 96511; - String nickname = "nickname70690926"; - boolean enableNotifications = true; - double heightFeet = -1032737338; - User response = - identityClient.createUser( - parent, displayName, email, age, nickname, enableNotifications, heightFeet); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + String parent = UserName.of("[USER]").toString(); + String displayName = "displayName1714148973"; + String email = "email96619420"; + int age = 96511; + String nickname = "nickname70690926"; + boolean enableNotifications = true; + double heightFeet = -1032737338; + User response = + identityClient.createUser( + parent, displayName, email, age, nickname, enableNotifications, heightFeet); } } // [END goldensample_generated_Identity_CreateUser_StringStringStringIntStringBooleanDouble_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringStringStringStringIntStringStringStringString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringStringStringStringIntStringStringStringString.golden index 3edeac6779f8..2f1d138fb11a 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringStringStringStringIntStringStringStringString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncCreateUserStringStringStringStringStringIntStringStringStringString.golden @@ -34,30 +34,34 @@ public class SyncCreateUserStringStringStringStringStringIntStringStringStringSt // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - String parent = UserName.of("[USER]").toString(); - String displayName = "displayName1714148973"; - String email = "email96619420"; - String hobbyName = "hobbyName882586493"; - String songName = "songName1535136064"; - int weeklyFrequency = 1572999966; - String companyName = "companyName-508582744"; - String title = "title110371416"; - String subject = "subject-1867885268"; - String artistName = "artistName629723762"; - User response = - identityClient.createUser( - parent, - displayName, - email, - hobbyName, - songName, - weeklyFrequency, - companyName, - title, - subject, - artistName); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + String parent = UserName.of("[USER]").toString(); + String displayName = "displayName1714148973"; + String email = "email96619420"; + String hobbyName = "hobbyName882586493"; + String songName = "songName1535136064"; + int weeklyFrequency = 1572999966; + String companyName = "companyName-508582744"; + String title = "title110371416"; + String subject = "subject-1867885268"; + String artistName = "artistName629723762"; + User response = + identityClient.createUser( + parent, + displayName, + email, + hobbyName, + songName, + weeklyFrequency, + companyName, + title, + subject, + artistName); } } // [END goldensample_generated_Identity_CreateUser_StringStringStringStringStringIntStringStringStringString_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUser.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUser.golden index c410fe13670d..bab5ecb191c9 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUser.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUser.golden @@ -34,11 +34,15 @@ public class SyncDeleteUser { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - DeleteUserRequest request = - DeleteUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); - identityClient.deleteUser(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + DeleteUserRequest request = + DeleteUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); + identityClient.deleteUser(request); } } // [END goldensample_generated_Identity_DeleteUser_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUserString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUserString.golden index 0471b8916752..8bcc6531d2f7 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUserString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUserString.golden @@ -33,10 +33,14 @@ public class SyncDeleteUserString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - String name = UserName.of("[USER]").toString(); - identityClient.deleteUser(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + String name = UserName.of("[USER]").toString(); + identityClient.deleteUser(name); } } // [END goldensample_generated_Identity_DeleteUser_String_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUserUsername.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUserUsername.golden index b0a0d20dd84c..4cbd561ce4a8 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUserUsername.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncDeleteUserUsername.golden @@ -33,10 +33,14 @@ public class SyncDeleteUserUsername { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - UserName name = UserName.of("[USER]"); - identityClient.deleteUser(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + UserName name = UserName.of("[USER]"); + identityClient.deleteUser(name); } } // [END goldensample_generated_Identity_DeleteUser_Username_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUser.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUser.golden index a32aed24a6ae..44b5ef33515e 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUser.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUser.golden @@ -34,11 +34,15 @@ public class SyncGetUser { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - GetUserRequest request = - GetUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); - User response = identityClient.getUser(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + GetUserRequest request = + GetUserRequest.newBuilder().setName(UserName.of("[USER]").toString()).build(); + User response = identityClient.getUser(request); } } // [END goldensample_generated_Identity_GetUser_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUserString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUserString.golden index b54b28c5e195..b1e873d2a1a1 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUserString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUserString.golden @@ -33,10 +33,14 @@ public class SyncGetUserString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - String name = UserName.of("[USER]").toString(); - User response = identityClient.getUser(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + String name = UserName.of("[USER]").toString(); + User response = identityClient.getUser(name); } } // [END goldensample_generated_Identity_GetUser_String_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUserUsername.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUserUsername.golden index ef19a6ad18d1..5810129bee60 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUserUsername.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncGetUserUsername.golden @@ -33,10 +33,14 @@ public class SyncGetUserUsername { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - UserName name = UserName.of("[USER]"); - User response = identityClient.getUser(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + UserName name = UserName.of("[USER]"); + User response = identityClient.getUser(name); } } // [END goldensample_generated_Identity_GetUser_Username_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncListUsers.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncListUsers.golden index b5f3a0151127..18319de0f97b 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncListUsers.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncListUsers.golden @@ -33,15 +33,19 @@ public class SyncListUsers { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - ListUsersRequest request = - ListUsersRequest.newBuilder() - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - for (User element : identityClient.listUsers(request).iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + ListUsersRequest request = + ListUsersRequest.newBuilder() + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + for (User element : identityClient.listUsers(request).iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncUpdateUser.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncUpdateUser.golden index 05f88e969ac5..0529e1a7280a 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncUpdateUser.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/identityclient/SyncUpdateUser.golden @@ -33,11 +33,15 @@ public class SyncUpdateUser { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (IdentityClient identityClient = IdentityClient.create()) { - UpdateUserRequest request = - UpdateUserRequest.newBuilder().setUser(User.newBuilder().build()).build(); - User response = identityClient.updateUser(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + IdentityClient identityClient = IdentityClient.create(); + UpdateUserRequest request = + UpdateUserRequest.newBuilder().setUser(User.newBuilder().build()).build(); + User response = identityClient.updateUser(request); } } // [END goldensample_generated_Identity_UpdateUser_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncConnect.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncConnect.golden index 318986b0d1ed..78bcfc7d8265 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncConnect.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncConnect.golden @@ -34,14 +34,18 @@ public class AsyncConnect { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - BidiStream bidiStream = - messagingClient.connectCallable().call(); - ConnectRequest request = ConnectRequest.newBuilder().build(); - bidiStream.send(request); - for (StreamBlurbsResponse response : bidiStream) { - // Do something when a response is received. - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + BidiStream bidiStream = + messagingClient.connectCallable().call(); + ConnectRequest request = ConnectRequest.newBuilder().build(); + bidiStream.send(request); + for (StreamBlurbsResponse response : bidiStream) { + // Do something when a response is received. } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncCreateBlurb.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncCreateBlurb.golden index e58bd8373750..c8c6f07c1049 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncCreateBlurb.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncCreateBlurb.golden @@ -35,16 +35,20 @@ public class AsyncCreateBlurb { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - CreateBlurbRequest request = - CreateBlurbRequest.newBuilder() - .setParent(ProfileName.of("[USER]").toString()) - .setBlurb(Blurb.newBuilder().build()) - .build(); - ApiFuture future = messagingClient.createBlurbCallable().futureCall(request); - // Do something. - Blurb response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + CreateBlurbRequest request = + CreateBlurbRequest.newBuilder() + .setParent(ProfileName.of("[USER]").toString()) + .setBlurb(Blurb.newBuilder().build()) + .build(); + ApiFuture future = messagingClient.createBlurbCallable().futureCall(request); + // Do something. + Blurb response = future.get(); } } // [END goldensample_generated_Messaging_CreateBlurb_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncCreateRoom.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncCreateRoom.golden index ff22fccac9ca..4d9af7197e43 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncCreateRoom.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncCreateRoom.golden @@ -34,13 +34,17 @@ public class AsyncCreateRoom { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - CreateRoomRequest request = - CreateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); - ApiFuture future = messagingClient.createRoomCallable().futureCall(request); - // Do something. - Room response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + CreateRoomRequest request = + CreateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); + ApiFuture future = messagingClient.createRoomCallable().futureCall(request); + // Do something. + Room response = future.get(); } } // [END goldensample_generated_Messaging_CreateRoom_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncDeleteBlurb.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncDeleteBlurb.golden index af1812a55b09..b53b7ece2750 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncDeleteBlurb.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncDeleteBlurb.golden @@ -35,15 +35,19 @@ public class AsyncDeleteBlurb { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - DeleteBlurbRequest request = - DeleteBlurbRequest.newBuilder() - .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) - .build(); - ApiFuture future = messagingClient.deleteBlurbCallable().futureCall(request); - // Do something. - future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + DeleteBlurbRequest request = + DeleteBlurbRequest.newBuilder() + .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) + .build(); + ApiFuture future = messagingClient.deleteBlurbCallable().futureCall(request); + // Do something. + future.get(); } } // [END goldensample_generated_Messaging_DeleteBlurb_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncDeleteRoom.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncDeleteRoom.golden index 8c0aba4c5504..f00144afd642 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncDeleteRoom.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncDeleteRoom.golden @@ -35,13 +35,17 @@ public class AsyncDeleteRoom { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - DeleteRoomRequest request = - DeleteRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); - ApiFuture future = messagingClient.deleteRoomCallable().futureCall(request); - // Do something. - future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + DeleteRoomRequest request = + DeleteRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); + ApiFuture future = messagingClient.deleteRoomCallable().futureCall(request); + // Do something. + future.get(); } } // [END goldensample_generated_Messaging_DeleteRoom_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncGetBlurb.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncGetBlurb.golden index ed3e142a4010..343e06ef3e9c 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncGetBlurb.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncGetBlurb.golden @@ -35,15 +35,19 @@ public class AsyncGetBlurb { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - GetBlurbRequest request = - GetBlurbRequest.newBuilder() - .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) - .build(); - ApiFuture future = messagingClient.getBlurbCallable().futureCall(request); - // Do something. - Blurb response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + GetBlurbRequest request = + GetBlurbRequest.newBuilder() + .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) + .build(); + ApiFuture future = messagingClient.getBlurbCallable().futureCall(request); + // Do something. + Blurb response = future.get(); } } // [END goldensample_generated_Messaging_GetBlurb_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncGetRoom.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncGetRoom.golden index 476dfc81b15b..536351399cd2 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncGetRoom.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncGetRoom.golden @@ -35,13 +35,17 @@ public class AsyncGetRoom { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - GetRoomRequest request = - GetRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); - ApiFuture future = messagingClient.getRoomCallable().futureCall(request); - // Do something. - Room response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + GetRoomRequest request = + GetRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); + ApiFuture future = messagingClient.getRoomCallable().futureCall(request); + // Do something. + Room response = future.get(); } } // [END goldensample_generated_Messaging_GetRoom_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListBlurbs.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListBlurbs.golden index 077ecdd0f396..8e8f6fc6326b 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListBlurbs.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListBlurbs.golden @@ -35,18 +35,22 @@ public class AsyncListBlurbs { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - ListBlurbsRequest request = - ListBlurbsRequest.newBuilder() - .setParent(ProfileName.of("[USER]").toString()) - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - ApiFuture future = messagingClient.listBlurbsPagedCallable().futureCall(request); - // Do something. - for (Blurb element : future.get().iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + ListBlurbsRequest request = + ListBlurbsRequest.newBuilder() + .setParent(ProfileName.of("[USER]").toString()) + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + ApiFuture future = messagingClient.listBlurbsPagedCallable().futureCall(request); + // Do something. + for (Blurb element : future.get().iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListBlurbsPaged.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListBlurbsPaged.golden index 20ebe70435f3..0741fb0e1d69 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListBlurbsPaged.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListBlurbsPaged.golden @@ -36,24 +36,28 @@ public class AsyncListBlurbsPaged { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - ListBlurbsRequest request = - ListBlurbsRequest.newBuilder() - .setParent(ProfileName.of("[USER]").toString()) - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - while (true) { - ListBlurbsResponse response = messagingClient.listBlurbsCallable().call(request); - for (Blurb element : response.getBlurbsList()) { - // doThingsWith(element); - } - String nextPageToken = response.getNextPageToken(); - if (!Strings.isNullOrEmpty(nextPageToken)) { - request = request.toBuilder().setPageToken(nextPageToken).build(); - } else { - break; - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + ListBlurbsRequest request = + ListBlurbsRequest.newBuilder() + .setParent(ProfileName.of("[USER]").toString()) + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + while (true) { + ListBlurbsResponse response = messagingClient.listBlurbsCallable().call(request); + for (Blurb element : response.getBlurbsList()) { + // doThingsWith(element); + } + String nextPageToken = response.getNextPageToken(); + if (!Strings.isNullOrEmpty(nextPageToken)) { + request = request.toBuilder().setPageToken(nextPageToken).build(); + } else { + break; } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListRooms.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListRooms.golden index ee18467a1099..4a6b7a1d8c7b 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListRooms.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListRooms.golden @@ -34,17 +34,21 @@ public class AsyncListRooms { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - ListRoomsRequest request = - ListRoomsRequest.newBuilder() - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - ApiFuture future = messagingClient.listRoomsPagedCallable().futureCall(request); - // Do something. - for (Room element : future.get().iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + ListRoomsRequest request = + ListRoomsRequest.newBuilder() + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + ApiFuture future = messagingClient.listRoomsPagedCallable().futureCall(request); + // Do something. + for (Room element : future.get().iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListRoomsPaged.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListRoomsPaged.golden index a9dbe6241097..fe76441a4362 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListRoomsPaged.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncListRoomsPaged.golden @@ -35,23 +35,27 @@ public class AsyncListRoomsPaged { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - ListRoomsRequest request = - ListRoomsRequest.newBuilder() - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - while (true) { - ListRoomsResponse response = messagingClient.listRoomsCallable().call(request); - for (Room element : response.getRoomsList()) { - // doThingsWith(element); - } - String nextPageToken = response.getNextPageToken(); - if (!Strings.isNullOrEmpty(nextPageToken)) { - request = request.toBuilder().setPageToken(nextPageToken).build(); - } else { - break; - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + ListRoomsRequest request = + ListRoomsRequest.newBuilder() + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + while (true) { + ListRoomsResponse response = messagingClient.listRoomsCallable().call(request); + for (Room element : response.getRoomsList()) { + // doThingsWith(element); + } + String nextPageToken = response.getNextPageToken(); + if (!Strings.isNullOrEmpty(nextPageToken)) { + request = request.toBuilder().setPageToken(nextPageToken).build(); + } else { + break; } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSearchBlurbs.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSearchBlurbs.golden index 0331967ba444..5dcb5a09f669 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSearchBlurbs.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSearchBlurbs.golden @@ -35,18 +35,22 @@ public class AsyncSearchBlurbs { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - SearchBlurbsRequest request = - SearchBlurbsRequest.newBuilder() - .setQuery("query107944136") - .setParent(ProfileName.of("[USER]").toString()) - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - ApiFuture future = messagingClient.searchBlurbsCallable().futureCall(request); - // Do something. - Operation response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + SearchBlurbsRequest request = + SearchBlurbsRequest.newBuilder() + .setQuery("query107944136") + .setParent(ProfileName.of("[USER]").toString()) + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + ApiFuture future = messagingClient.searchBlurbsCallable().futureCall(request); + // Do something. + Operation response = future.get(); } } // [END goldensample_generated_Messaging_SearchBlurbs_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSearchBlurbsLRO.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSearchBlurbsLRO.golden index b58df5ec148f..97f05a125706 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSearchBlurbsLRO.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSearchBlurbsLRO.golden @@ -36,19 +36,23 @@ public class AsyncSearchBlurbsLRO { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - SearchBlurbsRequest request = - SearchBlurbsRequest.newBuilder() - .setQuery("query107944136") - .setParent(ProfileName.of("[USER]").toString()) - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - OperationFuture future = - messagingClient.searchBlurbsOperationCallable().futureCall(request); - // Do something. - SearchBlurbsResponse response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + SearchBlurbsRequest request = + SearchBlurbsRequest.newBuilder() + .setQuery("query107944136") + .setParent(ProfileName.of("[USER]").toString()) + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + OperationFuture future = + messagingClient.searchBlurbsOperationCallable().futureCall(request); + // Do something. + SearchBlurbsResponse response = future.get(); } } // [END goldensample_generated_Messaging_SearchBlurbs_LRO_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSendBlurbs.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSendBlurbs.golden index 87960ea720e7..a0da690abe16 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSendBlurbs.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncSendBlurbs.golden @@ -36,33 +36,37 @@ public class AsyncSendBlurbs { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - ApiStreamObserver responseObserver = - new ApiStreamObserver() { - @Override - public void onNext(SendBlurbsResponse response) { - // Do something when a response is received. - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + ApiStreamObserver responseObserver = + new ApiStreamObserver() { + @Override + public void onNext(SendBlurbsResponse response) { + // Do something when a response is received. + } - @Override - public void onError(Throwable t) { - // Add error-handling - } + @Override + public void onError(Throwable t) { + // Add error-handling + } - @Override - public void onCompleted() { - // Do something when complete. - } - }; - ApiStreamObserver requestObserver = - messagingClient.sendBlurbs().clientStreamingCall(responseObserver); - CreateBlurbRequest request = - CreateBlurbRequest.newBuilder() - .setParent(ProfileName.of("[USER]").toString()) - .setBlurb(Blurb.newBuilder().build()) - .build(); - requestObserver.onNext(request); - } + @Override + public void onCompleted() { + // Do something when complete. + } + }; + ApiStreamObserver requestObserver = + messagingClient.sendBlurbs().clientStreamingCall(responseObserver); + CreateBlurbRequest request = + CreateBlurbRequest.newBuilder() + .setParent(ProfileName.of("[USER]").toString()) + .setBlurb(Blurb.newBuilder().build()) + .build(); + requestObserver.onNext(request); } } // [END goldensample_generated_Messaging_SendBlurbs_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncStreamBlurbs.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncStreamBlurbs.golden index 6d4a1397aa56..bca98cec8cc8 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncStreamBlurbs.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncStreamBlurbs.golden @@ -35,14 +35,18 @@ public class AsyncStreamBlurbs { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - StreamBlurbsRequest request = - StreamBlurbsRequest.newBuilder().setName(ProfileName.of("[USER]").toString()).build(); - ServerStream stream = - messagingClient.streamBlurbsCallable().call(request); - for (StreamBlurbsResponse response : stream) { - // Do something when a response is received. - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + StreamBlurbsRequest request = + StreamBlurbsRequest.newBuilder().setName(ProfileName.of("[USER]").toString()).build(); + ServerStream stream = + messagingClient.streamBlurbsCallable().call(request); + for (StreamBlurbsResponse response : stream) { + // Do something when a response is received. } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncUpdateBlurb.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncUpdateBlurb.golden index e3fafc66ea28..96325d2194e4 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncUpdateBlurb.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncUpdateBlurb.golden @@ -34,13 +34,17 @@ public class AsyncUpdateBlurb { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - UpdateBlurbRequest request = - UpdateBlurbRequest.newBuilder().setBlurb(Blurb.newBuilder().build()).build(); - ApiFuture future = messagingClient.updateBlurbCallable().futureCall(request); - // Do something. - Blurb response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + UpdateBlurbRequest request = + UpdateBlurbRequest.newBuilder().setBlurb(Blurb.newBuilder().build()).build(); + ApiFuture future = messagingClient.updateBlurbCallable().futureCall(request); + // Do something. + Blurb response = future.get(); } } // [END goldensample_generated_Messaging_UpdateBlurb_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncUpdateRoom.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncUpdateRoom.golden index 539dbd8d67ae..6e8526a23ada 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncUpdateRoom.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/AsyncUpdateRoom.golden @@ -34,13 +34,17 @@ public class AsyncUpdateRoom { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - UpdateRoomRequest request = - UpdateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); - ApiFuture future = messagingClient.updateRoomCallable().futureCall(request); - // Do something. - Room response = future.get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + UpdateRoomRequest request = + UpdateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); + ApiFuture future = messagingClient.updateRoomCallable().futureCall(request); + // Do something. + Room response = future.get(); } } // [END goldensample_generated_Messaging_UpdateRoom_async] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurb.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurb.golden index d2b5c1a05b4c..755bc91d0d2f 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurb.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurb.golden @@ -34,14 +34,18 @@ public class SyncCreateBlurb { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - CreateBlurbRequest request = - CreateBlurbRequest.newBuilder() - .setParent(ProfileName.of("[USER]").toString()) - .setBlurb(Blurb.newBuilder().build()) - .build(); - Blurb response = messagingClient.createBlurb(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + CreateBlurbRequest request = + CreateBlurbRequest.newBuilder() + .setParent(ProfileName.of("[USER]").toString()) + .setBlurb(Blurb.newBuilder().build()) + .build(); + Blurb response = messagingClient.createBlurb(request); } } // [END goldensample_generated_Messaging_CreateBlurb_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbProfilenameBytestring.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbProfilenameBytestring.golden index 33f6c4a10cdc..26e3058438b7 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbProfilenameBytestring.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbProfilenameBytestring.golden @@ -34,11 +34,15 @@ public class SyncCreateBlurbProfilenameBytestring { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - ProfileName parent = ProfileName.of("[USER]"); - ByteString image = ByteString.EMPTY; - Blurb response = messagingClient.createBlurb(parent, image); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + ProfileName parent = ProfileName.of("[USER]"); + ByteString image = ByteString.EMPTY; + Blurb response = messagingClient.createBlurb(parent, image); } } // [END goldensample_generated_Messaging_CreateBlurb_ProfilenameBytestring_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbProfilenameString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbProfilenameString.golden index 8e60d8e479ba..641eb295cb4b 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbProfilenameString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbProfilenameString.golden @@ -33,11 +33,15 @@ public class SyncCreateBlurbProfilenameString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - ProfileName parent = ProfileName.of("[USER]"); - String text = "text3556653"; - Blurb response = messagingClient.createBlurb(parent, text); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + ProfileName parent = ProfileName.of("[USER]"); + String text = "text3556653"; + Blurb response = messagingClient.createBlurb(parent, text); } } // [END goldensample_generated_Messaging_CreateBlurb_ProfilenameString_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbRoomnameBytestring.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbRoomnameBytestring.golden index 761e4c46c3a1..e0fc0f0b33b3 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbRoomnameBytestring.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbRoomnameBytestring.golden @@ -34,11 +34,15 @@ public class SyncCreateBlurbRoomnameBytestring { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - RoomName parent = RoomName.of("[ROOM]"); - ByteString image = ByteString.EMPTY; - Blurb response = messagingClient.createBlurb(parent, image); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + RoomName parent = RoomName.of("[ROOM]"); + ByteString image = ByteString.EMPTY; + Blurb response = messagingClient.createBlurb(parent, image); } } // [END goldensample_generated_Messaging_CreateBlurb_RoomnameBytestring_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbRoomnameString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbRoomnameString.golden index ee819230f64f..e492feb5ae34 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbRoomnameString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbRoomnameString.golden @@ -33,11 +33,15 @@ public class SyncCreateBlurbRoomnameString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - RoomName parent = RoomName.of("[ROOM]"); - String text = "text3556653"; - Blurb response = messagingClient.createBlurb(parent, text); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + RoomName parent = RoomName.of("[ROOM]"); + String text = "text3556653"; + Blurb response = messagingClient.createBlurb(parent, text); } } // [END goldensample_generated_Messaging_CreateBlurb_RoomnameString_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbStringBytestring.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbStringBytestring.golden index 5e5ebad693bb..71cd712f0a29 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbStringBytestring.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbStringBytestring.golden @@ -34,11 +34,15 @@ public class SyncCreateBlurbStringBytestring { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - String parent = ProfileName.of("[USER]").toString(); - ByteString image = ByteString.EMPTY; - Blurb response = messagingClient.createBlurb(parent, image); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + String parent = ProfileName.of("[USER]").toString(); + ByteString image = ByteString.EMPTY; + Blurb response = messagingClient.createBlurb(parent, image); } } // [END goldensample_generated_Messaging_CreateBlurb_StringBytestring_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbStringString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbStringString.golden index 5fc08872f32b..93de7da43dd0 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbStringString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateBlurbStringString.golden @@ -33,11 +33,15 @@ public class SyncCreateBlurbStringString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - String parent = ProfileName.of("[USER]").toString(); - String text = "text3556653"; - Blurb response = messagingClient.createBlurb(parent, text); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + String parent = ProfileName.of("[USER]").toString(); + String text = "text3556653"; + Blurb response = messagingClient.createBlurb(parent, text); } } // [END goldensample_generated_Messaging_CreateBlurb_StringString_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateRoom.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateRoom.golden index 7842ebea2425..1e46194ae3be 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateRoom.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateRoom.golden @@ -33,11 +33,15 @@ public class SyncCreateRoom { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - CreateRoomRequest request = - CreateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); - Room response = messagingClient.createRoom(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + CreateRoomRequest request = + CreateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); + Room response = messagingClient.createRoom(request); } } // [END goldensample_generated_Messaging_CreateRoom_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateRoomStringString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateRoomStringString.golden index f96d76acf4c5..be15697f0f69 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateRoomStringString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateRoomStringString.golden @@ -32,11 +32,15 @@ public class SyncCreateRoomStringString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - String displayName = "displayName1714148973"; - String description = "description-1724546052"; - Room response = messagingClient.createRoom(displayName, description); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + String displayName = "displayName1714148973"; + String description = "description-1724546052"; + Room response = messagingClient.createRoom(displayName, description); } } // [END goldensample_generated_Messaging_CreateRoom_StringString_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateSetCredentialsProvider.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateSetCredentialsProvider.golden index f2377f6dd53f..2f5da984f626 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateSetCredentialsProvider.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateSetCredentialsProvider.golden @@ -34,6 +34,11 @@ public class SyncCreateSetCredentialsProvider { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle MessagingSettings messagingSettings = MessagingSettings.newBuilder() .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateSetEndpoint.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateSetEndpoint.golden index a0ebebc4da92..076ec4b218e7 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateSetEndpoint.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncCreateSetEndpoint.golden @@ -33,6 +33,11 @@ public class SyncCreateSetEndpoint { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle MessagingSettings messagingSettings = MessagingSettings.newBuilder().setEndpoint(myEndpoint).build(); MessagingClient messagingClient = MessagingClient.create(messagingSettings); diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurb.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurb.golden index cdb73087b159..ddcdd573d69e 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurb.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurb.golden @@ -34,13 +34,17 @@ public class SyncDeleteBlurb { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - DeleteBlurbRequest request = - DeleteBlurbRequest.newBuilder() - .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) - .build(); - messagingClient.deleteBlurb(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + DeleteBlurbRequest request = + DeleteBlurbRequest.newBuilder() + .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) + .build(); + messagingClient.deleteBlurb(request); } } // [END goldensample_generated_Messaging_DeleteBlurb_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurbBlurbname.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurbBlurbname.golden index 21d3be2509a9..874d319f540f 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurbBlurbname.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurbBlurbname.golden @@ -33,10 +33,14 @@ public class SyncDeleteBlurbBlurbname { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - BlurbName name = BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]"); - messagingClient.deleteBlurb(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + BlurbName name = BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]"); + messagingClient.deleteBlurb(name); } } // [END goldensample_generated_Messaging_DeleteBlurb_Blurbname_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurbString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurbString.golden index 864f6bf16bc8..80ec168c0f0f 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurbString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteBlurbString.golden @@ -33,11 +33,15 @@ public class SyncDeleteBlurbString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - String name = - BlurbName.ofUserLegacyUserBlurbName("[USER]", "[LEGACY_USER]", "[BLURB]").toString(); - messagingClient.deleteBlurb(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + String name = + BlurbName.ofUserLegacyUserBlurbName("[USER]", "[LEGACY_USER]", "[BLURB]").toString(); + messagingClient.deleteBlurb(name); } } // [END goldensample_generated_Messaging_DeleteBlurb_String_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoom.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoom.golden index 128c9d6798da..9d57a1e0ee22 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoom.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoom.golden @@ -34,11 +34,15 @@ public class SyncDeleteRoom { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - DeleteRoomRequest request = - DeleteRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); - messagingClient.deleteRoom(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + DeleteRoomRequest request = + DeleteRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); + messagingClient.deleteRoom(request); } } // [END goldensample_generated_Messaging_DeleteRoom_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoomRoomname.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoomRoomname.golden index 4f3cde1c6b1c..562893370ff5 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoomRoomname.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoomRoomname.golden @@ -33,10 +33,14 @@ public class SyncDeleteRoomRoomname { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - RoomName name = RoomName.of("[ROOM]"); - messagingClient.deleteRoom(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + RoomName name = RoomName.of("[ROOM]"); + messagingClient.deleteRoom(name); } } // [END goldensample_generated_Messaging_DeleteRoom_Roomname_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoomString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoomString.golden index ec8a08416b64..b05950a9bf2a 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoomString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncDeleteRoomString.golden @@ -33,10 +33,14 @@ public class SyncDeleteRoomString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - String name = RoomName.of("[ROOM]").toString(); - messagingClient.deleteRoom(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + String name = RoomName.of("[ROOM]").toString(); + messagingClient.deleteRoom(name); } } // [END goldensample_generated_Messaging_DeleteRoom_String_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurb.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurb.golden index 631604f878e7..e2bd1c3e6235 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurb.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurb.golden @@ -34,13 +34,17 @@ public class SyncGetBlurb { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - GetBlurbRequest request = - GetBlurbRequest.newBuilder() - .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) - .build(); - Blurb response = messagingClient.getBlurb(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + GetBlurbRequest request = + GetBlurbRequest.newBuilder() + .setName(BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]").toString()) + .build(); + Blurb response = messagingClient.getBlurb(request); } } // [END goldensample_generated_Messaging_GetBlurb_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurbBlurbname.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurbBlurbname.golden index d538b7fab2dd..87e0f037b02b 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurbBlurbname.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurbBlurbname.golden @@ -33,10 +33,14 @@ public class SyncGetBlurbBlurbname { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - BlurbName name = BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]"); - Blurb response = messagingClient.getBlurb(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + BlurbName name = BlurbName.ofRoomBlurbName("[ROOM]", "[BLURB]"); + Blurb response = messagingClient.getBlurb(name); } } // [END goldensample_generated_Messaging_GetBlurb_Blurbname_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurbString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurbString.golden index 004da1b32be4..04e334fca793 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurbString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetBlurbString.golden @@ -33,11 +33,15 @@ public class SyncGetBlurbString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - String name = - BlurbName.ofUserLegacyUserBlurbName("[USER]", "[LEGACY_USER]", "[BLURB]").toString(); - Blurb response = messagingClient.getBlurb(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + String name = + BlurbName.ofUserLegacyUserBlurbName("[USER]", "[LEGACY_USER]", "[BLURB]").toString(); + Blurb response = messagingClient.getBlurb(name); } } // [END goldensample_generated_Messaging_GetBlurb_String_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoom.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoom.golden index 3c6df997a196..9b7c24321726 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoom.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoom.golden @@ -34,11 +34,15 @@ public class SyncGetRoom { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - GetRoomRequest request = - GetRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); - Room response = messagingClient.getRoom(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + GetRoomRequest request = + GetRoomRequest.newBuilder().setName(RoomName.of("[ROOM]").toString()).build(); + Room response = messagingClient.getRoom(request); } } // [END goldensample_generated_Messaging_GetRoom_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoomRoomname.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoomRoomname.golden index 62193bbaa85f..135f2eeecf40 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoomRoomname.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoomRoomname.golden @@ -33,10 +33,14 @@ public class SyncGetRoomRoomname { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - RoomName name = RoomName.of("[ROOM]"); - Room response = messagingClient.getRoom(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + RoomName name = RoomName.of("[ROOM]"); + Room response = messagingClient.getRoom(name); } } // [END goldensample_generated_Messaging_GetRoom_Roomname_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoomString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoomString.golden index 963edfe1e657..2a6bb2ceee64 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoomString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncGetRoomString.golden @@ -33,10 +33,14 @@ public class SyncGetRoomString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - String name = RoomName.of("[ROOM]").toString(); - Room response = messagingClient.getRoom(name); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + String name = RoomName.of("[ROOM]").toString(); + Room response = messagingClient.getRoom(name); } } // [END goldensample_generated_Messaging_GetRoom_String_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbs.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbs.golden index eec7f8f96494..d77c12390da4 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbs.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbs.golden @@ -34,16 +34,20 @@ public class SyncListBlurbs { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - ListBlurbsRequest request = - ListBlurbsRequest.newBuilder() - .setParent(ProfileName.of("[USER]").toString()) - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - for (Blurb element : messagingClient.listBlurbs(request).iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + ListBlurbsRequest request = + ListBlurbsRequest.newBuilder() + .setParent(ProfileName.of("[USER]").toString()) + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + for (Blurb element : messagingClient.listBlurbs(request).iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsProfilename.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsProfilename.golden index 92bab5e6ac62..a56266f9a5e7 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsProfilename.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsProfilename.golden @@ -33,11 +33,15 @@ public class SyncListBlurbsProfilename { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - ProfileName parent = ProfileName.of("[USER]"); - for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + ProfileName parent = ProfileName.of("[USER]"); + for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsRoomname.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsRoomname.golden index dc7a69d58ec8..ca44bde778ee 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsRoomname.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsRoomname.golden @@ -33,11 +33,15 @@ public class SyncListBlurbsRoomname { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - RoomName parent = RoomName.of("[ROOM]"); - for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + RoomName parent = RoomName.of("[ROOM]"); + for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsString.golden index 3536a447ddd2..dfd7ea72711f 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListBlurbsString.golden @@ -33,11 +33,15 @@ public class SyncListBlurbsString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - String parent = ProfileName.of("[USER]").toString(); - for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + String parent = ProfileName.of("[USER]").toString(); + for (Blurb element : messagingClient.listBlurbs(parent).iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListRooms.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListRooms.golden index 3e98751800e7..34d583cd5f93 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListRooms.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncListRooms.golden @@ -33,15 +33,19 @@ public class SyncListRooms { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - ListRoomsRequest request = - ListRoomsRequest.newBuilder() - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - for (Room element : messagingClient.listRooms(request).iterateAll()) { - // doThingsWith(element); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + ListRoomsRequest request = + ListRoomsRequest.newBuilder() + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + for (Room element : messagingClient.listRooms(request).iterateAll()) { + // doThingsWith(element); } } } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncSearchBlurbs.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncSearchBlurbs.golden index f00ca3afeb07..776520d89908 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncSearchBlurbs.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncSearchBlurbs.golden @@ -34,16 +34,20 @@ public class SyncSearchBlurbs { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - SearchBlurbsRequest request = - SearchBlurbsRequest.newBuilder() - .setQuery("query107944136") - .setParent(ProfileName.of("[USER]").toString()) - .setPageSize(883849137) - .setPageToken("pageToken873572522") - .build(); - SearchBlurbsResponse response = messagingClient.searchBlurbsAsync(request).get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + SearchBlurbsRequest request = + SearchBlurbsRequest.newBuilder() + .setQuery("query107944136") + .setParent(ProfileName.of("[USER]").toString()) + .setPageSize(883849137) + .setPageToken("pageToken873572522") + .build(); + SearchBlurbsResponse response = messagingClient.searchBlurbsAsync(request).get(); } } // [END goldensample_generated_Messaging_SearchBlurbs_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncSearchBlurbsString.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncSearchBlurbsString.golden index a6c306195162..3cdd21b5218f 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncSearchBlurbsString.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncSearchBlurbsString.golden @@ -32,10 +32,14 @@ public class SyncSearchBlurbsString { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - String query = "query107944136"; - SearchBlurbsResponse response = messagingClient.searchBlurbsAsync(query).get(); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + String query = "query107944136"; + SearchBlurbsResponse response = messagingClient.searchBlurbsAsync(query).get(); } } // [END goldensample_generated_Messaging_SearchBlurbs_String_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncUpdateBlurb.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncUpdateBlurb.golden index 4c58aa77b285..583e47a44974 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncUpdateBlurb.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncUpdateBlurb.golden @@ -33,11 +33,15 @@ public class SyncUpdateBlurb { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - UpdateBlurbRequest request = - UpdateBlurbRequest.newBuilder().setBlurb(Blurb.newBuilder().build()).build(); - Blurb response = messagingClient.updateBlurb(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + UpdateBlurbRequest request = + UpdateBlurbRequest.newBuilder().setBlurb(Blurb.newBuilder().build()).build(); + Blurb response = messagingClient.updateBlurb(request); } } // [END goldensample_generated_Messaging_UpdateBlurb_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncUpdateRoom.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncUpdateRoom.golden index 5a8f111584da..31c70aff0486 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncUpdateRoom.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/messagingclient/SyncUpdateRoom.golden @@ -33,11 +33,15 @@ public class SyncUpdateRoom { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - try (MessagingClient messagingClient = MessagingClient.create()) { - UpdateRoomRequest request = - UpdateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); - Room response = messagingClient.updateRoom(request); - } + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle + MessagingClient messagingClient = MessagingClient.create(); + UpdateRoomRequest request = + UpdateRoomRequest.newBuilder().setRoom(Room.newBuilder().build()).build(); + Room response = messagingClient.updateRoom(request); } } // [END goldensample_generated_Messaging_UpdateRoom_sync] diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncEcho.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncEcho.golden index 72bcf935aff2..75d689d18a21 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncEcho.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncEcho.golden @@ -32,6 +32,11 @@ public class SyncEcho { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoSettings.Builder echoSettingsBuilder = EchoSettings.newBuilder(); echoSettingsBuilder .echoSettings() diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncEchoShouldGenerateAsUsual.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncEchoShouldGenerateAsUsual.golden index 64beddd0cd26..9c2ee168d9f7 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncEchoShouldGenerateAsUsual.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncEchoShouldGenerateAsUsual.golden @@ -32,6 +32,11 @@ public class SyncEchoShouldGenerateAsUsual { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoServiceShouldGeneratePartialUsualSettings.Builder echoServiceShouldGeneratePartialUsualSettingsBuilder = EchoServiceShouldGeneratePartialUsualSettings.newBuilder(); diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncFastFibonacci.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncFastFibonacci.golden index 1ad7ea2c07f6..d27b1e92967b 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncFastFibonacci.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncFastFibonacci.golden @@ -32,6 +32,11 @@ public class SyncFastFibonacci { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle DeprecatedServiceSettings.Builder deprecatedServiceSettingsBuilder = DeprecatedServiceSettings.newBuilder(); deprecatedServiceSettingsBuilder diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncWait.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncWait.golden index 56b28ef988a5..b5b18a0121ea 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncWait.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/SyncWait.golden @@ -35,6 +35,11 @@ public class SyncWait { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoSettings.Builder echoSettingsBuilder = EchoSettings.newBuilder(); TimedRetryAlgorithm timedRetryAlgorithm = OperationalTimedPollAlgorithm.create( diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncCreateTopic.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncCreateTopic.golden index 1d4be7de4165..8c35d140aa02 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncCreateTopic.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncCreateTopic.golden @@ -32,6 +32,11 @@ public class SyncCreateTopic { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle PublisherStubSettings.Builder publisherSettingsBuilder = PublisherStubSettings.newBuilder(); publisherSettingsBuilder .createTopicSettings() diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncDeleteJob.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncDeleteJob.golden index db01c32cd86d..c5c74d55d875 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncDeleteJob.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncDeleteJob.golden @@ -32,6 +32,11 @@ public class SyncDeleteJob { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle JobServiceStubSettings.Builder jobServiceSettingsBuilder = JobServiceStubSettings.newBuilder(); jobServiceSettingsBuilder .deleteJobSettings() diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncDeleteLog.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncDeleteLog.golden index e52a0ed50153..cf834adbcb29 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncDeleteLog.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncDeleteLog.golden @@ -32,6 +32,11 @@ public class SyncDeleteLog { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle LoggingServiceV2StubSettings.Builder loggingServiceV2SettingsBuilder = LoggingServiceV2StubSettings.newBuilder(); loggingServiceV2SettingsBuilder diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEcho.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEcho.golden index 6ddb9df6435e..227fa468a866 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEcho.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEcho.golden @@ -32,6 +32,11 @@ public class SyncEcho { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoStubSettings.Builder echoSettingsBuilder = EchoStubSettings.newBuilder(); echoSettingsBuilder .echoSettings() diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEchoShouldGenerateAsUsual.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEchoShouldGenerateAsUsual.golden index 8daf4e32c6a8..ac0b176f2305 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEchoShouldGenerateAsUsual.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEchoShouldGenerateAsUsual.golden @@ -32,6 +32,11 @@ public class SyncEchoShouldGenerateAsUsual { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoServiceShouldGeneratePartialUsualStubSettings.Builder echoServiceShouldGeneratePartialUsualSettingsBuilder = EchoServiceShouldGeneratePartialUsualStubSettings.newBuilder(); diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEchoWithVersionMethod.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEchoWithVersionMethod.golden index 30718ddfaea6..caca1e972df9 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEchoWithVersionMethod.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncEchoWithVersionMethod.golden @@ -32,6 +32,11 @@ public class SyncEchoWithVersionMethod { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoWithVersionStubSettings.Builder echoWithVersionSettingsBuilder = EchoWithVersionStubSettings.newBuilder(); echoWithVersionSettingsBuilder diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncFastFibonacci.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncFastFibonacci.golden index 6dac79d370c7..c3e17f5be0fb 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncFastFibonacci.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncFastFibonacci.golden @@ -32,6 +32,11 @@ public class SyncFastFibonacci { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle DeprecatedServiceStubSettings.Builder deprecatedServiceSettingsBuilder = DeprecatedServiceStubSettings.newBuilder(); deprecatedServiceSettingsBuilder diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncWait.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncWait.golden index 0d3abce70e09..fc17d933f89f 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncWait.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/samples/servicesettings/stub/SyncWait.golden @@ -35,6 +35,11 @@ public class SyncWait { // - It may require correct/in-range values for request initialization. // - It may require specifying regional endpoints when creating the service client as shown in // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + // - The samples create a client that can be re-used for multiple requests + // and are expected to be long-lived. + // The clients should be resource managed properly and eventually closed. + // For more information on client lifecycle, see + // https://docs.cloud.google.com/java/docs/client-lifecycle EchoStubSettings.Builder echoSettingsBuilder = EchoStubSettings.newBuilder(); TimedRetryAlgorithm timedRetryAlgorithm = OperationalTimedPollAlgorithm.create( diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden index 91e167d4e103..ecfca6239dd2 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden @@ -41,9 +41,13 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoResponse response = echoClient.echo(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoResponse response = echoClient.echo(); * } * *

Note: close() needs to be called on the EchoClient object to clean up resources such as @@ -248,6 +252,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * EchoSettings echoSettings = * EchoSettings.newBuilder() * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) @@ -263,6 +272,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * EchoSettings echoSettings = EchoSettings.newBuilder().setEndpoint(myEndpoint).build(); * EchoClient echoClient = EchoClient.create(echoSettings); * } @@ -276,6 +290,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * EchoSettings echoSettings = EchoSettings.newHttpJsonBuilder().build(); * EchoClient echoClient = EchoClient.create(echoSettings); * } @@ -366,9 +385,13 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoResponse response = echoClient.echo(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoResponse response = echoClient.echo(); * } * * @param request The request object containing all of the parameters for the API call. @@ -389,10 +412,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * ResourceName parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); - * EchoResponse response = echoClient.echo(parent); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * ResourceName parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); + * EchoResponse response = echoClient.echo(parent); * } * * @param parent @@ -414,10 +441,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * Status error = Status.newBuilder().build(); - * EchoResponse response = echoClient.echo(error); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * Status error = Status.newBuilder().build(); + * EchoResponse response = echoClient.echo(error); * } * * @param error @@ -438,10 +469,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * FoobarName name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); - * EchoResponse response = echoClient.echo(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * FoobarName name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]"); + * EchoResponse response = echoClient.echo(name); * } * * @param name @@ -463,10 +498,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * String content = "content951530617"; - * EchoResponse response = echoClient.echo(content); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * String content = "content951530617"; + * EchoResponse response = echoClient.echo(content); * } * * @param content @@ -487,10 +526,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * String name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); - * EchoResponse response = echoClient.echo(name); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * String name = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); + * EchoResponse response = echoClient.echo(name); * } * * @param name @@ -511,10 +554,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * String parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); - * EchoResponse response = echoClient.echo(parent); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * String parent = FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString(); + * EchoResponse response = echoClient.echo(parent); * } * * @param parent @@ -535,11 +582,15 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * String content = "content951530617"; - * Severity severity = Severity.forNumber(0); - * EchoResponse response = echoClient.echo(content, severity); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * String content = "content951530617"; + * Severity severity = Severity.forNumber(0); + * EchoResponse response = echoClient.echo(content, severity); * } * * @param content @@ -562,16 +613,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFooBar(Foobar.newBuilder().build()) - * .build(); - * EchoResponse response = echoClient.echo(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFooBar(Foobar.newBuilder().build()) + * .build(); + * EchoResponse response = echoClient.echo(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -591,18 +646,22 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFooBar(Foobar.newBuilder().build()) - * .build(); - * ApiFuture future = echoClient.echoCallable().futureCall(request); - * // Do something. - * EchoResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFooBar(Foobar.newBuilder().build()) + * .build(); + * ApiFuture future = echoClient.echoCallable().futureCall(request); + * // Do something. + * EchoResponse response = future.get(); * } */ public final UnaryCallable echoCallable() { @@ -619,16 +678,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * ExpandRequest request = - * ExpandRequest.newBuilder() - * .setContent("content951530617") - * .addAllInfo(new ArrayList()) - * .build(); - * ServerStream stream = echoClient.expandCallable().call(request); - * for (EchoResponse response : stream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * ExpandRequest request = + * ExpandRequest.newBuilder() + * .setContent("content951530617") + * .addAllInfo(new ArrayList()) + * .build(); + * ServerStream stream = echoClient.expandCallable().call(request); + * for (EchoResponse response : stream) { + * // Do something when a response is received. * } * } */ @@ -646,16 +709,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * for (EchoResponse element : echoClient.pagedExpand(request).iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * for (EchoResponse element : echoClient.pagedExpand(request).iterateAll()) { + * // doThingsWith(element); * } * } * @@ -676,18 +743,22 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * ApiFuture future = echoClient.pagedExpandPagedCallable().futureCall(request); - * // Do something. - * for (EchoResponse element : future.get().iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * ApiFuture future = echoClient.pagedExpandPagedCallable().futureCall(request); + * // Do something. + * for (EchoResponse element : future.get().iterateAll()) { + * // doThingsWith(element); * } * } */ @@ -706,24 +777,28 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * while (true) { - * PagedExpandResponse response = echoClient.pagedExpandCallable().call(request); - * for (EchoResponse element : response.getResponsesList()) { - * // doThingsWith(element); - * } - * String nextPageToken = response.getNextPageToken(); - * if (!Strings.isNullOrEmpty(nextPageToken)) { - * request = request.toBuilder().setPageToken(nextPageToken).build(); - * } else { - * break; - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * while (true) { + * PagedExpandResponse response = echoClient.pagedExpandCallable().call(request); + * for (EchoResponse element : response.getResponsesList()) { + * // doThingsWith(element); + * } + * String nextPageToken = response.getNextPageToken(); + * if (!Strings.isNullOrEmpty(nextPageToken)) { + * request = request.toBuilder().setPageToken(nextPageToken).build(); + * } else { + * break; * } * } * } @@ -742,10 +817,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * for (EchoResponse element : echoClient.simplePagedExpand().iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * for (EchoResponse element : echoClient.simplePagedExpand().iterateAll()) { + * // doThingsWith(element); * } * } * @@ -767,16 +846,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * for (EchoResponse element : echoClient.simplePagedExpand(request).iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * for (EchoResponse element : echoClient.simplePagedExpand(request).iterateAll()) { + * // doThingsWith(element); * } * } * @@ -797,19 +880,23 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * ApiFuture future = - * echoClient.simplePagedExpandPagedCallable().futureCall(request); - * // Do something. - * for (EchoResponse element : future.get().iterateAll()) { - * // doThingsWith(element); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * ApiFuture future = + * echoClient.simplePagedExpandPagedCallable().futureCall(request); + * // Do something. + * for (EchoResponse element : future.get().iterateAll()) { + * // doThingsWith(element); * } * } */ @@ -828,24 +915,28 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * PagedExpandRequest request = - * PagedExpandRequest.newBuilder() - * .setContent("content951530617") - * .setPageSize(883849137) - * .setPageToken("pageToken873572522") - * .build(); - * while (true) { - * PagedExpandResponse response = echoClient.simplePagedExpandCallable().call(request); - * for (EchoResponse element : response.getResponsesList()) { - * // doThingsWith(element); - * } - * String nextPageToken = response.getNextPageToken(); - * if (!Strings.isNullOrEmpty(nextPageToken)) { - * request = request.toBuilder().setPageToken(nextPageToken).build(); - * } else { - * break; - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * PagedExpandRequest request = + * PagedExpandRequest.newBuilder() + * .setContent("content951530617") + * .setPageSize(883849137) + * .setPageToken("pageToken873572522") + * .build(); + * while (true) { + * PagedExpandResponse response = echoClient.simplePagedExpandCallable().call(request); + * for (EchoResponse element : response.getResponsesList()) { + * // doThingsWith(element); + * } + * String nextPageToken = response.getNextPageToken(); + * if (!Strings.isNullOrEmpty(nextPageToken)) { + * request = request.toBuilder().setPageToken(nextPageToken).build(); + * } else { + * break; * } * } * } @@ -864,10 +955,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * Duration ttl = Duration.newBuilder().build(); - * WaitResponse response = echoClient.waitAsync(ttl).get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * Duration ttl = Duration.newBuilder().build(); + * WaitResponse response = echoClient.waitAsync(ttl).get(); * } * * @param ttl @@ -888,10 +983,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * Timestamp endTime = Timestamp.newBuilder().build(); - * WaitResponse response = echoClient.waitAsync(endTime).get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * Timestamp endTime = Timestamp.newBuilder().build(); + * WaitResponse response = echoClient.waitAsync(endTime).get(); * } * * @param endTime @@ -912,10 +1011,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * WaitRequest request = WaitRequest.newBuilder().build(); - * WaitResponse response = echoClient.waitAsync(request).get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * WaitRequest request = WaitRequest.newBuilder().build(); + * WaitResponse response = echoClient.waitAsync(request).get(); * } * * @param request The request object containing all of the parameters for the API call. @@ -935,13 +1038,17 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * WaitRequest request = WaitRequest.newBuilder().build(); - * OperationFuture future = - * echoClient.waitOperationCallable().futureCall(request); - * // Do something. - * WaitResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * WaitRequest request = WaitRequest.newBuilder().build(); + * OperationFuture future = + * echoClient.waitOperationCallable().futureCall(request); + * // Do something. + * WaitResponse response = future.get(); * } */ public final OperationCallable waitOperationCallable() { @@ -958,12 +1065,16 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * WaitRequest request = WaitRequest.newBuilder().build(); - * ApiFuture future = echoClient.waitCallable().futureCall(request); - * // Do something. - * Operation response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * WaitRequest request = WaitRequest.newBuilder().build(); + * ApiFuture future = echoClient.waitCallable().futureCall(request); + * // Do something. + * Operation response = future.get(); * } */ public final UnaryCallable waitCallable() { @@ -980,10 +1091,14 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * BlockRequest request = BlockRequest.newBuilder().build(); - * BlockResponse response = echoClient.block(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * BlockRequest request = BlockRequest.newBuilder().build(); + * BlockResponse response = echoClient.block(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1003,12 +1118,16 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * BlockRequest request = BlockRequest.newBuilder().build(); - * ApiFuture future = echoClient.blockCallable().futureCall(request); - * // Do something. - * BlockResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * BlockRequest request = BlockRequest.newBuilder().build(); + * ApiFuture future = echoClient.blockCallable().futureCall(request); + * // Do something. + * BlockResponse response = future.get(); * } */ public final UnaryCallable blockCallable() { @@ -1025,16 +1144,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFooBar(Foobar.newBuilder().build()) - * .build(); - * Object response = echoClient.collideName(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFooBar(Foobar.newBuilder().build()) + * .build(); + * Object response = echoClient.collideName(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1054,18 +1177,22 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFooBar(Foobar.newBuilder().build()) - * .build(); - * ApiFuture future = echoClient.collideNameCallable().futureCall(request); - * // Do something. - * Object response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFooBar(Foobar.newBuilder().build()) + * .build(); + * ApiFuture future = echoClient.collideNameCallable().futureCall(request); + * // Do something. + * Object response = future.get(); * } */ public final UnaryCallable collideNameCallable() { @@ -1082,16 +1209,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFooBar(Foobar.newBuilder().build()) - * .build(); - * Object response = echoClient.nestedBinding(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFooBar(Foobar.newBuilder().build()) + * .build(); + * Object response = echoClient.nestedBinding(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1111,18 +1242,22 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFooBar(Foobar.newBuilder().build()) - * .build(); - * ApiFuture future = echoClient.nestedBindingCallable().futureCall(request); - * // Do something. - * Object response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFooBar(Foobar.newBuilder().build()) + * .build(); + * ApiFuture future = echoClient.nestedBindingCallable().futureCall(request); + * // Do something. + * Object response = future.get(); * } */ public final UnaryCallable nestedBindingCallable() { @@ -1139,19 +1274,23 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * BidiStream bidiStream = echoClient.chatCallable().call(); - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFooBar(Foobar.newBuilder().build()) - * .build(); - * bidiStream.send(request); - * for (EchoResponse response : bidiStream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * BidiStream bidiStream = echoClient.chatCallable().call(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFooBar(Foobar.newBuilder().build()) + * .build(); + * bidiStream.send(request); + * for (EchoResponse response : bidiStream) { + * // Do something when a response is received. * } * } */ @@ -1169,16 +1308,20 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFooBar(Foobar.newBuilder().build()) - * .build(); - * EchoResponse response = echoClient.noBinding(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFooBar(Foobar.newBuilder().build()) + * .build(); + * EchoResponse response = echoClient.noBinding(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1198,18 +1341,22 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * EchoRequest request = - * EchoRequest.newBuilder() - * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) - * .setSeverity(Severity.forNumber(0)) - * .setFooBar(Foobar.newBuilder().build()) - * .build(); - * ApiFuture future = echoClient.noBindingCallable().futureCall(request); - * // Do something. - * EchoResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * EchoRequest request = + * EchoRequest.newBuilder() + * .setName(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setParent(FoobarName.ofProjectFoobarName("[PROJECT]", "[FOOBAR]").toString()) + * .setSeverity(Severity.forNumber(0)) + * .setFooBar(Foobar.newBuilder().build()) + * .build(); + * ApiFuture future = echoClient.noBindingCallable().futureCall(request); + * // Do something. + * EchoResponse response = future.get(); * } */ public final UnaryCallable noBindingCallable() { @@ -1226,11 +1373,15 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * Case case_ = Case.newBuilder().build(); - * FieldMask updateMask = FieldMask.newBuilder().build(); - * Case response = echoClient.updateCase(case_, updateMask); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * Case case_ = Case.newBuilder().build(); + * FieldMask updateMask = FieldMask.newBuilder().build(); + * Case response = echoClient.updateCase(case_, updateMask); * } * * @param case_ @@ -1253,11 +1404,15 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * UpdateCaseRequest request = - * UpdateCaseRequest.newBuilder().setCase(Case.newBuilder().build()).build(); - * Case response = echoClient.updateCase(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * UpdateCaseRequest request = + * UpdateCaseRequest.newBuilder().setCase(Case.newBuilder().build()).build(); + * Case response = echoClient.updateCase(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -1277,13 +1432,17 @@ public class EchoClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (EchoClient echoClient = EchoClient.create()) { - * UpdateCaseRequest request = - * UpdateCaseRequest.newBuilder().setCase(Case.newBuilder().build()).build(); - * ApiFuture future = echoClient.updateCaseCallable().futureCall(request); - * // Do something. - * Case response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * EchoClient echoClient = EchoClient.create(); + * UpdateCaseRequest request = + * UpdateCaseRequest.newBuilder().setCase(Case.newBuilder().build()).build(); + * ApiFuture future = echoClient.updateCaseCallable().futureCall(request); + * // Do something. + * Case response = future.get(); * } */ public final UnaryCallable updateCaseCallable() { diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden index 138bee4bc15d..14847d34ed89 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden @@ -22,11 +22,15 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (WickedClient wickedClient = WickedClient.create()) { - * EvilRequest request = - * EvilRequest.newBuilder().setMaliciousIdea("maliciousIdea712541645").build(); - * EvilResponse response = wickedClient.craftEvilPlan(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * WickedClient wickedClient = WickedClient.create(); + * EvilRequest request = + * EvilRequest.newBuilder().setMaliciousIdea("maliciousIdea712541645").build(); + * EvilResponse response = wickedClient.craftEvilPlan(request); * } * *

Note: close() needs to be called on the WickedClient object to clean up resources such as @@ -92,6 +96,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * WickedSettings wickedSettings = * WickedSettings.newBuilder() * .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials)) @@ -107,6 +116,11 @@ import javax.annotation.Generated; * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle * WickedSettings wickedSettings = WickedSettings.newBuilder().setEndpoint(myEndpoint).build(); * WickedClient wickedClient = WickedClient.create(wickedSettings); * } @@ -172,11 +186,15 @@ public class WickedClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (WickedClient wickedClient = WickedClient.create()) { - * EvilRequest request = - * EvilRequest.newBuilder().setMaliciousIdea("maliciousIdea712541645").build(); - * EvilResponse response = wickedClient.craftEvilPlan(request); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * WickedClient wickedClient = WickedClient.create(); + * EvilRequest request = + * EvilRequest.newBuilder().setMaliciousIdea("maliciousIdea712541645").build(); + * EvilResponse response = wickedClient.craftEvilPlan(request); * } * * @param request The request object containing all of the parameters for the API call. @@ -196,13 +214,17 @@ public class WickedClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (WickedClient wickedClient = WickedClient.create()) { - * EvilRequest request = - * EvilRequest.newBuilder().setMaliciousIdea("maliciousIdea712541645").build(); - * ApiFuture future = wickedClient.craftEvilPlanCallable().futureCall(request); - * // Do something. - * EvilResponse response = future.get(); - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * WickedClient wickedClient = WickedClient.create(); + * EvilRequest request = + * EvilRequest.newBuilder().setMaliciousIdea("maliciousIdea712541645").build(); + * ApiFuture future = wickedClient.craftEvilPlanCallable().futureCall(request); + * // Do something. + * EvilResponse response = future.get(); * } */ public final UnaryCallable craftEvilPlanCallable() { @@ -219,15 +241,19 @@ public class WickedClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (WickedClient wickedClient = WickedClient.create()) { - * BidiStream bidiStream = - * wickedClient.brainstormEvilPlansCallable().call(); - * EvilRequest request = - * EvilRequest.newBuilder().setMaliciousIdea("maliciousIdea712541645").build(); - * bidiStream.send(request); - * for (EvilResponse response : bidiStream) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * WickedClient wickedClient = WickedClient.create(); + * BidiStream bidiStream = + * wickedClient.brainstormEvilPlansCallable().call(); + * EvilRequest request = + * EvilRequest.newBuilder().setMaliciousIdea("maliciousIdea712541645").build(); + * bidiStream.send(request); + * for (EvilResponse response : bidiStream) { + * // Do something when a response is received. * } * } */ @@ -245,30 +271,34 @@ public class WickedClient implements BackgroundResource { * // - It may require correct/in-range values for request initialization. * // - It may require specifying regional endpoints when creating the service client as shown in * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library - * try (WickedClient wickedClient = WickedClient.create()) { - * ApiStreamObserver responseObserver = - * new ApiStreamObserver() { - * {@literal @}Override - * public void onNext(EvilResponse response) { - * // Do something when a response is received. - * } + * // - The samples create a client that can be re-used for multiple requests + * // and are expected to be long-lived. + * // The clients should be resource managed properly and eventually closed. + * // For more information on client lifecycle, see + * // https://docs.cloud.google.com/java/docs/client-lifecycle + * WickedClient wickedClient = WickedClient.create(); + * ApiStreamObserver responseObserver = + * new ApiStreamObserver() { + * {@literal @}Override + * public void onNext(EvilResponse response) { + * // Do something when a response is received. + * } * - * {@literal @}Override - * public void onError(Throwable t) { - * // Add error-handling - * } + * {@literal @}Override + * public void onError(Throwable t) { + * // Add error-handling + * } * - * {@literal @}Override - * public void onCompleted() { - * // Do something when complete. - * } - * }; - * ApiStreamObserver requestObserver = - * wickedClient.persuadeEvilPlan().clientStreamingCall(responseObserver); - * EvilRequest request = - * EvilRequest.newBuilder().setMaliciousIdea("maliciousIdea712541645").build(); - * requestObserver.onNext(request); - * } + * {@literal @}Override + * public void onCompleted() { + * // Do something when complete. + * } + * }; + * ApiStreamObserver requestObserver = + * wickedClient.persuadeEvilPlan().clientStreamingCall(responseObserver); + * EvilRequest request = + * EvilRequest.newBuilder().setMaliciousIdea("maliciousIdea712541645").build(); + * requestObserver.onNext(request); * } */ public final ClientStreamingCallable persuadeEvilPlanCallable() { diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/SampleCodeWriterTest.java b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/SampleCodeWriterTest.java index 820fa739a182..6e9938b4d567 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/SampleCodeWriterTest.java +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/SampleCodeWriterTest.java @@ -112,6 +112,11 @@ void writeInlineSample() { "// - It may require correct/in-range values for request initialization.\n", "// - It may require specifying regional endpoints when creating the service client as shown in\n", "// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library\n", + "// - The samples create a client that can be re-used for multiple requests\n", + "// and are expected to be long-lived.\n", + "// The clients should be resource managed properly and eventually closed.\n", + "// For more information on client lifecycle, see\n", + "// https://docs.cloud.google.com/java/docs/client-lifecycle\n", "ClientSettings clientSettings = ClientSettings.newBuilder().build();\n", "try (boolean aBool = false) {\n", " int x = 3;\n", @@ -147,6 +152,11 @@ void writeExecutableSample() { " // - It may require correct/in-range values for request initialization.\n", " // - It may require specifying regional endpoints when creating the service client as shown in\n", " // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library\n", + " // - The samples create a client that can be re-used for multiple requests\n", + " // and are expected to be long-lived.\n", + " // The clients should be resource managed properly and eventually closed.\n", + " // For more information on client lifecycle, see\n", + " // https://docs.cloud.google.com/java/docs/client-lifecycle\n", " ClientSettings clientSettings = ClientSettings.newBuilder().build();\n", " try (boolean aBool = false) {\n", " int x = 3;\n", diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/SampleComposerTest.java b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/SampleComposerTest.java index 94e381dca856..e7b07beacfdb 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/SampleComposerTest.java +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/SampleComposerTest.java @@ -54,6 +54,11 @@ void createInlineSample() { "// - It may require correct/in-range values for request initialization.\n", "// - It may require specifying regional endpoints when creating the service client as shown in\n", "// https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library\n", + "// - The samples create a client that can be re-used for multiple requests\n", + "// and are expected to be long-lived.\n", + "// The clients should be resource managed properly and eventually closed.\n", + "// For more information on client lifecycle, see\n", + "// https://docs.cloud.google.com/java/docs/client-lifecycle\n", "System.out.println(\"testing\");"); assertEquals(expected, sampleResult); @@ -88,6 +93,11 @@ void createExecutableSampleEmptyStatementSample() { " // - It may require correct/in-range values for request initialization.\n", " // - It may require specifying regional endpoints when creating the service client as shown in\n", " // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library\n", + " // - The samples create a client that can be re-used for multiple requests\n", + " // and are expected to be long-lived.\n", + " // The clients should be resource managed properly and eventually closed.\n", + " // For more information on client lifecycle, see\n", + " // https://docs.cloud.google.com/java/docs/client-lifecycle\n", " }\n", "}\n", "// [END apiname_generated_Echo_CreateExecutableSample_EmptyStatementSample_sync]\n"); @@ -127,6 +137,11 @@ void createExecutableSampleMethodArgsNoVar() { " // - It may require correct/in-range values for request initialization.\n", " // - It may require specifying regional endpoints when creating the service client as shown in\n", " // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library\n", + " // - The samples create a client that can be re-used for multiple requests\n", + " // and are expected to be long-lived.\n", + " // The clients should be resource managed properly and eventually closed.\n", + " // For more information on client lifecycle, see\n", + " // https://docs.cloud.google.com/java/docs/client-lifecycle\n", " System.out.println(\"Testing CreateExecutableSampleMethodArgsNoVar\");\n", " }\n", "}\n", @@ -176,6 +191,11 @@ void createExecutableSampleMethod() { " // - It may require correct/in-range values for request initialization.\n", " // - It may require specifying regional endpoints when creating the service client as shown in\n", " // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library\n", + " // - The samples create a client that can be re-used for multiple requests\n", + " // and are expected to be long-lived.\n", + " // The clients should be resource managed properly and eventually closed.\n", + " // For more information on client lifecycle, see\n", + " // https://docs.cloud.google.com/java/docs/client-lifecycle\n", " System.out.println(content);\n", " }\n", "}\n", @@ -265,6 +285,11 @@ void createExecutableSampleMethodMultipleStatements() { " // - It may require correct/in-range values for request initialization.\n", " // - It may require specifying regional endpoints when creating the service client as shown in\n", " // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library\n", + " // - The samples create a client that can be re-used for multiple requests\n", + " // and are expected to be long-lived.\n", + " // The clients should be resource managed properly and eventually closed.\n", + " // For more information on client lifecycle, see\n", + " // https://docs.cloud.google.com/java/docs/client-lifecycle\n", " System.out.println(content);\n", " System.out.println(num);\n", " System.out.println(thing.response());\n", diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientCallableMethodSampleComposerTest.java b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientCallableMethodSampleComposerTest.java index 2b058aca7c64..cbd41542f8ad 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientCallableMethodSampleComposerTest.java +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientCallableMethodSampleComposerTest.java @@ -111,13 +111,12 @@ void valid_composeLroCallableMethod_withReturnResponse() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " WaitRequest request = WaitRequest.newBuilder().build();\n", - " OperationFuture future =\n", - " echoClient.waitOperationCallable().futureCall(request);\n", - " // Do something.\n", - " WaitResponse response = future.get();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "WaitRequest request = WaitRequest.newBuilder().build();\n", + "OperationFuture future =\n", + " echoClient.waitOperationCallable().futureCall(request);\n", + "// Do something.\n", + "WaitResponse response = future.get();"); Assert.assertEquals(results, expected); } @@ -179,13 +178,12 @@ void valid_composeLroCallableMethod_withReturnVoid() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " WaitRequest request = WaitRequest.newBuilder().build();\n", - " OperationFuture future =\n", - " echoClient.waitOperationCallable().futureCall(request);\n", - " // Do something.\n", - " future.get();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "WaitRequest request = WaitRequest.newBuilder().build();\n", + "OperationFuture future =\n", + " echoClient.waitOperationCallable().futureCall(request);\n", + "// Do something.\n", + "future.get();"); Assert.assertEquals(results, expected); } @@ -237,19 +235,18 @@ void valid_composePagedCallableMethod() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " PagedExpandRequest request =\n", - " PagedExpandRequest.newBuilder()\n", - " .setContent(\"content951530617\")\n", - " .setPageSize(883849137)\n", - " .setPageToken(\"pageToken873572522\")\n", - " .build();\n", - " ApiFuture future =" + "EchoClient echoClient = EchoClient.create();\n", + "PagedExpandRequest request =\n", + " PagedExpandRequest.newBuilder()\n", + " .setContent(\"content951530617\")\n", + " .setPageSize(883849137)\n", + " .setPageToken(\"pageToken873572522\")\n", + " .build();\n", + "ApiFuture future =" + " echoClient.pagedExpandPagedCallable().futureCall(request);\n", - " // Do something.\n", - " for (EchoResponse element : future.get().iterateAll()) {\n", - " // doThingsWith(element);\n", - " }\n", + "// Do something.\n", + "for (EchoResponse element : future.get().iterateAll()) {\n", + " // doThingsWith(element);\n", "}"); Assert.assertEquals(results, expected); } @@ -460,13 +457,12 @@ void valid_composeStreamCallableMethod_serverStream() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " ExpandRequest request =\n", - " ExpandRequest.newBuilder().setContent(\"content951530617\").setInfo(\"info3237038\").build();\n", - " ServerStream stream = echoClient.expandCallable().call(request);\n", - " for (EchoResponse response : stream) {\n", - " // Do something when a response is received.\n", - " }\n", + "EchoClient echoClient = EchoClient.create();\n", + "ExpandRequest request =\n", + " ExpandRequest.newBuilder().setContent(\"content951530617\").setInfo(\"info3237038\").build();\n", + "ServerStream stream = echoClient.expandCallable().call(request);\n", + "for (EchoResponse response : stream) {\n", + " // Do something when a response is received.\n", "}"); Assert.assertEquals(results, expected); } @@ -566,22 +562,21 @@ void valid_composeStreamCallableMethod_bidiStream() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " BidiStream bidiStream =" + "EchoClient echoClient = EchoClient.create();\n", + "BidiStream bidiStream =" + " echoClient.chatCallable().call();\n", - " EchoRequest request =\n", - " EchoRequest.newBuilder()\n", - " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + "EchoRequest request =\n", + " EchoRequest.newBuilder()\n", + " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setSeverity(Severity.forNumber(0))\n", - " .setFoobar(Foobar.newBuilder().build())\n", - " .build();\n", - " bidiStream.send(request);\n", - " for (EchoResponse response : bidiStream) {\n", - " // Do something when a response is received.\n", - " }\n", + " .setSeverity(Severity.forNumber(0))\n", + " .setFoobar(Foobar.newBuilder().build())\n", + " .build();\n", + "bidiStream.send(request);\n", + "for (EchoResponse response : bidiStream) {\n", + " // Do something when a response is received.\n", "}"); Assert.assertEquals(results, expected); } @@ -681,37 +676,36 @@ void valid_composeStreamCallableMethod_clientStream() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " ApiStreamObserver responseObserver =\n", - " new ApiStreamObserver() {\n", - " {@literal @}Override\n", - " public void onNext(EchoResponse response) {\n", - " // Do something when a response is received.\n", - " }\n", + "EchoClient echoClient = EchoClient.create();\n", + "ApiStreamObserver responseObserver =\n", + " new ApiStreamObserver() {\n", + " {@literal @}Override\n", + " public void onNext(EchoResponse response) {\n", + " // Do something when a response is received.\n", + " }\n", "\n", - " {@literal @}Override\n", - " public void onError(Throwable t) {\n", - " // Add error-handling\n", - " }\n", + " {@literal @}Override\n", + " public void onError(Throwable t) {\n", + " // Add error-handling\n", + " }\n", "\n", - " {@literal @}Override\n", - " public void onCompleted() {\n", - " // Do something when complete.\n", - " }\n", - " };\n", - " ApiStreamObserver requestObserver =\n", - " echoClient.collect().clientStreamingCall(responseObserver);\n", - " EchoRequest request =\n", - " EchoRequest.newBuilder()\n", - " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " {@literal @}Override\n", + " public void onCompleted() {\n", + " // Do something when complete.\n", + " }\n", + " };\n", + "ApiStreamObserver requestObserver =\n", + " echoClient.collect().clientStreamingCall(responseObserver);\n", + "EchoRequest request =\n", + " EchoRequest.newBuilder()\n", + " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setSeverity(Severity.forNumber(0))\n", - " .setFoobar(Foobar.newBuilder().build())\n", - " .build();\n", - " requestObserver.onNext(request);\n", - "}"); + " .setSeverity(Severity.forNumber(0))\n", + " .setFoobar(Foobar.newBuilder().build())\n", + " .build();\n", + "requestObserver.onNext(request);"); Assert.assertEquals(results, expected); } @@ -806,20 +800,19 @@ void valid_composeRegularCallableMethod_unaryRpc() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " EchoRequest request =\n", - " EchoRequest.newBuilder()\n", - " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + "EchoClient echoClient = EchoClient.create();\n", + "EchoRequest request =\n", + " EchoRequest.newBuilder()\n", + " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setSeverity(Severity.forNumber(0))\n", - " .setFoobar(Foobar.newBuilder().build())\n", - " .build();\n", - " ApiFuture future = echoClient.echoCallable().futureCall(request);\n", - " // Do something.\n", - " EchoResponse response = future.get();\n", - "}"); + " .setSeverity(Severity.forNumber(0))\n", + " .setFoobar(Foobar.newBuilder().build())\n", + " .build();\n", + "ApiFuture future = echoClient.echoCallable().futureCall(request);\n", + "// Do something.\n", + "EchoResponse response = future.get();"); Assert.assertEquals(results, expected); } @@ -884,12 +877,11 @@ void valid_composeRegularCallableMethod_lroRpc() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " WaitRequest request = WaitRequest.newBuilder().build();\n", - " ApiFuture future = echoClient.waitCallable().futureCall(request);\n", - " // Do something.\n", - " Operation response = future.get();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "WaitRequest request = WaitRequest.newBuilder().build();\n", + "ApiFuture future = echoClient.waitCallable().futureCall(request);\n", + "// Do something.\n", + "Operation response = future.get();"); Assert.assertEquals(results, expected); } @@ -951,12 +943,11 @@ void valid_composeRegularCallableMethod_lroRpcWithReturnVoid() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " WaitRequest request = WaitRequest.newBuilder().build();\n", - " ApiFuture future = echoClient.waitCallable().futureCall(request);\n", - " // Do something.\n", - " future.get();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "WaitRequest request = WaitRequest.newBuilder().build();\n", + "ApiFuture future = echoClient.waitCallable().futureCall(request);\n", + "// Do something.\n", + "future.get();"); Assert.assertEquals(results, expected); } @@ -1008,24 +999,23 @@ void valid_composeRegularCallableMethod_pageRpc() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " PagedExpandRequest request =\n", - " PagedExpandRequest.newBuilder()\n", - " .setContent(\"content951530617\")\n", - " .setPageSize(883849137)\n", - " .setPageToken(\"pageToken873572522\")\n", - " .build();\n", - " while (true) {\n", - " PagedExpandResponse response = echoClient.pagedExpandCallable().call(request);\n", - " for (EchoResponse element : response.getResponsesList()) {\n", - " // doThingsWith(element);\n", - " }\n", - " String nextPageToken = response.getNextPageToken();\n", - " if (!Strings.isNullOrEmpty(nextPageToken)) {\n", - " request = request.toBuilder().setPageToken(nextPageToken).build();\n", - " } else {\n", - " break;\n", - " }\n", + "EchoClient echoClient = EchoClient.create();\n", + "PagedExpandRequest request =\n", + " PagedExpandRequest.newBuilder()\n", + " .setContent(\"content951530617\")\n", + " .setPageSize(883849137)\n", + " .setPageToken(\"pageToken873572522\")\n", + " .build();\n", + "while (true) {\n", + " PagedExpandResponse response = echoClient.pagedExpandCallable().call(request);\n", + " for (EchoResponse element : response.getResponsesList()) {\n", + " // doThingsWith(element);\n", + " }\n", + " String nextPageToken = response.getNextPageToken();\n", + " if (!Strings.isNullOrEmpty(nextPageToken)) {\n", + " request = request.toBuilder().setPageToken(nextPageToken).build();\n", + " } else {\n", + " break;\n", " }\n", "}"); Assert.assertEquals(results, expected); diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientHeaderSampleComposerTest.java b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientHeaderSampleComposerTest.java index 48a7e4175e14..1d929d748fcf 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientHeaderSampleComposerTest.java +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientHeaderSampleComposerTest.java @@ -81,9 +81,8 @@ void composeClassHeaderSample_unaryRpc() { String results = writeStatements(sample); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " EchoResponse response = echoClient.echo();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "EchoResponse response = echoClient.echo();"); Assert.assertEquals(expected, results); } @@ -164,10 +163,9 @@ void composeClassHeaderSample_firstMethodIsNotUnaryRpc() { service, clientType, resourceNames, messageTypes)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " Duration ttl = Duration.newBuilder().build();\n", - " WaitResponse response = echoClient.waitAsync(ttl).get();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "Duration ttl = Duration.newBuilder().build();\n", + "WaitResponse response = echoClient.waitAsync(ttl).get();"); Assert.assertEquals(results, expected); } @@ -219,18 +217,17 @@ void composeClassHeaderSample_firstMethodHasNoSignatures() { System.out.println("results: " + results); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " EchoRequest request =\n", - " EchoRequest.newBuilder()\n", - " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + "EchoClient echoClient = EchoClient.create();\n", + "EchoRequest request =\n", + " EchoRequest.newBuilder()\n", + " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setSeverity(Severity.forNumber(0))\n", - " .setFoobar(Foobar.newBuilder().build())\n", - " .build();\n", - " EchoResponse response = echoClient.echo(request);\n", - "}"); + " .setSeverity(Severity.forNumber(0))\n", + " .setFoobar(Foobar.newBuilder().build())\n", + " .build();\n", + "EchoResponse response = echoClient.echo(request);"); System.out.println("results: " + expected); Assert.assertEquals(results, expected); } @@ -282,13 +279,12 @@ void composeClassHeaderSample_firstMethodIsStream() { service, clientType, resourceNames, messageTypes)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " ExpandRequest request =\n", - " ExpandRequest.newBuilder().setContent(\"content951530617\").setInfo(\"info3237038\").build();\n", - " ServerStream stream = echoClient.expandCallable().call(request);\n", - " for (EchoResponse response : stream) {\n", - " // Do something when a response is received.\n", - " }\n", + "EchoClient echoClient = EchoClient.create();\n", + "ExpandRequest request =\n", + " ExpandRequest.newBuilder().setContent(\"content951530617\").setInfo(\"info3237038\").build();\n", + "ServerStream stream = echoClient.expandCallable().call(request);\n", + "for (EchoResponse response : stream) {\n", + " // Do something when a response is received.\n", "}"); Assert.assertEquals(results, expected); } @@ -349,17 +345,15 @@ void composeClassHeaderSample_firstMethodIsInternal() { service, clientType, resourceNames, messageTypes)); String expected = LineFormatter.lines( - "try (EchoServiceSelectiveApiClient echoServiceSelectiveApiClient =\n" - + " EchoServiceSelectiveApiClient.create()) {\n" - + " EchoRequest request =\n" - + " EchoRequest.newBuilder()\n" - + " .setName(FoobarName.of(\"[PROJECT]\", \"[FOOBAR]\").toString())\n" - + " .setParent(\n" - + " FoobarbazName.ofProjectFoobarbazName(\"[PROJECT]\", \"[FOOBARBAZ]\").toString())\n" - + " .setFoobar(Foobar.newBuilder().build())\n" - + " .build();\n" - + " EchoResponse response = echoServiceSelectiveApiClient.chatShouldGenerateAsUsual(request);\n" - + "}"); + "EchoServiceSelectiveApiClient echoServiceSelectiveApiClient =\n" + + " EchoServiceSelectiveApiClient.create();\n" + + "EchoRequest request =\n" + + " EchoRequest.newBuilder()\n" + + " .setName(FoobarName.of(\"[PROJECT]\", \"[FOOBAR]\").toString())\n" + + " .setParent(FoobarbazName.ofProjectFoobarbazName(\"[PROJECT]\", \"[FOOBARBAZ]\").toString())\n" + + " .setFoobar(Foobar.newBuilder().build())\n" + + " .build();\n" + + "EchoResponse response = echoServiceSelectiveApiClient.chatShouldGenerateAsUsual(request);"); Assert.assertEquals(results, expected); } @@ -419,8 +413,8 @@ void composeClassHeaderSample_allMethodsAreInternal() { service, clientType, resourceNames, messageTypes)); String expected = LineFormatter.lines( - "try (EchoServiceSelectiveApiClient echoServiceSelectiveApiClient =\n" - + " EchoServiceSelectiveApiClient.create()) {}"); + "EchoServiceSelectiveApiClient echoServiceSelectiveApiClient =\n" + + " EchoServiceSelectiveApiClient.create();"); Assert.assertEquals(expected, results); } @@ -578,13 +572,11 @@ void valid_composeShowcaseMethodSample_pagedRpcWithMultipleMethodArguments() { method, clientType, arguments, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " List resourceName = new ArrayList<>();\n", - " String filter = \"filter-1274492040\";\n", - " for (Content element : echoClient.listContent(resourceName, filter).iterateAll())" - + " {\n", - " // doThingsWith(element);\n", - " }\n", + "EchoClient echoClient = EchoClient.create();\n", + "List resourceName = new ArrayList<>();\n", + "String filter = \"filter-1274492040\";\n", + "for (Content element : echoClient.listContent(resourceName, filter).iterateAll()) {\n", + " // doThingsWith(element);\n", "}"); Assert.assertEquals(results, expected); } @@ -663,10 +655,9 @@ void valid_composeShowcaseMethodSample_pagedRpcWithNoMethodArguments() { method, clientType, arguments, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " for (Content element : echoClient.listContent().iterateAll()) {\n", - " // doThingsWith(element);\n", - " }\n", + "EchoClient echoClient = EchoClient.create();\n", + "for (Content element : echoClient.listContent().iterateAll()) {\n", + " // doThingsWith(element);\n", "}"); Assert.assertEquals(results, expected); } @@ -855,9 +846,8 @@ void valid_composeShowcaseMethodSample_lroUnaryRpcWithNoMethodArgument() { method, clientType, Collections.emptyList(), resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " WaitResponse response = echoClient.waitAsync().get();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "WaitResponse response = echoClient.waitAsync().get();"); Assert.assertEquals(results, expected); } @@ -940,10 +930,9 @@ void valid_composeShowcaseMethodSample_lroRpcWithReturnResponseType() { method, clientType, arguments, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " Duration ttl = Duration.newBuilder().build();\n", - " WaitResponse response = echoClient.waitAsync(ttl).get();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "Duration ttl = Duration.newBuilder().build();\n", + "WaitResponse response = echoClient.waitAsync(ttl).get();"); Assert.assertEquals(results, expected); } @@ -1022,10 +1011,9 @@ void valid_composeShowcaseMethodSample_lroRpcWithReturnVoid() { method, clientType, arguments, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " Duration ttl = Duration.newBuilder().build();\n", - " echoClient.waitAsync(ttl).get();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "Duration ttl = Duration.newBuilder().build();\n", + "echoClient.waitAsync(ttl).get();"); Assert.assertEquals(results, expected); } diff --git a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientMethodSampleComposerTest.java b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientMethodSampleComposerTest.java index d1b93a932ab3..eb53d4373dd4 100644 --- a/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientMethodSampleComposerTest.java +++ b/sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/samplecode/ServiceClientMethodSampleComposerTest.java @@ -86,16 +86,15 @@ void valid_composeDefaultSample_isPagedMethod() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " PagedExpandRequest request =\n", - " PagedExpandRequest.newBuilder()\n", - " .setContent(\"content951530617\")\n", - " .setPageSize(883849137)\n", - " .setPageToken(\"pageToken873572522\")\n", - " .build();\n", - " for (EchoResponse element : echoClient.pagedExpand(request).iterateAll()) {\n", - " // doThingsWith(element);\n", - " }\n", + "EchoClient echoClient = EchoClient.create();\n", + "PagedExpandRequest request =\n", + " PagedExpandRequest.newBuilder()\n", + " .setContent(\"content951530617\")\n", + " .setPageSize(883849137)\n", + " .setPageToken(\"pageToken873572522\")\n", + " .build();\n", + "for (EchoResponse element : echoClient.pagedExpand(request).iterateAll()) {\n", + " // doThingsWith(element);\n", "}"); Assert.assertEquals(results, expected); } @@ -208,10 +207,9 @@ void valid_composeDefaultSample_hasLroMethodWithReturnResponse() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " WaitRequest request = WaitRequest.newBuilder().build();\n", - " echoClient.waitAsync(request).get();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "WaitRequest request = WaitRequest.newBuilder().build();\n", + "echoClient.waitAsync(request).get();"); Assert.assertEquals(results, expected); } @@ -277,10 +275,9 @@ void valid_composeDefaultSample_hasLroMethodWithReturnVoid() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " WaitRequest request = WaitRequest.newBuilder().build();\n", - " WaitResponse response = echoClient.waitAsync(request).get();\n", - "}"); + "EchoClient echoClient = EchoClient.create();\n", + "WaitRequest request = WaitRequest.newBuilder().build();\n", + "WaitResponse response = echoClient.waitAsync(request).get();"); Assert.assertEquals(results, expected); } @@ -328,18 +325,17 @@ void valid_composeDefaultSample_pureUnaryReturnVoid() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " EchoRequest request =\n", - " EchoRequest.newBuilder()\n", - " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + "EchoClient echoClient = EchoClient.create();\n", + "EchoRequest request =\n", + " EchoRequest.newBuilder()\n", + " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setSeverity(Severity.forNumber(0))\n", - " .setFoobar(Foobar.newBuilder().build())\n", - " .build();\n", - " echoClient.echo(request);\n", - "}"); + " .setSeverity(Severity.forNumber(0))\n", + " .setFoobar(Foobar.newBuilder().build())\n", + " .build();\n", + "echoClient.echo(request);"); Assert.assertEquals(results, expected); } @@ -390,18 +386,17 @@ void valid_composeDefaultSample_pureUnaryReturnResponse() { method, clientType, resourceNames, messageTypes, service)); String expected = LineFormatter.lines( - "try (EchoClient echoClient = EchoClient.create()) {\n", - " EchoRequest request =\n", - " EchoRequest.newBuilder()\n", - " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + "EchoClient echoClient = EchoClient.create();\n", + "EchoRequest request =\n", + " EchoRequest.newBuilder()\n", + " .setName(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " .setParent(FoobarName.ofProjectFoobarName(\"[PROJECT]\"," + " \"[FOOBAR]\").toString())\n", - " .setSeverity(Severity.forNumber(0))\n", - " .setFoobar(Foobar.newBuilder().build())\n", - " .build();\n", - " EchoResponse response = echoClient.echo(request);\n", - "}"); + " .setSeverity(Severity.forNumber(0))\n", + " .setFoobar(Foobar.newBuilder().build())\n", + " .build();\n", + "EchoResponse response = echoClient.echo(request);"); Assert.assertEquals(results, expected); }