samples: Automl cleanup (#1621)

* Move samples and refactor them for simplification

* Add missing resource files

* Update GetDataset.java

* Update ListDatasets.java

* Remove output that isn't returned with create

* Update pom to Java 11

* Update samples to new format

* Use throw exception instead of catch

Author: nnegrey

automl/snippets/resources/input.txt

@@ -0,0 +1 @@
+Tell me how this ends

automl/snippets/src/main/java/com/example/automl/DeleteDataset.java

@@ -0,0 +1,50 @@
+/*
+ * 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.example.automl;
+
+// [START automl_delete_dataset]
+import com.google.cloud.automl.v1.AutoMlClient;
+import com.google.cloud.automl.v1.DatasetName;
+import com.google.protobuf.Empty;
+
+import java.io.IOException;
+import java.util.concurrent.ExecutionException;
+
+class DeleteDataset {
+
+  static void deleteDataset() throws IOException, ExecutionException, InterruptedException {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "YOUR_PROJECT_ID";
+    String datasetId = "YOUR_DATASET_ID";
+    deleteDataset(projectId, datasetId);
+  }
+
+  // Delete a dataset
+  static void deleteDataset(String projectId, String datasetId)
+      throws IOException, ExecutionException, InterruptedException {
+    // Initialize client that will be used to send requests. This client only needs to be created
+    // once, and can be reused for multiple requests. After completing all of your requests, call
+    // the "close" method on the client to safely clean up any remaining background resources.
+    try (AutoMlClient client = AutoMlClient.create()) {
+      // Get the full path of the dataset.
+      DatasetName datasetFullId = DatasetName.of(projectId, "us-central1", datasetId);
+      Empty response = client.deleteDatasetAsync(datasetFullId).get();
+      System.out.format("Dataset deleted. %s\n", response);
+    }
+  }
+}
+// [END automl_delete_dataset]

automl/snippets/src/main/java/com/example/automl/DeleteModel.java

@@ -0,0 +1,54 @@
+/*
+ * 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.example.automl;
+
+// [START automl_delete_model]
+import com.google.cloud.automl.v1.AutoMlClient;
+import com.google.cloud.automl.v1.ModelName;
+import com.google.protobuf.Empty;
+
+import java.io.IOException;
+import java.util.concurrent.ExecutionException;
+
+class DeleteModel {
+
+  static void deleteModel() throws IOException, ExecutionException, InterruptedException {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "YOUR_PROJECT_ID";
+    String modelId = "YOUR_MODEL_ID";
+    deleteModel(projectId, modelId);
+  }
+
+  // Get a model
+  static void deleteModel(String projectId, String modelId)
+      throws IOException, ExecutionException, InterruptedException {
+    // Initialize client that will be used to send requests. This client only needs to be created
+    // once, and can be reused for multiple requests. After completing all of your requests, call
+    // the "close" method on the client to safely clean up any remaining background resources.
+    try (AutoMlClient client = AutoMlClient.create()) {
+      // Get the full path of the model.
+      ModelName modelFullId = ModelName.of(projectId, "us-central1", modelId);
+
+      // Delete a model.
+      Empty response = client.deleteModelAsync(modelFullId).get();
+
+      System.out.println("Model deletion started...");
+      System.out.println(String.format("Model deleted. %s", response));
+    }
+  }
+}
+// [END automl_delete_model]

automl/snippets/src/main/java/com/example/automl/ExportDataset.java

@@ -0,0 +1,61 @@
+/*
+ * 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.example.automl;
+
+// [START automl_export_dataset]
+import com.google.cloud.automl.v1.AutoMlClient;
+import com.google.cloud.automl.v1.DatasetName;
+import com.google.cloud.automl.v1.GcsDestination;
+import com.google.cloud.automl.v1.OutputConfig;
+import com.google.protobuf.Empty;
+
+import java.io.IOException;
+import java.util.concurrent.ExecutionException;
+
+class ExportDataset {
+
+  static void exportDataset() throws IOException, ExecutionException, InterruptedException {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "YOUR_PROJECT_ID";
+    String datasetId = "YOUR_DATASET_ID";
+    String gcsUri = "gs://BUCKET_ID/path_to_export/";
+    exportDataset(projectId, datasetId, gcsUri);
+  }
+
+  // Export a dataset
+  static void exportDataset(String projectId, String datasetId, String gcsUri)
+      throws IOException, ExecutionException, InterruptedException {
+    // Initialize client that will be used to send requests. This client only needs to be created
+    // once, and can be reused for multiple requests. After completing all of your requests, call
+    // the "close" method on the client to safely clean up any remaining background resources.
+    try (AutoMlClient client = AutoMlClient.create()) {
+      // Get the complete path of the dataset.
+      DatasetName datasetFullId = DatasetName.of(projectId, "us-central1", datasetId);
+      GcsDestination gcsDestination =
+          GcsDestination.newBuilder().setOutputUriPrefix(gcsUri).build();
+
+      // Export the dataset to the output URI.
+      OutputConfig outputConfig =
+          OutputConfig.newBuilder().setGcsDestination(gcsDestination).build();
+
+      System.out.println("Processing export...");
+      Empty response = client.exportDataAsync(datasetFullId, outputConfig).get();
+      System.out.format("Dataset exported. %s\n", response);
+    }
+  }
+}
+// [END automl_export_dataset]

automl/snippets/src/main/java/com/example/automl/GetDataset.java

@@ -0,0 +1,68 @@
+/*
+ * 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.example.automl;
+
+// [START automl_translate_get_dataset]
+
+import com.google.cloud.automl.v1.AutoMlClient;
+import com.google.cloud.automl.v1.Dataset;
+import com.google.cloud.automl.v1.DatasetName;
+
+import java.io.IOException;
+
+class GetDataset {
+
+  static void getDataset() throws IOException {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "YOUR_PROJECT_ID";
+    String datasetId = "YOUR_DATASET_ID";
+    getDataset(projectId, datasetId);
+  }
+
+  // Get a dataset
+  static void getDataset(String projectId, String datasetId) throws IOException {
+    // Initialize client that will be used to send requests. This client only needs to be created
+    // once, and can be reused for multiple requests. After completing all of your requests, call
+    // the "close" method on the client to safely clean up any remaining background resources.
+    try (AutoMlClient client = AutoMlClient.create()) {
+      // Get the complete path of the dataset.
+      DatasetName datasetFullId = DatasetName.of(projectId, "us-central1", datasetId);
+      Dataset dataset = client.getDataset(datasetFullId);
+
+      // Display the dataset information
+      System.out.format("Dataset name: %s\n", dataset.getName());
+      // To get the dataset id, you have to parse it out of the `name` field. As dataset Ids are
+      // required for other methods.
+      // Name Form: `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}`
+      String[] names = dataset.getName().split("/");
+      String retrievedDatasetId = names[names.length - 1];
+      System.out.format("Dataset id: %s\n", retrievedDatasetId);
+      System.out.format("Dataset display name: %s\n", dataset.getDisplayName());
+      System.out.println("Translation dataset metadata:");
+      System.out.format(
+          "\tSource language code: %s\n",
+          dataset.getTranslationDatasetMetadata().getSourceLanguageCode());
+      System.out.format(
+          "\tTarget language code: %s\n",
+          dataset.getTranslationDatasetMetadata().getTargetLanguageCode());
+      System.out.println("Dataset create time:");
+      System.out.format("\tseconds: %s\n", dataset.getCreateTime().getSeconds());
+      System.out.format("\tnanos: %s\n", dataset.getCreateTime().getNanos());
+    }
+  }
+}
+// [END automl_translate_get_dataset]

automl/snippets/src/main/java/com/example/automl/GetModel.java

@@ -0,0 +1,61 @@
+/*
+ * 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.example.automl;
+
+// [START automl_get_model]
+import com.google.cloud.automl.v1.AutoMlClient;
+import com.google.cloud.automl.v1.Model;
+import com.google.cloud.automl.v1.ModelName;
+
+import java.io.IOException;
+
+class GetModel {
+
+  static void getModel() throws IOException {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "YOUR_PROJECT_ID";
+    String modelId = "YOUR_MODEL_ID";
+    getModel(projectId, modelId);
+  }
+
+  // Get a model
+  static void getModel(String projectId, String modelId) throws IOException {
+    // Initialize client that will be used to send requests. This client only needs to be created
+    // once, and can be reused for multiple requests. After completing all of your requests, call
+    // the "close" method on the client to safely clean up any remaining background resources.
+    try (AutoMlClient client = AutoMlClient.create()) {
+      // Get the full path of the model.
+      ModelName modelFullId = ModelName.of(projectId, "us-central1", modelId);
+      Model model = client.getModel(modelFullId);
+
+      // Display the model information.
+      System.out.format("Model name: %s\n", model.getName());
+      // To get the model id, you have to parse it out of the `name` field. As models Ids are
+      // required for other methods.
+      // Name Format: `projects/{project_id}/locations/{location_id}/models/{model_id}`
+      String[] names = model.getName().split("/");
+      String retrievedModelId = names[names.length - 1];
+      System.out.format("Model id: %s\n", retrievedModelId);
+      System.out.format("Model display name: %s\n", model.getDisplayName());
+      System.out.println("Model create time:");
+      System.out.format("\tseconds: %s\n", model.getCreateTime().getSeconds());
+      System.out.format("\tnanos: %s\n", model.getCreateTime().getNanos());
+      System.out.format("Model deployment state: %s\n", model.getDeploymentState());
+    }
+  }
+}
+// [END automl_get_model]

automl/snippets/src/main/java/com/example/automl/GetModelEvaluation.java

@@ -0,0 +1,62 @@
+/*
+ * 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.example.automl;
+
+// [START automl_get_model_evaluation]
+import com.google.cloud.automl.v1.AutoMlClient;
+import com.google.cloud.automl.v1.ModelEvaluation;
+import com.google.cloud.automl.v1.ModelEvaluationName;
+
+import java.io.IOException;
+
+class GetModelEvaluation {
+
+  static void getModelEvaluation() throws IOException {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "YOUR_PROJECT_ID";
+    String modelId = "YOUR_MODEL_ID";
+    String modelEvaluationId = "YOUR_MODEL_EVALUATION_ID";
+    getModelEvaluation(projectId, modelId, modelEvaluationId);
+  }
+
+  // Get a model evaluation
+  static void getModelEvaluation(String projectId, String modelId, String modelEvaluationId)
+      throws IOException {
+    // Initialize client that will be used to send requests. This client only needs to be created
+    // once, and can be reused for multiple requests. After completing all of your requests, call
+    // the "close" method on the client to safely clean up any remaining background resources.
+    try (AutoMlClient client = AutoMlClient.create()) {
+      // Get the full path of the model evaluation.
+      ModelEvaluationName modelEvaluationFullId =
+          ModelEvaluationName.of(projectId, "us-central1", modelId, modelEvaluationId);
+
+      // Get complete detail of the model evaluation.
+      ModelEvaluation modelEvaluation = client.getModelEvaluation(modelEvaluationFullId);
+
+      System.out.format("Model Evaluation Name: %s\n", modelEvaluation.getName());
+      System.out.format("Model Annotation Spec Id: %s", modelEvaluation.getAnnotationSpecId());
+      System.out.println("Create Time:");
+      System.out.format("\tseconds: %s\n", modelEvaluation.getCreateTime().getSeconds());
+      System.out.format("\tnanos: %s", modelEvaluation.getCreateTime().getNanos() / 1e9);
+      System.out.format(
+          "Evalution Example Count: %d\n", modelEvaluation.getEvaluatedExampleCount());
+      System.out.format(
+          "Model Evaluation Metrics: %s\n", modelEvaluation.getTranslationEvaluationMetrics());
+    }
+  }
+}
+// [END automl_get_model_evaluation]