Add new storage snippets to javadoc

mziccard · mziccard · commit 38f6d31d7695 · 2016-11-09T16:45:22.000+01:00
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
@@ -617,6 +617,18 @@ public CopyWriter copyTo(String targetBucket, String targetBlob, BlobSourceOptio
    * }
    * }</pre>
    *
+   * <p>Example of reading just a portion of the blob's content.
+   * <pre> {@code
+   * int start = 1;
+   * int end = 8;
+   * try (ReadChannel reader = blob.reader()) {
+   *   reader.seek(start);
+   *   ByteBuffer bytes = ByteBuffer.allocate(end - start);
+   *   reader.read(bytes);
+   *   return bytes.array();
+   * }
+   * }</pre>
+   *
    * @param options blob read options
    * @throws StorageException upon failure
    */
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java
@@ -1496,6 +1496,17 @@ public static Builder newBuilder() {
    * Bucket bucket = storage.create(BucketInfo.of(bucketName));
    * }</pre>
    *
+   * <p>Example of creating a bucket with storage class and location.
+   * <pre> {@code
+   * String bucketName = "my_unique_bucket";
+   * Bucket bucket = storage.create(BucketInfo.newBuilder(bucketName)
+   *     // See here for possible values: http://g.co/cloud/storage/docs/storage-classes
+   *     .setStorageClass("COLDLINE")
+   *     // Possible values: http://g.co/cloud/storage/docs/bucket-locations#location-mr
+   *     .setLocation("asia")
+   *     .build());
+   * }</pre>
+   *
    * @return a complete bucket
    * @throws StorageException upon failure
    */
