---

jean-philippe-martin · sduskis · commit 8952bfdd1447 · 2019-03-19T13:51:33.000-04:00
yaml --- r: 25213 b: refs/heads/autosynth-tasks c: f574484 h: refs/heads/master i: 25211: e470198
diff --git a/[refs] b/[refs]
@@ -139,7 +139,7 @@ refs/heads/autosynth-redis: 6bedce4d7c7c6ca6a22e83ad1780e08fdc565a9e
 refs/heads/autosynth-scheduler: 57f9fdb1e7de30c85f4ec7198931a07f50603e55
 refs/heads/autosynth-spanner: cbd30ccc550e9d0419ce4e5e6cfef4951ea170b1
 refs/heads/autosynth-speech: 64692f6db11364f663921be02c08072b966b6e7b
-refs/heads/autosynth-tasks: bd8d2cecdfb56b35d41a86697eda279e34f19bcf
+refs/heads/autosynth-tasks: f5744849a2bb093b21577730984510f657968526
 refs/heads/autosynth-texttospeech: 2dcc5dc22be0f456caa1b6a8a4bcdace2641239c
 refs/heads/autosynth-trace: 8804c46bfe147702ee9c95669f17f42d3790cf23
 refs/heads/autosynth-websecurityscanner: a3c778316a0f78f7ad4bac3dc3721da5ca832d3c
diff --git a/branches/autosynth-tasks/google-cloud-clients/google-cloud-contrib/google-cloud-nio-examples/README.md b/branches/autosynth-tasks/google-cloud-clients/google-cloud-contrib/google-cloud-nio-examples/README.md
@@ -6,7 +6,8 @@ application that uses Java NIO without the need to recompile.
 
 Note that whenever possible, you instead want to recompile the app and use the normal
 dependency mechanism to add a dependency to google-cloud-nio. You can see examples of
-this in the [google-cloud-examples](../../../google-cloud-examples) project.
+this in the [google-cloud-examples](../../../google-cloud-examples) project,
+[under nio](../../../google-cloud-examples/src/main/java/com/google/cloud/examples/nio).
 
 To run this example:
 
diff --git a/branches/autosynth-tasks/google-cloud-clients/google-cloud-contrib/google-cloud-nio/README.md b/branches/autosynth-tasks/google-cloud-clients/google-cloud-contrib/google-cloud-nio/README.md
@@ -57,7 +57,8 @@ Authentication
 --------------
 
 See the [Authentication](https://github.com/googleapis/google-cloud-java#authentication)
-section in the base directory's README.
+section in the base directory's README. This shows how to construct the `StorageOptions` object,
+which you can then pass to `CloudStorageFileSystem.forBucket`.
 
 About Google Cloud Storage
 --------------------------
diff --git a/branches/autosynth-tasks/google-cloud-clients/google-cloud-contrib/google-cloud-nio/src/main/java/com/google/cloud/storage/contrib/nio/CloudStorageFileSystemProvider.java b/branches/autosynth-tasks/google-cloud-clients/google-cloud-contrib/google-cloud-nio/src/main/java/com/google/cloud/storage/contrib/nio/CloudStorageFileSystemProvider.java
@@ -140,7 +140,12 @@ protected Path computeNext() {
     }
   }
 
-  /** Sets options that are only used by the constructor. */
+  /**
+   * Sets options that are only used by the constructor.
+   *
+   * <p>Instead of calling this, when possible use CloudStorageFileSystem.forBucket and pass
+   * StorageOptions as an argument.
+   */
   @VisibleForTesting
   public static void setStorageOptions(@Nullable StorageOptions newStorageOptions) {
     futureStorageOptions = newStorageOptions;
diff --git a/branches/autosynth-tasks/google-cloud-examples/src/main/java/com/google/cloud/examples/nio/snippets/UseExplicitCredentials.java b/branches/autosynth-tasks/google-cloud-examples/src/main/java/com/google/cloud/examples/nio/snippets/UseExplicitCredentials.java
@@ -0,0 +1,47 @@
+/*
+ * Copyright 2019 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.google.cloud.examples.nio.snippets;
+
+import com.google.auth.oauth2.ServiceAccountCredentials;
+import com.google.cloud.storage.StorageOptions;
+import com.google.cloud.storage.contrib.nio.CloudStorageConfiguration;
+import com.google.cloud.storage.contrib.nio.CloudStorageFileSystem;
+import java.io.FileInputStream;
+import java.io.IOException;
+
+/**
+ * A snippet for Google Cloud Storage NIO that shows how to create a {@link CloudStorageFileSystem}
+ * using explicitly-provided credentials instead of the default ones.
+ */
+public class UseExplicitCredentials {
+
+  public static void main(String... args) throws IOException {
+    // Create a file system for the bucket using the service account credentials
+    // saved in the file below.
+    String myCredentials = "/path/to/my/key.json";
+    CloudStorageFileSystem fs =
+        CloudStorageFileSystem.forBucket(
+            "mybucket",
+            CloudStorageConfiguration.DEFAULT,
+            StorageOptions.newBuilder()
+                .setCredentials(
+                    ServiceAccountCredentials.fromStream(new FileInputStream(myCredentials)))
+                .build());
+    // Can now read and write to the bucket using fs
+    // (see e.g. ReadAllLines for an example).
+  }
+}

Original file line number	Diff line number	Diff line change
`@@ -140,7 +140,12 @@ protected Path computeNext() {`
`140`	`140`	`}`
`141`	`141`	`}`
`142`	`142`
`143`		`- /** Sets options that are only used by the constructor. */`
	`143`	`+ /**`
	`144`	`+ * Sets options that are only used by the constructor.`
	`145`	`+ *`
	`146`	`+ * <p>Instead of calling this, when possible use CloudStorageFileSystem.forBucket and pass`
	`147`	`+ * StorageOptions as an argument.`
	`148`	`+ */`
`144`	`149`	`@VisibleForTesting`
`145`	`150`	`public static void setStorageOptions(@Nullable StorageOptions newStorageOptions) {`
`146`	`151`	`futureStorageOptions = newStorageOptions;`