[Storage] Add a simple download sample

google-cloud-examples/src/main/java/com/google/cloud/examples/storage/snippets/StorageSnippets.java

@@ -1133,6 +1133,32 @@ public Bucket getRequesterPaysStatus(String bucketName) throws StorageException
     return bucket;
   }
 
+  /**
+   * Example of downloading a file.
+   */
+  public void downloadFile(String bucketName, String srcFilename,
+      Path destFilePath) throws IOException {
+    // [START storage_download_file]
+    // The name of the bucket to access
+    // String bucketName = "my-bucket";
+
+    // The name of the remote file to download
+    // String srcFilename = "file.txt";
+
+    // The path to which the file should be downloaded
+    // Path destFilePath = Paths.get("/local/path/to/file.txt");
+
+    // Instantiate a Google Cloud Storage client
+    Storage storage = StorageOptions.getDefaultInstance().getService();
+
+    // Get specific file from specified bucket
+    Blob blob = storage.get(BlobId.of(bucketName, srcFilename));
+
+    // Download file to specified path
+    blob.downloadTo(destFilePath);
+    // [END storage_download_file]
+  }
+
   /**
    * Example of downloading a file using Requester pay.
    */

google-cloud-examples/src/test/java/com/google/cloud/examples/storage/snippets/ITStorageSnippets.java

@@ -421,6 +421,18 @@ public void testAuthListBuckets() {
     assertNotNull(bucket);
   }
 
+  @Test
+  public void testBlobDownload() throws Exception {
+    String blobName = "test-create-empty-blob";
+    BlobId blobId = BlobId.of(BUCKET, blobName);
+    BlobInfo blobInfo = BlobInfo.newBuilder(blobId).build();
+    Blob remoteBlob = storage.create(blobInfo, BLOB_BYTE_CONTENT);
+    assertNotNull(remoteBlob);
+    storageSnippets.downloadFile(BUCKET, blobName, Paths.get(blobName));
+    byte[] readBytes = Files.readAllBytes(Paths.get(blobName));
+    assertArrayEquals(BLOB_BYTE_CONTENT, readBytes);
+  }
+
   @Test
   public void testRequesterPays() throws Exception {
     Bucket bucket = storageSnippets.enableRequesterPays(BUCKET);