Add sample for moving blob.

Jerjou Cheng · Jerjou Cheng · commit f308eddcb5df · 2016-11-09T15:10:18.000-08:00
diff --git a/google-cloud-examples/src/main/java/com/google/cloud/examples/storage/snippets/BlobSnippets.java b/google-cloud-examples/src/main/java/com/google/cloud/examples/storage/snippets/BlobSnippets.java
@@ -172,6 +172,22 @@ public Blob copyToStrings(String bucketName, String blobName) {
     return copiedBlob;
   }
 
+  /**
+   * Example of moving a blob to a different bucket with a different name.
+   */
+  public Blob moveTo(Blob srcBlob, String destBucket, String destBlob) {
+    // [START storageMoveFile]
+    CopyWriter copyWriter = srcBlob.copyTo(destBucket, destBlob);
+    Blob copiedBlob = copyWriter.getResult();
+    boolean deleted = srcBlob.delete();
+    // [END storageMoveFile]
+    if (deleted) {
+      return copiedBlob;
+    } else {
+      return null;
+    }
+  }
+
   /**
    * Example of reading the blob's content through a reader.
    */
diff --git a/google-cloud-examples/src/test/java/com/google/cloud/examples/storage/snippets/ITBlobSnippets.java b/google-cloud-examples/src/test/java/com/google/cloud/examples/storage/snippets/ITBlobSnippets.java
@@ -105,7 +105,11 @@ public void testBlob() throws IOException {
     copiedBlob.delete();
     copiedBlob = blobSnippets.copyToBucket(BUCKET);
     assertNotNull(copiedBlob);
+
+    copiedBlob = blobSnippets.moveTo(copiedBlob, BUCKET, "moveBlob");
+    assertNotNull(copiedBlob);
     copiedBlob.delete();
+
     blobSnippets.reload();
     blobSnippets.writer();
     URL signedUrl = blobSnippets.signUrl();
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/Blob.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/Blob.java
@@ -543,6 +543,13 @@ public boolean delete(BlobSourceOption... options) {
    * Blob copiedBlob = copyWriter.getResult();
    * }</pre>
    *
+   * <p>Example of moving a blob to a different bucket with a different name.
+   * <pre> {@code
+   * CopyWriter copyWriter = srcBlob.copyTo(destBucket, destBlob);
+   * Blob copiedBlob = copyWriter.getResult();
+   * boolean deleted = srcBlob.delete();
+   * }</pre>
+   *
    * @param targetBlob target blob's id
    * @param options source blob options
    * @return a {@link CopyWriter} object that can be used to get information on the newly created
