feat(storage/control): add delete folder recursive sample (#13642)

Adds a Java code sample demonstrating hierarchical namespace recursive
folder delete.

Fixes: b/530058464

Author: nidhiii-27

java-storage/samples/snippets/src/main/java/com/example/storage/control/v2/DeleteFolderRecursive.java

@@ -0,0 +1,58 @@
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.storage.control.v2;
+
+// [START storage_control_delete_folder_recursive]
+
+import com.google.api.gax.longrunning.OperationFuture;
+import com.google.protobuf.Empty;
+import com.google.storage.control.v2.DeleteFolderRecursiveMetadata;
+import com.google.storage.control.v2.DeleteFolderRecursiveRequest;
+import com.google.storage.control.v2.FolderName;
+import com.google.storage.control.v2.StorageControlClient;
+import java.io.IOException;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.TimeoutException;
+
+public final class DeleteFolderRecursive {
+
+  public static void deleteFolderRecursive(String bucketName, String folderName)
+      throws IOException, ExecutionException, InterruptedException, TimeoutException {
+    // The name of the bucket
+    // String bucketName = "your-unique-bucket-name";
+
+    // The name of the folder within the bucket
+    // String folderName = "your-unique-folder-name";
+
+    try (StorageControlClient storageControl = StorageControlClient.create()) {
+
+      // Set project to "_" to signify globally scoped bucket
+      String folderResourceName = FolderName.format("_", bucketName, folderName);
+      DeleteFolderRecursiveRequest request =
+          DeleteFolderRecursiveRequest.newBuilder().setName(folderResourceName).build();
+
+      OperationFuture<Empty, DeleteFolderRecursiveMetadata> operationFuture =
+          storageControl.deleteFolderRecursiveAsync(request);
+
+      operationFuture.get(30, TimeUnit.SECONDS);
+
+      System.out.printf("Deleted folder: %s%n", folderResourceName);
+    }
+  }
+}
+// [END storage_control_delete_folder_recursive]

java-storage/samples/snippets/src/test/java/com/example/storage/control/v2/FoldersTest.java

@@ -139,6 +139,27 @@ public void deleteFolder() throws IOException {
     assertThrows(NotFoundException.class, () -> storageControl.getFolder(folderName));
   }
 
+  @Test
+  public void deleteFolderRecursive()
+      throws IOException, ExecutionException, InterruptedException, TimeoutException {
+    String parentFolderName = UUID.randomUUID().toString();
+    FolderName parentFolder = FolderName.of("_", bucket.getName(), parentFolderName);
+    storageControl.createFolder(
+        BucketName.of("_", bucket.getName()),
+        Folder.getDefaultInstance(),
+        parentFolder.getFolder());
+
+    String childFolderName = parentFolderName + "/" + UUID.randomUUID().toString();
+    FolderName childFolder = FolderName.of("_", bucket.getName(), childFolderName);
+    storageControl.createFolder(
+        BucketName.of("_", bucket.getName()), Folder.getDefaultInstance(), childFolder.getFolder());
+
+    DeleteFolderRecursive.deleteFolderRecursive(bucket.getName(), parentFolder.getFolder());
+    assertThat(stdOut.getCapturedOutputAsUtf8String()).contains(parentFolder.toString());
+    assertThrows(NotFoundException.class, () -> storageControl.getFolder(parentFolder));
+    assertThrows(NotFoundException.class, () -> storageControl.getFolder(childFolder));
+  }
+
   @Test
   public void listFolder() throws IOException {
     FolderName folderName = FolderName.of("_", bucket.getName(), UUID.randomUUID().toString());