feat: add preview MultipartUploadClient#listMultipartUploads

google-cloud-storage/clirr-ignored-differences.xml

@@ -197,5 +197,13 @@
     <method>void flush()</method>
   </difference>
 
+  <!-- MultipartUploadClient is @InternalExtensionOnly -->
+  <difference>
+    <!-- allow new method to be added at any time -->
+    <differenceType>7013</differenceType>
+    <className>com/google/cloud/storage/MultipartUploadClient</className>
+    <method>* *(*)</method>
+  </difference>
+
 
 </differences>

google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClient.java

@@ -24,6 +24,8 @@
 import com.google.cloud.storage.multipartupload.model.CompleteMultipartUploadResponse;
 import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadRequest;
 import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadResponse;
+import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsRequest;
+import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsResponse;
 import com.google.cloud.storage.multipartupload.model.ListPartsRequest;
 import com.google.cloud.storage.multipartupload.model.ListPartsResponse;
 import com.google.cloud.storage.multipartupload.model.UploadPartRequest;
@@ -99,6 +101,17 @@ public abstract CompleteMultipartUploadResponse completeMultipartUpload(
   @BetaApi
   public abstract UploadPartResponse uploadPart(UploadPartRequest request, RequestBody requestBody);
 
+  /**
+   * Lists all multipart uploads in a bucket.
+   *
+   * @param request The request object containing the details for listing the multipart uploads.
+   * @return A {@link ListMultipartUploadsResponse} object containing the list of multipart uploads.
+   * @since 2.61.0 This new api is in preview and is subject to breaking changes.
+   */
+  @BetaApi
+  public abstract ListMultipartUploadsResponse listMultipartUploads(
+      ListMultipartUploadsRequest request);
+
   /**
    * Creates a new instance of {@link MultipartUploadClient}.
    *

google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadClientImpl.java

@@ -23,6 +23,8 @@
 import com.google.cloud.storage.multipartupload.model.CompleteMultipartUploadResponse;
 import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadRequest;
 import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadResponse;
+import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsRequest;
+import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsResponse;
 import com.google.cloud.storage.multipartupload.model.ListPartsRequest;
 import com.google.cloud.storage.multipartupload.model.ListPartsResponse;
 import com.google.cloud.storage.multipartupload.model.UploadPartRequest;
@@ -96,4 +98,12 @@ public UploadPartResponse uploadPart(UploadPartRequest request, RequestBody requ
         },
         Decoder.identity());
   }
+
+  @Override
+  public ListMultipartUploadsResponse listMultipartUploads(ListMultipartUploadsRequest request) {
+    return retrier.run(
+        retryAlgorithmManager.idempotent(),
+        () -> httpRequestManager.sendListMultipartUploadsRequest(request),
+        Decoder.identity());
+  }
 }

google-cloud-storage/src/main/java/com/google/cloud/storage/MultipartUploadHttpRequestManager.java

@@ -36,6 +36,8 @@
 import com.google.cloud.storage.multipartupload.model.CompleteMultipartUploadResponse;
 import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadRequest;
 import com.google.cloud.storage.multipartupload.model.CreateMultipartUploadResponse;
+import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsRequest;
+import com.google.cloud.storage.multipartupload.model.ListMultipartUploadsResponse;
 import com.google.cloud.storage.multipartupload.model.ListPartsRequest;
 import com.google.cloud.storage.multipartupload.model.ListPartsResponse;
 import com.google.cloud.storage.multipartupload.model.UploadPartRequest;
@@ -118,6 +120,42 @@ ListPartsResponse sendListPartsRequest(ListPartsRequest request) throws IOExcept
     return httpRequest.execute().parseAs(ListPartsResponse.class);
   }
 
+  ListMultipartUploadsResponse sendListMultipartUploadsRequest(ListMultipartUploadsRequest request)
+      throws IOException {
+
+    ImmutableMap.Builder<String, Object> params =
+        ImmutableMap.<String, Object>builder().put("bucket", request.bucket());
+    if (request.delimiter() != null) {
+      params.put("delimiter", request.delimiter());
+    }
+    if (request.encodingType() != null) {
+      params.put("encoding-type", request.encodingType());
+    }
+    if (request.keyMarker() != null) {
+      params.put("key-marker", request.keyMarker());
+    }
+    if (request.maxUploads() != null) {
+      params.put("max-uploads", request.maxUploads());
+    }
+    if (request.prefix() != null) {
+      params.put("prefix", request.prefix());
+    }
+    if (request.uploadIdMarker() != null) {
+      params.put("upload-id-marker", request.uploadIdMarker());
+    }
+    String listUri =
+        UriTemplate.expand(
+            uri.toString()
+                + "{bucket}?uploads{&delimiter,encoding-type,key-marker,max-uploads,prefix,upload-id-marker}",
+            params.build(),
+            false);
+    HttpRequest httpRequest = requestFactory.buildGetRequest(new GenericUrl(listUri));
+    httpRequest.getHeaders().putAll(headerProvider.getHeaders());
+    httpRequest.setParser(objectParser);
+    httpRequest.setThrowExceptionOnExecuteError(true);
+    return httpRequest.execute().parseAs(ListMultipartUploadsResponse.class);
+  }
+
   AbortMultipartUploadResponse sendAbortMultipartUploadRequest(AbortMultipartUploadRequest request)
       throws IOException {
 
@@ -282,7 +320,7 @@ private static String urlEncode(String value) {
    */
   private static String formatName(String name) {
     // Only lowercase letters, digits, and "-" are allowed
-    return name.toLowerCase().replaceAll("[^\\w\\d\\-]", "-");
+    return name.toLowerCase().replaceAll("[^\\w-]", "-");
   }
 
   private static String formatSemver(String version) {