samples: import quickstart samples from java-docs-samples (#60)

* samples: import samples from java-docs-samples * fix lint * skip dependency check for samples * hide samples module in an explicit profile * fix profile name, run sample tests if samples directory exists * fix parent project for install-without-bom * restore kokoro build file
googleapis · Feb 13, 2020 · 472f89d · 472f89d
1 parent 4e834a9
commit 472f89d
Show file tree

Hide file tree

Showing 9 changed files with 526 additions and 2 deletions.
diff --git a/google-cloud-monitoring-bom/pom.xml b/google-cloud-monitoring-bom/pom.xml
@@ -11,7 +11,7 @@
     <version>0.4.0</version>
   </parent>
 
-  <name>Google Cloud monitoring BOM</name>
+  <name>Google Cloud Monitoring BOM</name>
   <url>https://github.com/googleapis/java-monitoring</url>
   <description>
     BOM for Google Cloud Monitoring

diff --git a/pom.xml b/pom.xml
@@ -181,7 +181,7 @@
     <module>proto-google-cloud-monitoring-v3</module>
     <module>grpc-google-cloud-monitoring-v3</module>
     <module>google-cloud-monitoring</module>
-  <module>google-cloud-monitoring-bom</module>
+    <module>google-cloud-monitoring-bom</module>
   </modules>
 
   <reporting>
@@ -253,4 +253,13 @@
       </plugin>
     </plugins>
   </reporting>
+
+  <profiles>
+    <profile>
+      <id>enable-samples</id>
+      <modules>
+        <module>samples</module>
+      </modules>
+    </profile>
+  </profiles>
 </project>
diff --git a/samples/install-with-bom/pom.xml b/samples/install-with-bom/pom.xml
@@ -0,0 +1,46 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<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>monitoring-install-with-bom</artifactId>
+  <packaging>jar</packaging>
+  <name>Google Cloud Monitoring Install With BOM Sample</name>
+  <url>https://github.com/googleapis/java-monitoring</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</groupId>
+    <artifactId>google-cloud-monitoring-samples</artifactId>
+    <version>0.0.1-SNAPSHOT</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 monitoring_install_with_bom] -->
+  <dependencyManagement>
+    <dependencies>
+      <dependency>
+        <groupId>com.google.cloud</groupId>
+        <artifactId>libraries-bom</artifactId>
+        <version>3.5.0</version>
+        <type>pom</type>
+        <scope>import</scope>
+      </dependency>
+    </dependencies>
+  </dependencyManagement>
+
+  <dependencies>
+    <dependency>
+      <groupId>com.google.cloud</groupId>
+      <artifactId>google-cloud-monitoring</artifactId>
+    </dependency>
+  </dependencies>
+  <!-- [END monitoring_install_with_bom] -->
+</project>
diff --git a/samples/install-with-bom/src/main/java/com/example/monitoring/QuickstartSample.java b/samples/install-with-bom/src/main/java/com/example/monitoring/QuickstartSample.java
@@ -0,0 +1,106 @@
+/*
+ * 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.monitoring;
+
+// CHECKSTYLE OFF: VariableDeclarationUsageDistance
+// [START monitoring_quickstart]
+
+import com.google.api.Metric;
+import com.google.api.MonitoredResource;
+import com.google.cloud.monitoring.v3.MetricServiceClient;
+import com.google.monitoring.v3.CreateTimeSeriesRequest;
+import com.google.monitoring.v3.Point;
+import com.google.monitoring.v3.ProjectName;
+import com.google.monitoring.v3.TimeInterval;
+import com.google.monitoring.v3.TimeSeries;
+import com.google.monitoring.v3.TypedValue;
+import com.google.protobuf.util.Timestamps;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+// Imports the Google Cloud client library
+
+public class QuickstartSample {
+
+  public static void main(String... args) throws Exception {
+    // Your Google Cloud Platform project ID
+    String projectId = System.getProperty("projectId");
+
+    if (projectId == null) {
+      System.err.println("Usage: QuickstartSample -DprojectId=YOUR_PROJECT_ID");
+      return;
+    }
+
+    // Instantiates a client
+    MetricServiceClient metricServiceClient = MetricServiceClient.create();
+
+    // Prepares an individual data point
+    TimeInterval interval =
+        TimeInterval.newBuilder()
+            .setEndTime(Timestamps.fromMillis(System.currentTimeMillis()))
+            .build();
+    TypedValue value = TypedValue.newBuilder().setDoubleValue(123.45).build();
+    Point point = Point.newBuilder().setInterval(interval).setValue(value).build();
+
+    List<Point> pointList = new ArrayList<>();
+    pointList.add(point);
+
+    ProjectName name = ProjectName.of(projectId);
+
+    // Prepares the metric descriptor
+    Map<String, String> metricLabels = new HashMap<String, String>();
+    metricLabels.put("store_id", "Pittsburg");
+    Metric metric =
+        Metric.newBuilder()
+            .setType("custom.googleapis.com/stores/daily_sales")
+            .putAllLabels(metricLabels)
+            .build();
+
+    // Prepares the monitored resource descriptor
+    Map<String, String> resourceLabels = new HashMap<String, String>();
+    resourceLabels.put("project_id", projectId);
+    MonitoredResource resource =
+        MonitoredResource.newBuilder().setType("global").putAllLabels(resourceLabels).build();
+
+    // Prepares the time series request
+    TimeSeries timeSeries =
+        TimeSeries.newBuilder()
+            .setMetric(metric)
+            .setResource(resource)
+            .addAllPoints(pointList)
+            .build();
+    List<TimeSeries> timeSeriesList = new ArrayList<>();
+    timeSeriesList.add(timeSeries);
+
+    CreateTimeSeriesRequest request =
+        CreateTimeSeriesRequest.newBuilder()
+            .setName(name.toString())
+            .addAllTimeSeries(timeSeriesList)
+            .build();
+
+    // Writes time series data
+    metricServiceClient.createTimeSeries(request);
+
+    System.out.printf("Done writing time series data.%n");
+
+    metricServiceClient.close();
+  }
+}
+// [END monitoring_quickstart]
+// CHECKSTYLE ON: VariableDeclarationUsageDistance
diff --git a/samples/install-with-bom/src/test/java/com/example/monitoring/QuickstartSampleIT.java b/samples/install-with-bom/src/test/java/com/example/monitoring/QuickstartSampleIT.java
@@ -0,0 +1,69 @@
+/*
+ * 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.monitoring;
+
+import static com.google.common.truth.Truth.assertThat;
+
+import java.io.ByteArrayOutputStream;
+import java.io.PrintStream;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.JUnit4;
+
+/** Tests for quickstart sample. */
+@RunWith(JUnit4.class)
+@SuppressWarnings("checkstyle:abbreviationaswordinname")
+public class QuickstartSampleIT {
+  private ByteArrayOutputStream bout;
+  private PrintStream out;
+  private static final String LEGACY_PROJECT_ENV_NAME = "GCLOUD_PROJECT";
+  private static final String PROJECT_ENV_NAME = "GOOGLE_CLOUD_PROJECT";
+
+  private static String getProjectId() {
+    String projectId = System.getProperty(PROJECT_ENV_NAME, System.getenv(PROJECT_ENV_NAME));
+    if (projectId == null) {
+      projectId =
+          System.getProperty(LEGACY_PROJECT_ENV_NAME, System.getenv(LEGACY_PROJECT_ENV_NAME));
+    }
+    return projectId;
+  }
+
+  @Before
+  public void setUp() {
+    bout = new ByteArrayOutputStream();
+    out = new PrintStream(bout);
+    System.setOut(out);
+  }
+
+  @After
+  public void tearDown() {
+    System.setOut(null);
+  }
+
+  @Test
+  public void testQuickstart() throws Exception {
+    // Act
+    System.setProperty("projectId", QuickstartSampleIT.getProjectId());
+    QuickstartSample.main();
+
+    // Assert
+    String got = bout.toString();
+    assertThat(got).contains("Done writing time series data.");
+  }
+}
diff --git a/samples/install-without-bom/pom.xml b/samples/install-without-bom/pom.xml
@@ -0,0 +1,38 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<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>monitoring-install-without-bom</artifactId>
+  <packaging>jar</packaging>
+  <name>Google Cloud Monitoring Install Without BOM Sample</name>
+  <url>https://github.com/googleapis/java-monitoring</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</groupId>
+    <artifactId>google-cloud-monitoring-samples</artifactId>
+    <version>0.0.1-SNAPSHOT</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>
+
+  <!-- {x-version-update-start:google-cloud-monitoring:released} -->
+  <dependencies>
+    <!-- [START monitoring_install_without_bom] -->
+    <dependency>
+      <groupId>com.google.cloud</groupId>
+      <artifactId>google-cloud-monitoring</artifactId>
+      <version>1.99.2</version>
+    </dependency>
+    <!-- [END monitoring_install_without_bom] -->
+  </dependencies>
+  <!-- {x-version-update-end} -->
+
+</project>