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

Re-applies the changes from #13642 (which was reverted in #14391 due to
#14387) and includes librarian generation updates so that the librarian
generate diff check succeeds.

[Generated-by: AI]

Author: nidhiii-27

java-storage/README.md

@@ -310,6 +310,7 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-java/
 | Create Folder | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/storage/control/v2/CreateFolder.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/storage/control/v2/CreateFolder.java) |
 | Create Hierarchical Namespace Bucket | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/storage/control/v2/CreateHierarchicalNamespaceBucket.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/storage/control/v2/CreateHierarchicalNamespaceBucket.java) |
 | Delete Folder | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/storage/control/v2/DeleteFolder.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/storage/control/v2/DeleteFolder.java) |
+| Delete Folder Recursive | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/storage/control/v2/DeleteFolderRecursive.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/storage/control/v2/DeleteFolderRecursive.java) |
 | Get Folder | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/storage/control/v2/GetFolder.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/storage/control/v2/GetFolder.java) |
 | List Folders | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/storage/control/v2/ListFolders.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/storage/control/v2/ListFolders.java) |
 | Rename Folder | [source code](https://github.com/googleapis/google-cloud-java/blob/main/samples/snippets/src/main/java/com/example/storage/control/v2/RenameFolder.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-java&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/storage/control/v2/RenameFolder.java) |

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

@@ -0,0 +1,56 @@
+/*
+ * 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;
+
+public final class DeleteFolderRecursive {
+
+  public static void deleteFolderRecursive(String bucketName, String folderName)
+      throws IOException, ExecutionException, InterruptedException {
+    // 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();
+
+      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,26 @@ public void deleteFolder() throws IOException {
     assertThrows(NotFoundException.class, () -> storageControl.getFolder(folderName));
   }
 
+  @Test
+  public void deleteFolderRecursive() throws IOException, ExecutionException, InterruptedException {
+    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());