[WIP] samples: migrate code from googleapis/java-servicedirectory

servicedirectory/snippets/snippets/README.md

@@ -0,0 +1,46 @@
+# Service Directory
+
+[Service Directory](https://cloud.google.com/service-directory/) is a platform
+for discovering, publishing, and connecting services. It offers customers a
+single place to register and discover their services in a consistent and
+reliable way, regardless of their environment. These sample Java applications
+demonstrate how to access the Service Directory API using the Google Java API
+Client Libraries.
+
+## Prerequisites
+
+### Enable the API
+
+You must enable the Service Directory API for your project in order to use these
+samples. You can do so
+[here](https://console.cloud.google.com/flows/enableapi?apiid=servicedirectory.googleapis.com&_ga=2.140387959.57242806.1585772225-360187285.1585772225).
+
+### Set Environment Variables
+
+You must set your project ID in order to run the tests
+
+`$ export GOOGLE_CLOUD_PROJECT=<your-project-id-here>`
+
+### Grant Permissions
+
+You must ensure that the
+[user account or service account](https://cloud.google.com/iam/docs/service-accounts#differences_between_a_service_account_and_a_user_account)
+you used to authorize your gcloud session has the proper permissions to edit
+Service Directory resources for your project. In the Cloud Console under IAM,
+add the `Service Directory Admin` role to the project whose service account
+you're using to test.
+
+More information can be found in the
+[Authentication docs](https://cloud.google.com/docs/authentication/production).
+
+## Quickstart
+
+Install [Maven](https://maven.apache.org/).
+
+Build your project with:
+
+    mvn clean package -DskipTests
+
+You can run all tests with:
+
+    mvn clean verify

servicedirectory/snippets/snippets/pom.xml

@@ -0,0 +1,73 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!--
+ Copyright 2020 Google Inc.
+ 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.
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>com.google.cloud</groupId>
+  <artifactId>servicedirectory-snippets</artifactId>
+  <packaging>jar</packaging>
+  <name>Google Service Directory Snippets</name>
+  <url>https://github.com/googleapis/java-servicedirectory</url>
+
+  <!--
+    The parent pom defines common style checks and testing strategies for our samples.
+    Removing or replacing it should not affect the execution of the samples in anyway.
+  -->
+  <parent>
+    <groupId>com.google.cloud.samples</groupId>
+    <artifactId>shared-configuration</artifactId>
+    <version>1.2.0</version>
+  </parent>
+
+  <properties>
+    <maven.compiler.target>1.8</maven.compiler.target>
+    <maven.compiler.source>1.8</maven.compiler.source>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+
+
+  <!-- [START servicedirectory_install_with_bom] -->
+  <dependencyManagement>
+    <dependencies>
+      <dependency>
+        <groupId>com.google.cloud</groupId>
+        <artifactId>libraries-bom</artifactId>
+        <version>26.1.4</version>
+        <type>pom</type>
+        <scope>import</scope>
+      </dependency>
+    </dependencies>
+  </dependencyManagement>
+
+  <dependencies>
+    <dependency>
+      <groupId>com.google.cloud</groupId>
+      <artifactId>google-cloud-servicedirectory</artifactId>
+    </dependency>
+    <!-- [END servicedirectory_install_with_bom] -->
+
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>4.13.2</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.google.truth</groupId>
+      <artifactId>truth</artifactId>
+      <version>1.1.3</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+
+</project>

servicedirectory/snippets/snippets/src/main/java/com/example/servicedirectory/EndpointsCreate.java

@@ -0,0 +1,66 @@
+/*
+ * Copyright 2020 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.servicedirectory;
+
+// [START servicedirectory_create_endpoint]
+
+import com.google.cloud.servicedirectory.v1.Endpoint;
+import com.google.cloud.servicedirectory.v1.RegistrationServiceClient;
+import com.google.cloud.servicedirectory.v1.ServiceName;
+import java.io.IOException;
+
+public class EndpointsCreate {
+
+  public static void createEndpoint() throws IOException {
+    // TODO(developer): Replace these variables before running the sample.
+    // These variables should refer to an existing Service Directory service.
+    String projectId = "your-project-id";
+    String locationId = "your-region";
+    String namespaceId = "your-namespace";
+    String serviceId = "your-service";
+    // This is user-created; must be unique within the service above.
+    String endpointId = "your-endpoint";
+    createEndpoint(projectId, locationId, namespaceId, serviceId, endpointId);
+  }
+
+  // Create a new endpoint.
+  public static void createEndpoint(
+      String projectId, String locationId, String namespaceId, String serviceId, String endpointId)
+      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 (RegistrationServiceClient client = RegistrationServiceClient.create()) {
+
+      // The service to create the endpoint in.
+      ServiceName parent = ServiceName.of(projectId, locationId, namespaceId, serviceId);
+
+      // The endpoint to create, with fields filled in.
+      // Optionally set an IP address and port for the endpoint.
+      Endpoint endpoint = Endpoint.newBuilder().setAddress("10.0.0.1").setPort(443).build();
+
+      // Send the request to create the endpoint.
+      Endpoint createdEndpoint = client.createEndpoint(parent, endpoint, endpointId);
+
+      // Process the response.
+      System.out.println("Created Endpoint: " + createdEndpoint.getName());
+      System.out.println("IP Address: " + createdEndpoint.getAddress());
+      System.out.println("Port: " + createdEndpoint.getPort());
+    }
+  }
+}
+// [END servicedirectory_create_endpoint]

servicedirectory/snippets/snippets/src/main/java/com/example/servicedirectory/EndpointsDelete.java

@@ -0,0 +1,59 @@
+/*
+ * Copyright 2020 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.servicedirectory;
+
+// [START servicedirectory_delete_endpoint]
+
+import com.google.cloud.servicedirectory.v1.EndpointName;
+import com.google.cloud.servicedirectory.v1.RegistrationServiceClient;
+import java.io.IOException;
+
+public class EndpointsDelete {
+
+  public static void deleteEndpoint() throws IOException {
+    // TODO(developer): Replace these variables before running the sample.
+    // These variables should refer to an existing Service Directory endpoint.
+    String projectId = "your-project-id";
+    String locationId = "your-region";
+    String namespaceId = "your-namespace";
+    String serviceId = "your-service";
+    String endpointId = "your-endpoint";
+    deleteEndpoint(projectId, locationId, namespaceId, serviceId, endpointId);
+  }
+
+  // Delete an endpoint.
+  public static void deleteEndpoint(
+      String projectId, String locationId, String namespaceId, String serviceId, String endpointId)
+      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 (RegistrationServiceClient client = RegistrationServiceClient.create()) {
+
+      // The endpoint to delete.
+      EndpointName endpointName =
+          EndpointName.of(projectId, locationId, namespaceId, serviceId, endpointId);
+
+      // Send the request to delete the endpoint.
+      client.deleteEndpoint(endpointName);
+
+      // Log the action.
+      System.out.println("Deleted Endpoint: " + endpointName.toString());
+    }
+  }
+}
+// [END servicedirectory_delete_endpoint]

servicedirectory/snippets/snippets/src/main/java/com/example/servicedirectory/NamespacesCreate.java

@@ -0,0 +1,59 @@
+/*
+ * Copyright 2020 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.servicedirectory;
+
+// [START servicedirectory_create_namespace]
+
+import com.google.cloud.servicedirectory.v1.LocationName;
+import com.google.cloud.servicedirectory.v1.Namespace;
+import com.google.cloud.servicedirectory.v1.RegistrationServiceClient;
+import java.io.IOException;
+
+public class NamespacesCreate {
+
+  public static void createNamespace() throws IOException {
+    // TODO(developer): Replace these variables before running the sample.
+    String projectId = "your-project-id";
+    String locationId = "your-region";
+    // This is user-created; must be unique within the project/region above.
+    String namespaceId = "your-namespace";
+    createNamespace(projectId, locationId, namespaceId);
+  }
+
+  // Create a new namespace.
+  public static void createNamespace(String projectId, String locationId, String namespaceId)
+      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 (RegistrationServiceClient client = RegistrationServiceClient.create()) {
+
+      // The project and location to create the namespace in.
+      LocationName parent = LocationName.of(projectId, locationId);
+
+      // The namespace object to create. Here, we use the default instance.
+      Namespace namespace = Namespace.newBuilder().build();
+
+      // Send the request to create the namespace.
+      Namespace createdNamespace = client.createNamespace(parent, namespace, namespaceId);
+
+      // Process the response.
+      System.out.println("Created Namespace: " + createdNamespace.getName());
+    }
+  }
+}
+// [END servicedirectory_create_namespace]

servicedirectory/snippets/snippets/src/main/java/com/example/servicedirectory/NamespacesDelete.java

@@ -0,0 +1,55 @@
+/*
+ * Copyright 2020 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.servicedirectory;
+
+// [START servicedirectory_delete_namespace]
+
+import com.google.cloud.servicedirectory.v1.NamespaceName;
+import com.google.cloud.servicedirectory.v1.RegistrationServiceClient;
+import java.io.IOException;
+
+public class NamespacesDelete {
+
+  public static void deleteNamespace() throws IOException {
+    // TODO(developer): Replace these variables before running the sample.
+    // These variables should refer to an existing Service Directory namespace.
+    String projectId = "your-project-id";
+    String locationId = "your-region";
+    String namespaceId = "your-namespace";
+    deleteNamespace(projectId, locationId, namespaceId);
+  }
+
+  // Delete a namespace.
+  public static void deleteNamespace(String projectId, String locationId, String namespaceId)
+      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 (RegistrationServiceClient client = RegistrationServiceClient.create()) {
+
+      // The namespace to delete.
+      NamespaceName namespaceName = NamespaceName.of(projectId, locationId, namespaceId);
+
+      // Send the request to delete the namespace.
+      client.deleteNamespace(namespaceName);
+
+      // Log the action.
+      System.out.println("Deleted Namespace: " + namespaceName.toString());
+    }
+  }
+}
+// [END servicedirectory_delete_namespace]