test(generator): rename test service and proto to MediaService and add GetMediaMetadata method (#14440)

Previously we'd checked in a copy of `resumable_upload.proto` from
showcase to be used in generator unit tests for resumable uploads. This
was confusing because

- there's only one method listed in the proto, which revealed some
generator edge cases e.g. for test class generation
- the name triggered awkward class names like
"HttpJsonResumableUploadServiceResumableUploadStub"

This PR changes the test proto to `media.proto`, the service to
`MediaService`, and adds a `GetMediaMetadata` method, with the intention
to make diffs/testing for future changes more understandable.

Author: whowes

sdk-platform-java/gapic-generator-java/src/main/java/com/google/api/generator/gapic/protoparser/Parser.java

@@ -139,6 +139,8 @@ enum SelectiveGapicType {
   static final ImmutableList<Pattern> RESUMABLE_UPLOAD_ALLOWLIST_PATTERNS =
       ImmutableList.of(
           Pattern.compile("^google\\.showcase\\.v1beta1\\.ResumableUploadService\\.UploadMedia$"),
+          // For generator unit tests only; not an implemented service.
+          Pattern.compile("^google\\.showcase\\.v1beta1\\.MediaService\\.UploadMedia$"),
           Pattern.compile(
               "^google\\.ads\\.googleads\\.v\\d+\\.services\\.YouTubeVideoUploadService\\.CreateYouTubeVideoUpload$"));
 

sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/GrpcServiceStubClassComposerTest.java

@@ -129,7 +129,7 @@ void generateGrpcServiceStubClass_resumableUpload() {
     Service service = context.services().get(0);
     GapicClass clazz = GrpcServiceStubClassComposer.instance().generate(context, service);
 
-    Assert.assertGoldenClass(this.getClass(), clazz, "GrpcResumableUploadServiceStub.golden");
+    Assert.assertGoldenClass(this.getClass(), clazz, "GrpcMediaServiceStub.golden");
     Assert.assertEmptySamples(clazz.samples());
   }
 }

sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/ServiceClientClassComposerTest.java

@@ -66,7 +66,7 @@ private static Stream<Arguments> data() {
             "v1beta1",
             1),
         Arguments.of(
-            "ResumableUploadServiceClient",
+            "MediaServiceClient",
             GrpcTestProtoLoader.instance().parseShowcaseResumableUpload(),
             "localhost:7469",
             "v1beta1",

sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/ServiceSettingsClassComposerTest.java

@@ -47,7 +47,7 @@ static Stream<Arguments> data() {
             "v1beta1",
             1),
         Arguments.of(
-            "ResumableUploadServiceSettings",
+            "MediaServiceSettings",
             TestProtoLoader.instance().parseShowcaseResumableUpload(),
             "localhost:7469",
             "v1beta1",

sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/ServiceStubClassComposerTest.java

@@ -41,7 +41,7 @@ static Stream<Arguments> data() {
             "",
             1),
         Arguments.of(
-            "ResumableUploadServiceStub",
+            "MediaServiceStub",
             TestProtoLoader.instance().parseShowcaseResumableUpload(),
             "",
             "",

sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/ServiceStubSettingsClassComposerTest.java

@@ -70,7 +70,7 @@ static Stream<Arguments> data() {
             "v2",
             0),
         Arguments.of(
-            "ResumableUploadServiceStubSettings",
+            "MediaServiceStubSettings",
             GrpcTestProtoLoader.instance().parseShowcaseResumableUpload(),
             "localhost:7469",
             "v1beta1",

sdk-platform-java/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/GrpcMediaServiceStub.golden

@@ -0,0 +1,162 @@
+package com.google.showcase.v1beta1.stub;
+
+import com.google.api.core.BetaApi;
+import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.core.BackgroundResourceAggregation;
+import com.google.api.gax.grpc.GrpcCallSettings;
+import com.google.api.gax.grpc.GrpcStubCallableFactory;
+import com.google.api.gax.rpc.ClientContext;
+import com.google.api.gax.rpc.ResumableUploadCallable;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.common.collect.ImmutableList;
+import com.google.longrunning.stub.GrpcOperationsStub;
+import com.google.showcase.v1beta1.GetMediaMetadataRequest;
+import com.google.showcase.v1beta1.GetMediaMetadataResponse;
+import com.google.showcase.v1beta1.UploadMediaRequest;
+import com.google.showcase.v1beta1.UploadMediaResponse;
+import io.grpc.MethodDescriptor;
+import io.grpc.protobuf.ProtoUtils;
+import java.io.IOException;
+import java.util.concurrent.TimeUnit;
+import javax.annotation.Generated;
+import org.jspecify.annotations.NullMarked;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * gRPC stub implementation for the MediaService service API.
+ *
+ * <p>This class is for advanced usage and reflects the underlying API directly.
+ */
+@NullMarked
+@BetaApi
+@Generated("by gapic-generator-java")
+public class GrpcMediaServiceStub extends MediaServiceStub {
+  private static final MethodDescriptor<GetMediaMetadataRequest, GetMediaMetadataResponse>
+      getMediaMetadataMethodDescriptor =
+          MethodDescriptor.<GetMediaMetadataRequest, GetMediaMetadataResponse>newBuilder()
+              .setType(MethodDescriptor.MethodType.UNARY)
+              .setFullMethodName("google.showcase.v1beta1.MediaService/GetMediaMetadata")
+              .setRequestMarshaller(
+                  ProtoUtils.marshaller(GetMediaMetadataRequest.getDefaultInstance()))
+              .setResponseMarshaller(
+                  ProtoUtils.marshaller(GetMediaMetadataResponse.getDefaultInstance()))
+              .setSampledToLocalTracing(true)
+              .build();
+
+  private final UnaryCallable<GetMediaMetadataRequest, GetMediaMetadataResponse>
+      getMediaMetadataCallable;
+
+  private final BackgroundResource backgroundResources;
+  private final GrpcOperationsStub operationsStub;
+  private final HttpJsonMediaServiceResumableUploadStub resumableUploadStub;
+  private final GrpcStubCallableFactory callableFactory;
+
+  public static final GrpcMediaServiceStub create(MediaServiceStubSettings settings)
+      throws IOException {
+    return new GrpcMediaServiceStub(settings, ClientContext.create(settings));
+  }
+
+  public static final GrpcMediaServiceStub create(ClientContext clientContext) throws IOException {
+    return new GrpcMediaServiceStub(MediaServiceStubSettings.newBuilder().build(), clientContext);
+  }
+
+  public static final GrpcMediaServiceStub create(
+      ClientContext clientContext, GrpcStubCallableFactory callableFactory) throws IOException {
+    return new GrpcMediaServiceStub(
+        MediaServiceStubSettings.newBuilder().build(), clientContext, callableFactory);
+  }
+
+  /**
+   * Constructs an instance of GrpcMediaServiceStub, using the given settings. This is protected so
+   * that it is easy to make a subclass, but otherwise, the static factory methods should be
+   * preferred.
+   */
+  protected GrpcMediaServiceStub(MediaServiceStubSettings settings, ClientContext clientContext)
+      throws IOException {
+    this(settings, clientContext, new GrpcMediaServiceCallableFactory());
+  }
+
+  /**
+   * Constructs an instance of GrpcMediaServiceStub, using the given settings. This is protected so
+   * that it is easy to make a subclass, but otherwise, the static factory methods should be
+   * preferred.
+   */
+  protected GrpcMediaServiceStub(
+      MediaServiceStubSettings settings,
+      ClientContext clientContext,
+      GrpcStubCallableFactory callableFactory)
+      throws IOException {
+    this.callableFactory = callableFactory;
+    this.operationsStub = GrpcOperationsStub.create(clientContext, callableFactory);
+
+    GrpcCallSettings<GetMediaMetadataRequest, GetMediaMetadataResponse>
+        getMediaMetadataTransportSettings =
+            GrpcCallSettings.<GetMediaMetadataRequest, GetMediaMetadataResponse>newBuilder()
+                .setMethodDescriptor(getMediaMetadataMethodDescriptor)
+                .build();
+
+    this.getMediaMetadataCallable =
+        callableFactory.createUnaryCallable(
+            getMediaMetadataTransportSettings, settings.getMediaMetadataSettings(), clientContext);
+
+    this.resumableUploadStub = HttpJsonMediaServiceResumableUploadStub.create(settings);
+
+    this.backgroundResources =
+        new BackgroundResourceAggregation(
+            ImmutableList.<BackgroundResource>builder()
+                .addAll(clientContext.getBackgroundResources())
+                .add(resumableUploadStub)
+                .build());
+  }
+
+  public GrpcOperationsStub getOperationsStub() {
+    return operationsStub;
+  }
+
+  @Override
+  public UnaryCallable<GetMediaMetadataRequest, GetMediaMetadataResponse>
+      getMediaMetadataCallable() {
+    return getMediaMetadataCallable;
+  }
+
+  @Override
+  public ResumableUploadCallable<UploadMediaRequest, UploadMediaResponse> uploadMediaCallable() {
+    return resumableUploadStub.uploadMediaCallable();
+  }
+
+  @Override
+  public final void close() {
+    try {
+      backgroundResources.close();
+    } catch (RuntimeException e) {
+      throw e;
+    } catch (Exception e) {
+      throw new IllegalStateException("Failed to close resource", e);
+    }
+  }
+
+  @Override
+  public void shutdown() {
+    backgroundResources.shutdown();
+  }
+
+  @Override
+  public boolean isShutdown() {
+    return backgroundResources.isShutdown();
+  }
+
+  @Override
+  public boolean isTerminated() {
+    return backgroundResources.isTerminated();
+  }
+
+  @Override
+  public void shutdownNow() {
+    backgroundResources.shutdownNow();
+  }
+
+  @Override
+  public boolean awaitTermination(long duration, TimeUnit unit) throws InterruptedException {
+    return backgroundResources.awaitTermination(duration, unit);
+  }
+}