");
+ }
+}
diff --git a/appengine-java21/ee8/bigquery/src/main/java/com/example/appengine/bigquerylogging/BigQueryRun.java b/appengine-java21/ee8/bigquery/src/main/java/com/example/appengine/bigquerylogging/BigQueryRun.java
new file mode 100644
index 00000000000..fa83033229e
--- /dev/null
+++ b/appengine-java21/ee8/bigquery/src/main/java/com/example/appengine/bigquerylogging/BigQueryRun.java
@@ -0,0 +1,44 @@
+/*
+ * Copyright 2018 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.appengine.bigquerylogging;
+
+import java.io.IOException;
+import javax.servlet.annotation.WebServlet;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+@WebServlet(name = "runQuery BigQuery", value = "/bigquery/run")
+public class BigQueryRun extends HttpServlet {
+ private BigQueryRunner queryRunner;
+
+ public BigQueryRun() throws IOException {
+ this.queryRunner = BigQueryRunner.getInstance();
+ }
+
+ @Override
+ public void doPost(HttpServletRequest req, HttpServletResponse resp) throws IOException {
+ try {
+ queryRunner.runQuery();
+ } catch (InterruptedException e) {
+ resp.sendError(
+ HttpServletResponse.SC_INTERNAL_SERVER_ERROR, "Interrupted while running BigQuery job.");
+ }
+ // redirect to home page
+ resp.sendRedirect("/");
+ }
+}
diff --git a/appengine-java21/ee8/bigquery/src/main/java/com/example/appengine/bigquerylogging/BigQueryRunner.java b/appengine-java21/ee8/bigquery/src/main/java/com/example/appengine/bigquerylogging/BigQueryRunner.java
new file mode 100644
index 00000000000..0e4702e12ae
--- /dev/null
+++ b/appengine-java21/ee8/bigquery/src/main/java/com/example/appengine/bigquerylogging/BigQueryRunner.java
@@ -0,0 +1,255 @@
+/*
+ * Copyright 2018 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.appengine.bigquerylogging;
+
+import com.google.api.Metric;
+import com.google.api.MetricDescriptor;
+import com.google.cloud.ServiceOptions;
+import com.google.cloud.bigquery.BigQuery;
+import com.google.cloud.bigquery.BigQueryOptions;
+import com.google.cloud.bigquery.Job;
+import com.google.cloud.bigquery.JobId;
+import com.google.cloud.bigquery.JobInfo;
+import com.google.cloud.bigquery.QueryJobConfiguration;
+import com.google.cloud.bigquery.TableResult;
+import com.google.cloud.monitoring.v3.MetricServiceClient;
+import com.google.cloud.monitoring.v3.MetricServiceClient.ListMetricDescriptorsPagedResponse;
+import com.google.cloud.monitoring.v3.MetricServiceClient.ListTimeSeriesPagedResponse;
+import com.google.common.collect.ImmutableSet;
+import com.google.common.collect.Lists;
+import com.google.common.collect.Sets;
+import com.google.monitoring.v3.CreateMetricDescriptorRequest;
+import com.google.monitoring.v3.CreateTimeSeriesRequest;
+import com.google.monitoring.v3.ListMetricDescriptorsRequest;
+import com.google.monitoring.v3.ListTimeSeriesRequest;
+import com.google.monitoring.v3.Point;
+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.io.IOException;
+import java.io.PrintStream;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Set;
+import java.util.UUID;
+import java.util.stream.Collectors;
+
+public class BigQueryRunner {
+ private static final String CUSTOM_METRIC_FILTER =
+ "metric.type = starts_with(\"custom.googleapis.com/\")";
+ private static BigQueryRunner instance;
+
+ private static final MetricDescriptor QUERY_DURATION_METRIC =
+ MetricDescriptor.newBuilder()
+ .setName("custom.googleapis.com/queryDuration")
+ .setType("custom.googleapis.com/queryDuration")
+ .setDisplayName("queryDuration")
+ .setDescription("Time it took a query to run.")
+ .setMetricKind(MetricDescriptor.MetricKind.GAUGE)
+ .setValueType(MetricDescriptor.ValueType.INT64)
+ .build();
+ private static final MetricDescriptor ROWS_RETURNED_METRIC =
+ MetricDescriptor.newBuilder()
+ .setName("custom.googleapis.com/rowsReturned")
+ .setType("custom.googleapis.com/rowsReturned")
+ .setDisplayName("rowsReturned")
+ .setDescription("Total rows returned by the query result.")
+ .setMetricKind(MetricDescriptor.MetricKind.GAUGE)
+ .setValueType(MetricDescriptor.ValueType.INT64)
+ .build();
+ private static final Set REQUIRED_METRICS =
+ ImmutableSet.of(QUERY_DURATION_METRIC, ROWS_RETURNED_METRIC);
+
+ private static TableResult mostRecentRunResult;
+ private static Set existingMetrics = Sets.newHashSet();
+
+ private final MetricServiceClient client;
+ private final BigQuery bigquery;
+ private final String projectName;
+ private PrintStream os;
+
+ // Retrieve a singleton instance
+ public static synchronized BigQueryRunner getInstance() throws IOException {
+ if (instance == null) {
+ instance = new BigQueryRunner();
+ }
+ return instance;
+ }
+
+ private BigQueryRunner() throws IOException {
+ this(
+ MetricServiceClient.create(),
+ BigQueryOptions.getDefaultInstance().getService(),
+ System.out);
+ }
+
+ BigQueryRunner(MetricServiceClient metricsClient, BigQuery bigquery, PrintStream os) {
+ client = metricsClient;
+ this.os = os;
+ this.projectName = String.format("projects/%s", ServiceOptions.getDefaultProjectId());
+ this.bigquery = bigquery;
+ }
+
+ public static TableResult getMostRecentRunResult() {
+ return mostRecentRunResult;
+ }
+
+ public void runQuery() throws InterruptedException {
+ QueryJobConfiguration queryConfig =
+ QueryJobConfiguration.newBuilder(
+ "SELECT "
+ + "CONCAT('https://stackoverflow.com/questions/', CAST(id as STRING)) as url, "
+ + "view_count "
+ + "FROM `bigquery-public-data.stackoverflow.posts_questions` "
+ + "WHERE tags like '%google-bigquery%' "
+ + "ORDER BY favorite_count DESC LIMIT 10")
+ // Use standard SQL syntax for queries.
+ // See: https://cloud.google.com/bigquery/sql-reference/
+ .setUseLegacySql(false)
+ .build();
+
+ List timeSeriesList = new ArrayList<>();
+
+ long queryStartTime = System.currentTimeMillis();
+
+ // Create a job ID so that we can safely retry.
+ JobId jobId = JobId.of(UUID.randomUUID().toString());
+ Job queryJob = bigquery.create(JobInfo.newBuilder(queryConfig).setJobId(jobId).build());
+
+ // Wait for the query to complete.
+ queryJob = queryJob.waitFor();
+
+ // Check for errors
+ if (queryJob == null) {
+ throw new RuntimeException("Job no longer exists");
+ } else if (queryJob.getStatus().getError() != null) {
+ // You can also look at queryJob.getStatus().getExecutionErrors() for all
+ // errors, not just the latest one.
+ throw new RuntimeException(queryJob.getStatus().getError().toString());
+ }
+
+ // Log the result metrics.
+ TableResult result = queryJob.getQueryResults();
+
+ long queryEndTime = System.currentTimeMillis();
+ // Add query duration metric.
+ timeSeriesList.add(prepareMetric(QUERY_DURATION_METRIC, queryEndTime - queryStartTime));
+
+ // Add rows returned metric.
+ timeSeriesList.add(prepareMetric(ROWS_RETURNED_METRIC, result.getTotalRows()));
+
+ // Prepares the time series request
+ CreateTimeSeriesRequest request =
+ CreateTimeSeriesRequest.newBuilder()
+ .setName(projectName)
+ .addAllTimeSeries(timeSeriesList)
+ .build();
+
+ createMetricsIfNeeded();
+ client.createTimeSeries(request);
+ os.println("Done writing metrics.");
+
+ mostRecentRunResult = result;
+ }
+
+ // Returns a metric time series with a single int64 data point.
+ private TimeSeries prepareMetric(MetricDescriptor requiredMetric, long metricValue) {
+ TimeInterval interval =
+ TimeInterval.newBuilder()
+ .setEndTime(Timestamps.fromMillis(System.currentTimeMillis()))
+ .build();
+ TypedValue value = TypedValue.newBuilder().setInt64Value(metricValue).build();
+
+ Point point = Point.newBuilder().setInterval(interval).setValue(value).build();
+
+ List pointList = Lists.newArrayList();
+ pointList.add(point);
+
+ Metric metric = Metric.newBuilder().setType(requiredMetric.getName()).build();
+
+ return TimeSeries.newBuilder().setMetric(metric).addAllPoints(pointList).build();
+ }
+
+ public List> getTimeSeriesValues() {
+ List> summaries = Lists.newArrayList();
+ createMetricsIfNeeded();
+ for (MetricDescriptor metric : REQUIRED_METRICS) {
+ ListTimeSeriesRequest listTimeSeriesRequest =
+ ListTimeSeriesRequest.newBuilder()
+ .setName(projectName)
+ .setFilter(String.format("metric.type = \"%s\"", metric.getType()))
+ .setInterval(
+ TimeInterval.newBuilder()
+ .setStartTime(
+ Timestamps.subtract(
+ Timestamps.fromMillis(System.currentTimeMillis()),
+ com.google.protobuf.Duration.newBuilder()
+ .setSeconds(60L * 60L * 24L * 30L) // 30 days ago
+ .build()))
+ .setEndTime(Timestamps.fromMillis(System.currentTimeMillis()))
+ .build())
+ .build();
+ try {
+ ListTimeSeriesPagedResponse listTimeSeriesResponse =
+ client.listTimeSeries(listTimeSeriesRequest);
+ ArrayList timeSeries = Lists.newArrayList(listTimeSeriesResponse.iterateAll());
+ summaries.addAll(
+ timeSeries.stream()
+ .map(TimeSeriesSummary::fromTimeSeries)
+ .collect(Collectors.toList()));
+ } catch (RuntimeException ex) {
+ os.println("MetricDescriptors not yet synced. Please try again in a moment.");
+ }
+ }
+ return summaries;
+ }
+
+ private void createMetricsIfNeeded() {
+ // If all required metrics already exist, no need to make service calls.
+ if (REQUIRED_METRICS.stream()
+ .map(MetricDescriptor::getDisplayName)
+ .allMatch(existingMetrics::contains)) {
+ return;
+ }
+ ListMetricDescriptorsRequest listMetricsRequest =
+ ListMetricDescriptorsRequest.newBuilder()
+ .setName(projectName)
+ .setFilter(CUSTOM_METRIC_FILTER)
+ .build();
+ ListMetricDescriptorsPagedResponse listMetricsResponse =
+ client.listMetricDescriptors(listMetricsRequest);
+
+ for (MetricDescriptor existingMetric : listMetricsResponse.iterateAll()) {
+ existingMetrics.add(existingMetric.getDisplayName());
+ }
+
+ REQUIRED_METRICS.stream()
+ .filter(metric -> !existingMetrics.contains(metric.getDisplayName()))
+ .forEach(this::createMetric);
+ }
+
+ private void createMetric(MetricDescriptor newMetric) {
+ CreateMetricDescriptorRequest request =
+ CreateMetricDescriptorRequest.newBuilder()
+ .setName(projectName)
+ .setMetricDescriptor(newMetric)
+ .build();
+
+ client.createMetricDescriptor(request);
+ }
+}
diff --git a/appengine-java21/ee8/bigquery/src/main/java/com/example/appengine/bigquerylogging/TimeSeriesSummary.java b/appengine-java21/ee8/bigquery/src/main/java/com/example/appengine/bigquerylogging/TimeSeriesSummary.java
new file mode 100644
index 00000000000..04e2e23e543
--- /dev/null
+++ b/appengine-java21/ee8/bigquery/src/main/java/com/example/appengine/bigquerylogging/TimeSeriesSummary.java
@@ -0,0 +1,116 @@
+/*
+ * Copyright 2018 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.appengine.bigquerylogging;
+
+import com.google.common.collect.Collections2;
+import com.google.common.collect.Lists;
+import com.google.monitoring.v3.Point;
+import com.google.monitoring.v3.TimeSeries;
+import com.google.protobuf.Timestamp;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.List;
+import java.util.stream.Collectors;
+
+public abstract class TimeSeriesSummary {
+ private String name;
+ private Timestamp mostRecentRunTime;
+ T mostRecentValue;
+ List values;
+
+ public static TimeSeriesSummary fromTimeSeries(TimeSeries timeSeries) {
+ switch (timeSeries.getValueType()) {
+ case STRING:
+ return new StringTimeSeriesSummary(timeSeries);
+ case INT64:
+ return new Int64TimeSeriesSummary(timeSeries);
+ default:
+ return null;
+ }
+ }
+
+ private TimeSeriesSummary(TimeSeries timeSeries) {
+ name = timeSeries.getMetric().getType();
+ }
+
+ Point getMostRecentPoint(TimeSeries timeSeries) {
+ Point max =
+ Collections.max(
+ timeSeries.getPointsList(),
+ Comparator.comparingLong(p -> p.getInterval().getEndTime().getSeconds()));
+ mostRecentRunTime = max.getInterval().getEndTime();
+ return max;
+ }
+
+ public String getName() {
+ return name;
+ }
+
+ public T getMostRecentValue() {
+ return mostRecentValue;
+ }
+
+ public Timestamp getMostRecentRunTime() {
+ return mostRecentRunTime;
+ }
+
+ public List getValues() {
+ return values;
+ }
+
+ public abstract T getAverage();
+
+ public static class StringTimeSeriesSummary extends TimeSeriesSummary {
+ private StringTimeSeriesSummary(TimeSeries timeSeries) {
+ super(timeSeries);
+ Point max = getMostRecentPoint(timeSeries);
+ if (max == null) {
+ return;
+ }
+ mostRecentValue = max.getValue().getStringValue();
+ values =
+ Lists.newArrayList(
+ Collections2.transform(
+ timeSeries.getPointsList(), point -> point.getValue().getStringValue()));
+ }
+
+ @Override
+ public String getAverage() {
+ return values.stream().collect(Collectors.joining(","));
+ }
+ }
+
+ public static class Int64TimeSeriesSummary extends TimeSeriesSummary {
+ private Int64TimeSeriesSummary(TimeSeries timeSeries) {
+ super(timeSeries);
+ Point max = getMostRecentPoint(timeSeries);
+ if (max == null) {
+ return;
+ }
+ mostRecentValue = max.getValue().getInt64Value();
+ values =
+ Lists.newArrayList(
+ Collections2.transform(
+ timeSeries.getPointsList(), point -> point.getValue().getInt64Value()));
+ }
+
+ @Override
+ public Long getAverage() {
+ return values.stream().collect(Collectors.averagingLong(Long::longValue)).longValue();
+ }
+ }
+}
diff --git a/appengine-java21/ee8/bigquery/src/main/webapp/WEB-INF/appengine-web.xml b/appengine-java21/ee8/bigquery/src/main/webapp/WEB-INF/appengine-web.xml
new file mode 100644
index 00000000000..15fc6f754c4
--- /dev/null
+++ b/appengine-java21/ee8/bigquery/src/main/webapp/WEB-INF/appengine-web.xml
@@ -0,0 +1,10 @@
+
+
+ java21
+ true
+
+
+
+
+ dzlier-work
+
\ No newline at end of file
diff --git a/appengine-java21/ee8/bigquery/src/main/webapp/index.jsp b/appengine-java21/ee8/bigquery/src/main/webapp/index.jsp
new file mode 100644
index 00000000000..af045fbf1fc
--- /dev/null
+++ b/appengine-java21/ee8/bigquery/src/main/webapp/index.jsp
@@ -0,0 +1,30 @@
+<%@ page import="com.example.appengine.bigquerylogging.BigQueryHome" %>
+
+
+ An example of using BigQuery and StackDriver Logging on AppEngine Standard
+
+
Run query
+
+
Most Recent Run Results
+
+
+
URL
+
View Count
+
+ <%= BigQueryHome.getMostRecentRun() %>
+
+
Run Metric Values
+
+
+
Metric Type
+
Count
+
Most Recent End Time
+
Most Recent Value
+
Average/Values
+
+ <%= BigQueryHome.getMetricAverages() %>
+
+
+
diff --git a/appengine-java21/ee8/bigquery/src/test/java/com/example/appengine/bigquerylogging/BigQueryRunnerTest.java b/appengine-java21/ee8/bigquery/src/test/java/com/example/appengine/bigquerylogging/BigQueryRunnerTest.java
new file mode 100644
index 00000000000..1332c3afa05
--- /dev/null
+++ b/appengine-java21/ee8/bigquery/src/test/java/com/example/appengine/bigquerylogging/BigQueryRunnerTest.java
@@ -0,0 +1,107 @@
+/*
+ * Copyright 2018 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.appengine.bigquerylogging;
+
+import static com.google.common.truth.Truth.assertThat;
+import static org.junit.Assert.assertEquals;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+import com.google.api.MetricDescriptor;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.cloud.bigquery.BigQueryOptions;
+import com.google.cloud.monitoring.v3.MetricServiceClient;
+import com.google.cloud.monitoring.v3.MetricServiceClient.ListMetricDescriptorsPagedResponse;
+import com.google.cloud.monitoring.v3.stub.MetricServiceStub;
+import com.google.monitoring.v3.CreateMetricDescriptorRequest;
+import com.google.monitoring.v3.CreateTimeSeriesRequest;
+import com.google.monitoring.v3.ListMetricDescriptorsRequest;
+import com.google.protobuf.Empty;
+import java.io.ByteArrayOutputStream;
+import java.io.PrintStream;
+import java.util.Collections;
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.JUnit4;
+import org.mockito.ArgumentCaptor;
+import org.mockito.Captor;
+import org.mockito.Mock;
+import org.mockito.MockitoAnnotations;
+
+/** Tests for simple app sample. */
+@RunWith(JUnit4.class)
+public class BigQueryRunnerTest {
+ private ByteArrayOutputStream bout;
+ private BigQueryRunner app;
+
+ @Mock private MetricServiceStub metricsServiceStub;
+
+ @Mock
+ private UnaryCallable
+ listCallable;
+
+ @Mock private UnaryCallable createMetricCallable;
+ @Mock private UnaryCallable createTimeSeriesCallable;
+ @Mock private ListMetricDescriptorsPagedResponse listResponse;
+
+ @Captor private ArgumentCaptor createTimeSeriesRequest;
+
+ @Before
+ public void setUp() {
+ MockitoAnnotations.openMocks(this);
+ bout = new ByteArrayOutputStream();
+ PrintStream out = new PrintStream(bout);
+
+ MetricServiceClient metricsClient = MetricServiceClient.create(metricsServiceStub);
+ app = new BigQueryRunner(metricsClient, BigQueryOptions.getDefaultInstance().getService(), out);
+
+ when(metricsServiceStub.listMetricDescriptorsPagedCallable()).thenReturn(listCallable);
+ when(listCallable.call(any(ListMetricDescriptorsRequest.class))).thenReturn(listResponse);
+ when(listResponse.iterateAll()).thenReturn(Collections.emptyList());
+
+ when(metricsServiceStub.createMetricDescriptorCallable()).thenReturn(createMetricCallable);
+ when(createMetricCallable.call(any(CreateMetricDescriptorRequest.class))).thenReturn(null);
+
+ when(metricsServiceStub.createTimeSeriesCallable()).thenReturn(createTimeSeriesCallable);
+ when(createTimeSeriesCallable.call(any(CreateTimeSeriesRequest.class)))
+ .thenReturn(Empty.getDefaultInstance());
+ }
+
+ @Test
+ public void testRun() throws Exception {
+ app.runQuery();
+ String got = bout.toString();
+ assertThat(got).contains("Done writing metrics.");
+ verify(metricsServiceStub).listMetricDescriptorsPagedCallable();
+
+ verify(metricsServiceStub, times(2)).createMetricDescriptorCallable();
+
+ verify(metricsServiceStub).createTimeSeriesCallable();
+ verify(createTimeSeriesCallable).call(createTimeSeriesRequest.capture());
+ CreateTimeSeriesRequest actual = createTimeSeriesRequest.getValue();
+ assertEquals(2, actual.getTimeSeriesCount());
+ assertThat(actual.getTimeSeries(0).getMetric().getType())
+ .isEqualTo("custom.googleapis.com/queryDuration");
+ assertThat(actual.getTimeSeries(0).getPoints(0).getValue().getInt64Value()).isGreaterThan(0L);
+ assertThat(actual.getTimeSeries(1).getMetric().getType())
+ .isEqualTo("custom.googleapis.com/rowsReturned");
+ assertThat(actual.getTimeSeries(1).getPoints(0).getValue().getInt64Value()).isGreaterThan(0L);
+ }
+}
diff --git a/appengine-java21/ee8/bigtable/README.md b/appengine-java21/ee8/bigtable/README.md
new file mode 100644
index 00000000000..c4df5547773
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/README.md
@@ -0,0 +1,59 @@
+Bigtable-hello-j21
+=================
+
+
+
+
+Moves the Bigtable Hello World application to Google App Engine Standard for Java 21.
+
+
+* [Java 21](http://www.oracle.com/technetwork/java/javase/downloads/index.html)
+* [Maven](https://maven.apache.org/download.cgi) (at least 3.3.9)
+* [Gradle](https://gradle.org)
+* [Google Cloud CLI](https://cloud.google.com/cli/) (aka gcloud)
+
+Initialize the Google Cloud CLI using:
+
+ gcloud init
+
+ gcloud auth application-default login
+
+Then you need to [Create a Cloud Bigtable Instance](https://cloud.google.com/bigtable/docs/creating-instance)
+
+
+## Using Maven
+
+### Run Locally
+
+ mvn -Dbigtable.projectID=PROJECTID -Dbigtable.instanceID=INSTANCEID appengine:run
+
+### Deploy to App Engine Standard for Java 21
+
+ mvn -Dbigtable.projectID=PROJECTID -Dbigtable.instanceID=INSTANCEID package appengine:deploy
+
+### Run Integration Tests
+
+ mvn -Dbigtable.projectID=PROJECTID -Dbigtable.instanceID=INSTANCEID verify
+
+## Using Gradle
+
+### Run Locally
+
+ gradle -Dbigtable.projectID=PROJECTID -Dbigtable.instanceID=INSTANCEID appengineRun
+
+### Integration Tests & Deploy to App Engine Standard for Java 21
+
+ gradle -Dbigtable.projectID=PROJECTID -Dbigtable.instanceID=INSTANCEID appengineDeploy
+
+As you add / modify the source code (`src/main/java/...`) it's very useful to add
+[unit testing](https://cloud.google.com/appengine/docs/java/tools/localunittesting)
+to (`src/main/test/...`). The following resources are quite useful:
+
+* [JUnit4](http://junit.org/junit4/)
+* [Mockito](http://mockito.org/)
+* [Truth](http://google.github.io/truth/)
+
+### When done
+
+Cloud Bigtable Instances should be [deleted](https://cloud.google.com/bigtable/docs/deleting-instance)
+when they are no longer being used as they use significant resources.
diff --git a/appengine-java21/ee8/bigtable/build.gradle b/appengine-java21/ee8/bigtable/build.gradle
new file mode 100644
index 00000000000..999819d2758
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/build.gradle
@@ -0,0 +1,113 @@
+// Copyright 2017 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.
+// [START gae_java21_bigtable_gradle_file]
+buildscript { // Configuration for building
+ repositories {
+ jcenter() // Bintray's repository - a fast Maven Central mirror & more
+ mavenCentral()
+ }
+ dependencies {
+ classpath 'com.google.cloud.tools:appengine-gradle-plugin:2.5.0'
+ classpath 'org.akhikhl.gretty:gretty:+'
+ }
+}
+
+apply plugin: 'java'
+apply plugin: 'war'
+apply plugin: 'org.akhikhl.gretty' // To get webappcopy
+apply plugin: 'com.google.cloud.tools.appengine'
+
+group = 'com.example.google.cloud.bigtable'
+version = '0.1-SNAPSHOT'
+
+sourceCompatibility = 21
+targetCompatibility = 21
+
+tasks.withType(JavaCompile) {
+ options.encoding = 'UTF-8'
+}
+
+repositories {
+ maven { url "https://oss.sonatype.org/content/repositories/snapshots" }
+ jcenter()
+ mavenCentral()
+}
+
+dependencies {
+ compile group: 'com.google.cloud.bigtable', name: 'bigtable-hbase-1.2', version:'1.0.0-pre3'
+ compile group: 'org.apache.hbase', name: 'hbase-client', version:'2.5.6'
+ compile group: 'io.netty', name: 'netty-tcnative-boringssl-static', version:'2.0.62.Final'
+ compile group: 'jakarta.servlet.jsp.jstl', name: 'jakarta.servlet.jsp.jstl-api', version:'1.2.7'
+
+ providedCompile group: 'jakarta.servlet', name: 'jakarta.servlet-api', version:'4.0.4'
+
+ testCompile group: 'com.google.truth', name: 'truth', version:'1.4.4'
+ testCompile group: 'junit', name: 'junit', version:'4.13.2'
+ testCompile group: 'org.mockito', name: 'mockito-core', version:'4.11.0'
+}
+
+import org.apache.tools.ant.filters.ReplaceTokens
+gretty {
+ contextPath = '/'
+ servletContainer = 'jetty9'
+
+ jvmArgs = [ '-DBIGTABLE_PROJECT=' + System.getProperty("bigtable.projectID"),
+ '-DBIGTABLE_INSTANCE=' + System.getProperty("bigtable.instanceID")]
+
+ webappCopy {
+ // Enable filtering on all xml files in WEB-INF
+ filesMatching "**/WEB-INF/*.xml", { FileCopyDetails fileDetails ->
+ logger.lifecycle 'File filtered: {}', fileDetails.path
+ filter (ReplaceTokens, tokens: [
+ 'bigtable.projectID' : System.getProperty("bigtable.projectID"),
+ 'bigtable.instanceID': System.getProperty("bigtable.instanceID")
+ ])
+ }
+ }
+}
+
+// Always run unit tests
+appengineDeploy.dependsOn test
+
+// [START gae_java21_bigtable_gradle_model]
+appengine {
+ run {
+
+ }
+ deploy { // deploy configuration
+ stopPreviousVersion = true // default - stop the current version
+ promote = true // default - & make this the current version
+ }
+}
+
+test {
+ useJUnit()
+ testLogging.showStandardStreams = true
+
+ systemProperty 'BIGTABLE_PROJECT', System.getProperty("bigtable.projectID")
+ systemProperty 'BIGTABLE_INSTANCE',System.getProperty("bigtable.instanceID")
+
+ beforeTest { descriptor ->
+ logger.lifecycle("test: " + descriptor + " Running")
+ }
+
+ onOutput { descriptor, event ->
+ logger.lifecycle("test: " + descriptor + ": " + event.message )
+ }
+ afterTest { descriptor, result ->
+ logger.lifecycle("test: " + descriptor + ": " + result )
+ }
+}
+// [END gae_java21_bigtable_gradle_model]
+// [END gae_java21_bigtable_gradle_file]
diff --git a/appengine-java21/ee8/bigtable/gradle/wrapper/gradle-wrapper.properties b/appengine-java21/ee8/bigtable/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 00000000000..6e82a0b51fb
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,6 @@
+#Mon Apr 03 21:11:48 PDT 2017
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
diff --git a/appengine-java21/ee8/bigtable/gradlew b/appengine-java21/ee8/bigtable/gradlew
new file mode 100755
index 00000000000..4453ccea33d
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/gradlew
@@ -0,0 +1,172 @@
+#!/usr/bin/env sh
+
+##############################################################################
+##
+## Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+ ls=`ls -ld "$PRG"`
+ link=`expr "$ls" : '.*-> \(.*\)$'`
+ if expr "$link" : '/.*' > /dev/null; then
+ PRG="$link"
+ else
+ PRG=`dirname "$PRG"`"/$link"
+ fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >/dev/null
+APP_HOME="`pwd -P`"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS=""
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn ( ) {
+ echo "$*"
+}
+
+die ( ) {
+ echo
+ echo "$*"
+ echo
+ exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "`uname`" in
+ CYGWIN* )
+ cygwin=true
+ ;;
+ Darwin* )
+ darwin=true
+ ;;
+ MINGW* )
+ msys=true
+ ;;
+ NONSTOP* )
+ nonstop=true
+ ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+ if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+ # IBM's JDK on AIX uses strange locations for the executables
+ JAVACMD="$JAVA_HOME/jre/sh/java"
+ else
+ JAVACMD="$JAVA_HOME/bin/java"
+ fi
+ if [ ! -x "$JAVACMD" ] ; then
+ die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+else
+ JAVACMD="java"
+ which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
+ MAX_FD_LIMIT=`ulimit -H -n`
+ if [ $? -eq 0 ] ; then
+ if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+ MAX_FD="$MAX_FD_LIMIT"
+ fi
+ ulimit -n $MAX_FD
+ if [ $? -ne 0 ] ; then
+ warn "Could not set maximum file descriptor limit: $MAX_FD"
+ fi
+ else
+ warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+ fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+ GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin, switch paths to Windows format before running java
+if $cygwin ; then
+ APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+ CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+ JAVACMD=`cygpath --unix "$JAVACMD"`
+
+ # We build the pattern for arguments to be converted via cygpath
+ ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+ SEP=""
+ for dir in $ROOTDIRSRAW ; do
+ ROOTDIRS="$ROOTDIRS$SEP$dir"
+ SEP="|"
+ done
+ OURCYGPATTERN="(^($ROOTDIRS))"
+ # Add a user-defined pattern to the cygpath arguments
+ if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+ OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+ fi
+ # Now convert the arguments - kludge to limit ourselves to /bin/sh
+ i=0
+ for arg in "$@" ; do
+ CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+ CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
+
+ if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
+ eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+ else
+ eval `echo args$i`="\"$arg\""
+ fi
+ i=$((i+1))
+ done
+ case $i in
+ (0) set -- ;;
+ (1) set -- "$args0" ;;
+ (2) set -- "$args0" "$args1" ;;
+ (3) set -- "$args0" "$args1" "$args2" ;;
+ (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+ (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+ (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+ (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+ (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+ (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+ esac
+fi
+
+# Escape application args
+save ( ) {
+ for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
+ echo " "
+}
+APP_ARGS=$(save "$@")
+
+# Collect all arguments for the java command, following the shell quoting and substitution rules
+eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+
+# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
+if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then
+ cd "$(dirname "$0")"
+fi
+
+exec "$JAVACMD" "$@"
diff --git a/appengine-java21/ee8/bigtable/gradlew.bat b/appengine-java21/ee8/bigtable/gradlew.bat
new file mode 100644
index 00000000000..e95643d6a2c
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/gradlew.bat
@@ -0,0 +1,84 @@
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS=
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto init
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto init
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:init
+@rem Get command-line arguments, handling Windows variants
+
+if not "%OS%" == "Windows_NT" goto win9xME_args
+
+:win9xME_args
+@rem Slurp the command line arguments.
+set CMD_LINE_ARGS=
+set _SKIP=2
+
+:win9xME_args_slurp
+if "x%~1" == "x" goto execute
+
+set CMD_LINE_ARGS=%*
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega
diff --git a/appengine-java21/ee8/bigtable/pom.xml b/appengine-java21/ee8/bigtable/pom.xml
new file mode 100644
index 00000000000..8a52e798a79
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/pom.xml
@@ -0,0 +1,190 @@
+
+
+
+
+ 4.0.0
+ war
+ 0.1-SNAPSHOT
+
+ com.example.appengine
+ bigtable-hello-j21
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 21
+ 21
+
+ YOUR_PROJECT_ID
+ YOUR_INSTANCE_ID
+ false
+
+
+
+
+ com.google.cloud.bigtable
+
+ bigtable-hbase-1.x-hadoop
+ 2.12.0
+
+
+
+
+ jakarta.servlet
+ jakarta.servlet-api
+ 4.0.4
+ jar
+ provided
+
+
+ jakarta.servlet.jsp.jstl
+ jakarta.servlet.jsp.jstl-api
+ 1.2.7
+
+
+
+
+
+ com.google.truth
+ truth
+ 1.4.4
+ test
+
+
+
+ junit
+ junit
+ 4.13.2
+ test
+
+
+ org.mockito
+ mockito-core
+ 4.11.0
+ test
+
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+
+ org.apache.maven.plugins
+ maven-resources-plugin
+ 3.3.1
+
+ UTF-8
+
+ @
+
+ false
+
+
+
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.4.0
+
+ true
+
+
+
+ ${basedir}/src/main/webapp/WEB-INF
+ true
+ WEB-INF
+
+
+
+
+
+
+ org.jacoco
+ jacoco-maven-plugin
+ 0.8.13
+
+
+
+ org.apache.maven.plugins
+ maven-failsafe-plugin
+ 3.2.2
+
+
+ ${bigtable.projectID}
+ ${bigtable.instanceID}
+
+
+
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ 2.8.0
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+
+
+
+
+ org.apache.maven.plugins
+ maven-compiler-plugin
+ 3.11.0
+
+
+
+ org.apache.maven.plugins
+ maven-clean-plugin
+ 3.3.2
+
+
+
+ org.apache.maven.plugins
+ maven-enforcer-plugin
+ 3.4.1
+
+
+
+ [3.5.0,)
+
+
+
+
+
+
+
+
+
+ snapshots-repo
+ https://oss.sonatype.org/content/repositories/snapshots
+ false
+ true
+
+
+
+
diff --git a/appengine-java21/ee8/bigtable/settings.gradle b/appengine-java21/ee8/bigtable/settings.gradle
new file mode 100644
index 00000000000..f77c416bd3a
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/settings.gradle
@@ -0,0 +1,14 @@
+// Copyright 2017 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.
+rootProject.name = 'bigtable-hello-j21'
diff --git a/appengine-java21/ee8/bigtable/src/main/java/com/example/bigtable/BigtableHelloWorld.java b/appengine-java21/ee8/bigtable/src/main/java/com/example/bigtable/BigtableHelloWorld.java
new file mode 100644
index 00000000000..3d6e07dae5a
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/src/main/java/com/example/bigtable/BigtableHelloWorld.java
@@ -0,0 +1,142 @@
+/*
+ * Copyright 2016 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.bigtable;
+
+// [START gae_java21_bigtable_helloworld]
+
+import java.io.IOException;
+import org.apache.hadoop.hbase.HColumnDescriptor;
+import org.apache.hadoop.hbase.HTableDescriptor;
+import org.apache.hadoop.hbase.TableName;
+import org.apache.hadoop.hbase.client.Admin;
+import org.apache.hadoop.hbase.client.Connection;
+import org.apache.hadoop.hbase.client.Get;
+import org.apache.hadoop.hbase.client.Put;
+import org.apache.hadoop.hbase.client.Result;
+import org.apache.hadoop.hbase.client.ResultScanner;
+import org.apache.hadoop.hbase.client.Scan;
+import org.apache.hadoop.hbase.client.Table;
+import org.apache.hadoop.hbase.util.Bytes;
+
+/**
+ * A minimal application that connects to Cloud Bigtable using the native HBase API and performs
+ * some basic operations.
+ */
+public class BigtableHelloWorld {
+
+ // Refer to table metadata names by byte array in the HBase API
+ private static final byte[] TABLE_NAME = Bytes.toBytes("Hello-Bigtable");
+ private static final byte[] COLUMN_FAMILY_NAME = Bytes.toBytes("cf1");
+ private static final byte[] COLUMN_NAME = Bytes.toBytes("greeting");
+
+ // Write some friendly greetings to Cloud Bigtable
+ private static final String[] GREETINGS = {
+ "Hello World!", "Hello Cloud Bigtable!", "Hello HBase!"
+ };
+
+ /**
+ * Create a table -- first time only.
+ *
+ * @param connection to Bigtable
+ * @return the status
+ */
+ public static String create(Connection connection) {
+ try {
+ // The admin API lets us create, manage and delete tables
+ Admin admin = connection.getAdmin();
+
+ // Create a table with a single column family
+ HTableDescriptor descriptor = new HTableDescriptor(TableName.valueOf(TABLE_NAME));
+ descriptor.addFamily(new HColumnDescriptor(COLUMN_FAMILY_NAME));
+
+ admin.createTable(descriptor);
+ } catch (IOException e) {
+ return "Table exists.";
+ }
+ return "Create table " + Bytes.toString(TABLE_NAME);
+ }
+
+ /** Connects to Cloud Bigtable, runs some basic operations and prints the results. */
+ public static String doHelloWorld() {
+
+ StringBuilder result = new StringBuilder();
+
+ // Create the Bigtable connection, use try-with-resources to make sure it gets closed
+ Connection connection = BigtableHelper.getConnection();
+ result.append(create(connection));
+ result.append("
");
+ try (Table table = connection.getTable(TableName.valueOf(TABLE_NAME))) {
+
+ // Retrieve the table we just created so we can do some reads and writes
+
+ // Write some rows to the table
+ result.append("Write some greetings to the table ");
+ for (int i = 0; i < GREETINGS.length; i++) {
+ // Each row has a unique row key.
+ //
+ // Note: This example uses sequential numeric IDs for simplicity, but
+ // this can result in poor performance in a production application.
+ // Since rows are stored in sorted order by key, sequential keys can
+ // result in poor distribution of operations across nodes.
+ //
+ // For more information about how to design a Bigtable schema for the
+ // best performance, see the documentation:
+ //
+ // https://cloud.google.com/bigtable/docs/schema-design
+ String rowKey = "greeting" + i;
+
+ // Put a single row into the table. We could also pass a list of Puts to write a batch.
+ Put put = new Put(Bytes.toBytes(rowKey));
+ put.addColumn(COLUMN_FAMILY_NAME, COLUMN_NAME, Bytes.toBytes(GREETINGS[i]));
+ table.put(put);
+ }
+
+ // Get the first greeting by row key
+ String rowKey = "greeting0";
+ Result getResult = table.get(new Get(Bytes.toBytes(rowKey)));
+ String greeting = Bytes.toString(getResult.getValue(COLUMN_FAMILY_NAME, COLUMN_NAME));
+ result.append("Get a single greeting by row key ");
+
+ result.append(" ");
+ result.append(rowKey);
+ result.append("= ");
+ result.append(greeting);
+ result.append(" ");
+
+ // Now scan across all rows.
+ Scan scan = new Scan();
+
+ result.append("Scan for all greetings:");
+ ResultScanner scanner = table.getScanner(scan);
+ for (Result row : scanner) {
+ byte[] valueBytes = row.getValue(COLUMN_FAMILY_NAME, COLUMN_NAME);
+ result.append(" ");
+ result.append(Bytes.toString(valueBytes));
+ result.append(" ");
+ }
+
+ } catch (IOException e) {
+ result.append("Exception while running HelloWorld: " + e.getMessage() + " ");
+ result.append(e.toString());
+ return result.toString();
+ }
+
+ return result.toString();
+ }
+}
+// [END gae_java21_bigtable_helloworld]
diff --git a/appengine-java21/ee8/bigtable/src/main/java/com/example/bigtable/BigtableHelper.java b/appengine-java21/ee8/bigtable/src/main/java/com/example/bigtable/BigtableHelper.java
new file mode 100644
index 00000000000..dfcbd1e6352
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/src/main/java/com/example/bigtable/BigtableHelper.java
@@ -0,0 +1,142 @@
+/*
+ * Copyright 2016 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.bigtable;
+
+import com.google.cloud.bigtable.hbase.BigtableConfiguration;
+import java.io.IOException;
+import javax.servlet.ServletContext;
+import javax.servlet.ServletContextEvent;
+import javax.servlet.ServletContextListener;
+import javax.servlet.annotation.WebListener;
+import org.apache.hadoop.hbase.client.Connection;
+
+/**
+ * BigtableHelper, a ServletContextListener, is setup in web.xml to run before a jsp is run. Project
+ * / Instance settings can be passed as an Environment Variable, a System Property, or set in
+ * web.xml from a context-param
+ */
+@WebListener
+public class BigtableHelper implements ServletContextListener {
+
+ private static String PROJECT_ID;
+ private static String INSTANCE_ID;
+
+ // The initial connection to Cloud Bigtable is an expensive operation -- We cache this Connection
+ // to speed things up. For this sample, keeping them here is a good idea, for
+ // your application, you may wish to keep this somewhere else.
+ private static Connection connection = null; // The authenticated connection
+
+ private static ServletContext sc;
+
+ /** Connect will establish the connection to Cloud Bigtable. */
+ public static void connect() throws IOException {
+
+ if (PROJECT_ID == null || INSTANCE_ID == null) {
+ if (sc != null) {
+ sc.log("environment variables BIGTABLE_PROJECT, and BIGTABLE_INSTANCE need to be defined.");
+ }
+ return;
+ }
+
+ connection = BigtableConfiguration.connect(PROJECT_ID, INSTANCE_ID);
+ }
+
+ /**
+ * Get the shared connection to Cloud Bigtable.
+ *
+ * @return the connection
+ */
+ public static Connection getConnection() {
+ if (connection == null) {
+ try {
+ connect();
+ } catch (IOException e) {
+ if (sc != null) {
+ sc.log("connect ", e);
+ }
+ }
+ }
+ if (connection == null) {
+ if (sc != null) {
+ sc.log("BigtableHelper-No Connection");
+ }
+ }
+ return connection;
+ }
+
+ @Override
+ public void contextInitialized(ServletContextEvent event) {
+ // This will be invoked as part of a warmup request, or the first user
+ // request if no warmup request was invoked.
+
+ if (event != null) {
+ sc = event.getServletContext();
+ if (PROJECT_ID == null) {
+ PROJECT_ID = sc.getInitParameter("BIGTABLE_PROJECT");
+ }
+ if (INSTANCE_ID == null) {
+ INSTANCE_ID = sc.getInitParameter("BIGTABLE_INSTANCE");
+ }
+ }
+
+ if (PROJECT_ID != null && PROJECT_ID.startsWith("@")) {
+ PROJECT_ID = null;
+ }
+ if (INSTANCE_ID != null && INSTANCE_ID.startsWith("@")) {
+ INSTANCE_ID = null;
+ }
+
+ if (PROJECT_ID == null) {
+ PROJECT_ID = System.getProperty("bigtable.projectID");
+ }
+ if (INSTANCE_ID == null) {
+ INSTANCE_ID = System.getProperty("bigtable.instanceID");
+ }
+
+ try {
+ connect();
+ } catch (IOException e) {
+ if (sc != null) {
+ sc.log("BigtableHelper - connect ", e);
+ }
+ }
+ if (connection == null) {
+ if (sc != null) {
+ sc.log("BigtableHelper-No Connection");
+ }
+ }
+ if (sc != null) {
+ sc.log("ctx Initialized: " + PROJECT_ID + " " + INSTANCE_ID);
+ }
+ }
+
+ @Override
+ public void contextDestroyed(ServletContextEvent event) {
+ // App Engine does not currently invoke this method.
+ if (connection == null) {
+ return;
+ }
+ try {
+ connection.close();
+ } catch (IOException io) {
+ if (sc != null) {
+ sc.log("contextDestroyed ", io);
+ }
+ }
+ connection = null;
+ }
+}
diff --git a/appengine-java21/ee8/bigtable/src/main/webapp/WEB-INF/appengine-web.xml b/appengine-java21/ee8/bigtable/src/main/webapp/WEB-INF/appengine-web.xml
new file mode 100644
index 00000000000..2209fe610cd
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/src/main/webapp/WEB-INF/appengine-web.xml
@@ -0,0 +1,24 @@
+
+
+
+ java21
+ true
+
+
+
+
+
+
+
+
diff --git a/appengine-java21/ee8/bigtable/src/main/webapp/WEB-INF/logging.properties b/appengine-java21/ee8/bigtable/src/main/webapp/WEB-INF/logging.properties
new file mode 100644
index 00000000000..0c2ea51bc6d
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/src/main/webapp/WEB-INF/logging.properties
@@ -0,0 +1,13 @@
+# A default java.util.logging configuration.
+# (All App Engine logging is through java.util.logging by default).
+#
+# To use this configuration, copy it into your application's WEB-INF
+# folder and add the following to your appengine-web.xml:
+#
+#
+#
+#
+#
+
+# Set the default logging level for all loggers to WARNING
+.level = WARNING
diff --git a/appengine-java21/ee8/bigtable/src/main/webapp/WEB-INF/web.xml b/appengine-java21/ee8/bigtable/src/main/webapp/WEB-INF/web.xml
new file mode 100644
index 00000000000..2fecfb4115c
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/src/main/webapp/WEB-INF/web.xml
@@ -0,0 +1,35 @@
+
+
+
+
+
+ bigtable.jsp
+
+
+ BIGTABLE_PROJECT
+ @bigtable.projectID@
+
+
+ BIGTABLE_INSTANCE
+ @bigtable.instanceID@
+
+
+
diff --git a/appengine-java21/ee8/bigtable/src/main/webapp/bigtable.jsp b/appengine-java21/ee8/bigtable/src/main/webapp/bigtable.jsp
new file mode 100644
index 00000000000..88a040051e6
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/src/main/webapp/bigtable.jsp
@@ -0,0 +1,32 @@
+
+<%@ page contentType="text/html;charset=UTF-8" language="java" %>
+<%@ page import="com.example.bigtable.BigtableHelloWorld" %>
+
+<%--
+ ~ Copyright 2017 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.
+ --%>
+
+
+
+
+ Hello App Engine Standard using Java 21
+
+
+
Hello App Engine -- Standard for Java 21!
+
+
This is <%= BigtableHelloWorld.doHelloWorld() %>.
+
+
+
diff --git a/appengine-java21/ee8/bigtable/src/main/webapp/favicon.ico b/appengine-java21/ee8/bigtable/src/main/webapp/favicon.ico
new file mode 100644
index 00000000000..0062ab413e7
Binary files /dev/null and b/appengine-java21/ee8/bigtable/src/main/webapp/favicon.ico differ
diff --git a/appengine-java21/ee8/bigtable/src/test/java/com/example/bigtable/BigtableHelloWorldTests.java b/appengine-java21/ee8/bigtable/src/test/java/com/example/bigtable/BigtableHelloWorldTests.java
new file mode 100644
index 00000000000..7b13aa67e2f
--- /dev/null
+++ b/appengine-java21/ee8/bigtable/src/test/java/com/example/bigtable/BigtableHelloWorldTests.java
@@ -0,0 +1,47 @@
+/*
+ * Copyright 2016 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.bigtable;
+
+import static com.google.common.truth.Truth.assertThat;
+
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.JUnit4;
+
+/** Unit tests for {@link BigtableHelloWorld}. */
+@RunWith(JUnit4.class)
+public class BigtableHelloWorldTests {
+
+ private BigtableHelper helper;
+
+ @Before
+ public void setUp() throws Exception {
+ helper = new BigtableHelper();
+ helper.contextInitialized(null);
+ }
+
+ @Test
+ public void bigtable_test() {
+ String result = BigtableHelloWorld.doHelloWorld();
+ assertThat(result).contains("Write some greetings to the table");
+ assertThat(result).contains("Get a single greeting by row key");
+ assertThat(result).contains("greeting0= Hello World!");
+ assertThat(result).contains("Hello Cloud Bigtable!");
+ assertThat(result).contains("Hello HBase!");
+ }
+}
diff --git a/appengine-java21/ee8/datastore/README.md b/appengine-java21/ee8/datastore/README.md
new file mode 100644
index 00000000000..cb258be8741
--- /dev/null
+++ b/appengine-java21/ee8/datastore/README.md
@@ -0,0 +1,32 @@
+# Google Cloud Datastore Sample
+
+
+
+
+This sample demonstrates how to use [Google Cloud Datastore][java-datastore]
+from [Google App Engine standard environment][ae-docs].
+
+[java-datastore]: https://cloud.google.com/appengine/docs/java/datastore/
+[ae-docs]: https://cloud.google.com/appengine/docs/java/
+
+
+## Running locally
+
+This example uses the
+[Cloud SDK Maven plugin](https://cloud.google.com/appengine/docs/legacy/standard/java/using-maven).
+To run this sample locally:
+
+ $ mvn appengine:run
+
+To see the results of the sample application, open
+[localhost:8080](http://localhost:8080) in a web browser.
+
+
+## Deploying
+
+In the following command, replace YOUR-PROJECT-ID with your
+[Google Cloud Project ID](https://developers.google.com/console/help/new/#projectnumber)
+and SOME-VERSION with a valid version number.
+
+ $ mvn clean package appengine:deploy
+ $ mvn appengine:deployIndex
diff --git a/appengine-java21/ee8/datastore/pom.xml b/appengine-java21/ee8/datastore/pom.xml
new file mode 100644
index 00000000000..ae955be85df
--- /dev/null
+++ b/appengine-java21/ee8/datastore/pom.xml
@@ -0,0 +1,181 @@
+
+
+ 4.0.0
+ war
+ 1.0-SNAPSHOT
+ com.example.appengine
+ appengine-datastore-j21
+
+
+
+ com.google.cloud.samples
+ shared-configuration
+ 1.2.0
+
+
+
+ 21
+ 21
+
+
+
+
+
+ libraries-bom
+ com.google.cloud
+ import
+ pom
+ 26.28.0
+
+
+
+
+
+
+ com.google.appengine
+ appengine-api-1.0-sdk
+ 2.0.39
+
+
+
+ jakarta.servlet
+ jakarta.servlet-api
+ 4.0.4
+ jar
+ provided
+
+
+
+ taglibs
+ standard
+ 1.1.2
+
+
+ jakarta.servlet.jsp.jstl
+ jakarta.servlet.jsp.jstl-api
+ 1.2.7
+
+
+
+ com.google.auto.value
+ auto-value
+ 1.11.0
+ provided
+
+
+
+ com.google.auto.value
+ auto-value-annotations
+
+
+
+ com.google.code.findbugs
+ jsr305
+ 3.0.2
+
+
+
+ com.google.guava
+ guava
+
+
+
+
+ junit
+ junit
+ 4.13.2
+ test
+
+
+ org.mockito
+ mockito-core
+ 4.11.0
+ test
+
+
+
+ com.google.appengine
+ appengine-testing
+ 2.0.39
+ test
+
+
+ com.google.appengine
+ appengine-api-stubs
+ 2.0.39
+ test
+
+
+ com.google.appengine
+ appengine-tools-sdk
+ 2.0.39
+ test
+
+
+ com.google.truth
+ truth
+ 1.4.4
+ test
+
+
+
+
+
+ ${project.build.directory}/${project.build.finalName}/WEB-INF/classes
+
+
+ org.apache.maven.plugins
+ maven-war-plugin
+ 3.4.0
+
+
+ org.jacoco
+ jacoco-maven-plugin
+ 0.8.13
+
+
+ com.google.cloud.tools
+ appengine-maven-plugin
+ 2.5.0
+
+ GCLOUD_CONFIG
+ GCLOUD_CONFIG
+ true
+ true
+
+
+
+
+ maven-compiler-plugin
+ 3.11.0
+
+
+
+ com.google.auto.value
+ auto-value
+ 1.11.0
+
+
+
+
+
+
+
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/AbstractGuestbook.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/AbstractGuestbook.java
new file mode 100644
index 00000000000..a7b46bc4727
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/AbstractGuestbook.java
@@ -0,0 +1,76 @@
+/*
+ * Copyright 2016 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.appengine;
+
+import com.example.time.Clock;
+import com.google.appengine.api.datastore.DatastoreService;
+import com.google.appengine.api.datastore.DatastoreServiceFactory;
+import com.google.appengine.api.datastore.Entity;
+import com.google.appengine.api.users.User;
+import com.google.appengine.api.users.UserService;
+import com.google.appengine.api.users.UserServiceFactory;
+import com.google.common.collect.ImmutableList;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * A log of notes left by users.
+ *
+ *
This is meant to be subclassed to demonstrate different storage structures in Datastore.
+ */
+abstract class AbstractGuestbook {
+
+ private final DatastoreService datastore;
+ private final UserService userService;
+ private final Clock clock;
+
+ AbstractGuestbook(Clock clock) {
+ this.datastore = DatastoreServiceFactory.getDatastoreService();
+ this.userService = UserServiceFactory.getUserService();
+ this.clock = clock;
+ }
+
+ /**
+ * Appends a new greeting to the guestbook and returns the {@link Entity} that was created.
+ **/
+ public Greeting appendGreeting(String content) {
+ return Greeting.create(
+ createGreeting(datastore, userService.getCurrentUser(), Date.from(clock.now()), content));
+ }
+
+ /**
+ * Write a greeting to Datastore.
+ */
+ protected abstract Entity createGreeting(
+ DatastoreService datastore, User user, Date date, String content);
+
+ /**
+ * Return a list of the most recent greetings.
+ */
+ public List listGreetings() {
+ ImmutableList.Builder greetings = ImmutableList.builder();
+ for (Entity entity : listGreetingEntities(datastore)) {
+ greetings.add(Greeting.create(entity));
+ }
+ return greetings.build();
+ }
+
+ /**
+ * Return a list of the most recent greetings.
+ */
+ protected abstract List listGreetingEntities(DatastoreService datastore);
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/AbstractGuestbookServlet.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/AbstractGuestbookServlet.java
new file mode 100644
index 00000000000..d9a0d518b92
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/AbstractGuestbookServlet.java
@@ -0,0 +1,58 @@
+/*
+ * Copyright 2016 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.appengine;
+
+import java.io.IOException;
+import javax.servlet.ServletException;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+abstract class AbstractGuestbookServlet extends HttpServlet {
+
+ private final AbstractGuestbook guestbook;
+
+ public AbstractGuestbookServlet(AbstractGuestbook guestbook) {
+ this.guestbook = guestbook;
+ }
+
+ private void renderGuestbook(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+ resp.setContentType("text/html");
+ resp.setCharacterEncoding("UTF-8");
+ req.setAttribute("greetings", guestbook.listGreetings());
+ req.getRequestDispatcher("/guestbook.jsp").forward(req, resp);
+ }
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+ renderGuestbook(req, resp);
+ }
+
+ @Override
+ public void doPost(HttpServletRequest req, HttpServletResponse resp)
+ throws IOException, ServletException {
+ String content = req.getParameter("content");
+ if (content == null || content.isEmpty()) {
+ resp.sendError(HttpServletResponse.SC_BAD_REQUEST, "missing content");
+ return;
+ }
+ guestbook.appendGreeting(content);
+ renderGuestbook(req, resp);
+ }
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/Greeting.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/Greeting.java
new file mode 100644
index 00000000000..ff45e508205
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/Greeting.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright 2016 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.appengine;
+
+import com.google.appengine.api.datastore.Entity;
+import com.google.appengine.api.users.User;
+import com.google.auto.value.AutoValue;
+import java.time.Instant;
+import java.util.Date;
+import javax.annotation.Nullable;
+
+@AutoValue
+public abstract class Greeting {
+
+ static Greeting create(Entity entity) {
+ User user = (User) entity.getProperty("user");
+ Instant date = ((Date) entity.getProperty("date")).toInstant();
+ String content = (String) entity.getProperty("content");
+ return new AutoValue_Greeting(user, date, content);
+ }
+
+ @Nullable
+ public abstract User getUser();
+
+ public abstract Instant getDate();
+
+ public abstract String getContent();
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/Guestbook.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/Guestbook.java
new file mode 100644
index 00000000000..ebacbf540ae
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/Guestbook.java
@@ -0,0 +1,59 @@
+/*
+ * Copyright 2016 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.appengine;
+
+import com.example.time.Clock;
+import com.google.appengine.api.datastore.DatastoreService;
+import com.google.appengine.api.datastore.Entity;
+import com.google.appengine.api.datastore.FetchOptions;
+import com.google.appengine.api.datastore.Query;
+import com.google.appengine.api.users.User;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * A log of notes left by users.
+ *
+ *
This demonstrates the use of Google Cloud Datastore using the App Engine APIs. See the documentation for more
+ * information.
+ */
+class Guestbook extends AbstractGuestbook {
+
+ Guestbook(Clock clock) {
+ super(clock);
+ }
+
+ @Override
+ protected Entity createGreeting(
+ DatastoreService datastore, User user, Date date, String content) {
+ // No parent key specified, so Greeting is a root entity.
+ Entity greeting = new Entity("Greeting");
+ greeting.setProperty("user", user);
+ greeting.setProperty("date", date);
+ greeting.setProperty("content", content);
+
+ datastore.put(greeting);
+ return greeting;
+ }
+
+ @Override
+ protected List listGreetingEntities(DatastoreService datastore) {
+ Query query = new Query("Greeting").addSort("date", Query.SortDirection.DESCENDING);
+ return datastore.prepare(query).asList(FetchOptions.Builder.withLimit(10));
+ }
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/GuestbookServlet.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/GuestbookServlet.java
new file mode 100644
index 00000000000..019e5a4210c
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/GuestbookServlet.java
@@ -0,0 +1,26 @@
+/*
+ * Copyright 2016 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.appengine;
+
+import com.example.time.SystemClock;
+
+public class GuestbookServlet extends AbstractGuestbookServlet {
+
+ public GuestbookServlet() {
+ super(new Guestbook(new SystemClock()));
+ }
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/GuestbookStrong.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/GuestbookStrong.java
new file mode 100644
index 00000000000..a3c1bc08743
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/GuestbookStrong.java
@@ -0,0 +1,71 @@
+/*
+ * Copyright 2016 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.appengine;
+
+import com.example.time.Clock;
+import com.google.appengine.api.datastore.DatastoreService;
+import com.google.appengine.api.datastore.Entity;
+import com.google.appengine.api.datastore.FetchOptions;
+import com.google.appengine.api.datastore.Key;
+import com.google.appengine.api.datastore.KeyFactory;
+import com.google.appengine.api.datastore.Query;
+import com.google.appengine.api.users.User;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * A log of notes left by users.
+ *
+ *
This demonstrates the use of Google Cloud Datastore using the App Engine APIs. See the documentation for more
+ * information.
+ */
+class GuestbookStrong extends AbstractGuestbook {
+
+ private final String guestbookName;
+
+ GuestbookStrong(String guestbookName, Clock clock) {
+ super(clock);
+ this.guestbookName = guestbookName;
+ }
+
+ @Override
+ protected Entity createGreeting(
+ DatastoreService datastore, User user, Date date, String content) {
+ // String guestbookName = "my guestbook"; -- Set elsewhere (injected to the constructor).
+ Key guestbookKey = KeyFactory.createKey("Guestbook", guestbookName);
+
+ // Place greeting in the same entity group as guestbook.
+ Entity greeting = new Entity("Greeting", guestbookKey);
+ greeting.setProperty("user", user);
+ greeting.setProperty("date", date);
+ greeting.setProperty("content", content);
+
+ datastore.put(greeting);
+ return greeting;
+ }
+
+ @Override
+ protected List listGreetingEntities(DatastoreService datastore) {
+ Key guestbookKey = KeyFactory.createKey("Guestbook", guestbookName);
+ Query query =
+ new Query("Greeting", guestbookKey)
+ .setAncestor(guestbookKey)
+ .addSort("date", Query.SortDirection.DESCENDING);
+ return datastore.prepare(query).asList(FetchOptions.Builder.withLimit(10));
+ }
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/GuestbookStrongServlet.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/GuestbookStrongServlet.java
new file mode 100644
index 00000000000..2861c88d991
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/GuestbookStrongServlet.java
@@ -0,0 +1,28 @@
+/*
+ * Copyright 2016 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.appengine;
+
+import com.example.time.SystemClock;
+
+public class GuestbookStrongServlet extends AbstractGuestbookServlet {
+
+ public static final String GUESTBOOK_ID = "my guestbook";
+
+ public GuestbookStrongServlet() {
+ super(new GuestbookStrong(GUESTBOOK_ID, new SystemClock()));
+ }
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/ListPeopleServlet.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/ListPeopleServlet.java
new file mode 100644
index 00000000000..8bb61cbbadc
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/ListPeopleServlet.java
@@ -0,0 +1,91 @@
+/*
+ * Copyright 2016 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.appengine;
+
+// [START gae_java21_datastore_cursors]
+
+import com.google.appengine.api.datastore.Cursor;
+import com.google.appengine.api.datastore.DatastoreService;
+import com.google.appengine.api.datastore.DatastoreServiceFactory;
+import com.google.appengine.api.datastore.Entity;
+import com.google.appengine.api.datastore.FetchOptions;
+import com.google.appengine.api.datastore.PreparedQuery;
+import com.google.appengine.api.datastore.Query;
+import com.google.appengine.api.datastore.Query.SortDirection;
+import com.google.appengine.api.datastore.QueryResultList;
+import java.io.IOException;
+import java.io.PrintWriter;
+import javax.servlet.ServletException;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+public class ListPeopleServlet extends HttpServlet {
+
+ static final int PAGE_SIZE = 15;
+ private final DatastoreService datastore;
+
+ public ListPeopleServlet() {
+ datastore = DatastoreServiceFactory.getDatastoreService();
+ }
+
+ @Override
+ protected void doGet(HttpServletRequest req, HttpServletResponse resp)
+ throws ServletException, IOException {
+ FetchOptions fetchOptions = FetchOptions.Builder.withLimit(PAGE_SIZE);
+
+ // If this servlet is passed a cursor parameter, let's use it.
+ String startCursor = req.getParameter("cursor");
+ if (startCursor != null) {
+ fetchOptions.startCursor(Cursor.fromWebSafeString(startCursor));
+ }
+
+ Query q = new Query("Person").addSort("name", SortDirection.ASCENDING);
+ PreparedQuery pq = datastore.prepare(q);
+
+ QueryResultList results;
+ try {
+ results = pq.asQueryResultList(fetchOptions);
+ } catch (IllegalArgumentException e) {
+ // IllegalArgumentException happens when an invalid cursor is used.
+ // A user could have manually entered a bad cursor in the URL or there
+ // may have been an internal implementation detail change in App Engine.
+ // Redirect to the page without the cursor parameter to show something
+ // rather than an error.
+ resp.sendRedirect("/people");
+ return;
+ }
+
+ resp.setContentType("text/html");
+ resp.setCharacterEncoding("UTF-8");
+ PrintWriter w = resp.getWriter();
+ w.println("");
+ w.println("");
+ w.println("Cloud Datastore Cursor Sample");
+ w.println("
");
+ for (Entity entity : results) {
+ w.println("
" + entity.getProperty("name") + "
");
+ }
+ w.println("
");
+
+ String cursorString = results.getCursor().toWebSafeString();
+
+ // This servlet lives at '/people'.
+ w.println("Next page");
+ }
+}
+// [END gae_java21_datastore_cursors]
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/ProjectionServlet.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/ProjectionServlet.java
new file mode 100644
index 00000000000..d062f9d6d17
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/ProjectionServlet.java
@@ -0,0 +1,78 @@
+/*
+ * Copyright 2016 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.appengine;
+
+import com.google.appengine.api.datastore.DatastoreService;
+import com.google.appengine.api.datastore.DatastoreServiceFactory;
+import com.google.appengine.api.datastore.Entity;
+import com.google.appengine.api.datastore.FetchOptions;
+import com.google.appengine.api.datastore.Key;
+import com.google.appengine.api.datastore.KeyFactory;
+import com.google.appengine.api.datastore.PropertyProjection;
+import com.google.appengine.api.datastore.Query;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.util.Date;
+import java.util.List;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+/**
+ * Servlet to demonstrate use of Datastore projection queries.
+ *
+ *
See the
+ * documentation
+ * for using Datastore projection queries from the Google App Engine standard environment.
+ */
+@SuppressWarnings("serial")
+public class ProjectionServlet extends HttpServlet {
+
+ private static final String GUESTBOOK_ID = GuestbookStrongServlet.GUESTBOOK_ID;
+ private final DatastoreService datastore;
+
+ public ProjectionServlet() {
+ datastore = DatastoreServiceFactory.getDatastoreService();
+ }
+
+ @Override
+ public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
+ resp.setContentType("text/plain");
+ resp.setCharacterEncoding("UTF-8");
+ PrintWriter out = resp.getWriter();
+ out.printf("Latest entries from guestbook: \n");
+
+ Key guestbookKey = KeyFactory.createKey("Guestbook", GUESTBOOK_ID);
+ Query query = new Query("Greeting", guestbookKey);
+ addGuestbookProjections(query);
+ printGuestbookEntries(datastore, query, out);
+ }
+
+ private void addGuestbookProjections(Query query) {
+ query.addProjection(new PropertyProjection("content", String.class));
+ query.addProjection(new PropertyProjection("date", Date.class));
+ }
+
+ private void printGuestbookEntries(DatastoreService datastore, Query query, PrintWriter out) {
+ List guests = datastore.prepare(query).asList(FetchOptions.Builder.withLimit(5));
+ for (Entity guest : guests) {
+ String content = (String) guest.getProperty("content");
+ Date stamp = (Date) guest.getProperty("date");
+ out.printf("Message %s posted on %s.\n", content, stamp.toString());
+ }
+ }
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/StartupServlet.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/StartupServlet.java
new file mode 100644
index 00000000000..9f4d2d06970
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/StartupServlet.java
@@ -0,0 +1,119 @@
+/*
+ * Copyright 2016 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.appengine;
+
+import com.google.appengine.api.datastore.DatastoreService;
+import com.google.appengine.api.datastore.DatastoreServiceFactory;
+import com.google.appengine.api.datastore.Entity;
+import com.google.appengine.api.datastore.EntityNotFoundException;
+import com.google.appengine.api.datastore.Key;
+import com.google.appengine.api.datastore.KeyFactory;
+import com.google.common.collect.ImmutableList;
+import java.io.IOException;
+import javax.servlet.ServletException;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+/**
+ * A startup handler to populate the datastore with example entities.
+ */
+public class StartupServlet extends HttpServlet {
+
+ static final String IS_POPULATED_ENTITY = "IsPopulated";
+ static final String IS_POPULATED_KEY_NAME = "is-populated";
+
+ private static final String PERSON_ENTITY = "Person";
+ private static final String NAME_PROPERTY = "name";
+ private static final ImmutableList US_PRESIDENTS =
+ ImmutableList.builder()
+ .add("George Washington")
+ .add("John Adams")
+ .add("Thomas Jefferson")
+ .add("James Madison")
+ .add("James Monroe")
+ .add("John Quincy Adams")
+ .add("Andrew Jackson")
+ .add("Martin Van Buren")
+ .add("William Henry Harrison")
+ .add("John Tyler")
+ .add("James K. Polk")
+ .add("Zachary Taylor")
+ .add("Millard Fillmore")
+ .add("Franklin Pierce")
+ .add("James Buchanan")
+ .add("Abraham Lincoln")
+ .add("Andrew Johnson")
+ .add("Ulysses S. Grant")
+ .add("Rutherford B. Hayes")
+ .add("James A. Garfield")
+ .add("Chester A. Arthur")
+ .add("Grover Cleveland")
+ .add("Benjamin Harrison")
+ .add("Grover Cleveland")
+ .add("William McKinley")
+ .add("Theodore Roosevelt")
+ .add("William Howard Taft")
+ .add("Woodrow Wilson")
+ .add("Warren G. Harding")
+ .add("Calvin Coolidge")
+ .add("Herbert Hoover")
+ .add("Franklin D. Roosevelt")
+ .add("Harry S. Truman")
+ .add("Dwight D. Eisenhower")
+ .add("John F. Kennedy")
+ .add("Lyndon B. Johnson")
+ .add("Richard Nixon")
+ .add("Gerald Ford")
+ .add("Jimmy Carter")
+ .add("Ronald Reagan")
+ .add("George H. W. Bush")
+ .add("Bill Clinton")
+ .add("George W. Bush")
+ .add("Barack Obama")
+ .build();
+
+ @Override
+ protected void doGet(HttpServletRequest req, HttpServletResponse resp)
+ throws ServletException, IOException {
+ resp.setContentType("text/plain");
+ DatastoreService datastore = DatastoreServiceFactory.getDatastoreService();
+
+ Key isPopulatedKey = KeyFactory.createKey(IS_POPULATED_ENTITY, IS_POPULATED_KEY_NAME);
+ boolean isAlreadyPopulated;
+ try {
+ datastore.get(isPopulatedKey);
+ isAlreadyPopulated = true;
+ } catch (EntityNotFoundException expected) {
+ isAlreadyPopulated = false;
+ }
+ if (isAlreadyPopulated) {
+ resp.getWriter().println("ok");
+ return;
+ }
+
+ ImmutableList.Builder people = ImmutableList.builder();
+ for (String name : US_PRESIDENTS) {
+ Entity person = new Entity(PERSON_ENTITY);
+ person.setProperty(NAME_PROPERTY, name);
+ people.add(person);
+ }
+ datastore.put(people.build());
+ datastore.put(new Entity(isPopulatedKey));
+ resp.getWriter().println("ok");
+ }
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/StatsServlet.java b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/StatsServlet.java
new file mode 100644
index 00000000000..74531a56e56
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/appengine/StatsServlet.java
@@ -0,0 +1,47 @@
+/*
+ * Copyright 2016 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.appengine;
+
+import com.google.appengine.api.datastore.DatastoreService;
+import com.google.appengine.api.datastore.DatastoreServiceFactory;
+import com.google.appengine.api.datastore.Entity;
+import com.google.appengine.api.datastore.Query;
+import java.io.IOException;
+import java.io.PrintWriter;
+import javax.servlet.ServletException;
+import javax.servlet.http.HttpServlet;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+
+public class StatsServlet extends HttpServlet {
+
+ @Override
+ protected void doGet(HttpServletRequest req, HttpServletResponse resp)
+ throws ServletException, IOException {
+ // [START gae_java21_datastore_stat_example]
+ DatastoreService datastore = DatastoreServiceFactory.getDatastoreService();
+ Entity globalStat = datastore.prepare(new Query("__Stat_Total__")).asSingleEntity();
+ Long totalBytes = (Long) globalStat.getProperty("bytes");
+ Long totalEntities = (Long) globalStat.getProperty("count");
+ // [END gae_java21_datastore_stat_example]
+
+ resp.setContentType("text/plain");
+ resp.setCharacterEncoding("UTF-8");
+ PrintWriter w = resp.getWriter();
+ w.printf("%d bytes\n%d entities\n", totalBytes, totalEntities);
+ }
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/time/Clock.java b/appengine-java21/ee8/datastore/src/main/java/com/example/time/Clock.java
new file mode 100644
index 00000000000..a703577d7f9
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/time/Clock.java
@@ -0,0 +1,36 @@
+/*
+ * Copyright 2016 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.time;
+
+import java.time.Instant;
+
+/**
+ * Provides the current value of "now." To preserve testability, avoid all other libraries that
+ * access the system clock (whether {@linkplain System#currentTimeMillis directly} or {@linkplain
+ * java.time.Instant#now() indirectly}).
+ *
+ *
In production, use the {@link SystemClock} implementation to return the "real" system time. In
+ * tests, either use {@link com.example.time.testing.FakeClock}, or get an instance from a mocking
+ * framework such as Mockito.
+ */
+public interface Clock {
+
+ /**
+ * Returns the current, absolute time according to this clock.
+ */
+ Instant now();
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/time/SystemClock.java b/appengine-java21/ee8/datastore/src/main/java/com/example/time/SystemClock.java
new file mode 100644
index 00000000000..dcde41330f6
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/time/SystemClock.java
@@ -0,0 +1,39 @@
+/*
+ * Copyright 2016 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.time;
+
+import java.time.Instant;
+
+/**
+ * Clock implementation that returns the "real" system time.
+ *
+ *
This class exists so that we can use a fake implementation for unit testing classes that need
+ * the current time value. See {@link Clock} for general information about clocks.
+ */
+public class SystemClock implements Clock {
+
+ /**
+ * Creates a new instance. All {@code SystemClock} instances function identically.
+ */
+ public SystemClock() {
+ }
+
+ @Override
+ public Instant now() {
+ return Instant.now();
+ }
+}
diff --git a/appengine-java21/ee8/datastore/src/main/java/com/example/time/testing/FakeClock.java b/appengine-java21/ee8/datastore/src/main/java/com/example/time/testing/FakeClock.java
new file mode 100644
index 00000000000..a08343e51b6
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/java/com/example/time/testing/FakeClock.java
@@ -0,0 +1,180 @@
+/*
+ * Copyright 2016 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.time.testing;
+
+import com.example.time.Clock;
+import java.time.Duration;
+import java.time.Instant;
+import java.util.concurrent.atomic.AtomicLong;
+
+/**
+ * A Clock that returns a fixed Instant value as the current clock time. The fixed Instant is
+ * settable for testing. Test code should hold a reference to the FakeClock, while code under test
+ * should hold a Clock reference.
+ *
+ *
The clock time can be incremented/decremented manually, with {@link #incrementTime} and {@link
+ * #decrementTime} respectively.
+ *
+ *
The clock can also be configured so that the time is incremented whenever {@link #now()} is
+ * called: see {@link #setAutoIncrementStep}.
+ */
+public class FakeClock implements Clock {
+
+ private static final Instant DEFAULT_TIME = Instant.ofEpochMilli(1000000000L);
+ private final long baseTimeMs;
+ private final AtomicLong fakeNowMs;
+ private volatile long autoIncrementStepMs;
+
+ /**
+ * Creates a FakeClock instance initialized to an arbitrary constant.
+ */
+ public FakeClock() {
+ this(DEFAULT_TIME);
+ }
+
+ /**
+ * Creates a FakeClock instance initialized to the given time.
+ */
+ public FakeClock(Instant now) {
+ baseTimeMs = now.toEpochMilli();
+ fakeNowMs = new AtomicLong(baseTimeMs);
+ }
+
+ /**
+ * Sets the value of the underlying instance for testing purposes.
+ *
+ * @return this
+ */
+ public FakeClock setNow(Instant now) {
+ fakeNowMs.set(now.toEpochMilli());
+ return this;
+ }
+
+ @Override
+ public Instant now() {
+ return getAndAdd(autoIncrementStepMs);
+ }
+
+ /**
+ * Returns the current time without applying an auto increment, if configured. The default
+ * behavior of {@link #now()} is the same as this method.
+ */
+ public Instant peek() {
+ return Instant.ofEpochMilli(fakeNowMs.get());
+ }
+
+ /**
+ * Reset the given clock back to the base time with which the FakeClock was initially
+ * constructed.
+ *
+ * @return this
+ */
+ public FakeClock resetTime() {
+ fakeNowMs.set(baseTimeMs);
+ return this;
+ }
+
+ /**
+ * Increments the clock time by the given duration.
+ *
+ * @param duration the duration to increment the clock time by
+ * @return this
+ */
+ public FakeClock incrementTime(Duration duration) {
+ incrementTime(duration.toMillis());
+ return this;
+ }
+
+ /**
+ * Increments the clock time by the given duration.
+ *
+ * @param durationMs the duration to increment the clock time by, in milliseconds
+ * @return this
+ */
+ public FakeClock incrementTime(long durationMs) {
+ fakeNowMs.addAndGet(durationMs);
+ return this;
+ }
+
+ /**
+ * Decrements the clock time by the given duration.
+ *
+ * @param duration the duration to decrement the clock time by
+ * @return this
+ */
+ public FakeClock decrementTime(Duration duration) {
+ incrementTime(-duration.toMillis());
+ return this;
+ }
+
+ /**
+ * Decrements the clock time by the given duration.
+ *
+ * @param durationMs the duration to decrement the clock time by, in milliseconds
+ * @return this
+ */
+ public FakeClock decrementTime(long durationMs) {
+ incrementTime(-durationMs);
+ return this;
+ }
+
+ /**
+ * Sets the increment applied to the clock whenever it is queried. The increment is zero by
+ * default: the clock is left unchanged when queried.
+ *
+ * @param autoIncrementStep the new auto increment duration
+ * @return this
+ */
+ public FakeClock setAutoIncrementStep(Duration autoIncrementStep) {
+ setAutoIncrementStep(autoIncrementStep.toMillis());
+ return this;
+ }
+
+ /**
+ * Sets the increment applied to the clock whenever it is queried. The increment is zero by
+ * default: the clock is left unchanged when queried.
+ *
+ * @param autoIncrementStepMs the new auto increment duration, in milliseconds
+ * @return this
+ */
+ public FakeClock setAutoIncrementStep(long autoIncrementStepMs) {
+ this.autoIncrementStepMs = autoIncrementStepMs;
+ return this;
+ }
+
+ /**
+ * Atomically adds the given value to the current time.
+ *
+ * @param durationMs the duration to add, in milliseconds
+ * @return the updated current time
+ * @see AtomicLong#addAndGet
+ */
+ protected final Instant addAndGet(long durationMs) {
+ return Instant.ofEpochMilli(fakeNowMs.addAndGet(durationMs));
+ }
+
+ /**
+ * Atomically adds the given value to the current time.
+ *
+ * @param durationMs the duration to add, in milliseconds
+ * @return the previous time
+ * @see AtomicLong#getAndAdd
+ */
+ protected final Instant getAndAdd(long durationMs) {
+ return Instant.ofEpochMilli(fakeNowMs.getAndAdd(durationMs));
+ }
+}
diff --git a/appengine-java21/ee8/datastore/src/main/webapp/WEB-INF/appengine-web.xml b/appengine-java21/ee8/datastore/src/main/webapp/WEB-INF/appengine-web.xml
new file mode 100644
index 00000000000..56e91137870
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/webapp/WEB-INF/appengine-web.xml
@@ -0,0 +1,22 @@
+
+
+
+
+
+ java21
+ true
+
+
+
+
diff --git a/appengine-java21/ee8/datastore/src/main/webapp/WEB-INF/datastore-indexes.xml b/appengine-java21/ee8/datastore/src/main/webapp/WEB-INF/datastore-indexes.xml
new file mode 100644
index 00000000000..c99175eba3b
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/webapp/WEB-INF/datastore-indexes.xml
@@ -0,0 +1,22 @@
+
+
+
+
+
+
+
+
+
+
+
diff --git a/appengine-java21/ee8/datastore/src/main/webapp/WEB-INF/web.xml b/appengine-java21/ee8/datastore/src/main/webapp/WEB-INF/web.xml
new file mode 100644
index 00000000000..dddc47141c7
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/webapp/WEB-INF/web.xml
@@ -0,0 +1,98 @@
+
+
+
+
+ guestbook-strong
+ com.example.appengine.GuestbookStrongServlet
+
+
+ guestbook-strong
+ /
+
+
+ guestbook
+ com.example.appengine.GuestbookServlet
+
+
+ guestbook
+ /guestbook
+
+
+ people
+ com.example.appengine.ListPeopleServlet
+
+
+ people
+ /people
+
+
+ projection
+ com.example.appengine.ProjectionServlet
+
+
+ projection
+ /projection
+
+
+ stats
+ com.example.appengine.StatsServlet
+
+
+ stats
+ /stats
+
+
+
+
+ startup
+ com.example.appengine.StartupServlet
+
+
+ startup
+ /_ah/start
+
+
+
+
+ profile
+ /*
+
+
+ CONFIDENTIAL
+
+
+ *
+
+
+
+
+
+ profile
+ /stats
+
+
+ CONFIDENTIAL
+
+
+ admin
+
+
+
diff --git a/appengine-java21/ee8/datastore/src/main/webapp/guestbook.jsp b/appengine-java21/ee8/datastore/src/main/webapp/guestbook.jsp
new file mode 100644
index 00000000000..5d2d5708f7e
--- /dev/null
+++ b/appengine-java21/ee8/datastore/src/main/webapp/guestbook.jsp
@@ -0,0 +1,45 @@
+
+
+<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
+<%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn" %>
+
+
");
+ }
+ }
+}
+// [END gae_java21_users_api]
diff --git a/appengine-java21/ee8/users/src/main/webapp/WEB-INF/appengine-web.xml b/appengine-java21/ee8/users/src/main/webapp/WEB-INF/appengine-web.xml
new file mode 100644
index 00000000000..71f00b07474
--- /dev/null
+++ b/appengine-java21/ee8/users/src/main/webapp/WEB-INF/appengine-web.xml
@@ -0,0 +1,8 @@
+
+
+ java21
+
+
+
+ true
+
diff --git a/appengine-java21/ee8/users/src/main/webapp/WEB-INF/web.xml b/appengine-java21/ee8/users/src/main/webapp/WEB-INF/web.xml
new file mode 100644
index 00000000000..5fece3ce81b
--- /dev/null
+++ b/appengine-java21/ee8/users/src/main/webapp/WEB-INF/web.xml
@@ -0,0 +1,26 @@
+
+
+
+
+ userapi
+
+ true
+
diff --git a/appengine-java21/ee8/users/src/test/java/com/example/appengine/users/UsersServletTest.java b/appengine-java21/ee8/users/src/test/java/com/example/appengine/users/UsersServletTest.java
new file mode 100644
index 00000000000..e7195d3f2f2
--- /dev/null
+++ b/appengine-java21/ee8/users/src/test/java/com/example/appengine/users/UsersServletTest.java
@@ -0,0 +1,109 @@
+/*
+ * Copyright 2015 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.appengine.users;
+
+import static com.google.common.truth.Truth.assertWithMessage;
+import static org.mockito.Mockito.when;
+
+import com.google.appengine.tools.development.testing.LocalServiceTestHelper;
+import java.io.PrintWriter;
+import java.io.StringWriter;
+import javax.management.remote.JMXPrincipal;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.JUnit4;
+import org.mockito.Mock;
+import org.mockito.MockitoAnnotations;
+
+/**
+ * Unit tests for {@link UsersServlet}.
+ */
+@RunWith(JUnit4.class)
+public class UsersServletTest {
+
+ private static final String FAKE_URL = "fakey.fake.fak";
+ private static final String FAKE_NAME = "Fake";
+ // Set up a helper so that the ApiProxy returns a valid environment for local testing.
+ private final LocalServiceTestHelper helper = new LocalServiceTestHelper();
+
+ @Mock
+ private HttpServletRequest mockRequestNotLoggedIn;
+ @Mock
+ private HttpServletRequest mockRequestLoggedIn;
+ @Mock
+ private HttpServletResponse mockResponse;
+ private StringWriter responseWriter;
+ private UsersServlet servletUnderTest;
+
+ @Before
+ public void setUp() throws Exception {
+ MockitoAnnotations.openMocks(this);
+ helper.setUp();
+
+ // Set up some fake HTTP requests
+ // If the user isn't logged in, use this request
+ when(mockRequestNotLoggedIn.getRequestURI()).thenReturn(FAKE_URL);
+ when(mockRequestNotLoggedIn.getUserPrincipal()).thenReturn(null);
+
+ // If the user is logged in, use this request
+ when(mockRequestLoggedIn.getRequestURI()).thenReturn(FAKE_URL);
+ // Most of the classes that implement Principal have been
+ // deprecated. JMXPrincipal seems like a safe choice.
+ when(mockRequestLoggedIn.getUserPrincipal()).thenReturn(new JMXPrincipal(FAKE_NAME));
+
+ // Set up a fake HTTP response.
+ responseWriter = new StringWriter();
+ when(mockResponse.getWriter()).thenReturn(new PrintWriter(responseWriter));
+
+ servletUnderTest = new UsersServlet();
+ }
+
+ @After
+ public void tearDown() {
+ helper.tearDown();
+ }
+
+ @Test
+ public void doGet_userNotLoggedIn_writesResponse() throws Exception {
+ servletUnderTest.doGet(mockRequestNotLoggedIn, mockResponse);
+
+ // If a user isn't logged in, we expect a prompt
+ // to login to be returned.
+ assertWithMessage("UsersServlet response")
+ .that(responseWriter.toString())
+ .contains("
");
+ }
+
+ @Test
+ public void doGet_userLoggedIn_writesResponse() throws Exception {
+ servletUnderTest.doGet(mockRequestLoggedIn, mockResponse);
+
+ // If a user is logged in, we expect a prompt
+ // to logout to be returned.
+ assertWithMessage("UsersServlet response")
+ .that(responseWriter.toString())
+ .contains("
We add a @Parent to tell the object about its ancestor. We are doing this to support many
- * guestbooks. Objectify, unlike the AppEngine library requires that you specify the fields you want
- * to index using @Index. Only indexing the fields you need can lead to substantial gains in
- * performance -- though if not indexing your data from the start will require indexing it later.
- *
- *
NOTE - all the properties are PUBLIC so that can keep the code simple.
- */
-@Entity
-public class Greeting {
-
- @Parent
- Key theBook;
- @Id
- public Long id;
-
- public String authorEmail;
- public String authorId;
- public String content;
- @Index
- public Date date;
-
- /**
- * Simple constructor just sets the date.
- */
- public Greeting() {
- date = new Date();
- }
-
- /**
- * A convenience constructor.
- */
- public Greeting(String book, String content) {
- this();
- if (book != null) {
- theBook = Key.create(Guestbook.class, book); // Creating the Ancestor key
- } else {
- theBook = Key.create(Guestbook.class, "default");
- }
- this.content = content;
- }
-
- /**
- * Construct a Greeting with all params.
- *
- * @param book .
- * @param content .
- * @param id .
- * @param email .
- */
- public Greeting(String book, String content, String id, String email) {
- this(book, content);
- authorEmail = email;
- authorId = id;
- }
-}
-//[END all]
diff --git a/appengine-java8/multitenancy/src/main/java/com/example/appengine/Guestbook.java b/appengine-java8/multitenancy/src/main/java/com/example/appengine/Guestbook.java
deleted file mode 100644
index 40840fa7a21..00000000000
--- a/appengine-java8/multitenancy/src/main/java/com/example/appengine/Guestbook.java
+++ /dev/null
@@ -1,36 +0,0 @@
-/*
- * Copyright 2015 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.
- */
-
-//[START all]
-
-package com.example.appengine;
-
-import com.googlecode.objectify.annotation.Entity;
-import com.googlecode.objectify.annotation.Id;
-
-/**
- * The @Entity tells Objectify about our entity. We also register it in OfyHelper.java -- very
- * important.
- *
- *
This is never actually created, but gives a hint to Objectify about our Ancestor key.
- */
-@Entity
-public class Guestbook {
-
- @Id
- public String book;
-}
-//[END all]
diff --git a/appengine-java8/multitenancy/src/main/java/com/example/appengine/MultitenancyServlet.java b/appengine-java8/multitenancy/src/main/java/com/example/appengine/MultitenancyServlet.java
deleted file mode 100644
index 8cdc4d7a470..00000000000
--- a/appengine-java8/multitenancy/src/main/java/com/example/appengine/MultitenancyServlet.java
+++ /dev/null
@@ -1,111 +0,0 @@
-/*
- * Copyright 2016 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.
- */
-
-package com.example.appengine;
-
-import com.google.appengine.api.NamespaceManager;
-import com.google.appengine.api.memcache.MemcacheService;
-import com.google.appengine.api.memcache.MemcacheServiceFactory;
-import com.google.appengine.api.search.Index;
-import com.google.appengine.api.search.IndexSpec;
-import com.google.appengine.api.search.SearchService;
-import com.google.appengine.api.search.SearchServiceConfig;
-import com.google.appengine.api.search.SearchServiceFactory;
-import com.google.appengine.api.users.UserServiceFactory;
-import java.io.IOException;
-import java.io.PrintWriter;
-import javax.servlet.http.HttpServlet;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
-
-// [START example]
-@SuppressWarnings("serial")
-public class MultitenancyServlet extends HttpServlet {
-
- @Override
- public void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
- String namespace;
-
- PrintWriter out = resp.getWriter();
- out.println("Code Snippets -- not yet fully runnable as an app");
-
- // [START temp_namespace]
- // Set the namepace temporarily to "abc"
- String oldNamespace = NamespaceManager.get();
- NamespaceManager.set("abc");
- try {
- // ... perform operation using current namespace ...
- } finally {
- NamespaceManager.set(oldNamespace);
- }
- // [END temp_namespace]
-
- // [START per_user_namespace]
- if (com.google.appengine.api.NamespaceManager.get() == null) {
- // Assuming there is a logged in user.
- namespace = UserServiceFactory.getUserService().getCurrentUser().getUserId();
- NamespaceManager.set(namespace);
- }
- // [END per_user_namespace]
- String value = "something here";
-
- // [START ns_memcache]
- // Create a MemcacheService that uses the current namespace by
- // calling NamespaceManager.get() for every access.
- MemcacheService current = MemcacheServiceFactory.getMemcacheService();
-
- // stores value in namespace "abc"
- oldNamespace = NamespaceManager.get();
- NamespaceManager.set("abc");
- try {
- current.put("key", value); // stores value in namespace “abc”
- } finally {
- NamespaceManager.set(oldNamespace);
- }
- // [END ns_memcache]
-
- // [START specific_memcache]
- // Create a MemcacheService that uses the namespace "abc".
- MemcacheService explicit = MemcacheServiceFactory.getMemcacheService("abc");
- explicit.put("key", value); // stores value in namespace "abc"
- // [END specific_memcache]
-
- //[START searchns]
- // Set the current namespace to "aSpace"
- NamespaceManager.set("aSpace");
- // Create a SearchService with the namespace "aSpace"
- SearchService searchService = SearchServiceFactory.getSearchService();
- // Create an IndexSpec
- IndexSpec indexSpec = IndexSpec.newBuilder().setName("myIndex").build();
- // Create an Index with the namespace "aSpace"
- Index index = searchService.getIndex(indexSpec);
- // [END searchns]
-
- // [START searchns_2]
- // Create a SearchServiceConfig, specifying the namespace "anotherSpace"
- SearchServiceConfig config =
- SearchServiceConfig.newBuilder().setNamespace("anotherSpace").build();
- // Create a SearchService with the namespace "anotherSpace"
- searchService = SearchServiceFactory.getSearchService(config);
- // Create an IndexSpec
- indexSpec = IndexSpec.newBuilder().setName("myindex").build();
- // Create an Index with the namespace "anotherSpace"
- index = searchService.getIndex(indexSpec);
- // [END searchns_2]
-
- }
-}
-// [END example]
diff --git a/appengine-java8/multitenancy/src/main/java/com/example/appengine/NamespaceFilter.java b/appengine-java8/multitenancy/src/main/java/com/example/appengine/NamespaceFilter.java
deleted file mode 100644
index 17e84e90620..00000000000
--- a/appengine-java8/multitenancy/src/main/java/com/example/appengine/NamespaceFilter.java
+++ /dev/null
@@ -1,52 +0,0 @@
-/*
- * Copyright 2016 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.
- */
-
-package com.example.appengine;
-
-import com.google.appengine.api.NamespaceManager;
-import java.io.IOException;
-import javax.servlet.Filter;
-import javax.servlet.FilterChain;
-import javax.servlet.FilterConfig;
-import javax.servlet.ServletException;
-import javax.servlet.ServletRequest;
-import javax.servlet.ServletResponse;
-
-// [START nsfilter]
-// Filter to set the Google Apps domain as the namespace.
-public class NamespaceFilter implements Filter {
-
- @Override
- public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
- throws IOException, ServletException {
- // Make sure set() is only called if the current namespace is not already set.
- if (NamespaceManager.get() == null) {
- // If your app is hosted on appspot, this will be empty. Otherwise it will be the domain
- // the app is hosted on.
- NamespaceManager.set(NamespaceManager.getGoogleAppsNamespace());
- }
- chain.doFilter(req, res); // Pass request back down the filter chain
- }
- // [END nsfilter]
-
- @Override
- public void init(FilterConfig filterConfig) throws ServletException {
- }
-
- @Override
- public void destroy() {
- }
-}
diff --git a/appengine-java8/multitenancy/src/main/java/com/example/appengine/OfyHelper.java b/appengine-java8/multitenancy/src/main/java/com/example/appengine/OfyHelper.java
deleted file mode 100644
index 7585fc5b454..00000000000
--- a/appengine-java8/multitenancy/src/main/java/com/example/appengine/OfyHelper.java
+++ /dev/null
@@ -1,48 +0,0 @@
-/*
- * Copyright 2015 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.
- */
-
-//[START all]
-
-package com.example.appengine;
-
-import com.googlecode.objectify.ObjectifyService;
-import javax.servlet.ServletContextEvent;
-import javax.servlet.ServletContextListener;
-
-/**
- * OfyHelper, a ServletContextListener, is setup in web.xml to run before a JSP is run. This is
- * required to let JSP's access Ofy.
- */
-public class OfyHelper implements ServletContextListener {
-
- /**
- * A ServletContextListener initializer.
- *
- * @param event .
- */
- public void contextInitialized(ServletContextEvent event) {
- // This will be invoked as part of a warmup request, or the first user request if no warmup
- // request.
- ObjectifyService.init();
- ObjectifyService.register(Guestbook.class);
- ObjectifyService.register(Greeting.class);
- }
-
- public void contextDestroyed(ServletContextEvent event) {
- // App Engine does not currently invoke this method.
- }
-}
-//[END all]
diff --git a/appengine-java8/multitenancy/src/main/java/com/example/appengine/SignGuestbookServlet.java b/appengine-java8/multitenancy/src/main/java/com/example/appengine/SignGuestbookServlet.java
deleted file mode 100644
index 0e452b20d32..00000000000
--- a/appengine-java8/multitenancy/src/main/java/com/example/appengine/SignGuestbookServlet.java
+++ /dev/null
@@ -1,59 +0,0 @@
-/*
- * Copyright 2015 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.
- */
-
-//[START all]
-
-package com.example.appengine;
-
-import com.google.appengine.api.users.User;
-import com.google.appengine.api.users.UserService;
-import com.google.appengine.api.users.UserServiceFactory;
-import com.googlecode.objectify.ObjectifyService;
-import java.io.IOException;
-import javax.servlet.http.HttpServlet;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
-
-/**
- * Form Handling Servlet - most of the action for this sample is in webapp/guestbook.jsp. It
- * displays {@link Greeting}'s.
- */
-public class SignGuestbookServlet extends HttpServlet {
-
- // Process the http POST of the form
- @Override
- public void doPost(HttpServletRequest req, HttpServletResponse resp) throws IOException {
- Greeting greeting;
-
- UserService userService = UserServiceFactory.getUserService();
- User user = userService.getCurrentUser(); // Find out who the user is.
-
- String guestbookName = req.getParameter("guestbookName");
- String content = req.getParameter("content");
- if (user != null) {
- greeting = new Greeting(guestbookName, content, user.getUserId(), user.getEmail());
- } else {
- greeting = new Greeting(guestbookName, content);
- }
-
- // Use Objectify to save the greeting and now() is used to make the call synchronously as we
- // will immediately get a new page using redirect and we want the data to be present.
- ObjectifyService.ofy().save().entity(greeting).now();
-
- resp.sendRedirect("/guestbook.jsp?guestbookName=" + guestbookName);
- }
-}
-//[END all]
diff --git a/appengine-java8/multitenancy/src/main/java/com/example/appengine/SomeRequestServlet.java b/appengine-java8/multitenancy/src/main/java/com/example/appengine/SomeRequestServlet.java
deleted file mode 100644
index 2bfa418cfd0..00000000000
--- a/appengine-java8/multitenancy/src/main/java/com/example/appengine/SomeRequestServlet.java
+++ /dev/null
@@ -1,53 +0,0 @@
-/*
- * Copyright 2016 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.
- */
-
-package com.example.appengine;
-
-import com.google.appengine.api.NamespaceManager;
-import com.google.appengine.api.taskqueue.QueueFactory;
-import com.google.appengine.api.taskqueue.TaskOptions;
-import java.io.IOException;
-import javax.servlet.http.HttpServlet;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
-
-// [START tq_3]
-public class SomeRequestServlet extends HttpServlet {
-
- // Handler for URL get requests.
- @Override
- protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
-
- // Increment the count for the current namespace asynchronously.
- QueueFactory.getDefaultQueue()
- .add(TaskOptions.Builder.withUrl("/_ah/update_count").param("countName", "SomeRequest"));
- // Increment the global count and set the
- // namespace locally. The namespace is
- // transferred to the invoked request and
- // executed asynchronously.
- String namespace = NamespaceManager.get();
- try {
- NamespaceManager.set("-global-");
- QueueFactory.getDefaultQueue()
- .add(TaskOptions.Builder.withUrl("/_ah/update_count").param("countName", "SomeRequest"));
- } finally {
- NamespaceManager.set(namespace);
- }
- resp.setContentType("text/plain");
- resp.getWriter().println("Counts are being updated.");
- }
-}
-// [END tq_3]
diff --git a/appengine-java8/multitenancy/src/main/java/com/example/appengine/UpdateCountsServlet.java b/appengine-java8/multitenancy/src/main/java/com/example/appengine/UpdateCountsServlet.java
deleted file mode 100644
index 76e15d88990..00000000000
--- a/appengine-java8/multitenancy/src/main/java/com/example/appengine/UpdateCountsServlet.java
+++ /dev/null
@@ -1,107 +0,0 @@
-/*
- * Copyright 2016 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.
- */
-
-package com.example.appengine;
-
-import static com.googlecode.objectify.ObjectifyService.ofy;
-
-import com.google.appengine.api.NamespaceManager;
-import com.googlecode.objectify.annotation.Entity;
-import com.googlecode.objectify.annotation.Id;
-import com.googlecode.objectify.annotation.Index;
-import javax.servlet.http.HttpServlet;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
-
-// [START datastore]
-// [START tq_1]
-public class UpdateCountsServlet extends HttpServlet {
-
- private static final int NUM_RETRIES = 10;
-
- @Entity
- public class CounterPojo {
-
- @Id
- public Long id;
- @Index
- public String name;
- public Long count;
-
- public CounterPojo() {
- this.count = 0L;
- }
-
- public CounterPojo(String name) {
- this.name = name;
- this.count = 0L;
- }
-
- public void increment() {
- count++;
- }
- }
-
- /**
- * Increment the count in a Counter datastore entity.
- **/
- public long updateCount(String countName) {
-
- CounterPojo cp = ofy().load().type(CounterPojo.class).filter("name", countName).first().now();
- if (cp == null) {
- cp = new CounterPojo(countName);
- }
- cp.increment();
- ofy().save().entity(cp).now();
-
- return cp.count;
- }
- // [END tq_1]
-
- @Override
- protected void doGet(HttpServletRequest req, HttpServletResponse resp)
- throws java.io.IOException {
-
- // Update the count for the current namespace.
- updateCount("request");
-
- // Update the count for the "-global-" namespace.
- String namespace = NamespaceManager.get();
- try {
- // "-global-" is namespace reserved by the application.
- NamespaceManager.set("-global-");
- updateCount("request");
- } finally {
- NamespaceManager.set(namespace);
- }
- resp.setContentType("text/plain");
- resp.getWriter().println("Counts are now updated.");
- }
- // [END datastore]
-
- // [START tq_2]
- // called from Task Queue
- @Override
- protected void doPost(HttpServletRequest req, HttpServletResponse resp) {
- String[] countName = req.getParameterValues("countName");
- if (countName.length != 1) {
- resp.setStatus(HttpServletResponse.SC_BAD_REQUEST);
- return;
- }
- updateCount(countName[0]);
- }
- // [END tq_2]
-}
diff --git a/appengine-java8/multitenancy/src/main/webapp/WEB-INF/appengine-web.xml b/appengine-java8/multitenancy/src/main/webapp/WEB-INF/appengine-web.xml
deleted file mode 100644
index b85f72b69e3..00000000000
--- a/appengine-java8/multitenancy/src/main/webapp/WEB-INF/appengine-web.xml
+++ /dev/null
@@ -1,9 +0,0 @@
-
-
- java8
- true
-
-
-
-
-
diff --git a/appengine-java8/multitenancy/src/main/webapp/WEB-INF/logging.properties b/appengine-java8/multitenancy/src/main/webapp/WEB-INF/logging.properties
deleted file mode 100644
index a17206681f0..00000000000
--- a/appengine-java8/multitenancy/src/main/webapp/WEB-INF/logging.properties
+++ /dev/null
@@ -1,13 +0,0 @@
-# A default java.util.logging configuration.
-# (All App Engine logging is through java.util.logging by default).
-#
-# To use this configuration, copy it into your application's WEB-INF
-# folder and add the following to your appengine-web.xml:
-#
-#
-#
-#
-#
-
-# Set the default logging level for all loggers to WARNING
-.level = WARNING
diff --git a/appengine-java8/multitenancy/src/main/webapp/WEB-INF/web.xml b/appengine-java8/multitenancy/src/main/webapp/WEB-INF/web.xml
deleted file mode 100644
index c8853530ceb..00000000000
--- a/appengine-java8/multitenancy/src/main/webapp/WEB-INF/web.xml
+++ /dev/null
@@ -1,66 +0,0 @@
-
-
-
-
-
-
- sign
- com.example.appengine.SignGuestbookServlet
-
-
-
- sign
- /sign
-
-
-
- guestbook.jsp
-
-
-
-
-
- ObjectifyFilter
- com.googlecode.objectify.ObjectifyFilter
-
-
- ObjectifyFilter
- /*
-
-
- com.example.appengine.OfyHelper
-
-
-
-
-
-
- NamespaceFilter
- com.example.appengine.NamespaceFilter
-
-
-
- NamespaceFilter
- /sign
-
-
-
-
diff --git a/appengine-java8/multitenancy/src/main/webapp/guestbook.jsp b/appengine-java8/multitenancy/src/main/webapp/guestbook.jsp
deleted file mode 100644
index 317ba765ddc..00000000000
--- a/appengine-java8/multitenancy/src/main/webapp/guestbook.jsp
+++ /dev/null
@@ -1,106 +0,0 @@
-<%-- //[START all]--%>
-<%@ page contentType="text/html;charset=UTF-8" language="java" %>
-<%@ page import="com.google.appengine.api.users.User" %>
-<%@ page import="com.google.appengine.api.users.UserService" %>
-<%@ page import="com.google.appengine.api.users.UserServiceFactory" %>
-
-<%-- //[START imports]--%>
-<%@ page import="com.example.appengine.Greeting" %>
-<%@ page import="com.example.appengine.Guestbook" %>
-<%@ page import="com.googlecode.objectify.Key" %>
-<%@ page import="com.googlecode.objectify.ObjectifyService" %>
-<%-- //[END imports]--%>
-
-<%@ page import="java.util.List" %>
-<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
-
-
-
Hello, ${fn:escapeXml(user.nickname)}! (You can
- sign out.)
-<%
- } else {
-%>
-
Hello!
- Sign in
- to include your name with greetings you post.
-<%
- }
-%>
-
-<%-- //[START datastore]--%>
-<%
- // Create the correct Ancestor key
- Key theBook = Key.create(Guestbook.class, guestbookName);
-
- // Run an ancestor query to ensure we see the most up-to-date
- // view of the Greetings belonging to the selected Guestbook.
- List greetings = ObjectifyService.ofy()
- .load()
- .type(Greeting.class) // We want only Greetings
- .ancestor(theBook) // Anyone in this book
- .order("-date") // Most recent first - date is indexed.
- .limit(5) // Only show 5 of them.
- .list();
-
- if (greetings.isEmpty()) {
-%>
-
Guestbook '${fn:escapeXml(guestbookName)}' has no messages.
-<%
- } else {
-%>
-
Messages in Guestbook '${fn:escapeXml(guestbookName)}'.
-<%
- }
- }
-%>
-
-
-<%-- //[END datastore]--%>
-
-
-
-
-<%-- //[END all]--%>
diff --git a/appengine-java8/multitenancy/src/main/webapp/stylesheets/main.css b/appengine-java8/multitenancy/src/main/webapp/stylesheets/main.css
deleted file mode 100644
index 05d72d5536d..00000000000
--- a/appengine-java8/multitenancy/src/main/webapp/stylesheets/main.css
+++ /dev/null
@@ -1,4 +0,0 @@
-body {
- font-family: Verdana, Helvetica, sans-serif;
- background-color: #FFFFCC;
-}
diff --git a/appengine-java8/multitenancy/src/test/java/com/example/appengine/GreetingTest.java b/appengine-java8/multitenancy/src/test/java/com/example/appengine/GreetingTest.java
deleted file mode 100644
index 09d27914899..00000000000
--- a/appengine-java8/multitenancy/src/test/java/com/example/appengine/GreetingTest.java
+++ /dev/null
@@ -1,84 +0,0 @@
-/*
- * Copyright 2016 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.
- */
-
-package com.example.appengine;
-
-import static com.example.appengine.GuestbookTestUtilities.cleanDatastore;
-import static org.junit.Assert.assertEquals;
-
-import com.google.appengine.api.datastore.DatastoreService;
-import com.google.appengine.api.datastore.DatastoreServiceFactory;
-import com.google.appengine.tools.development.testing.LocalDatastoreServiceTestConfig;
-import com.google.appengine.tools.development.testing.LocalServiceTestHelper;
-import com.googlecode.objectify.Key;
-import com.googlecode.objectify.ObjectifyService;
-import com.googlecode.objectify.util.Closeable;
-import org.junit.After;
-import org.junit.Before;
-import org.junit.Test;
-import org.junit.runner.RunWith;
-import org.junit.runners.JUnit4;
-
-@RunWith(JUnit4.class)
-public class GreetingTest {
-
- private static final String TEST_CONTENT = "The world is Blue today";
-
- private final LocalServiceTestHelper helper =
- new LocalServiceTestHelper(
- // Set no eventual consistency, that way queries return all results.
- // https://cloud.google
- // .com/appengine/docs/java/tools/localunittesting
- // #Java_Writing_High_Replication_Datastore_tests
- new LocalDatastoreServiceTestConfig()
- .setDefaultHighRepJobPolicyUnappliedJobPercentage(0));
-
- private Closeable closeable;
- private DatastoreService ds;
-
- @Before
- public void setUp() throws Exception {
-
- helper.setUp();
- ds = DatastoreServiceFactory.getDatastoreService();
-
- ObjectifyService.init();
- ObjectifyService.register(Guestbook.class);
- ObjectifyService.register(Greeting.class);
-
- closeable = ObjectifyService.begin();
-
- cleanDatastore(ds, "default");
- }
-
- @After
- public void tearDown() {
- cleanDatastore(ds, "default");
- helper.tearDown();
- closeable.close();
- }
-
- @Test
- public void createSaveObject() throws Exception {
-
- Greeting g = new Greeting("default", TEST_CONTENT);
- ObjectifyService.ofy().save().entity(g).now();
-
- Greeting greeting = ObjectifyService.ofy().load().type(Greeting.class).ancestor(
- Key.create(Guestbook.class, "default")).first().now();
- assertEquals(greeting.content, TEST_CONTENT);
- }
-}
diff --git a/appengine-java8/multitenancy/src/test/java/com/example/appengine/GuestbookTestUtilities.java b/appengine-java8/multitenancy/src/test/java/com/example/appengine/GuestbookTestUtilities.java
deleted file mode 100644
index 9dcafcc102b..00000000000
--- a/appengine-java8/multitenancy/src/test/java/com/example/appengine/GuestbookTestUtilities.java
+++ /dev/null
@@ -1,45 +0,0 @@
-/*
- * Copyright 2016 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.
- */
-
-package com.example.appengine;
-
-import com.google.appengine.api.datastore.DatastoreService;
-import com.google.appengine.api.datastore.Entity;
-import com.google.appengine.api.datastore.FetchOptions;
-import com.google.appengine.api.datastore.Key;
-import com.google.appengine.api.datastore.KeyFactory;
-import com.google.appengine.api.datastore.PreparedQuery;
-import com.google.appengine.api.datastore.Query;
-import java.util.ArrayList;
-import java.util.List;
-
-public class GuestbookTestUtilities {
-
- public static void cleanDatastore(DatastoreService ds, String book) {
- Query query =
- new Query("Greeting")
- .setAncestor(new KeyFactory.Builder("Guestbook", book).getKey())
- .setKeysOnly();
- PreparedQuery pq = ds.prepare(query);
- List entities = pq.asList(FetchOptions.Builder.withDefaults());
- ArrayList keys = new ArrayList<>(entities.size());
-
- for (Entity e : entities) {
- keys.add(e.getKey());
- }
- ds.delete(keys);
- }
-}
diff --git a/appengine-java8/multitenancy/src/test/java/com/example/appengine/SignGuestbookServletTest.java b/appengine-java8/multitenancy/src/test/java/com/example/appengine/SignGuestbookServletTest.java
deleted file mode 100644
index e964411adec..00000000000
--- a/appengine-java8/multitenancy/src/test/java/com/example/appengine/SignGuestbookServletTest.java
+++ /dev/null
@@ -1,113 +0,0 @@
-/*
- * Copyright 2015 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.
- */
-
-package com.example.appengine;
-
-import static com.example.appengine.GuestbookTestUtilities.cleanDatastore;
-import static org.junit.Assert.assertEquals;
-import static org.mockito.Mockito.when;
-
-import com.google.appengine.api.datastore.DatastoreService;
-import com.google.appengine.api.datastore.DatastoreServiceFactory;
-import com.google.appengine.tools.development.testing.LocalDatastoreServiceTestConfig;
-import com.google.appengine.tools.development.testing.LocalServiceTestHelper;
-import com.googlecode.objectify.Key;
-import com.googlecode.objectify.ObjectifyService;
-import com.googlecode.objectify.util.Closeable;
-import java.io.PrintWriter;
-import java.io.StringWriter;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
-import org.junit.After;
-import org.junit.Before;
-import org.junit.Test;
-import org.junit.runner.RunWith;
-import org.junit.runners.JUnit4;
-import org.mockito.Mock;
-import org.mockito.MockitoAnnotations;
-
-/**
- * Unit tests for {@link com.example.appengine.SignGuestbookServlet}.
- */
-@RunWith(JUnit4.class)
-public class SignGuestbookServletTest {
-
- private static final String FAKE_URL = "fakey.org/sign";
-
- private final LocalServiceTestHelper helper =
- new LocalServiceTestHelper(
- // Set no eventual consistency, that way queries return all results.
- // https://cloud.google
- // .com/appengine/docs/java/tools/localunittesting
- // #Java_Writing_High_Replication_Datastore_tests
- new LocalDatastoreServiceTestConfig()
- .setDefaultHighRepJobPolicyUnappliedJobPercentage(0));
-
- private static final String testPhrase = "Noew is the time";
-
- @Mock
- private HttpServletRequest mockRequest;
-
- @Mock
- private HttpServletResponse mockResponse;
-
- private StringWriter stringWriter;
- private SignGuestbookServlet servletUnderTest;
- private Closeable closeable;
- private DatastoreService ds;
-
- @Before
- public void setUp() throws Exception {
-
- MockitoAnnotations.openMocks(this);
- helper.setUp();
- ds = DatastoreServiceFactory.getDatastoreService();
-
- // Set up some fake HTTP requests
- when(mockRequest.getRequestURI()).thenReturn(FAKE_URL);
- when(mockRequest.getParameter("guestbookName")).thenReturn("default2");
- when(mockRequest.getParameter("content")).thenReturn(testPhrase);
-
- stringWriter = new StringWriter();
- when(mockResponse.getWriter()).thenReturn(new PrintWriter(stringWriter));
-
- servletUnderTest = new SignGuestbookServlet();
-
- ObjectifyService.init();
- ObjectifyService.register(Guestbook.class);
- ObjectifyService.register(Greeting.class);
-
- closeable = ObjectifyService.begin();
-
- cleanDatastore(ds, "default");
- }
-
- @After
- public void tearDown() {
- cleanDatastore(ds, "default");
- helper.tearDown();
- closeable.close();
- }
-
- @Test
- public void doPostUserNotLoggedIn() throws Exception {
- servletUnderTest.doPost(mockRequest, mockResponse);
-
- Greeting greeting = ObjectifyService.ofy().load().type(Greeting.class)
- .ancestor(Key.create(Guestbook.class, "default2")).first().now();
- assertEquals(greeting.content, testPhrase);
- }
-}
diff --git a/asset/src/test/java/com/example/asset/RealTimeFeedIT.java b/asset/src/test/java/com/example/asset/RealTimeFeedIT.java
index fbfe2057b1c..5f528404ec2 100644
--- a/asset/src/test/java/com/example/asset/RealTimeFeedIT.java
+++ b/asset/src/test/java/com/example/asset/RealTimeFeedIT.java
@@ -32,7 +32,6 @@
import org.junit.Before;
import org.junit.BeforeClass;
import org.junit.FixMethodOrder;
-import org.junit.Ignore;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.JUnit4;
@@ -42,7 +41,6 @@
@RunWith(JUnit4.class)
@SuppressWarnings("checkstyle:abbreviationaswordinname")
@FixMethodOrder(MethodSorters.NAME_ASCENDING)
-@Ignore("TODO: Fix https://github.com/GoogleCloudPlatform/java-docs-samples/issues/8963")
public class RealTimeFeedIT {
private static final String topicId = "topicId";
private static final String feedId = UUID.randomUUID().toString();
@@ -63,14 +61,16 @@ private String getProjectNumber(String projectId) {
@BeforeClass
public static void createTopic() throws Exception {
- TopicAdminClient topicAdminClient = TopicAdminClient.create();
- topicAdminClient.createTopic(topicName);
+ try (TopicAdminClient topicAdminClient = TopicAdminClient.create()) {
+ topicAdminClient.createTopic(topicName);
+ }
}
@AfterClass
public static void deleteTopic() throws Exception {
- TopicAdminClient topicAdminClient = TopicAdminClient.create();
- topicAdminClient.deleteTopic(topicName);
+ try (TopicAdminClient topicAdminClient = TopicAdminClient.create()) {
+ topicAdminClient.deleteTopic(topicName);
+ }
}
@Before
diff --git a/asset/src/test/java/com/example/asset/SearchIT.java b/asset/src/test/java/com/example/asset/SearchIT.java
index 1fa86a2b15b..0ebb2f765ce 100644
--- a/asset/src/test/java/com/example/asset/SearchIT.java
+++ b/asset/src/test/java/com/example/asset/SearchIT.java
@@ -29,7 +29,6 @@
import java.util.concurrent.TimeUnit;
import org.junit.After;
import org.junit.Before;
-import org.junit.Ignore;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.JUnit4;
@@ -67,7 +66,6 @@ public void tearDown() {
bigquery.delete(datasetId, DatasetDeleteOption.deleteContents());
}
- @Ignore("Blocked on https://github.com/GoogleCloudPlatform/java-docs-samples/issues/8798")
@Test
public void testSearchAllResourcesExample() throws Exception {
// Wait 120 seconds to let dataset creation event go to CAI
diff --git a/auth/.gitignore b/auth/.gitignore
new file mode 100644
index 00000000000..305842cb8a4
--- /dev/null
+++ b/auth/.gitignore
@@ -0,0 +1,3 @@
+# Ignore GCP and IdP secret files
+src/main/java/com/google/cloud/auth/samples/customcredentials/aws/custom-credentials-aws-secrets.json
+src/main/java/com/google/cloud/auth/samples/customcredentials/okta/custom-credentials-okta-secrets.json
diff --git a/auth/README.md b/auth/README.md
index 8ee3187d212..186970b53dd 100644
--- a/auth/README.md
+++ b/auth/README.md
@@ -35,16 +35,37 @@ You can then run a given `ClassName` via:
mvn exec:java -Dexec.mainClass=com.google.cloud.auth.samples.AuthExample
-Dexec.args="compute"
+### Analyze text sentiment using LanguageService API with API key authentication
+
+Create an API key via the [Google Cloud console:](https://developers.google.com/workspace/guides/create-credentials#api-key)
+
+Once you have an API key replace it in the main function in ApiKeyAuthExample and run the following command
+
+ mvn exec:java -Dexec.mainClass=com.google.cloud.auth.samples.ApiKeyAuthExample
+
## Downscoping with Credential Access Boundaries
The same configuration above applies.
-To run the samples for [Downscoping with Credential Access Boundaries](https://cloud.google.com/iam/docs/downscoping-short-lived-credentials)
-you must provide both a bucket name and object name under the TODO(developer): in the main method of `DownscopingExample`.
+This section provides examples for [Downscoping with Credential Access Boundaries](https://cloud.google.com/iam/docs/downscoping-short-lived-credentials).
+There are two examples demonstrating different ways to implement downscoping.
+
+**`DownscopedAccessTokenGenerator` and `DownscopedAccessTokenConsumer` Examples:**
+
+These examples demonstrate a common pattern for downscoping, using a token broker and consumer.
+The `DownscopedAccessTokenGenerator` generates the downscoped access token using a client-side approach, and the `DownscopedAccessTokenConsumer` uses it to access Cloud Storage resources.
+To run the `DownscopedAccessTokenConsumer`, you must provide a bucket name and object name under the `TODO(developer):` in the `main` method.
+You can then run `DownscopedAccessTokenConsumer` via:
+
+ mvn exec:java -Dexec.mainClass=com.google.cloud.auth.samples.DownscopedAccessTokenConsumer
+
+**`DownscopingExample` Example:**
+
+This example demonstrates downscoping using a server-side approach. To run this example you must provide both a bucket name and object name under the TODO(developer): in the main method of `DownscopingExample`.
You can then run `DownscopingExample` via:
- mvn exec:exec
+ mvn exec:java -Dexec.mainClass=com.google.cloud.auth.samples.DownscopingExample
## Tests
Run all tests:
diff --git a/auth/pom.xml b/auth/pom.xml
index bb9be513846..c943b0a1ca4 100644
--- a/auth/pom.xml
+++ b/auth/pom.xml
@@ -30,7 +30,7 @@ limitations under the License.
com.google.cloud.samplesshared-configuration
- 1.2.0
+ 1.2.2
@@ -48,7 +48,14 @@ limitations under the License.
com.google.cloudlibraries-bom
- 26.32.0
+ 26.49.0
+ pom
+ import
+
+
+ software.amazon.awssdk
+ bom
+ 2.25.41pomimport
@@ -67,11 +74,29 @@ limitations under the License.
com.google.authgoogle-auth-library-oauth2-http
+ 1.32.0
+
+
+ com.google.auth
+ google-auth-library-cab-token-generator
+ 1.32.0com.google.cloudgoogle-cloud-apikeys
+
+ com.google.cloud
+ google-cloud-language
+
+
+ software.amazon.awssdk
+ auth
+
+
+ software.amazon.awssdk
+ regions
+ junit
@@ -104,11 +129,6 @@ limitations under the License.
java
-
- -classpath
-
- com.google.cloud.auth.samples.DownscopingExample
-
diff --git a/auth/src/main/java/UndeleteApiKey.java b/auth/src/main/java/UndeleteApiKey.java
new file mode 100644
index 00000000000..cd509c705b3
--- /dev/null
+++ b/auth/src/main/java/UndeleteApiKey.java
@@ -0,0 +1,59 @@
+/*
+ * Copyright 2024 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.
+ */
+
+// [START apikeys_undelete_api_key]
+import com.google.api.apikeys.v2.ApiKeysClient;
+import com.google.api.apikeys.v2.Key;
+import com.google.api.apikeys.v2.UndeleteKeyRequest;
+import java.io.IOException;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.TimeUnit;
+import java.util.concurrent.TimeoutException;
+
+public class UndeleteApiKey {
+
+ public static void main(String[] args)
+ throws IOException, ExecutionException, InterruptedException, TimeoutException {
+ // TODO(developer): Replace these variables before running the sample.
+ // Project ID or project number of the Google Cloud project.
+ String projectId = "YOUR_PROJECT_ID";
+ // The API key id to undelete.
+ String keyId = "YOUR_KEY_ID";
+
+ undeleteApiKey(projectId, keyId);
+ }
+
+ // Undeletes an API key.
+ public static void undeleteApiKey(String projectId, String keyId)
+ throws IOException, ExecutionException, InterruptedException, TimeoutException {
+ // Initialize client that will be used to send requests. This client only needs to be created
+ // once, and can be reused for multiple requests.
+ try (ApiKeysClient apiKeysClient = ApiKeysClient.create()) {
+
+ // Initialize the undelete request and set the argument.
+ UndeleteKeyRequest undeleteKeyRequest = UndeleteKeyRequest.newBuilder()
+ .setName(String.format("projects/%s/locations/global/keys/%s", projectId, keyId))
+ .build();
+
+ // Make the request and wait for the operation to complete.
+ Key undeletedKey = apiKeysClient.undeleteKeyAsync(undeleteKeyRequest)
+ .get(3, TimeUnit.MINUTES);
+
+ System.out.printf("Successfully undeleted the API key: %s", undeletedKey.getName());
+ }
+ }
+}
+// [END apikeys_undelete_api_key]
\ No newline at end of file
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/ApiKeyAuthExample.java b/auth/src/main/java/com/google/cloud/auth/samples/ApiKeyAuthExample.java
new file mode 100644
index 00000000000..7975abad40e
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/ApiKeyAuthExample.java
@@ -0,0 +1,58 @@
+/*
+ * Copyright 2024 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.auth.samples;
+
+// [START auth_cloud_api_key]
+import com.google.cloud.language.v2.AnalyzeSentimentResponse;
+import com.google.cloud.language.v2.Document;
+import com.google.cloud.language.v2.LanguageServiceClient;
+import com.google.cloud.language.v2.LanguageServiceSettings;
+import java.io.IOException;
+
+// [END auth_cloud_api_key]
+
+/**
+ * Demonstrate how to authenticate requests using an API Key using the Language API as an example.
+ */
+public class ApiKeyAuthExample {
+
+ // [START auth_cloud_api_key]
+ static String authenticateUsingApiKey(String apiKey) throws IOException {
+ LanguageServiceSettings settings =
+ LanguageServiceSettings.newBuilder().setApiKey(apiKey).build();
+ try (LanguageServiceClient client = LanguageServiceClient.create(settings)) {
+ Document document =
+ Document.newBuilder()
+ .setContent("Hello World!")
+ .setType(Document.Type.PLAIN_TEXT)
+ .build();
+
+ AnalyzeSentimentResponse actualResponse = client.analyzeSentiment(document);
+
+ return actualResponse.getDocumentSentiment().toString();
+ }
+ }
+ // [END auth_cloud_api_key]
+
+ public static void main(String[] args) throws IOException {
+ // TODO(Developer): Before running this sample, replace the variable(s) below.
+ // API key created in developer's project.
+ String apiKey = "api-key";
+
+ authenticateUsingApiKey(apiKey);
+ }
+}
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/DownscopedAccessTokenConsumer.java b/auth/src/main/java/com/google/cloud/auth/samples/DownscopedAccessTokenConsumer.java
new file mode 100644
index 00000000000..e59f5028f18
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/DownscopedAccessTokenConsumer.java
@@ -0,0 +1,95 @@
+/*
+ * Copyright 2025 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.auth.samples;
+
+// [START auth_client_cab_consumer]
+import com.google.auth.oauth2.AccessToken;
+import com.google.auth.oauth2.OAuth2CredentialsWithRefresh;
+import com.google.cloud.storage.Blob;
+import com.google.cloud.storage.Storage;
+import com.google.cloud.storage.StorageOptions;
+import java.io.IOException;
+// [END auth_client_cab_consumer]
+
+
+/**
+ * Demonstrates retrieving a Cloud Storage blob using a downscoped. This example showcases the
+ * consumer side of the downscoping process. It retrieves a blob's content using credentials that
+ * have limited access based on a pre-defined Credential Access Boundary.
+ */
+public class DownscopedAccessTokenConsumer {
+
+ public static void main(String[] args) throws IOException {
+ // TODO(developer): Replace these variables before running the sample.
+ // The Cloud Storage bucket name.
+ String bucketName = "your-gcs-bucket-name";
+ // The Cloud Storage object name that resides in the specified bucket.
+ String objectName = "your-gcs-object-name";
+
+ retrieveBlobWithDownscopedToken(bucketName, objectName);
+ }
+
+ /**
+ * Simulates token consumer readonly access to the specified object.
+ *
+ * @param bucketName The name of the Cloud Storage bucket containing the blob.
+ * @param objectName The name of the Cloud Storage object (blob).
+ * @return The content of the blob as a String, or {@code null} if the blob does not exist.
+ * @throws IOException If an error occurs during communication with Cloud Storage or token
+ * retrieval. This can include issues with authentication, authorization, or network
+ * connectivity.
+ */
+ // [START auth_client_cab_consumer]
+ public static String retrieveBlobWithDownscopedToken(
+ final String bucketName, final String objectName) throws IOException {
+ // You can pass an `OAuth2RefreshHandler` to `OAuth2CredentialsWithRefresh` which will allow the
+ // library to seamlessly handle downscoped token refreshes on expiration.
+ OAuth2CredentialsWithRefresh.OAuth2RefreshHandler handler =
+ new OAuth2CredentialsWithRefresh.OAuth2RefreshHandler() {
+ @Override
+ public AccessToken refreshAccessToken() throws IOException {
+ // The common pattern of usage is to have a token broker pass the downscoped short-lived
+ // access tokens to a token consumer via some secure authenticated channel.
+ // For illustration purposes, we are generating the downscoped token locally.
+ // We want to test the ability to limit access to objects with a certain prefix string
+ // in the resource bucket. objectName.substring(0, 3) is the prefix here. This field is
+ // not required if access to all bucket resources are allowed. If access to limited
+ // resources in the bucket is needed, this mechanism can be used.
+ return DownscopedAccessTokenGenerator
+ .getTokenFromBroker(bucketName, objectName);
+ }
+ };
+
+ AccessToken downscopedToken = handler.refreshAccessToken();
+
+ OAuth2CredentialsWithRefresh credentials =
+ OAuth2CredentialsWithRefresh.newBuilder()
+ .setAccessToken(downscopedToken)
+ .setRefreshHandler(handler)
+ .build();
+
+ StorageOptions options = StorageOptions.newBuilder().setCredentials(credentials).build();
+ Storage storage = options.getService();
+
+ Blob blob = storage.get(bucketName, objectName);
+ if (blob == null) {
+ return null;
+ }
+ return new String(blob.getContent());
+ }
+ // [END auth_client_cab_consumer]
+}
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/DownscopedAccessTokenGenerator.java b/auth/src/main/java/com/google/cloud/auth/samples/DownscopedAccessTokenGenerator.java
new file mode 100644
index 00000000000..3564bb6b3d3
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/DownscopedAccessTokenGenerator.java
@@ -0,0 +1,97 @@
+/*
+ * Copyright 2025 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.auth.samples;
+
+// [START auth_client_cab_token_broker]
+import com.google.auth.credentialaccessboundary.ClientSideCredentialAccessBoundaryFactory;
+import com.google.auth.oauth2.AccessToken;
+import com.google.auth.oauth2.CredentialAccessBoundary;
+import com.google.auth.oauth2.GoogleCredentials;
+import dev.cel.common.CelValidationException;
+import java.io.IOException;
+import java.security.GeneralSecurityException;
+// [END auth_client_cab_token_broker]
+
+/**
+ * Demonstrates how to use ClientSideCredentialAccessBoundaryFactory to generate downscoped tokens.
+ */
+public class DownscopedAccessTokenGenerator {
+
+ /**
+ * Simulates a token broker generating downscoped tokens for specific objects in a bucket.
+ *
+ * @param bucketName The name of the Cloud Storage bucket.
+ * @param objectPrefix Prefix of the object name for downscoped token access.
+ * @return An AccessToken representing the downscoped token.
+ * @throws IOException If an error occurs during token generation.
+ */
+ // [START auth_client_cab_token_broker]
+ public static AccessToken getTokenFromBroker(String bucketName, String objectPrefix)
+ throws IOException {
+ // Retrieve the source credentials from ADC.
+ GoogleCredentials sourceCredentials =
+ GoogleCredentials.getApplicationDefault()
+ .createScoped("https://www.googleapis.com/auth/cloud-platform");
+
+ // Initialize the Credential Access Boundary rules.
+ String availableResource = "//storage.googleapis.com/projects/_/buckets/" + bucketName;
+
+ // Downscoped credentials will have readonly access to the resource.
+ String availablePermission = "inRole:roles/storage.objectViewer";
+
+ // Only objects starting with the specified prefix string in the object name will be allowed
+ // read access.
+ String expression =
+ "resource.name.startsWith('projects/_/buckets/"
+ + bucketName
+ + "/objects/"
+ + objectPrefix
+ + "')";
+
+ // Build the AvailabilityCondition.
+ CredentialAccessBoundary.AccessBoundaryRule.AvailabilityCondition availabilityCondition =
+ CredentialAccessBoundary.AccessBoundaryRule.AvailabilityCondition.newBuilder()
+ .setExpression(expression)
+ .build();
+
+ // Define the single access boundary rule using the above properties.
+ CredentialAccessBoundary.AccessBoundaryRule rule =
+ CredentialAccessBoundary.AccessBoundaryRule.newBuilder()
+ .setAvailableResource(availableResource)
+ .addAvailablePermission(availablePermission)
+ .setAvailabilityCondition(availabilityCondition)
+ .build();
+
+ // Define the Credential Access Boundary with all the relevant rules.
+ CredentialAccessBoundary credentialAccessBoundary =
+ CredentialAccessBoundary.newBuilder().addRule(rule).build();
+
+ // Create an instance of ClientSideCredentialAccessBoundaryFactory.
+ ClientSideCredentialAccessBoundaryFactory factory =
+ ClientSideCredentialAccessBoundaryFactory.newBuilder()
+ .setSourceCredential(sourceCredentials)
+ .build();
+
+ // Generate the token and pass it to the Token Consumer.
+ try {
+ return factory.generateToken(credentialAccessBoundary);
+ } catch (GeneralSecurityException | CelValidationException e) {
+ throw new IOException("Error generating downscoped token", e);
+ }
+ }
+ // [END auth_client_cab_token_broker]
+}
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/CustomCredentialSupplierAwsWorkload.java b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/CustomCredentialSupplierAwsWorkload.java
new file mode 100644
index 00000000000..82f4836da58
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/CustomCredentialSupplierAwsWorkload.java
@@ -0,0 +1,237 @@
+/*
+ * Copyright 2025 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.auth.samples.customcredentials.aws;
+
+// [START auth_custom_credential_supplier_aws]
+import com.google.auth.oauth2.AwsCredentials;
+import com.google.auth.oauth2.AwsSecurityCredentials;
+import com.google.auth.oauth2.AwsSecurityCredentialsSupplier;
+import com.google.auth.oauth2.ExternalAccountSupplierContext;
+import com.google.auth.oauth2.GoogleCredentials;
+import com.google.cloud.storage.Bucket;
+import com.google.cloud.storage.Storage;
+import com.google.cloud.storage.StorageOptions;
+import com.google.gson.Gson;
+import com.google.gson.reflect.TypeToken;
+import java.io.IOException;
+import java.io.Reader;
+import java.lang.reflect.Type;
+import java.nio.file.Files;
+import java.nio.file.Paths;
+import java.util.Map;
+import software.amazon.awssdk.auth.credentials.AwsCredentialsProvider;
+import software.amazon.awssdk.auth.credentials.AwsSessionCredentials;
+import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider;
+import software.amazon.awssdk.regions.Region;
+import software.amazon.awssdk.regions.providers.DefaultAwsRegionProviderChain;
+
+// [END auth_custom_credential_supplier_aws]
+
+/**
+ * This sample demonstrates how to use a custom AWS security credentials supplier to authenticate to
+ * Google Cloud Storage using AWS Workload Identity Federation.
+ */
+public class CustomCredentialSupplierAwsWorkload {
+
+ public static void main(String[] args) throws IOException {
+
+ // Reads the custom-credentials-aws-secrets.json if running locally.
+ loadConfigFromFile();
+
+ // The audience for the workload identity federation.
+ // Format: //iam.googleapis.com/projects//locations/global/
+ // workloadIdentityPools//providers/
+ String gcpWorkloadAudience = getConfiguration("GCP_WORKLOAD_AUDIENCE");
+
+ // The bucket to fetch data from.
+ String gcsBucketName = getConfiguration("GCS_BUCKET_NAME");
+
+ // (Optional) The service account impersonation URL.
+ String saImpersonationUrl = getConfiguration("GCP_SERVICE_ACCOUNT_IMPERSONATION_URL");
+
+ if (gcpWorkloadAudience == null || gcsBucketName == null) {
+ System.err.println(
+ "Required configuration missing. Please provide it in a "
+ + "custom-credentials-aws-secrets.json file or as environment variables: "
+ + "GCP_WORKLOAD_AUDIENCE, GCS_BUCKET_NAME");
+ return;
+ }
+
+ try {
+ System.out.println("Retrieving metadata for bucket: " + gcsBucketName + "...");
+ Bucket bucket =
+ authenticateWithAwsCredentials(gcpWorkloadAudience, saImpersonationUrl, gcsBucketName);
+
+ System.out.println(" --- SUCCESS! ---");
+ System.out.println("Bucket details:");
+ System.out.printf(" Name: %s%n", bucket.getName());
+ System.out.printf(" Location: %s%n", bucket.getLocation());
+ System.out.printf(" Storage Class: %s%n", bucket.getStorageClass());
+ System.out.printf(" Metageneration: %s%n", bucket.getMetageneration());
+ } catch (Exception e) {
+ System.err.println("Authentication or Request failed: " + e.getMessage());
+ }
+ }
+
+ /**
+ * Helper method to retrieve configuration. It checks Environment variables first, then System
+ * properties (populated by loadConfigFromFile).
+ */
+ static String getConfiguration(String key) {
+ String value = System.getenv(key);
+ if (value == null) {
+ value = System.getProperty(key);
+ }
+ return value;
+ }
+
+ /**
+ * If a local secrets file is present, load it into the System Properties. This is a
+ * "just-in-time" configuration for local development. These variables are only set for the
+ * current process.
+ */
+ static void loadConfigFromFile() {
+ // By default, this expects the file to be in the project root.
+ String secretsFilePath = "custom-credentials-aws-secrets.json";
+ if (!Files.exists(Paths.get(secretsFilePath))) {
+ return;
+ }
+
+ try (Reader reader = Files.newBufferedReader(Paths.get(secretsFilePath))) {
+ // Use Gson to parse the JSON file into a Map
+ Gson gson = new Gson();
+ Type type = new TypeToken>() {}.getType();
+ Map secrets = gson.fromJson(reader, type);
+
+ if (secrets == null) {
+ return;
+ }
+
+ // AWS SDK for Java looks for System Properties with specific names (camelCase)
+ // if environment variables are missing.
+ if (secrets.containsKey("aws_access_key_id")) {
+ System.setProperty("aws.accessKeyId", secrets.get("aws_access_key_id"));
+ }
+ if (secrets.containsKey("aws_secret_access_key")) {
+ System.setProperty("aws.secretAccessKey", secrets.get("aws_secret_access_key"));
+ }
+ if (secrets.containsKey("aws_region")) {
+ System.setProperty("aws.region", secrets.get("aws_region"));
+ }
+
+ // Set custom GCP variables as System Properties so getConfiguration() can find them.
+ if (secrets.containsKey("gcp_workload_audience")) {
+ System.setProperty("GCP_WORKLOAD_AUDIENCE", secrets.get("gcp_workload_audience"));
+ }
+ if (secrets.containsKey("gcs_bucket_name")) {
+ System.setProperty("GCS_BUCKET_NAME", secrets.get("gcs_bucket_name"));
+ }
+ if (secrets.containsKey("gcp_service_account_impersonation_url")) {
+ System.setProperty(
+ "GCP_SERVICE_ACCOUNT_IMPERSONATION_URL",
+ secrets.get("gcp_service_account_impersonation_url"));
+ }
+
+ } catch (IOException e) {
+ System.err.println("Error reading secrets file: " + e.getMessage());
+ }
+ }
+
+ /**
+ * Authenticates using a custom AWS credential supplier and retrieves bucket metadata.
+ *
+ * @param gcpWorkloadAudience The WIF provider audience.
+ * @param saImpersonationUrl Optional service account impersonation URL.
+ * @param gcsBucketName The GCS bucket name.
+ * @return The Bucket object containing metadata.
+ * @throws IOException If authentication fails.
+ */
+ // [START auth_custom_credential_supplier_aws]
+ public static Bucket authenticateWithAwsCredentials(
+ String gcpWorkloadAudience, String saImpersonationUrl, String gcsBucketName)
+ throws IOException {
+
+ CustomAwsSupplier customSupplier = new CustomAwsSupplier();
+
+ AwsCredentials.Builder credentialsBuilder =
+ AwsCredentials.newBuilder()
+ .setAudience(gcpWorkloadAudience)
+ // This token type indicates that the subject token is an AWS Signature Version 4 signed
+ // request. This is required for AWS Workload Identity Federation.
+ .setSubjectTokenType("urn:ietf:params:aws:token-type:aws4_request")
+ .setAwsSecurityCredentialsSupplier(customSupplier);
+
+ if (saImpersonationUrl != null) {
+ credentialsBuilder.setServiceAccountImpersonationUrl(saImpersonationUrl);
+ }
+
+ GoogleCredentials credentials = credentialsBuilder.build();
+
+ Storage storage = StorageOptions.newBuilder().setCredentials(credentials).build().getService();
+
+ return storage.get(gcsBucketName);
+ }
+
+ /**
+ * Custom AWS Security Credentials Supplier.
+ *
+ *
This implementation resolves AWS credentials and regions using the default provider chains
+ * from the AWS SDK (v2). This supports environment variables, ~/.aws/credentials, and EC2/EKS
+ * metadata.
+ */
+ private static class CustomAwsSupplier implements AwsSecurityCredentialsSupplier {
+ private final AwsCredentialsProvider awsCredentialsProvider;
+ private String region;
+
+ public CustomAwsSupplier() {
+ // The AWS SDK handles caching internally.
+ this.awsCredentialsProvider = DefaultCredentialsProvider.create();
+ }
+
+ @Override
+ public String getRegion(ExternalAccountSupplierContext context) {
+ if (this.region == null) {
+ Region awsRegion = new DefaultAwsRegionProviderChain().getRegion();
+ if (awsRegion == null) {
+ throw new IllegalStateException(
+ "Unable to resolve AWS region. Ensure AWS_REGION is set or configured.");
+ }
+ this.region = awsRegion.id();
+ }
+ return this.region;
+ }
+
+ @Override
+ public AwsSecurityCredentials getCredentials(ExternalAccountSupplierContext context) {
+ software.amazon.awssdk.auth.credentials.AwsCredentials credentials =
+ this.awsCredentialsProvider.resolveCredentials();
+
+ if (credentials == null) {
+ throw new IllegalStateException("Unable to resolve AWS credentials.");
+ }
+
+ String sessionToken = null;
+ if (credentials instanceof AwsSessionCredentials) {
+ sessionToken = ((AwsSessionCredentials) credentials).sessionToken();
+ }
+
+ return new AwsSecurityCredentials(
+ credentials.accessKeyId(), credentials.secretAccessKey(), sessionToken);
+ }
+ }
+ // [END auth_custom_credential_supplier_aws]
+}
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/Dockerfile b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/Dockerfile
new file mode 100644
index 00000000000..50849a38ac3
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/Dockerfile
@@ -0,0 +1,21 @@
+FROM maven:3.9-eclipse-temurin-17 AS builder
+
+WORKDIR /app
+
+COPY pom.xml .
+COPY src ./src
+
+RUN mvn clean package dependency:copy-dependencies \
+ -DoutputDirectory=target/libs \
+ -DskipTests
+
+FROM eclipse-temurin:17.0.17_10-jre
+
+RUN useradd -m appuser
+USER appuser
+WORKDIR /app
+
+COPY --from=builder --chown=appuser:appuser /app/target/auth-1.0.jar app.jar
+COPY --from=builder --chown=appuser:appuser /app/target/libs lib/
+
+CMD ["java", "-cp", "app.jar:lib/*", "com.google.cloud.auth.samples.customcredentials.aws.CustomCredentialSupplierAwsWorkload"]
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/README.md b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/README.md
new file mode 100644
index 00000000000..6dd7d5428c8
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/README.md
@@ -0,0 +1,124 @@
+# Running the Custom AWS Credential Supplier Sample (Java)
+
+This sample demonstrates how to use a custom AWS security credential supplier to authenticate with Google Cloud using AWS as an external identity provider. It uses the **AWS SDK for Java (v2)** to fetch credentials from sources like Amazon Elastic Kubernetes Service (EKS) with IAM Roles for Service Accounts (IRSA), Elastic Container Service (ECS), or Fargate.
+
+## Prerequisites
+
+* An AWS account.
+* A Google Cloud project with the IAM API enabled.
+* A GCS bucket.
+* **Java 11** or later installed.
+* **Maven** installed.
+
+If you want to use AWS security credentials that cannot be retrieved using methods supported natively by the Google Auth library, a custom `AwsSecurityCredentialsSupplier` implementation may be specified. The supplier must return valid, unexpired AWS security credentials when called by the Google Cloud Auth library.
+
+## Running Locally
+
+For local development, you can provide credentials and configuration in a JSON file.
+
+### Build the Project
+
+Ensure you have Java and Maven installed, then build the project to download dependencies and create an executable JAR:
+
+```bash
+mvn clean package
+```
+
+### Configure Credentials for Local Development
+
+1. Copy the example secrets file to a new file named `custom-credentials-aws-secrets.json` in the project root:
+ ```bash
+ cp custom-credentials-aws-secrets.json.example custom-credentials-aws-secrets.json
+ ```
+2. Open `custom-credentials-aws-secrets.json` and fill in the required values for your AWS and Google Cloud configuration. Do not check your `custom-credentials-aws-secrets.json` file into version control.
+
+**Note:** This file is only used for local development and is not needed when running in a containerized environment like EKS with IRSA.
+
+### Run the Application
+
+Execute the JAR file generated in the `target` directory:
+
+```bash
+java -jar target/custom-credential-aws-1.0-SNAPSHOT.jar
+```
+
+*Note: Adjust the JAR filename version if you modified it in your `pom.xml`.*
+
+When run locally, the application will detect the `custom-credentials-aws-secrets.json` file and use it to configure the necessary system properties for the AWS SDK.
+
+## Running in a Containerized Environment (EKS)
+
+This section provides a brief overview of how to run the sample in an Amazon EKS cluster.
+
+### EKS Cluster Setup
+
+First, you need an EKS cluster. You can create one using `eksctl` or the AWS Management Console. For detailed instructions, refer to the [Amazon EKS documentation](https://docs.aws.amazon.com/eks/latest/userguide/create-cluster.html).
+
+### Configure IAM Roles for Service Accounts (IRSA)
+
+IRSA enables you to associate an IAM role with a Kubernetes service account. This provides a secure way for your pods to access AWS services without hardcoding long-lived credentials.
+
+Run the following command to create the IAM role and bind it to a Kubernetes Service Account:
+
+```bash
+eksctl create iamserviceaccount \
+ --name your-k8s-service-account \
+ --namespace default \
+ --cluster your-cluster-name \
+ --region your-aws-region \
+ --role-name your-role-name \
+ --attach-policy-arn arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess \
+ --approve
+```
+
+> **Note**: The `--attach-policy-arn` flag is used here to demonstrate attaching permissions. Update this with the specific AWS policy ARN your application requires.
+
+For a deep dive into how this works without using `eksctl`, refer to the [IAM Roles for Service Accounts](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html) documentation.
+
+### Configure Google Cloud to Trust the AWS Role
+
+To allow your AWS role to authenticate as a Google Cloud service account, you need to configure Workload Identity Federation. This process involves these key steps:
+
+1. **Create a Workload Identity Pool and an AWS Provider:** The pool holds the configuration, and the provider is set up to trust your AWS account.
+
+2. **Create or select a Google Cloud Service Account:** This service account will be impersonated by your AWS role.
+
+3. **Bind the AWS Role to the Google Cloud Service Account:** Create an IAM policy binding that gives your AWS role the `Workload Identity User` (`roles/iam.workloadIdentityUser`) role on the Google Cloud service account.
+
+For more detailed information, see the documentation on [Configuring Workload Identity Federation](https://cloud.google.com/iam/docs/workload-identity-federation-with-other-clouds).
+
+### Containerize and Package the Application
+
+Create a `Dockerfile` for the Java application and push the image to a container registry (for example Amazon ECR) that your EKS cluster can access.
+
+**Note:** The provided [`Dockerfile`](Dockerfile) is an example that may need modification for your specific needs.
+
+Build and push the image:
+```bash
+docker build -t your-container-image:latest .
+docker push your-container-image:latest
+```
+
+### Deploy to EKS
+
+Create a Kubernetes deployment manifest to deploy your application to the EKS cluster. See the [`pod.yaml`](pod.yaml) file for an example.
+
+**Note:** The provided [`pod.yaml`](pod.yaml) is an example and may need to be modified for your specific needs.
+
+Deploy the pod:
+
+```bash
+kubectl apply -f pod.yaml
+```
+
+### Clean Up
+
+To clean up the resources, delete the EKS cluster and any other AWS and Google Cloud resources you created.
+
+```bash
+eksctl delete cluster --name your-cluster-name
+```
+
+## Testing
+
+This sample is not continuously tested. It is provided for instructional purposes and may require modifications to work in your environment.
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/custom-credentials-aws-secrets.json.example b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/custom-credentials-aws-secrets.json.example
new file mode 100644
index 00000000000..300dc70c138
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/custom-credentials-aws-secrets.json.example
@@ -0,0 +1,8 @@
+{
+ "aws_access_key_id": "YOUR_AWS_ACCESS_KEY_ID",
+ "aws_secret_access_key": "YOUR_AWS_SECRET_ACCESS_KEY",
+ "aws_region": "YOUR_AWS_REGION",
+ "gcp_workload_audience": "YOUR_GCP_WORKLOAD_AUDIENCE",
+ "gcs_bucket_name": "YOUR_GCS_BUCKET_NAME",
+ "gcp_service_account_impersonation_url": "YOUR_GCP_SERVICE_ACCOUNT_IMPERSONATION_URL"
+}
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/pod.yaml b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/pod.yaml
new file mode 100644
index 00000000000..7cc35c293ca
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/aws/pod.yaml
@@ -0,0 +1,44 @@
+# Copyright 2025 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.
+
+apiVersion: v1
+kind: Pod
+metadata:
+ name: custom-credential-pod-java
+spec:
+ # The Kubernetes Service Account that is annotated with the corresponding
+ # AWS IAM role ARN. See the README for instructions on setting up IAM
+ # Roles for Service Accounts (IRSA).
+ serviceAccountName: your-k8s-service-account
+ containers:
+ - name: gcp-auth-sample-java
+ # The container image pushed to the container registry
+ # For example, Amazon Elastic Container Registry
+ image: your-container-image:latest
+ env:
+ # REQUIRED: The AWS region. The AWS SDK for Java requires this
+ # to be set explicitly in containers.
+ - name: AWS_REGION
+ value: "your-aws-region"
+
+ # REQUIRED: The full identifier of the Workload Identity Pool provider
+ - name: GCP_WORKLOAD_AUDIENCE
+ value: "your-gcp-workload-audience"
+
+ # OPTIONAL: Enable Google Cloud service account impersonation
+ # - name: GCP_SERVICE_ACCOUNT_IMPERSONATION_URL
+ # value: "your-gcp-service-account-impersonation-url"
+
+ # REQUIRED: The bucket to list
+ - name: GCS_BUCKET_NAME
+ value: "your-gcs-bucket-name"
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/okta/CustomCredentialSupplierOktaWorkload.java b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/okta/CustomCredentialSupplierOktaWorkload.java
new file mode 100644
index 00000000000..e628a90ba8f
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/okta/CustomCredentialSupplierOktaWorkload.java
@@ -0,0 +1,306 @@
+/*
+ * Copyright 2025 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.auth.samples.customcredentials.okta;
+
+// [START auth_custom_credential_supplier_okta]
+import com.google.api.client.json.GenericJson;
+import com.google.api.client.json.gson.GsonFactory;
+import com.google.auth.oauth2.ExternalAccountSupplierContext;
+import com.google.auth.oauth2.GoogleCredentials;
+import com.google.auth.oauth2.IdentityPoolCredentials;
+import com.google.auth.oauth2.IdentityPoolSubjectTokenSupplier;
+import com.google.cloud.storage.Bucket;
+import com.google.cloud.storage.Storage;
+import com.google.cloud.storage.StorageOptions;
+import com.google.gson.Gson;
+import com.google.gson.JsonSyntaxException;
+import com.google.gson.reflect.TypeToken;
+import java.io.BufferedReader;
+import java.io.DataOutputStream;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.io.Reader;
+import java.lang.reflect.Type;
+import java.net.HttpURLConnection;
+import java.net.URL;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Paths;
+import java.time.Instant;
+import java.util.Base64;
+import java.util.Map;
+
+// [END auth_custom_credential_supplier_okta]
+
+/**
+ * This sample demonstrates how to use a custom subject token supplier to authenticate to Google
+ * Cloud Storage, using Okta as the identity provider.
+ */
+public class CustomCredentialSupplierOktaWorkload {
+
+ public static void main(String[] args) throws IOException {
+
+ // Reads the custom-credentials-okta-secrets.json if running locally.
+ loadConfigFromFile();
+
+ // The audience for the workload identity federation.
+ // Format: //iam.googleapis.com/projects//locations/global/
+ // workloadIdentityPools//providers/
+ String gcpWorkloadAudience = getConfiguration("GCP_WORKLOAD_AUDIENCE");
+
+ // The bucket to fetch data from.
+ String gcsBucketName = getConfiguration("GCS_BUCKET_NAME");
+
+ // (Optional) The service account impersonation URL.
+ String saImpersonationUrl = getConfiguration("GCP_SERVICE_ACCOUNT_IMPERSONATION_URL");
+
+ // Okta Configuration
+ String oktaDomain = getConfiguration("OKTA_DOMAIN");
+ String oktaClientId = getConfiguration("OKTA_CLIENT_ID");
+ String oktaClientSecret = getConfiguration("OKTA_CLIENT_SECRET");
+
+ if (gcpWorkloadAudience == null
+ || gcsBucketName == null
+ || oktaDomain == null
+ || oktaClientId == null
+ || oktaClientSecret == null) {
+ System.err.println(
+ "Error: Missing required configuration. "
+ + "Please provide it in a custom-credentials-okta-secrets.json file or as "
+ + "environment variables: GCP_WORKLOAD_AUDIENCE, GCS_BUCKET_NAME, "
+ + "OKTA_DOMAIN, OKTA_CLIENT_ID, OKTA_CLIENT_SECRET");
+ return;
+ }
+
+ try {
+ System.out.println("Getting metadata for bucket: " + gcsBucketName + "...");
+ Bucket bucket =
+ authenticateWithOktaCredentials(
+ gcpWorkloadAudience,
+ saImpersonationUrl,
+ gcsBucketName,
+ oktaDomain,
+ oktaClientId,
+ oktaClientSecret);
+
+ System.out.println(" --- SUCCESS! ---");
+ System.out.printf("Bucket Name: %s%n", bucket.getName());
+ System.out.printf("Bucket Location: %s%n", bucket.getLocation());
+ } catch (Exception e) {
+ System.err.println("Authentication or Request failed: " + e.getMessage());
+ }
+ }
+
+ /**
+ * Helper method to retrieve configuration. It checks Environment variables first, then System
+ * properties (populated by loadConfigFromFile).
+ */
+ static String getConfiguration(String key) {
+ String value = System.getenv(key);
+ if (value == null) {
+ value = System.getProperty(key);
+ }
+ return value;
+ }
+
+ /**
+ * If a local secrets file is present, load it into the System Properties. This is a
+ * "just-in-time" configuration for local development. These variables are only set for the
+ * current process.
+ */
+ static void loadConfigFromFile() {
+ // By default, this expects the file to be in the project root.
+ String secretsFilePath = "custom-credentials-okta-secrets.json";
+ if (!Files.exists(Paths.get(secretsFilePath))) {
+ return;
+ }
+
+ try (Reader reader = Files.newBufferedReader(Paths.get(secretsFilePath))) {
+ Gson gson = new Gson();
+ Type type = new TypeToken>() {}.getType();
+ Map secrets = gson.fromJson(reader, type);
+
+ if (secrets == null) {
+ return;
+ }
+
+ // Map JSON keys (snake_case) to System Properties (UPPER_UNDERSCORE)
+ if (secrets.containsKey("gcp_workload_audience")) {
+ System.setProperty("GCP_WORKLOAD_AUDIENCE", secrets.get("gcp_workload_audience"));
+ }
+ if (secrets.containsKey("gcs_bucket_name")) {
+ System.setProperty("GCS_BUCKET_NAME", secrets.get("gcs_bucket_name"));
+ }
+ if (secrets.containsKey("gcp_service_account_impersonation_url")) {
+ System.setProperty(
+ "GCP_SERVICE_ACCOUNT_IMPERSONATION_URL",
+ secrets.get("gcp_service_account_impersonation_url"));
+ }
+ if (secrets.containsKey("okta_domain")) {
+ System.setProperty("OKTA_DOMAIN", secrets.get("okta_domain"));
+ }
+ if (secrets.containsKey("okta_client_id")) {
+ System.setProperty("OKTA_CLIENT_ID", secrets.get("okta_client_id"));
+ }
+ if (secrets.containsKey("okta_client_secret")) {
+ System.setProperty("OKTA_CLIENT_SECRET", secrets.get("okta_client_secret"));
+ }
+
+ } catch (IOException e) {
+ System.err.println("Error reading secrets file: " + e.getMessage());
+ } catch (JsonSyntaxException e) {
+ System.err.println("Error: File is not valid JSON.");
+ }
+ }
+
+ /**
+ * Authenticates using a custom Okta credential supplier and retrieves bucket metadata.
+ *
+ * @param gcpWorkloadAudience The WIF provider audience.
+ * @param saImpersonationUrl Optional service account impersonation URL.
+ * @param gcsBucketName The GCS bucket name.
+ * @param oktaDomain The Okta organization domain.
+ * @param oktaClientId The Okta application Client ID.
+ * @param oktaClientSecret The Okta application Client Secret.
+ * @return The Bucket object containing metadata.
+ * @throws IOException If authentication or the API request fails.
+ */
+ // [START auth_custom_credential_supplier_okta]
+ public static Bucket authenticateWithOktaCredentials(
+ String gcpWorkloadAudience,
+ String saImpersonationUrl,
+ String gcsBucketName,
+ String oktaDomain,
+ String oktaClientId,
+ String oktaClientSecret)
+ throws IOException {
+
+ OktaClientCredentialsSupplier oktaSupplier =
+ new OktaClientCredentialsSupplier(oktaDomain, oktaClientId, oktaClientSecret);
+
+ IdentityPoolCredentials.Builder credentialsBuilder =
+ IdentityPoolCredentials.newBuilder()
+ .setAudience(gcpWorkloadAudience)
+ // This token type indicates that the subject token is a JSON Web Token (JWT).
+ // This is required for Workload Identity Federation with an OIDC provider like Okta.
+ .setSubjectTokenType("urn:ietf:params:oauth:token-type:jwt")
+ .setTokenUrl("https://sts.googleapis.com/v1/token")
+ .setSubjectTokenSupplier(oktaSupplier);
+
+ if (saImpersonationUrl != null) {
+ credentialsBuilder.setServiceAccountImpersonationUrl(saImpersonationUrl);
+ }
+
+ GoogleCredentials credentials = credentialsBuilder.build();
+
+ Storage storage = StorageOptions.newBuilder().setCredentials(credentials).build().getService();
+
+ return storage.get(gcsBucketName);
+ }
+
+ /**
+ * A custom SubjectTokenSupplier that authenticates with Okta using the Client Credentials grant
+ * flow.
+ */
+ private static class OktaClientCredentialsSupplier implements IdentityPoolSubjectTokenSupplier {
+
+ private static final long TOKEN_REFRESH_BUFFER_SECONDS = 60;
+
+ private final String oktaTokenUrl;
+ private final String clientId;
+ private final String clientSecret;
+ private String accessToken;
+ private Instant expiryTime;
+
+ public OktaClientCredentialsSupplier(String domain, String clientId, String clientSecret) {
+ // Ensure domain doesn't have a trailing slash for cleaner URL construction
+ String cleanedDomain =
+ domain.endsWith("/") ? domain.substring(0, domain.length() - 1) : domain;
+ this.oktaTokenUrl = cleanedDomain + "/oauth2/default/v1/token";
+ this.clientId = clientId;
+ this.clientSecret = clientSecret;
+ }
+
+ /**
+ * Main method called by the auth library. It will fetch a new token if one is not already
+ * cached.
+ */
+ @Override
+ public String getSubjectToken(ExternalAccountSupplierContext context) throws IOException {
+ // Check if the current token is still valid (with a 60-second buffer).
+ boolean isTokenValid =
+ this.accessToken != null
+ && this.expiryTime != null
+ && Instant.now().isBefore(this.expiryTime.minusSeconds(TOKEN_REFRESH_BUFFER_SECONDS));
+
+ if (isTokenValid) {
+ return this.accessToken;
+ }
+
+ fetchOktaAccessToken();
+ return this.accessToken;
+ }
+
+ /**
+ * Performs the Client Credentials grant flow by making a POST request to Okta's token endpoint.
+ */
+ private void fetchOktaAccessToken() throws IOException {
+ URL url = new URL(this.oktaTokenUrl);
+ HttpURLConnection conn = (HttpURLConnection) url.openConnection();
+ conn.setRequestMethod("POST");
+ conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
+ conn.setRequestProperty("Accept", "application/json");
+
+ // The client_id and client_secret are sent in a Basic Auth header.
+ String auth = this.clientId + ":" + this.clientSecret;
+ String encodedAuth =
+ Base64.getEncoder().encodeToString(auth.getBytes(StandardCharsets.UTF_8));
+ conn.setRequestProperty("Authorization", "Basic " + encodedAuth);
+
+ conn.setDoOutput(true);
+ try (java.io.OutputStream out = conn.getOutputStream()) {
+ // Scopes define the permissions the access token will have.
+ // Update "gcp.test.read" to match your Okta configuration.
+ String params = "grant_type=client_credentials&scope=gcp.test.read";
+ out.write(params.getBytes(StandardCharsets.UTF_8));
+ out.flush();
+ }
+
+ int responseCode = conn.getResponseCode();
+ if (responseCode == HttpURLConnection.HTTP_OK) {
+ try (BufferedReader in =
+ new BufferedReader(
+ new InputStreamReader(conn.getInputStream(), StandardCharsets.UTF_8))) {
+
+ GenericJson jsonObject =
+ GsonFactory.getDefaultInstance().createJsonParser(in).parse(GenericJson.class);
+
+ if (jsonObject.containsKey("access_token") && jsonObject.containsKey("expires_in")) {
+ this.accessToken = (String) jsonObject.get("access_token");
+ Number expiresInNumber = (Number) jsonObject.get("expires_in");
+ this.expiryTime = Instant.now().plusSeconds(expiresInNumber.longValue());
+ } else {
+ throw new IOException("Access token or expires_in not found in Okta response.");
+ }
+ }
+ } else {
+ throw new IOException("Failed to authenticate with Okta. Response code: " + responseCode);
+ }
+ }
+ }
+ // [END auth_custom_credential_supplier_okta]
+}
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/okta/README.md b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/okta/README.md
new file mode 100644
index 00000000000..f2992fc16ed
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/okta/README.md
@@ -0,0 +1,83 @@
+# Running the Custom Okta Credential Supplier Sample (Java)
+
+This sample demonstrates how to use a custom subject token supplier to authenticate with Google Cloud using Okta as an external identity provider. It uses the Client Credentials flow for machine-to-machine (M2M) authentication.
+
+## Prerequisites
+
+* An Okta developer account.
+* A Google Cloud project with the IAM API enabled.
+* A Google Cloud Storage bucket. Ensure that the authenticated user has access to this bucket.
+* Java 11 or later installed.
+* Maven installed.
+
+## Okta Configuration
+
+Before running the sample, you need to configure an Okta application for Machine-to-Machine (M2M) communication.
+
+### Create an M2M Application in Okta
+
+1. Log in to your Okta developer console.
+2. Navigate to **Applications** > **Applications** and click **Create App Integration**.
+3. Select **API Services** as the sign-on method and click **Next**.
+4. Give your application a name and click **Save**.
+
+### Obtain Okta Credentials
+
+Once the application is created, you will find the following information in the **General** tab:
+
+* **Okta Domain**: Your Okta developer domain (e.g., `https://dev-123456.okta.com`).
+* **Client ID**: The client ID for your application.
+* **Client Secret**: The client secret for your application.
+
+You will need these values to configure the sample.
+
+## Google Cloud Configuration
+
+You need to configure a Workload Identity Pool in Google Cloud to trust the Okta application.
+
+### Set up Workload Identity Federation
+
+1. In the Google Cloud Console, navigate to **IAM & Admin** > **Workload Identity Federation**.
+2. Click **Create Pool** to create a new Workload Identity Pool.
+3. Add a new **OIDC provider** to the pool.
+4. Configure the provider with your Okta domain as the issuer URL.
+5. Map the Okta `sub` (subject) assertion to a GCP principal.
+
+For detailed instructions, refer to the [Workload Identity Federation documentation](https://cloud.google.com/iam/docs/workload-identity-federation).
+
+## Running the Sample
+
+To run the sample on your local system, you need to build the project and provide configuration via a secrets file.
+
+### 1. Build the Project
+
+This command compiles your code and downloads all dependencies.
+```bash
+mvn clean package
+```
+
+### Configure Credentials for Local Development
+
+1. Copy the example secrets file to a new file named `custom-credentials-okta-secrets.json` in the project root:
+ ```bash
+ cp custom-credentials-okta-secrets.json.example custom-credentials-okta-secrets.json
+ ```
+2. Open `custom-credentials-okta-secrets.json` and fill in the required values for your AWS and Google Cloud configuration. Do not check your `custom-credentials-okta-secrets.json` file into version control.
+
+### 3. Run the Application
+
+First, generate the classpath file:
+```bash
+mvn dependency:build-classpath -Dmdep.outputFile=cp.txt
+```
+
+Now, run the application, providing the generated classpath:
+```bash
+java -cp "target/auth-1.0.jar:$(cat cp.txt)" com.google.cloud.auth.samples.customcredentials.okta.CustomCredentialSupplierOktaWorkload
+```
+
+The script will detect the `custom-credentials-okta-secrets.json` file, authenticate with Okta to get an OIDC token, exchange it for a Google Cloud federated token, and retrieve metadata for your GCS bucket.
+
+## Testing
+
+This sample is not continuously tested. It is provided for instructional purposes and may require modifications to work in your environment.
diff --git a/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/okta/custom-credentials-okta-secrets.json.example b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/okta/custom-credentials-okta-secrets.json.example
new file mode 100644
index 00000000000..5564fab6333
--- /dev/null
+++ b/auth/src/main/java/com/google/cloud/auth/samples/customcredentials/okta/custom-credentials-okta-secrets.json.example
@@ -0,0 +1,8 @@
+{
+ "okta_domain": "https://your-okta-domain.okta.com",
+ "okta_client_id": "your-okta-client-id",
+ "okta_client_secret": "your-okta-client-secret",
+ "gcp_workload_audience": "//iam.googleapis.com/projects/123456789/locations/global/workloadIdentityPools/my-pool/providers/my-provider",
+ "gcs_bucket_name": "your-gcs-bucket-name",
+ "gcp_service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/my-service-account@my-project.iam.gserviceaccount.com:generateAccessToken"
+}
\ No newline at end of file
diff --git a/auth/src/test/java/ApiKeySnippetsIT.java b/auth/src/test/java/ApiKeySnippetsIT.java
index 46a059d2203..7f65313d0e1 100644
--- a/auth/src/test/java/ApiKeySnippetsIT.java
+++ b/auth/src/test/java/ApiKeySnippetsIT.java
@@ -36,7 +36,6 @@
public class ApiKeySnippetsIT {
private static final String PROJECT_ID = System.getenv("GOOGLE_CLOUD_PROJECT");
- private static final String CREDENTIALS = System.getenv("GOOGLE_APPLICATION_CREDENTIALS");
private static Key API_KEY;
private static String API_KEY_STRING;
private ByteArrayOutputStream stdOut;
@@ -79,8 +78,15 @@ public static void cleanup()
String apiKeyId = getApiKeyId(API_KEY);
DeleteApiKey.deleteApiKey(PROJECT_ID, apiKeyId);
- String goal = String.format("Successfully deleted the API key: %s", API_KEY.getName());
- assertThat(stdOut.toString()).contains(goal);
+
+ UndeleteApiKey.undeleteApiKey(PROJECT_ID, apiKeyId);
+ String undeletedKey = String.format("Successfully undeleted the API key: %s",
+ API_KEY.getName());
+ assertThat(stdOut.toString()).contains(undeletedKey);
+
+ DeleteApiKey.deleteApiKey(PROJECT_ID, apiKeyId);
+ String deletedKey = String.format("Successfully deleted the API key: %s", API_KEY.getName());
+ assertThat(stdOut.toString()).contains(deletedKey);
stdOut.close();
System.setOut(out);
diff --git a/auth/src/test/java/com/google/cloud/auth/samples/AuthExampleIT.java b/auth/src/test/java/com/google/cloud/auth/samples/AuthExampleIT.java
index 7a376efe4c6..9733c259cc4 100644
--- a/auth/src/test/java/com/google/cloud/auth/samples/AuthExampleIT.java
+++ b/auth/src/test/java/com/google/cloud/auth/samples/AuthExampleIT.java
@@ -19,10 +19,15 @@
import static org.junit.Assert.assertNotNull;
import static org.junit.Assert.assertTrue;
+import com.google.api.apikeys.v2.Key;
+import com.google.api.gax.rpc.InvalidArgumentException;
+import com.google.cloud.ServiceOptions;
+import io.grpc.StatusRuntimeException;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.PrintStream;
import org.junit.Before;
+import org.junit.Ignore;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.JUnit4;
@@ -57,4 +62,48 @@ public void testAuthExplicitNoPath() throws IOException {
String output = bout.toString();
assertTrue(output.contains("Buckets:"));
}
+
+ @Test
+ public void testAuthApiKey() throws IOException, IllegalStateException {
+ String projectId = ServiceOptions.getDefaultProjectId();
+ String keyDisplayName = "Test API Key";
+ String service = "language.googleapis.com";
+ String method = "google.cloud.language.v2.LanguageService.AnalyzeSentiment";
+ Key apiKey = null;
+ try {
+ apiKey = AuthTestUtils.createTestApiKey(projectId, keyDisplayName, service, method);
+
+ String output = authenticateUsingApiKeyWithRetry(apiKey.getKeyString());
+
+ assertTrue(output.contains("magnitude:"));
+ } finally {
+ if (apiKey != null) {
+ AuthTestUtils.deleteTestApiKey(apiKey.getName());
+ }
+ }
+ }
+
+ static String authenticateUsingApiKeyWithRetry(String apiKey) throws IOException {
+ int retries = 5;
+ int delay = 2000; // 2 seconds
+
+ for (int i = 0; i < retries; i++) {
+ try {
+ return ApiKeyAuthExample.authenticateUsingApiKey(apiKey);
+ } catch (StatusRuntimeException | InvalidArgumentException e) {
+ if (e.getMessage().contains("API key expired")) {
+ System.out.println("API key not yet active, retrying...");
+ try {
+ Thread.sleep(delay);
+ } catch (InterruptedException ignored) {
+ // ignore iterrupted exception and retry test
+ }
+ } else {
+ throw e;
+ }
+ }
+ }
+
+ throw new IOException("API key never became active after retries.");
+ }
}
diff --git a/auth/src/test/java/com/google/cloud/auth/samples/AuthTestUtils.java b/auth/src/test/java/com/google/cloud/auth/samples/AuthTestUtils.java
new file mode 100644
index 00000000000..09605a29605
--- /dev/null
+++ b/auth/src/test/java/com/google/cloud/auth/samples/AuthTestUtils.java
@@ -0,0 +1,64 @@
+/*
+ * Copyright 2024 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.auth.samples;
+
+import com.google.api.apikeys.v2.ApiKeysClient;
+import com.google.api.apikeys.v2.ApiTarget;
+import com.google.api.apikeys.v2.CreateKeyRequest;
+import com.google.api.apikeys.v2.Key;
+import com.google.api.apikeys.v2.LocationName;
+import com.google.api.apikeys.v2.Restrictions;
+import java.io.IOException;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Utility methods to setup data for IT auth tests.
+ */
+public class AuthTestUtils {
+
+ public static Key createTestApiKey(
+ String projectId, String keyDisplayName, String service, String method)
+ throws IllegalStateException {
+ try (ApiKeysClient apiKeysClient = ApiKeysClient.create()) {
+ Key key =
+ Key.newBuilder()
+ .setDisplayName(keyDisplayName)
+ .setRestrictions(
+ Restrictions.newBuilder()
+ .addApiTargets(
+ ApiTarget.newBuilder().setService(service).addMethods(method).build())
+ .build())
+ .build();
+
+ CreateKeyRequest createKeyRequest =
+ CreateKeyRequest.newBuilder()
+ // API keys can only be global.
+ .setParent(LocationName.of(projectId, "global").toString())
+ .setKey(key)
+ .build();
+ return apiKeysClient.createKeyAsync(createKeyRequest).get(3, TimeUnit.MINUTES);
+ } catch (Exception e) {
+ throw new IllegalStateException("Error trying to create API Key " + e.getMessage());
+ }
+ }
+
+ public static void deleteTestApiKey(String keyName) throws IOException {
+ try (ApiKeysClient apiKeysClient = ApiKeysClient.create()) {
+ apiKeysClient.deleteKeyAsync(keyName);
+ }
+ }
+}
diff --git a/auth/src/test/java/com/google/cloud/auth/samples/DownscopedAccessTokenIT.java b/auth/src/test/java/com/google/cloud/auth/samples/DownscopedAccessTokenIT.java
new file mode 100644
index 00000000000..20c6a5be9f8
--- /dev/null
+++ b/auth/src/test/java/com/google/cloud/auth/samples/DownscopedAccessTokenIT.java
@@ -0,0 +1,80 @@
+/*
+ * Copyright 2025 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.auth.samples;
+
+import static com.google.cloud.auth.samples.DownscopedAccessTokenConsumer.retrieveBlobWithDownscopedToken;
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNotNull;
+
+import com.google.cloud.storage.Blob;
+import com.google.cloud.storage.BlobId;
+import com.google.cloud.storage.BlobInfo;
+import com.google.cloud.storage.Bucket;
+import com.google.cloud.storage.BucketInfo;
+import com.google.cloud.storage.Storage;
+import com.google.cloud.storage.StorageOptions;
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.util.UUID;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.JUnit4;
+
+@RunWith(JUnit4.class)
+// CHECKSTYLE OFF: AbbreviationAsWordInName
+public class DownscopedAccessTokenIT {
+ // CHECKSTYLE ON: AbbreviationAsWordInName
+ private static final String CONTENT = "CONTENT";
+ private Bucket bucket;
+ private Blob blob;
+
+ @Before
+ public void setUp() {
+ String credentials = System.getenv("GOOGLE_APPLICATION_CREDENTIALS");
+ assertNotNull(credentials);
+
+ // Create a bucket and object that are deleted once the test completes.
+ Storage storage = StorageOptions.newBuilder().build().getService();
+
+ String suffix = UUID.randomUUID().toString().substring(0, 18);
+ String bucketName = String.format("bucket-client-side-cab-test-%s", suffix);
+ bucket = storage.create(BucketInfo.newBuilder(bucketName).build());
+
+ String objectName = String.format("blob-client-side-cab-test-%s", suffix);
+ BlobId blobId = BlobId.of(bucketName, objectName);
+ BlobInfo blobInfo = Blob.newBuilder(blobId).build();
+ blob = storage.create(blobInfo, CONTENT.getBytes(StandardCharsets.UTF_8));
+ }
+
+ @After
+ public void cleanup() {
+ if (blob != null) {
+ blob.delete();
+ }
+ if (bucket != null) {
+ bucket.delete();
+ }
+ }
+
+ @Test
+ public void testDownscopedAccessToken() throws IOException {
+ String content = retrieveBlobWithDownscopedToken(bucket.getName(), blob.getName());
+ assertEquals(CONTENT, content);
+ }
+}
diff --git a/auth/src/test/java/com/google/cloud/auth/samples/customcredentials/aws/CustomCredentialSupplierAwsWorkloadTest.java b/auth/src/test/java/com/google/cloud/auth/samples/customcredentials/aws/CustomCredentialSupplierAwsWorkloadTest.java
new file mode 100644
index 00000000000..7dd63657302
--- /dev/null
+++ b/auth/src/test/java/com/google/cloud/auth/samples/customcredentials/aws/CustomCredentialSupplierAwsWorkloadTest.java
@@ -0,0 +1,72 @@
+/*
+ * Copyright 2025 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.auth.samples.customcredentials.aws;
+
+import static com.google.common.truth.Truth.assertThat;
+import static org.junit.Assume.assumeTrue;
+
+import com.google.cloud.storage.Bucket;
+import org.junit.BeforeClass;
+import org.junit.Test;
+
+public class CustomCredentialSupplierAwsWorkloadTest {
+
+ private static final String AUDIENCE_KEY = "GCP_WORKLOAD_AUDIENCE";
+ private static final String BUCKET_KEY = "GCS_BUCKET_NAME";
+ private static final String IMPERSONATION_KEY = "GCP_SERVICE_ACCOUNT_IMPERSONATION_URL";
+
+ @BeforeClass
+ public static void setupConfiguration() {
+ // This will load secrets.json into System Properties if the file exists.
+ CustomCredentialSupplierAwsWorkload.loadConfigFromFile();
+
+ String audience = CustomCredentialSupplierAwsWorkload.getConfiguration(AUDIENCE_KEY);
+ String bucket = CustomCredentialSupplierAwsWorkload.getConfiguration(BUCKET_KEY);
+
+ // Check for AWS specific requirements (needed by the SDK)
+ String awsKey = System.getProperty("aws.accessKeyId"); // Set by loadConfigFromFile
+ if (awsKey == null) {
+ awsKey = System.getenv("AWS_ACCESS_KEY_ID");
+ }
+
+ // Skip the test if configuration is missing (mirrors pytest.skip).
+ assumeTrue("Skipping test: " + AUDIENCE_KEY + " is missing.", audience != null);
+ assumeTrue("Skipping test: " + BUCKET_KEY + " is missing.", bucket != null);
+ assumeTrue("Skipping test: AWS Credentials not found.", awsKey != null);
+ }
+
+ @Test
+ public void testAuthenticateWithAwsCredentials_system() throws Exception {
+ // Retrieve values using the helper
+ String audience = CustomCredentialSupplierAwsWorkload.getConfiguration(AUDIENCE_KEY);
+ String bucketName = CustomCredentialSupplierAwsWorkload.getConfiguration(BUCKET_KEY);
+ String impersonationUrl =
+ CustomCredentialSupplierAwsWorkload.getConfiguration(IMPERSONATION_KEY);
+
+ // Act: Run the authentication sample
+ Bucket bucket =
+ CustomCredentialSupplierAwsWorkload.authenticateWithAwsCredentials(
+ audience, impersonationUrl, bucketName);
+
+ // Verify we got a valid bucket object back from the API
+ assertThat(bucket).isNotNull();
+ assertThat(bucket.getName()).isEqualTo(bucketName);
+
+ // Verify we can actually access metadata (proving auth worked)
+ assertThat(bucket.getLocation()).isNotNull();
+ }
+}
diff --git a/auth/src/test/java/com/google/cloud/auth/samples/customcredentials/okta/CustomCredentialSupplierOktaWorkloadTest.java b/auth/src/test/java/com/google/cloud/auth/samples/customcredentials/okta/CustomCredentialSupplierOktaWorkloadTest.java
new file mode 100644
index 00000000000..83aefdf3793
--- /dev/null
+++ b/auth/src/test/java/com/google/cloud/auth/samples/customcredentials/okta/CustomCredentialSupplierOktaWorkloadTest.java
@@ -0,0 +1,86 @@
+/*
+ * Copyright 2025 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.auth.samples.customcredentials.okta;
+
+import static com.google.common.truth.Truth.assertThat;
+import static org.junit.Assume.assumeTrue;
+
+import com.google.cloud.storage.Bucket;
+import org.junit.BeforeClass;
+import org.junit.Test;
+
+public class CustomCredentialSupplierOktaWorkloadTest {
+
+ private static final String AUDIENCE_KEY = "GCP_WORKLOAD_AUDIENCE";
+ private static final String BUCKET_KEY = "GCS_BUCKET_NAME";
+ private static final String IMPERSONATION_KEY = "GCP_SERVICE_ACCOUNT_IMPERSONATION_URL";
+
+ private static final String OKTA_DOMAIN_KEY = "OKTA_DOMAIN";
+ private static final String OKTA_CLIENT_ID_KEY = "OKTA_CLIENT_ID";
+ private static final String OKTA_CLIENT_SECRET_KEY = "OKTA_CLIENT_SECRET";
+
+ @BeforeClass
+ public static void setupConfiguration() {
+ // 1. Call the loader from the main class.
+ // This will load custom-credentials-okta-secrets.json into System Properties if the file
+ // exists.
+ CustomCredentialSupplierOktaWorkload.loadConfigFromFile();
+
+ // 2. Validate requirements using the main class's getConfiguration helper.
+ // This checks both Environment Variables and the System Properties we just loaded.
+ requireConfig(AUDIENCE_KEY);
+ requireConfig(BUCKET_KEY);
+ requireConfig(OKTA_DOMAIN_KEY);
+ requireConfig(OKTA_CLIENT_ID_KEY);
+ requireConfig(OKTA_CLIENT_SECRET_KEY);
+ }
+
+ private static void requireConfig(String key) {
+ String value = CustomCredentialSupplierOktaWorkload.getConfiguration(key);
+ assumeTrue("Skipping test: " + key + " is missing.", value != null && !value.isEmpty());
+ }
+
+ /**
+ * System Test: Verifies the full end-to-end authentication flow. This runs against the real
+ * Google Cloud and Okta APIs.
+ */
+ @Test
+ public void testAuthenticateWithOktaCredentials_system() throws Exception {
+ // Retrieve values using the helper from the main class
+ String audience = CustomCredentialSupplierOktaWorkload.getConfiguration(AUDIENCE_KEY);
+ String bucketName = CustomCredentialSupplierOktaWorkload.getConfiguration(BUCKET_KEY);
+ String impersonationUrl =
+ CustomCredentialSupplierOktaWorkload.getConfiguration(IMPERSONATION_KEY);
+
+ String oktaDomain = CustomCredentialSupplierOktaWorkload.getConfiguration(OKTA_DOMAIN_KEY);
+ String oktaClientId = CustomCredentialSupplierOktaWorkload.getConfiguration(OKTA_CLIENT_ID_KEY);
+ String oktaSecret =
+ CustomCredentialSupplierOktaWorkload.getConfiguration(OKTA_CLIENT_SECRET_KEY);
+
+ // Act: Run the authentication sample
+ Bucket bucket =
+ CustomCredentialSupplierOktaWorkload.authenticateWithOktaCredentials(
+ audience, impersonationUrl, bucketName, oktaDomain, oktaClientId, oktaSecret);
+
+ // Assert: Verify we got a valid bucket object back from the API
+ assertThat(bucket).isNotNull();
+ assertThat(bucket.getName()).isEqualTo(bucketName);
+
+ // Verify we can actually access metadata (proving auth worked)
+ assertThat(bucket.getLocation()).isNotNull();
+ }
+}
diff --git a/automl/pom.xml b/automl/pom.xml
deleted file mode 100644
index b8138df5b7c..00000000000
--- a/automl/pom.xml
+++ /dev/null
@@ -1,82 +0,0 @@
-
-
- 4.0.0
- com.example.automl
- automl-snippets
- jar
- Google Cloud Auto ML Snippets
- https://github.com/GoogleCloudPlatform/java-docs-samples/tree/main/automl
-
-
-
- com.google.cloud.samples
- shared-configuration
- 1.2.0
-
-
-
- 1.8
- 1.8
- UTF-8
-
-
-
-
-
-
-
- com.google.cloud
- libraries-bom
- 26.32.0
- pom
- import
-
-
-
-
-
-
- com.google.cloud
- google-cloud-automl
-
-
- com.google.cloud
- google-cloud-bigquery
-
-
- com.google.cloud
- google-cloud-storage
-
-
-
- net.sourceforge.argparse4j
- argparse4j
- 0.9.0
-
-
- junit
- junit
- 4.13.2
- test
-
-
- com.google.truth
- truth
- 1.4.0
- test
-
-
- com.google.cloud
- google-cloud-core
- test
- tests
-
-
-
-
-
diff --git a/automl/resources/dandelion.jpg b/automl/resources/dandelion.jpg
deleted file mode 100644
index 326e4c1bf53..00000000000
Binary files a/automl/resources/dandelion.jpg and /dev/null differ
diff --git a/automl/resources/input.txt b/automl/resources/input.txt
deleted file mode 100644
index 5aecd6590fc..00000000000
--- a/automl/resources/input.txt
+++ /dev/null
@@ -1 +0,0 @@
-Tell me how this ends
\ No newline at end of file
diff --git a/automl/resources/salad.jpg b/automl/resources/salad.jpg
deleted file mode 100644
index a7f960b5030..00000000000
Binary files a/automl/resources/salad.jpg and /dev/null differ
diff --git a/automl/resources/test.png b/automl/resources/test.png
deleted file mode 100644
index 653342a46e5..00000000000
Binary files a/automl/resources/test.png and /dev/null differ
diff --git a/automl/src/main/java/beta/automl/BatchPredict.java b/automl/src/main/java/beta/automl/BatchPredict.java
deleted file mode 100644
index 8eab116c971..00000000000
--- a/automl/src/main/java/beta/automl/BatchPredict.java
+++ /dev/null
@@ -1,84 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_batch_predict]
-// [START automl_batch_predict_beta]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1beta1.BatchPredictInputConfig;
-import com.google.cloud.automl.v1beta1.BatchPredictOutputConfig;
-import com.google.cloud.automl.v1beta1.BatchPredictRequest;
-import com.google.cloud.automl.v1beta1.BatchPredictResult;
-import com.google.cloud.automl.v1beta1.GcsDestination;
-import com.google.cloud.automl.v1beta1.GcsSource;
-import com.google.cloud.automl.v1beta1.ModelName;
-import com.google.cloud.automl.v1beta1.OperationMetadata;
-import com.google.cloud.automl.v1beta1.PredictionServiceClient;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-abstract class BatchPredict {
-
- static void batchPredict() throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- String inputUri = "gs://YOUR_BUCKET_ID/path_to_your_input_csv_or_jsonl";
- String outputUri = "gs://YOUR_BUCKET_ID/path_to_save_results/";
- batchPredict(projectId, modelId, inputUri, outputUri);
- }
-
- static void batchPredict(String projectId, String modelId, String inputUri, String outputUri)
- 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 (PredictionServiceClient client = PredictionServiceClient.create()) {
- // Get the full path of the model.
- ModelName name = ModelName.of(projectId, "us-central1", modelId);
-
- // Configure the source of the file from a GCS bucket
- GcsSource gcsSource = GcsSource.newBuilder().addInputUris(inputUri).build();
- BatchPredictInputConfig inputConfig =
- BatchPredictInputConfig.newBuilder().setGcsSource(gcsSource).build();
-
- // Configure where to store the output in a GCS bucket
- GcsDestination gcsDestination =
- GcsDestination.newBuilder().setOutputUriPrefix(outputUri).build();
- BatchPredictOutputConfig outputConfig =
- BatchPredictOutputConfig.newBuilder().setGcsDestination(gcsDestination).build();
-
- // Build the request that will be sent to the API
- BatchPredictRequest request =
- BatchPredictRequest.newBuilder()
- .setName(name.toString())
- .setInputConfig(inputConfig)
- .setOutputConfig(outputConfig)
- .build();
-
- // Start an asynchronous request
- OperationFuture future =
- client.batchPredictAsync(request);
-
- System.out.println("Waiting for operation to complete...");
- future.get();
- System.out.println("Batch Prediction results saved to specified Cloud Storage bucket.");
- }
- }
-}
-// [END automl_batch_predict_beta]
-// [END automl_tables_batch_predict]
diff --git a/automl/src/main/java/beta/automl/CancelOperation.java b/automl/src/main/java/beta/automl/CancelOperation.java
deleted file mode 100644
index 1e0e4fd2a71..00000000000
--- a/automl/src/main/java/beta/automl/CancelOperation.java
+++ /dev/null
@@ -1,48 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_cancel_operation_beta]
-
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import io.grpc.StatusRuntimeException;
-import java.io.IOException;
-
-class CancelOperation {
-
- static void cancelOperation() throws IOException, InterruptedException, StatusRuntimeException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String location = "us-central1";
- String operationId = "YOUR_OPERATION_ID";
- String operationFullId =
- String.format("projects/%s/locations/%s/operations/%s", projectId, location, operationId);
- cancelOperation(operationFullId);
- }
-
- static void cancelOperation(String operationFullId)
- throws IOException, InterruptedException, StatusRuntimeException {
- // 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()) {
- client.getOperationsClient().cancelOperation(operationFullId);
- System.out.println("Operation cancelled");
- }
- }
-}
-// [END automl_cancel_operation_beta]
diff --git a/automl/src/main/java/beta/automl/DeleteDataset.java b/automl/src/main/java/beta/automl/DeleteDataset.java
deleted file mode 100644
index 9ef47c5c2fa..00000000000
--- a/automl/src/main/java/beta/automl/DeleteDataset.java
+++ /dev/null
@@ -1,51 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_delete_dataset_beta]
-// [START automl_tables_delete_dataset]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.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_tables_delete_dataset]
-// [END automl_delete_dataset_beta]
diff --git a/automl/src/main/java/beta/automl/DeleteModel.java b/automl/src/main/java/beta/automl/DeleteModel.java
deleted file mode 100644
index 77cc99bb2c9..00000000000
--- a/automl/src/main/java/beta/automl/DeleteModel.java
+++ /dev/null
@@ -1,56 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_delete_model]
-// [START automl_delete_model_beta]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.ModelName;
-import com.google.protobuf.Empty;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class DeleteModel {
-
- public static void main(String[] args)
- 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);
- }
-
- // Delete 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_beta]
-// [END automl_tables_delete_model]
diff --git a/automl/src/main/java/beta/automl/DeployModel.java b/automl/src/main/java/beta/automl/DeployModel.java
deleted file mode 100644
index 55a3105dd1c..00000000000
--- a/automl/src/main/java/beta/automl/DeployModel.java
+++ /dev/null
@@ -1,59 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_deploy_model]
-// [START automl_deploy_model_beta]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.DeployModelRequest;
-import com.google.cloud.automl.v1beta1.ModelName;
-import com.google.cloud.automl.v1beta1.OperationMetadata;
-import com.google.protobuf.Empty;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class DeployModel {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- deployModel(projectId, modelId);
- }
-
- // Deploy a model for prediction
- static void deployModel(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);
- DeployModelRequest request =
- DeployModelRequest.newBuilder().setName(modelFullId.toString()).build();
- OperationFuture future = client.deployModelAsync(request);
-
- future.get();
- System.out.println("Model deployment finished");
- }
- }
-}
-// [END automl_deploy_model_beta]
-// [END automl_tables_deploy_model]
diff --git a/automl/src/main/java/beta/automl/GetModel.java b/automl/src/main/java/beta/automl/GetModel.java
deleted file mode 100644
index 710b78053eb..00000000000
--- a/automl/src/main/java/beta/automl/GetModel.java
+++ /dev/null
@@ -1,62 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_get_model_beta]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.Model;
-import com.google.cloud.automl.v1beta1.ModelName;
-import io.grpc.StatusRuntimeException;
-import java.io.IOException;
-
-class GetModel {
-
- static void getModel() throws IOException, StatusRuntimeException {
- // 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, StatusRuntimeException {
- // 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_beta]
diff --git a/automl/src/main/java/beta/automl/GetModelEvaluation.java b/automl/src/main/java/beta/automl/GetModelEvaluation.java
deleted file mode 100644
index 74f35f5a74e..00000000000
--- a/automl/src/main/java/beta/automl/GetModelEvaluation.java
+++ /dev/null
@@ -1,75 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_video_classification_get_model_evaluation_beta]
-// [START automl_video_object_tracking_get_model_evaluation_beta]
-// [START automl_tables_get_model_evaluation]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.ModelEvaluation;
-import com.google.cloud.automl.v1beta1.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());
-
- // [END automl_video_object_tracking_get_model_evaluation_beta]
- System.out.format(
- "Classification Model Evaluation Metrics: %s%n",
- modelEvaluation.getClassificationEvaluationMetrics());
- // [END automl_video_classification_get_model_evaluation_beta]
-
- // [START automl_video_object_tracking_get_model_evaluation_beta]
- System.out.format(
- "Video Object Tracking Evaluation Metrics: %s%n",
- modelEvaluation.getVideoObjectTrackingEvaluationMetrics());
- // [START automl_video_classification_get_model_evaluation_beta]
- }
- }
-}
-// [END automl_tables_get_model_evaluation]
-// [END automl_video_object_tracking_get_model_evaluation_beta]
-// [END automl_video_classification_get_model_evaluation_beta]
diff --git a/automl/src/main/java/beta/automl/GetOperationStatus.java b/automl/src/main/java/beta/automl/GetOperationStatus.java
deleted file mode 100644
index 77dc703407e..00000000000
--- a/automl/src/main/java/beta/automl/GetOperationStatus.java
+++ /dev/null
@@ -1,59 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_get_operation_status_beta]
-// [START automl_tables_get_operation_status]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.longrunning.Operation;
-import java.io.IOException;
-
-class GetOperationStatus {
-
- static void getOperationStatus() throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String operationFullId = "projects/[projectId]/locations/us-central1/operations/[operationId]";
- getOperationStatus(operationFullId);
- }
-
- // Get the status of an operation
- static void getOperationStatus(String operationFullId) 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 latest state of a long-running operation.
- Operation operation = client.getOperationsClient().getOperation(operationFullId);
-
- // Display operation details.
- System.out.println("Operation details:");
- System.out.format("\tName: %s%n", operation.getName());
- System.out.format("\tMetadata Type Url: %s%n", operation.getMetadata().getTypeUrl());
- System.out.format("\tDone: %s%n", operation.getDone());
- if (operation.hasResponse()) {
- System.out.format("\tResponse Type Url: %s%n", operation.getResponse().getTypeUrl());
- }
- if (operation.hasError()) {
- System.out.println("\tResponse:");
- System.out.format("\t\tError code: %s%n", operation.getError().getCode());
- System.out.format("\t\tError message: %s%n", operation.getError().getMessage());
- }
- }
- }
-}
-// [END automl_tables_get_operation_status]
-// [END automl_get_operation_status_beta]
diff --git a/automl/src/main/java/beta/automl/ImportDataset.java b/automl/src/main/java/beta/automl/ImportDataset.java
deleted file mode 100644
index 72f19b19233..00000000000
--- a/automl/src/main/java/beta/automl/ImportDataset.java
+++ /dev/null
@@ -1,90 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_import_dataset_beta]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.api.gax.retrying.RetrySettings;
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.AutoMlSettings;
-import com.google.cloud.automl.v1beta1.DatasetName;
-import com.google.cloud.automl.v1beta1.GcsSource;
-import com.google.cloud.automl.v1beta1.InputConfig;
-import com.google.cloud.automl.v1beta1.OperationMetadata;
-import com.google.protobuf.Empty;
-import java.io.IOException;
-import java.util.Arrays;
-import java.util.concurrent.ExecutionException;
-import java.util.concurrent.TimeUnit;
-import java.util.concurrent.TimeoutException;
-import org.threeten.bp.Duration;
-
-class ImportDataset {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException, TimeoutException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String datasetId = "YOUR_DATASET_ID";
- String path = "gs://BUCKET_ID/path_to_training_data.csv";
- importDataset(projectId, datasetId, path);
- }
-
- // Import a dataset
- static void importDataset(String projectId, String datasetId, String path)
- throws IOException, ExecutionException, InterruptedException, TimeoutException {
- Duration totalTimeout = Duration.ofMinutes(45);
- RetrySettings retrySettings = RetrySettings.newBuilder().setTotalTimeout(totalTimeout).build();
- AutoMlSettings.Builder builder = AutoMlSettings.newBuilder();
- builder.importDataSettings().setRetrySettings(retrySettings).build();
- AutoMlSettings settings = builder.build();
-
- // 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(settings)) {
- // Get the complete path of the dataset.
- DatasetName datasetFullId = DatasetName.of(projectId, "us-central1", datasetId);
-
- // Get multiple Google Cloud Storage URIs to import data from
- GcsSource gcsSource =
- GcsSource.newBuilder().addAllInputUris(Arrays.asList(path.split(","))).build();
-
- // Import data from the input URI
- InputConfig inputConfig = InputConfig.newBuilder().setGcsSource(gcsSource).build();
- System.out.println("Processing import...");
-
- // Start the import job
- OperationFuture operation =
- client.importDataAsync(datasetFullId, inputConfig);
-
- System.out.format("Operation name: %s%n", operation.getName());
-
- // If you want to wait for the operation to finish, adjust the timeout appropriately. The
- // operation will still run if you choose not to wait for it to complete. You can check the
- // status of your operation using the operation's name.
- Empty response = operation.get(45, TimeUnit.MINUTES);
- System.out.format("Dataset imported. %s%n", response);
- } catch (TimeoutException e) {
- System.out.println("The operation's polling period was not long enough.");
- System.out.println("You can use the Operation's name to get the current status.");
- System.out.println("The import job is still running and will complete as expected.");
- throw e;
- }
- }
-}
-// [END automl_import_dataset_beta]
diff --git a/automl/src/main/java/beta/automl/ListDatasets.java b/automl/src/main/java/beta/automl/ListDatasets.java
deleted file mode 100644
index 7e624aa6fef..00000000000
--- a/automl/src/main/java/beta/automl/ListDatasets.java
+++ /dev/null
@@ -1,87 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_video_classification_list_datasets_beta]
-// [START automl_video_object_tracking_list_datasets_beta]
-// [START automl_tables_list_datasets]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.Dataset;
-import com.google.cloud.automl.v1beta1.ListDatasetsRequest;
-import com.google.cloud.automl.v1beta1.LocationName;
-import java.io.IOException;
-
-class ListDatasets {
-
- static void listDatasets() throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- listDatasets(projectId);
- }
-
- // List the datasets
- static void listDatasets(String projectId) 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- ListDatasetsRequest request =
- ListDatasetsRequest.newBuilder().setParent(projectLocation.toString()).build();
-
- // List all the datasets available in the region by applying filter.
- System.out.println("List of datasets:");
- for (Dataset dataset : client.listDatasets(request).iterateAll()) {
- // Display the dataset information
- System.out.format("%nDataset 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("Dataset create time:");
- System.out.format("\tseconds: %s%n", dataset.getCreateTime().getSeconds());
- System.out.format("\tnanos: %s%n", dataset.getCreateTime().getNanos());
-
- // [END automl_video_object_tracking_list_datasets_beta]
- // [END automl_tables_list_datasets]
- System.out.format(
- "Video classification dataset metadata: %s%n",
- dataset.getVideoClassificationDatasetMetadata());
- // [END automl_video_classification_list_datasets_beta]
-
- // [START automl_video_object_tracking_list_datasets_beta]
- System.out.format(
- "Video object tracking dataset metadata: %s%n",
- dataset.getVideoObjectTrackingDatasetMetadata());
- // [END automl_video_object_tracking_list_datasets_beta]
-
- // [START automl_tables_list_datasets]
- System.out.format("Tables dataset metadata: %s%n", dataset.getTablesDatasetMetadata());
-
- // [START automl_video_classification_list_datasets_beta]
- // [START automl_video_object_tracking_list_datasets_beta]
- }
- }
- }
-}
-// [END automl_video_classification_list_datasets_beta]
-// [END automl_video_object_tracking_list_datasets_beta]
-// [END automl_tables_list_datasets]
diff --git a/automl/src/main/java/beta/automl/ListModelEvaluations.java b/automl/src/main/java/beta/automl/ListModelEvaluations.java
deleted file mode 100644
index 2fad4ea8e76..00000000000
--- a/automl/src/main/java/beta/automl/ListModelEvaluations.java
+++ /dev/null
@@ -1,66 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_list_model_evaluations]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.ListModelEvaluationsRequest;
-import com.google.cloud.automl.v1beta1.ModelEvaluation;
-import com.google.cloud.automl.v1beta1.ModelName;
-import java.io.IOException;
-
-class ListModelEvaluations {
-
- public static void main(String[] args) throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- listModelEvaluations(projectId, modelId);
- }
-
- // List model evaluations
- static void listModelEvaluations(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);
- ListModelEvaluationsRequest modelEvaluationsrequest =
- ListModelEvaluationsRequest.newBuilder().setParent(modelFullId.toString()).build();
-
- // List all the model evaluations in the model by applying filter.
- System.out.println("List of model evaluations:");
- for (ModelEvaluation modelEvaluation :
- client.listModelEvaluations(modelEvaluationsrequest).iterateAll()) {
-
- 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(
- "Tables Model Evaluation Metrics: %s%n",
- modelEvaluation.getClassificationEvaluationMetrics());
- }
- }
- }
-}
-// [END automl_tables_list_model_evaluations]
diff --git a/automl/src/main/java/beta/automl/ListModels.java b/automl/src/main/java/beta/automl/ListModels.java
deleted file mode 100644
index 87d1b0a7f10..00000000000
--- a/automl/src/main/java/beta/automl/ListModels.java
+++ /dev/null
@@ -1,72 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_list_models]
-// [START automl_list_models_beta]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.ListModelsRequest;
-import com.google.cloud.automl.v1beta1.LocationName;
-import com.google.cloud.automl.v1beta1.Model;
-import java.io.IOException;
-
-class ListModels {
-
- static void listModels() throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- listModels(projectId);
- }
-
- // List the models available in the specified location
- static void listModels(String projectId) 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
-
- // Create list models request.
- ListModelsRequest listModelsRequest =
- ListModelsRequest.newBuilder()
- .setParent(projectLocation.toString())
- .setFilter("")
- .build();
-
- // List all the models available in the region by applying filter.
- System.out.println("List of models:");
- for (Model model : client.listModels(listModelsRequest).iterateAll()) {
- // 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_list_models_beta]
-// [END automl_tables_list_models]
diff --git a/automl/src/main/java/beta/automl/SetEndpoint.java b/automl/src/main/java/beta/automl/SetEndpoint.java
deleted file mode 100644
index 4718b220a23..00000000000
--- a/automl/src/main/java/beta/automl/SetEndpoint.java
+++ /dev/null
@@ -1,55 +0,0 @@
-/*
- * 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 beta.automl;
-
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.AutoMlSettings;
-import com.google.cloud.automl.v1beta1.Dataset;
-import com.google.cloud.automl.v1beta1.ListDatasetsRequest;
-import com.google.cloud.automl.v1beta1.LocationName;
-import java.io.IOException;
-
-class SetEndpoint {
-
- // Change your endpoint
- static void setEndpoint(String projectId) throws IOException {
- // [START automl_set_endpoint]
- AutoMlSettings settings =
- AutoMlSettings.newBuilder().setEndpoint("eu-automl.googleapis.com:443").build();
-
- // 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.
- AutoMlClient client = AutoMlClient.create(settings);
-
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "eu");
- // [END automl_set_endpoint]
-
- ListDatasetsRequest request =
- ListDatasetsRequest.newBuilder()
- .setParent(projectLocation.toString())
- .setFilter("translation_dataset_metadata:*")
- .build();
- // List all the datasets available
- System.out.println("List of datasets:");
- for (Dataset dataset : client.listDatasets(request).iterateAll()) {
- System.out.println(dataset);
- }
- client.close();
- }
-}
diff --git a/automl/src/main/java/beta/automl/TablesBatchPredictBigQuery.java b/automl/src/main/java/beta/automl/TablesBatchPredictBigQuery.java
deleted file mode 100644
index b0bc37f262e..00000000000
--- a/automl/src/main/java/beta/automl/TablesBatchPredictBigQuery.java
+++ /dev/null
@@ -1,82 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_batch_predict_bq]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1beta1.BatchPredictInputConfig;
-import com.google.cloud.automl.v1beta1.BatchPredictOutputConfig;
-import com.google.cloud.automl.v1beta1.BatchPredictRequest;
-import com.google.cloud.automl.v1beta1.BatchPredictResult;
-import com.google.cloud.automl.v1beta1.BigQueryDestination;
-import com.google.cloud.automl.v1beta1.BigQuerySource;
-import com.google.cloud.automl.v1beta1.ModelName;
-import com.google.cloud.automl.v1beta1.OperationMetadata;
-import com.google.cloud.automl.v1beta1.PredictionServiceClient;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-abstract class TablesBatchPredictBigQuery {
-
- static void batchPredict() throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- String inputUri = "bq://YOUR_PROJECT_ID.bqDatasetID.bqTableId";
- String outputUri = "bq://YOUR_PROJECT_ID";
- batchPredict(projectId, modelId, inputUri, outputUri);
- }
-
- static void batchPredict(String projectId, String modelId, String inputUri, String outputUri)
- 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 (PredictionServiceClient client = PredictionServiceClient.create()) {
- // Get the full path of the model.
- ModelName name = ModelName.of(projectId, "us-central1", modelId);
-
- // Configure the source of the file from BigQuery
- BigQuerySource bigQuerySource = BigQuerySource.newBuilder().setInputUri(inputUri).build();
- BatchPredictInputConfig inputConfig =
- BatchPredictInputConfig.newBuilder().setBigquerySource(bigQuerySource).build();
-
- // Configure where to store the output in BigQuery
- BigQueryDestination bigQueryDestination =
- BigQueryDestination.newBuilder().setOutputUri(outputUri).build();
- BatchPredictOutputConfig outputConfig =
- BatchPredictOutputConfig.newBuilder().setBigqueryDestination(bigQueryDestination).build();
-
- // Build the request that will be sent to the API
- BatchPredictRequest request =
- BatchPredictRequest.newBuilder()
- .setName(name.toString())
- .setInputConfig(inputConfig)
- .setOutputConfig(outputConfig)
- .build();
-
- // Start an asynchronous request
- OperationFuture future =
- client.batchPredictAsync(request);
-
- System.out.println("Waiting for operation to complete...");
- future.get();
- System.out.println("Batch Prediction results saved to BigQuery.");
- }
- }
-}
-// [END automl_tables_batch_predict_bq]
diff --git a/automl/src/main/java/beta/automl/TablesCreateDataset.java b/automl/src/main/java/beta/automl/TablesCreateDataset.java
deleted file mode 100644
index b5390f33705..00000000000
--- a/automl/src/main/java/beta/automl/TablesCreateDataset.java
+++ /dev/null
@@ -1,63 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_create_dataset]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.Dataset;
-import com.google.cloud.automl.v1beta1.LocationName;
-import com.google.cloud.automl.v1beta1.TablesDatasetMetadata;
-import java.io.IOException;
-
-class TablesCreateDataset {
-
- public static void main(String[] args) throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String displayName = "YOUR_DATASET_NAME";
- createDataset(projectId, displayName);
- }
-
- // Create a dataset
- static void createDataset(String projectId, String displayName) 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- TablesDatasetMetadata metadata = TablesDatasetMetadata.newBuilder().build();
- Dataset dataset =
- Dataset.newBuilder()
- .setDisplayName(displayName)
- .setTablesDatasetMetadata(metadata)
- .build();
-
- Dataset createdDataset = client.createDataset(projectLocation, dataset);
-
- // Display the dataset information.
- System.out.format("Dataset name: %s%n", createdDataset.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 = createdDataset.getName().split("/");
- String datasetId = names[names.length - 1];
- System.out.format("Dataset id: %s%n", datasetId);
- }
- }
-}
-// [END automl_tables_create_dataset]
diff --git a/automl/src/main/java/beta/automl/TablesCreateModel.java b/automl/src/main/java/beta/automl/TablesCreateModel.java
deleted file mode 100644
index 9c95119e17a..00000000000
--- a/automl/src/main/java/beta/automl/TablesCreateModel.java
+++ /dev/null
@@ -1,92 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_create_model]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.ColumnSpec;
-import com.google.cloud.automl.v1beta1.ColumnSpecName;
-import com.google.cloud.automl.v1beta1.LocationName;
-import com.google.cloud.automl.v1beta1.Model;
-import com.google.cloud.automl.v1beta1.OperationMetadata;
-import com.google.cloud.automl.v1beta1.TablesModelMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class TablesCreateModel {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String datasetId = "YOUR_DATASET_ID";
- String tableSpecId = "YOUR_TABLE_SPEC_ID";
- String columnSpecId = "YOUR_COLUMN_SPEC_ID";
- String displayName = "YOUR_DATASET_NAME";
- createModel(projectId, datasetId, tableSpecId, columnSpecId, displayName);
- }
-
- // Create a model
- static void createModel(
- String projectId,
- String datasetId,
- String tableSpecId,
- String columnSpecId,
- String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
-
- // Get the complete path of the column.
- ColumnSpecName columnSpecName =
- ColumnSpecName.of(projectId, "us-central1", datasetId, tableSpecId, columnSpecId);
-
- // Build the get column spec.
- ColumnSpec targetColumnSpec =
- ColumnSpec.newBuilder().setName(columnSpecName.toString()).build();
-
- // Set model metadata.
- TablesModelMetadata metadata =
- TablesModelMetadata.newBuilder()
- .setTargetColumnSpec(targetColumnSpec)
- .setTrainBudgetMilliNodeHours(24000)
- .build();
-
- Model model =
- Model.newBuilder()
- .setDisplayName(displayName)
- .setDatasetId(datasetId)
- .setTablesModelMetadata(metadata)
- .build();
-
- // Create a model with the model metadata in the region.
- OperationFuture future =
- client.createModelAsync(projectLocation, model);
- // OperationFuture.get() will block until the model is created, which may take several hours.
- // You can use OperationFuture.getInitialFuture to get a future representing the initial
- // response to the request, which contains information while the operation is in progress.
- System.out.format("Training operation name: %s%n", future.getInitialFuture().get().getName());
- System.out.println("Training started...");
- }
- }
-}
-// [END automl_tables_create_model]
diff --git a/automl/src/main/java/beta/automl/TablesGetModel.java b/automl/src/main/java/beta/automl/TablesGetModel.java
deleted file mode 100644
index 443491252b5..00000000000
--- a/automl/src/main/java/beta/automl/TablesGetModel.java
+++ /dev/null
@@ -1,83 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_get_model]
-
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.Model;
-import com.google.cloud.automl.v1beta1.ModelName;
-import com.google.cloud.automl.v1beta1.TablesModelColumnInfo;
-import io.grpc.StatusRuntimeException;
-import java.io.IOException;
-import java.text.DateFormat;
-import java.text.SimpleDateFormat;
-
-public class TablesGetModel {
-
- public static void main(String[] args) throws IOException, StatusRuntimeException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String region = "YOUR_REGION";
- String modelId = "YOUR_MODEL_ID";
- getModel(projectId, region, modelId);
- }
-
- // Demonstrates using the AutoML client to get model details.
- public static void getModel(String projectId, String computeRegion, String modelId)
- throws IOException, StatusRuntimeException {
- // 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, computeRegion, modelId);
-
- // Get complete detail of the model.
- Model model = client.getModel(modelFullId);
-
- // Display the model information.
- System.out.format("Model name: %s%n", model.getName());
- System.out.format(
- "Model Id: %s\n", model.getName().split("/")[model.getName().split("/").length - 1]);
- System.out.format("Model display name: %s%n", model.getDisplayName());
- System.out.format("Dataset Id: %s%n", model.getDatasetId());
- System.out.println("Tables Model Metadata: ");
- System.out.format(
- "\tTraining budget: %s%n", model.getTablesModelMetadata().getTrainBudgetMilliNodeHours());
- System.out.format(
- "\tTraining cost: %s%n", model.getTablesModelMetadata().getTrainBudgetMilliNodeHours());
-
- DateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ");
- String createTime =
- dateFormat.format(new java.util.Date(model.getCreateTime().getSeconds() * 1000));
- System.out.format("Model create time: %s%n", createTime);
-
- System.out.format("Model deployment state: %s%n", model.getDeploymentState());
-
- // Get features of top importance
- for (TablesModelColumnInfo info :
- model.getTablesModelMetadata().getTablesModelColumnInfoList()) {
- System.out.format(
- "Column: %s - Importance: %.2f%n",
- info.getColumnDisplayName(), info.getFeatureImportance());
- }
- }
- }
-}
-// [END automl_tables_get_model]
diff --git a/automl/src/main/java/beta/automl/TablesImportDataset.java b/automl/src/main/java/beta/automl/TablesImportDataset.java
deleted file mode 100644
index ce0e5fc16f0..00000000000
--- a/automl/src/main/java/beta/automl/TablesImportDataset.java
+++ /dev/null
@@ -1,74 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_import_data]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.BigQuerySource;
-import com.google.cloud.automl.v1beta1.DatasetName;
-import com.google.cloud.automl.v1beta1.GcsSource;
-import com.google.cloud.automl.v1beta1.InputConfig;
-import com.google.protobuf.Empty;
-import java.io.IOException;
-import java.util.Arrays;
-import java.util.concurrent.ExecutionException;
-
-class TablesImportDataset {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String datasetId = "YOUR_DATASET_ID";
- String path = "gs://BUCKET_ID/path/to//data.csv or bq://project_id.dataset_id.table_id";
- importDataset(projectId, datasetId, path);
- }
-
- // Import a dataset via BigQuery or Google Cloud Storage
- static void importDataset(String projectId, String datasetId, String path)
- 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);
-
- InputConfig.Builder inputConfigBuilder = InputConfig.newBuilder();
-
- // Determine which source type was used for the input path (BigQuery or GCS)
- if (path.startsWith("bq")) {
- // Get training data file to be imported from a BigQuery source.
- BigQuerySource.Builder bigQuerySource = BigQuerySource.newBuilder();
- bigQuerySource.setInputUri(path);
- inputConfigBuilder.setBigquerySource(bigQuerySource);
- } else {
- // Get multiple Google Cloud Storage URIs to import data from
- GcsSource gcsSource =
- GcsSource.newBuilder().addAllInputUris(Arrays.asList(path.split(","))).build();
- inputConfigBuilder.setGcsSource(gcsSource);
- }
-
- // Import data from the input URI
- System.out.println("Processing import...");
-
- Empty response = client.importDataAsync(datasetFullId, inputConfigBuilder.build()).get();
- System.out.format("Dataset imported. %s%n", response);
- }
- }
-}
-// [END automl_tables_import_data]
diff --git a/automl/src/main/java/beta/automl/TablesPredict.java b/automl/src/main/java/beta/automl/TablesPredict.java
deleted file mode 100644
index fd2257c899e..00000000000
--- a/automl/src/main/java/beta/automl/TablesPredict.java
+++ /dev/null
@@ -1,87 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_predict]
-import com.google.cloud.automl.v1beta1.AnnotationPayload;
-import com.google.cloud.automl.v1beta1.ExamplePayload;
-import com.google.cloud.automl.v1beta1.ModelName;
-import com.google.cloud.automl.v1beta1.PredictRequest;
-import com.google.cloud.automl.v1beta1.PredictResponse;
-import com.google.cloud.automl.v1beta1.PredictionServiceClient;
-import com.google.cloud.automl.v1beta1.Row;
-import com.google.cloud.automl.v1beta1.TablesAnnotation;
-import com.google.protobuf.Value;
-import java.io.IOException;
-import java.util.ArrayList;
-import java.util.List;
-
-class TablesPredict {
-
- public static void main(String[] args) throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- // Values should match the input expected by your model.
- List values = new ArrayList<>();
- // values.add(Value.newBuilder().setBoolValue(true).build());
- // values.add(Value.newBuilder().setNumberValue(10).build());
- // values.add(Value.newBuilder().setStringValue("YOUR_STRING").build());
- predict(projectId, modelId, values);
- }
-
- static void predict(String projectId, String modelId, List values) 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 (PredictionServiceClient client = PredictionServiceClient.create()) {
- // Get the full path of the model.
- ModelName name = ModelName.of(projectId, "us-central1", modelId);
- Row row = Row.newBuilder().addAllValues(values).build();
- ExamplePayload payload = ExamplePayload.newBuilder().setRow(row).build();
-
- // Feature importance gives you visibility into how the features in a specific prediction
- // request informed the resulting prediction. For more info, see:
- // https://cloud.google.com/automl-tables/docs/features#local
- PredictRequest request =
- PredictRequest.newBuilder()
- .setName(name.toString())
- .setPayload(payload)
- .putParams("feature_importance", "true")
- .build();
-
- PredictResponse response = client.predict(request);
-
- System.out.println("Prediction results:");
- for (AnnotationPayload annotationPayload : response.getPayloadList()) {
- TablesAnnotation tablesAnnotation = annotationPayload.getTables();
- System.out.format(
- "Classification label: %s%n", tablesAnnotation.getValue().getStringValue());
- System.out.format("Classification score: %.3f%n", tablesAnnotation.getScore());
- // Get features of top importance
- tablesAnnotation
- .getTablesModelColumnInfoList()
- .forEach(
- info ->
- System.out.format(
- "\tColumn: %s - Importance: %.2f%n",
- info.getColumnDisplayName(), info.getFeatureImportance()));
- }
- }
- }
-}
-// [END automl_tables_predict]
diff --git a/automl/src/main/java/beta/automl/UndeployModel.java b/automl/src/main/java/beta/automl/UndeployModel.java
deleted file mode 100644
index 7325f519dba..00000000000
--- a/automl/src/main/java/beta/automl/UndeployModel.java
+++ /dev/null
@@ -1,58 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_tables_undeploy_model]
-// [START automl_undeploy_model_beta]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.ModelName;
-import com.google.cloud.automl.v1beta1.OperationMetadata;
-import com.google.cloud.automl.v1beta1.UndeployModelRequest;
-import com.google.protobuf.Empty;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class UndeployModel {
-
- static void undeployModel() throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- undeployModel(projectId, modelId);
- }
-
- // Undeploy a model from prediction
- static void undeployModel(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);
- UndeployModelRequest request =
- UndeployModelRequest.newBuilder().setName(modelFullId.toString()).build();
- OperationFuture future = client.undeployModelAsync(request);
-
- future.get();
- System.out.println("Model undeployment finished");
- }
- }
-}
-// [END automl_undeploy_model_beta]
-// [END automl_tables_undeploy_model]
diff --git a/automl/src/main/java/beta/automl/VideoClassificationCreateDataset.java b/automl/src/main/java/beta/automl/VideoClassificationCreateDataset.java
deleted file mode 100644
index 1fe70c9f2b2..00000000000
--- a/automl/src/main/java/beta/automl/VideoClassificationCreateDataset.java
+++ /dev/null
@@ -1,64 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_video_classification_create_dataset_beta]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.Dataset;
-import com.google.cloud.automl.v1beta1.LocationName;
-import com.google.cloud.automl.v1beta1.VideoClassificationDatasetMetadata;
-import java.io.IOException;
-
-class VideoClassificationCreateDataset {
-
- public static void main(String[] args) throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String displayName = "YOUR_DATASET_NAME";
- createDataset(projectId, displayName);
- }
-
- // Create a dataset
- static void createDataset(String projectId, String displayName) 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- VideoClassificationDatasetMetadata metadata =
- VideoClassificationDatasetMetadata.newBuilder().build();
- Dataset dataset =
- Dataset.newBuilder()
- .setDisplayName(displayName)
- .setVideoClassificationDatasetMetadata(metadata)
- .build();
-
- Dataset createdDataset = client.createDataset(projectLocation, dataset);
-
- // Display the dataset information.
- System.out.format("Dataset name: %s%n", createdDataset.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 = createdDataset.getName().split("/");
- String datasetId = names[names.length - 1];
- System.out.format("Dataset id: %s%n", datasetId);
- }
- }
-}
-// [END automl_video_classification_create_dataset_beta]
diff --git a/automl/src/main/java/beta/automl/VideoClassificationCreateModel.java b/automl/src/main/java/beta/automl/VideoClassificationCreateModel.java
deleted file mode 100644
index 94f3407d442..00000000000
--- a/automl/src/main/java/beta/automl/VideoClassificationCreateModel.java
+++ /dev/null
@@ -1,70 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_video_classification_create_model_beta]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.LocationName;
-import com.google.cloud.automl.v1beta1.Model;
-import com.google.cloud.automl.v1beta1.OperationMetadata;
-import com.google.cloud.automl.v1beta1.VideoClassificationModelMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class VideoClassificationCreateModel {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String datasetId = "YOUR_DATASET_ID";
- String displayName = "YOUR_DATASET_NAME";
- createModel(projectId, datasetId, displayName);
- }
-
- // Create a model
- static void createModel(String projectId, String datasetId, String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- // Set model metadata.
- VideoClassificationModelMetadata metadata =
- VideoClassificationModelMetadata.newBuilder().build();
- Model model =
- Model.newBuilder()
- .setDisplayName(displayName)
- .setDatasetId(datasetId)
- .setVideoClassificationModelMetadata(metadata)
- .build();
-
- // Create a model with the model metadata in the region.
- OperationFuture future =
- client.createModelAsync(projectLocation, model);
- // OperationFuture.get() will block until the model is created, which may take several hours.
- // You can use OperationFuture.getInitialFuture to get a future representing the initial
- // response to the request, which contains information while the operation is in progress.
- System.out.format("Training operation name: %s%n", future.getInitialFuture().get().getName());
- System.out.println("Training started...");
- }
- }
-}
-// [END automl_video_classification_create_model_beta]
diff --git a/automl/src/main/java/beta/automl/VideoObjectTrackingCreateDataset.java b/automl/src/main/java/beta/automl/VideoObjectTrackingCreateDataset.java
deleted file mode 100644
index 61b2a1ada3a..00000000000
--- a/automl/src/main/java/beta/automl/VideoObjectTrackingCreateDataset.java
+++ /dev/null
@@ -1,64 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_video_object_tracking_create_dataset_beta]
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.Dataset;
-import com.google.cloud.automl.v1beta1.LocationName;
-import com.google.cloud.automl.v1beta1.VideoObjectTrackingDatasetMetadata;
-import java.io.IOException;
-
-class VideoObjectTrackingCreateDataset {
-
- public static void main(String[] args) throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String displayName = "YOUR_DATASET_NAME";
- createDataset(projectId, displayName);
- }
-
- // Create a dataset
- static void createDataset(String projectId, String displayName) 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- VideoObjectTrackingDatasetMetadata metadata =
- VideoObjectTrackingDatasetMetadata.newBuilder().build();
- Dataset dataset =
- Dataset.newBuilder()
- .setDisplayName(displayName)
- .setVideoObjectTrackingDatasetMetadata(metadata)
- .build();
-
- Dataset createdDataset = client.createDataset(projectLocation, dataset);
-
- // Display the dataset information.
- System.out.format("Dataset name: %s%n", createdDataset.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 = createdDataset.getName().split("/");
- String datasetId = names[names.length - 1];
- System.out.format("Dataset id: %s%n", datasetId);
- }
- }
-}
-// [END automl_video_object_tracking_create_dataset_beta]
diff --git a/automl/src/main/java/beta/automl/VideoObjectTrackingCreateModel.java b/automl/src/main/java/beta/automl/VideoObjectTrackingCreateModel.java
deleted file mode 100644
index 29df7866613..00000000000
--- a/automl/src/main/java/beta/automl/VideoObjectTrackingCreateModel.java
+++ /dev/null
@@ -1,70 +0,0 @@
-/*
- * 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 beta.automl;
-
-// [START automl_video_object_tracking_create_model_beta]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1beta1.AutoMlClient;
-import com.google.cloud.automl.v1beta1.LocationName;
-import com.google.cloud.automl.v1beta1.Model;
-import com.google.cloud.automl.v1beta1.OperationMetadata;
-import com.google.cloud.automl.v1beta1.VideoObjectTrackingModelMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class VideoObjectTrackingCreateModel {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String datasetId = "YOUR_DATASET_ID";
- String displayName = "YOUR_DATASET_NAME";
- createModel(projectId, datasetId, displayName);
- }
-
- // Create a model
- static void createModel(String projectId, String datasetId, String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- // Set model metadata.
- VideoObjectTrackingModelMetadata metadata =
- VideoObjectTrackingModelMetadata.newBuilder().build();
- Model model =
- Model.newBuilder()
- .setDisplayName(displayName)
- .setDatasetId(datasetId)
- .setVideoObjectTrackingModelMetadata(metadata)
- .build();
-
- // Create a model with the model metadata in the region.
- OperationFuture future =
- client.createModelAsync(projectLocation, model);
- // OperationFuture.get() will block until the model is created, which may take several hours.
- // You can use OperationFuture.getInitialFuture to get a future representing the initial
- // response to the request, which contains information while the operation is in progress.
- System.out.format("Training operation name: %s%n", future.getInitialFuture().get().getName());
- System.out.println("Training started...");
- }
- }
-}
-// [END automl_video_object_tracking_create_model_beta]
diff --git a/automl/src/main/java/com/example/automl/BatchPredict.java b/automl/src/main/java/com/example/automl/BatchPredict.java
deleted file mode 100644
index 03a0055155c..00000000000
--- a/automl/src/main/java/com/example/automl/BatchPredict.java
+++ /dev/null
@@ -1,75 +0,0 @@
-/*
- * 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_batch_predict]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.BatchPredictInputConfig;
-import com.google.cloud.automl.v1.BatchPredictOutputConfig;
-import com.google.cloud.automl.v1.BatchPredictRequest;
-import com.google.cloud.automl.v1.BatchPredictResult;
-import com.google.cloud.automl.v1.GcsDestination;
-import com.google.cloud.automl.v1.GcsSource;
-import com.google.cloud.automl.v1.ModelName;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.cloud.automl.v1.PredictionServiceClient;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-abstract class BatchPredict {
-
- static void batchPredict() throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- String inputUri = "gs://YOUR_BUCKET_ID/path_to_your_input_csv_or_jsonl";
- String outputUri = "gs://YOUR_BUCKET_ID/path_to_save_results/";
- batchPredict(projectId, modelId, inputUri, outputUri);
- }
-
- static void batchPredict(String projectId, String modelId, String inputUri, String outputUri)
- 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 (PredictionServiceClient client = PredictionServiceClient.create()) {
- // Get the full path of the model.
- ModelName name = ModelName.of(projectId, "us-central1", modelId);
- GcsSource gcsSource = GcsSource.newBuilder().addInputUris(inputUri).build();
- BatchPredictInputConfig inputConfig =
- BatchPredictInputConfig.newBuilder().setGcsSource(gcsSource).build();
- GcsDestination gcsDestination =
- GcsDestination.newBuilder().setOutputUriPrefix(outputUri).build();
- BatchPredictOutputConfig outputConfig =
- BatchPredictOutputConfig.newBuilder().setGcsDestination(gcsDestination).build();
- BatchPredictRequest request =
- BatchPredictRequest.newBuilder()
- .setName(name.toString())
- .setInputConfig(inputConfig)
- .setOutputConfig(outputConfig)
- .build();
-
- OperationFuture future =
- client.batchPredictAsync(request);
-
- System.out.println("Waiting for operation to complete...");
- future.get();
- System.out.println("Batch Prediction results saved to specified Cloud Storage bucket.");
- }
- }
-}
-// [END automl_batch_predict]
diff --git a/automl/src/main/java/com/example/automl/DeleteDataset.java b/automl/src/main/java/com/example/automl/DeleteDataset.java
deleted file mode 100644
index fcb6e2e913c..00000000000
--- a/automl/src/main/java/com/example/automl/DeleteDataset.java
+++ /dev/null
@@ -1,49 +0,0 @@
-/*
- * 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]
diff --git a/automl/src/main/java/com/example/automl/DeleteModel.java b/automl/src/main/java/com/example/automl/DeleteModel.java
deleted file mode 100644
index 66969ff75d4..00000000000
--- a/automl/src/main/java/com/example/automl/DeleteModel.java
+++ /dev/null
@@ -1,54 +0,0 @@
-/*
- * 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 {
-
- public static void main(String[] args)
- 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);
- }
-
- // Delete 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]
diff --git a/automl/src/main/java/com/example/automl/DeployModel.java b/automl/src/main/java/com/example/automl/DeployModel.java
deleted file mode 100644
index ecc338cf37e..00000000000
--- a/automl/src/main/java/com/example/automl/DeployModel.java
+++ /dev/null
@@ -1,57 +0,0 @@
-/*
- * 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_deploy_model]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.DeployModelRequest;
-import com.google.cloud.automl.v1.ModelName;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.protobuf.Empty;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class DeployModel {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- deployModel(projectId, modelId);
- }
-
- // Deploy a model for prediction
- static void deployModel(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);
- DeployModelRequest request =
- DeployModelRequest.newBuilder().setName(modelFullId.toString()).build();
- OperationFuture future = client.deployModelAsync(request);
-
- future.get();
- System.out.println("Model deployment finished");
- }
- }
-}
-// [END automl_deploy_model]
diff --git a/automl/src/main/java/com/example/automl/ExportDataset.java b/automl/src/main/java/com/example/automl/ExportDataset.java
deleted file mode 100644
index 812869b9a56..00000000000
--- a/automl/src/main/java/com/example/automl/ExportDataset.java
+++ /dev/null
@@ -1,60 +0,0 @@
-/*
- * 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 to a GCS bucket
- 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]
diff --git a/automl/src/main/java/com/example/automl/GetDataset.java b/automl/src/main/java/com/example/automl/GetDataset.java
deleted file mode 100644
index e1028d7052d..00000000000
--- a/automl/src/main/java/com/example/automl/GetDataset.java
+++ /dev/null
@@ -1,114 +0,0 @@
-/*
- * 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_language_entity_extraction_get_dataset]
-// [START automl_language_sentiment_analysis_get_dataset]
-// [START automl_language_text_classification_get_dataset]
-// [START automl_translate_get_dataset]
-// [START automl_vision_classification_get_dataset]
-// [START automl_vision_object_detection_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("Dataset create time:");
- System.out.format("\tseconds: %s\n", dataset.getCreateTime().getSeconds());
- System.out.format("\tnanos: %s\n", dataset.getCreateTime().getNanos());
- // [END automl_language_sentiment_analysis_get_dataset]
- // [END automl_language_text_classification_get_dataset]
- // [END automl_translate_get_dataset]
- // [END automl_vision_classification_get_dataset]
- // [END automl_vision_object_detection_get_dataset]
- System.out.format(
- "Text extraction dataset metadata: %s\n", dataset.getTextExtractionDatasetMetadata());
- // [END automl_language_entity_extraction_get_dataset]
-
- // [START automl_language_sentiment_analysis_get_dataset]
- System.out.format(
- "Text sentiment dataset metadata: %s\n", dataset.getTextSentimentDatasetMetadata());
- // [END automl_language_sentiment_analysis_get_dataset]
-
- // [START automl_language_text_classification_get_dataset]
- System.out.format(
- "Text classification dataset metadata: %s\n",
- dataset.getTextClassificationDatasetMetadata());
- // [END automl_language_text_classification_get_dataset]
-
- // [START automl_translate_get_dataset]
- 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());
- // [END automl_translate_get_dataset]
-
- // [START automl_vision_classification_get_dataset]
- System.out.format(
- "Image classification dataset metadata: %s\n",
- dataset.getImageClassificationDatasetMetadata());
- // [END automl_vision_classification_get_dataset]
-
- // [START automl_vision_object_detection_get_dataset]
- System.out.format(
- "Image object detection dataset metadata: %s\n",
- dataset.getImageObjectDetectionDatasetMetadata());
- // [START automl_language_entity_extraction_get_dataset]
- // [START automl_language_sentiment_analysis_get_dataset]
- // [START automl_language_text_classification_get_dataset]
- // [START automl_translate_get_dataset]
- // [START automl_vision_classification_get_dataset]
- }
- }
-}
-// [END automl_language_entity_extraction_get_dataset]
-// [END automl_language_sentiment_analysis_get_dataset]
-// [END automl_language_text_classification_get_dataset]
-// [END automl_translate_get_dataset]
-// [END automl_vision_classification_get_dataset]
-// [END automl_vision_object_detection_get_dataset]
diff --git a/automl/src/main/java/com/example/automl/GetModel.java b/automl/src/main/java/com/example/automl/GetModel.java
deleted file mode 100644
index 70b97905c2e..00000000000
--- a/automl/src/main/java/com/example/automl/GetModel.java
+++ /dev/null
@@ -1,60 +0,0 @@
-/*
- * 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]
diff --git a/automl/src/main/java/com/example/automl/GetModelEvaluation.java b/automl/src/main/java/com/example/automl/GetModelEvaluation.java
deleted file mode 100644
index 694888d53fa..00000000000
--- a/automl/src/main/java/com/example/automl/GetModelEvaluation.java
+++ /dev/null
@@ -1,109 +0,0 @@
-/*
- * 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_language_entity_extraction_get_model_evaluation]
-// [START automl_language_sentiment_analysis_get_model_evaluation]
-// [START automl_language_text_classification_get_model_evaluation]
-// [START automl_translate_get_model_evaluation]
-// [START automl_vision_classification_get_model_evaluation]
-// [START automl_vision_object_detection_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());
- // [END automl_language_sentiment_analysis_get_model_evaluation]
- // [END automl_language_text_classification_get_model_evaluation]
- // [END automl_translate_get_model_evaluation]
- // [END automl_vision_classification_get_model_evaluation]
- // [END automl_vision_object_detection_get_model_evaluation]
- System.out.format(
- "Entity Extraction Model Evaluation Metrics: %s\n",
- modelEvaluation.getTextExtractionEvaluationMetrics());
- // [END automl_language_entity_extraction_get_model_evaluation]
-
- // [START automl_language_sentiment_analysis_get_model_evaluation]
- System.out.format(
- "Sentiment Analysis Model Evaluation Metrics: %s\n",
- modelEvaluation.getTextSentimentEvaluationMetrics());
- // [END automl_language_sentiment_analysis_get_model_evaluation]
-
- // [START automl_language_text_classification_get_model_evaluation]
- // [START automl_vision_classification_get_model_evaluation]
- System.out.format(
- "Classification Model Evaluation Metrics: %s\n",
- modelEvaluation.getClassificationEvaluationMetrics());
- // [END automl_language_text_classification_get_model_evaluation]
- // [END automl_vision_classification_get_model_evaluation]
-
- // [START automl_translate_get_model_evaluation]
- System.out.format(
- "Translate Model Evaluation Metrics: %s\n",
- modelEvaluation.getTranslationEvaluationMetrics());
- // [END automl_translate_get_model_evaluation]
-
- // [START automl_vision_object_detection_get_model_evaluation]
- System.out.format(
- "Object Detection Model Evaluation Metrics: %s\n",
- modelEvaluation.getImageObjectDetectionEvaluationMetrics());
- // [START automl_language_entity_extraction_get_model_evaluation]
- // [START automl_language_sentiment_analysis_get_model_evaluation]
- // [START automl_language_text_classification_get_model_evaluation]
- // [START automl_translate_get_model_evaluation]
- // [START automl_vision_classification_get_model_evaluation]
- }
- }
-}
-// [END automl_language_entity_extraction_get_model_evaluation]
-// [END automl_language_sentiment_analysis_get_model_evaluation]
-// [END automl_language_text_classification_get_model_evaluation]
-// [END automl_translate_get_model_evaluation]
-// [END automl_vision_classification_get_model_evaluation]
-// [END automl_vision_object_detection_get_model_evaluation]
diff --git a/automl/src/main/java/com/example/automl/GetOperationStatus.java b/automl/src/main/java/com/example/automl/GetOperationStatus.java
deleted file mode 100644
index 07bfe02933d..00000000000
--- a/automl/src/main/java/com/example/automl/GetOperationStatus.java
+++ /dev/null
@@ -1,57 +0,0 @@
-/*
- * 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_operation_status]
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.longrunning.Operation;
-import java.io.IOException;
-
-class GetOperationStatus {
-
- static void getOperationStatus() throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String operationFullId = "projects/[projectId]/locations/us-central1/operations/[operationId]";
- getOperationStatus(operationFullId);
- }
-
- // Get the status of an operation
- static void getOperationStatus(String operationFullId) 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 latest state of a long-running operation.
- Operation operation = client.getOperationsClient().getOperation(operationFullId);
-
- // Display operation details.
- System.out.println("Operation details:");
- System.out.format("\tName: %s\n", operation.getName());
- System.out.format("\tMetadata Type Url: %s\n", operation.getMetadata().getTypeUrl());
- System.out.format("\tDone: %s\n", operation.getDone());
- if (operation.hasResponse()) {
- System.out.format("\tResponse Type Url: %s\n", operation.getResponse().getTypeUrl());
- }
- if (operation.hasError()) {
- System.out.println("\tResponse:");
- System.out.format("\t\tError code: %s\n", operation.getError().getCode());
- System.out.format("\t\tError message: %s\n", operation.getError().getMessage());
- }
- }
- }
-}
-// [END automl_get_operation_status]
diff --git a/automl/src/main/java/com/example/automl/ImportDataset.java b/automl/src/main/java/com/example/automl/ImportDataset.java
deleted file mode 100644
index 3ead88326b3..00000000000
--- a/automl/src/main/java/com/example/automl/ImportDataset.java
+++ /dev/null
@@ -1,81 +0,0 @@
-/*
- * 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_import_dataset]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.DatasetName;
-import com.google.cloud.automl.v1.GcsSource;
-import com.google.cloud.automl.v1.InputConfig;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.protobuf.Empty;
-import java.io.IOException;
-import java.util.Arrays;
-import java.util.concurrent.ExecutionException;
-import java.util.concurrent.TimeUnit;
-import java.util.concurrent.TimeoutException;
-
-class ImportDataset {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException, TimeoutException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String datasetId = "YOUR_DATASET_ID";
- String path = "gs://BUCKET_ID/path_to_training_data.csv";
- importDataset(projectId, datasetId, path);
- }
-
- // Import a dataset
- static void importDataset(String projectId, String datasetId, String path)
- throws IOException, ExecutionException, InterruptedException, TimeoutException {
- // 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);
-
- // Get multiple Google Cloud Storage URIs to import data from
- GcsSource gcsSource =
- GcsSource.newBuilder().addAllInputUris(Arrays.asList(path.split(","))).build();
-
- // Import data from the input URI
- InputConfig inputConfig = InputConfig.newBuilder().setGcsSource(gcsSource).build();
- System.out.println("Processing import...");
-
- // Start the import job
- OperationFuture operation =
- client.importDataAsync(datasetFullId, inputConfig);
-
- System.out.format("Operation name: %s%n", operation.getName());
-
- // If you want to wait for the operation to finish, adjust the timeout appropriately. The
- // operation will still run if you choose not to wait for it to complete. You can check the
- // status of your operation using the operation's name.
- Empty response = operation.get(45, TimeUnit.MINUTES);
- System.out.format("Dataset imported. %s%n", response);
- } catch (TimeoutException e) {
- System.out.println("The operation's polling period was not long enough.");
- System.out.println("You can use the Operation's name to get the current status.");
- System.out.println("The import job is still running and will complete as expected.");
- throw e;
- }
- }
-}
-// [END automl_import_dataset]
diff --git a/automl/src/main/java/com/example/automl/LanguageEntityExtractionCreateDataset.java b/automl/src/main/java/com/example/automl/LanguageEntityExtractionCreateDataset.java
deleted file mode 100644
index 7adf18dc623..00000000000
--- a/automl/src/main/java/com/example/automl/LanguageEntityExtractionCreateDataset.java
+++ /dev/null
@@ -1,70 +0,0 @@
-/*
- * 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_language_entity_extraction_create_dataset]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.Dataset;
-import com.google.cloud.automl.v1.LocationName;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.cloud.automl.v1.TextExtractionDatasetMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class LanguageEntityExtractionCreateDataset {
-
- static void createDataset() throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String displayName = "YOUR_DATASET_NAME";
- createDataset(projectId, displayName);
- }
-
- // Create a dataset
- static void createDataset(String projectId, String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
-
- TextExtractionDatasetMetadata metadata = TextExtractionDatasetMetadata.newBuilder().build();
- Dataset dataset =
- Dataset.newBuilder()
- .setDisplayName(displayName)
- .setTextExtractionDatasetMetadata(metadata)
- .build();
- OperationFuture future =
- client.createDatasetAsync(projectLocation, dataset);
-
- Dataset createdDataset = future.get();
-
- // Display the dataset information.
- System.out.format("Dataset name: %s\n", createdDataset.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 = createdDataset.getName().split("/");
- String datasetId = names[names.length - 1];
- System.out.format("Dataset id: %s\n", datasetId);
- }
- }
-}
-// [END automl_language_entity_extraction_create_dataset]
diff --git a/automl/src/main/java/com/example/automl/LanguageEntityExtractionCreateModel.java b/automl/src/main/java/com/example/automl/LanguageEntityExtractionCreateModel.java
deleted file mode 100644
index f2da97894df..00000000000
--- a/automl/src/main/java/com/example/automl/LanguageEntityExtractionCreateModel.java
+++ /dev/null
@@ -1,68 +0,0 @@
-/*
- * 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_language_entity_extraction_create_model]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.LocationName;
-import com.google.cloud.automl.v1.Model;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.cloud.automl.v1.TextExtractionModelMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class LanguageEntityExtractionCreateModel {
-
- static void createModel() throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String datasetId = "YOUR_DATASET_ID";
- String displayName = "YOUR_DATASET_NAME";
- createModel(projectId, datasetId, displayName);
- }
-
- // Create a model
- static void createModel(String projectId, String datasetId, String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- // Set model metadata.
- TextExtractionModelMetadata metadata = TextExtractionModelMetadata.newBuilder().build();
- Model model =
- Model.newBuilder()
- .setDisplayName(displayName)
- .setDatasetId(datasetId)
- .setTextExtractionModelMetadata(metadata)
- .build();
-
- // Create a model with the model metadata in the region.
- OperationFuture future =
- client.createModelAsync(projectLocation, model);
- // OperationFuture.get() will block until the model is created, which may take several hours.
- // You can use OperationFuture.getInitialFuture to get a future representing the initial
- // response to the request, which contains information while the operation is in progress.
- System.out.format("Training operation name: %s\n", future.getInitialFuture().get().getName());
- System.out.println("Training started...");
- }
- }
-}
-// [END automl_language_entity_extraction_create_model]
diff --git a/automl/src/main/java/com/example/automl/LanguageEntityExtractionPredict.java b/automl/src/main/java/com/example/automl/LanguageEntityExtractionPredict.java
deleted file mode 100644
index 065990613b3..00000000000
--- a/automl/src/main/java/com/example/automl/LanguageEntityExtractionPredict.java
+++ /dev/null
@@ -1,72 +0,0 @@
-/*
- * 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_language_entity_extraction_predict]
-import com.google.cloud.automl.v1.AnnotationPayload;
-import com.google.cloud.automl.v1.ExamplePayload;
-import com.google.cloud.automl.v1.ModelName;
-import com.google.cloud.automl.v1.PredictRequest;
-import com.google.cloud.automl.v1.PredictResponse;
-import com.google.cloud.automl.v1.PredictionServiceClient;
-import com.google.cloud.automl.v1.TextSegment;
-import com.google.cloud.automl.v1.TextSnippet;
-import java.io.IOException;
-
-class LanguageEntityExtractionPredict {
-
- static void predict() throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- String content = "text to predict";
- predict(projectId, modelId, content);
- }
-
- static void predict(String projectId, String modelId, String content) 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 (PredictionServiceClient client = PredictionServiceClient.create()) {
- // Get the full path of the model.
- ModelName name = ModelName.of(projectId, "us-central1", modelId);
-
- // For available mime types, see:
- // https://cloud.google.com/automl/docs/reference/rest/v1/projects.locations.models/predict#textsnippet
- TextSnippet textSnippet =
- TextSnippet.newBuilder()
- .setContent(content)
- .setMimeType("text/plain") // Types: text/plain, text/html
- .build();
- ExamplePayload payload = ExamplePayload.newBuilder().setTextSnippet(textSnippet).build();
- PredictRequest predictRequest =
- PredictRequest.newBuilder().setName(name.toString()).setPayload(payload).build();
-
- PredictResponse response = client.predict(predictRequest);
-
- for (AnnotationPayload annotationPayload : response.getPayloadList()) {
- System.out.format("Text Extract Entity Type: %s\n", annotationPayload.getDisplayName());
- System.out.format("Text score: %.2f\n", annotationPayload.getTextExtraction().getScore());
- TextSegment textSegment = annotationPayload.getTextExtraction().getTextSegment();
- System.out.format("Text Extract Entity Content: %s\n", textSegment.getContent());
- System.out.format("Text Start Offset: %s\n", textSegment.getStartOffset());
- System.out.format("Text End Offset: %s\n\n", textSegment.getEndOffset());
- }
- }
- }
-}
-// [END automl_language_entity_extraction_predict]
diff --git a/automl/src/main/java/com/example/automl/LanguageSentimentAnalysisCreateDataset.java b/automl/src/main/java/com/example/automl/LanguageSentimentAnalysisCreateDataset.java
deleted file mode 100644
index 6ab0be85851..00000000000
--- a/automl/src/main/java/com/example/automl/LanguageSentimentAnalysisCreateDataset.java
+++ /dev/null
@@ -1,73 +0,0 @@
-/*
- * 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_language_sentiment_analysis_create_dataset]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.Dataset;
-import com.google.cloud.automl.v1.LocationName;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.cloud.automl.v1.TextSentimentDatasetMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class LanguageSentimentAnalysisCreateDataset {
-
- static void createDataset() throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String displayName = "YOUR_DATASET_NAME";
- createDataset(projectId, displayName);
- }
-
- // Create a dataset
- static void createDataset(String projectId, String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- // Specify the text classification type for the dataset.
- TextSentimentDatasetMetadata metadata =
- TextSentimentDatasetMetadata.newBuilder()
- .setSentimentMax(4) // Possible max sentiment score: 1-10
- .build();
- Dataset dataset =
- Dataset.newBuilder()
- .setDisplayName(displayName)
- .setTextSentimentDatasetMetadata(metadata)
- .build();
- OperationFuture future =
- client.createDatasetAsync(projectLocation, dataset);
-
- Dataset createdDataset = future.get();
-
- // Display the dataset information.
- System.out.format("Dataset name: %s\n", createdDataset.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 = createdDataset.getName().split("/");
- String datasetId = names[names.length - 1];
- System.out.format("Dataset id: %s\n", datasetId);
- }
- }
-}
-// [END automl_language_sentiment_analysis_create_dataset]
diff --git a/automl/src/main/java/com/example/automl/LanguageSentimentAnalysisCreateModel.java b/automl/src/main/java/com/example/automl/LanguageSentimentAnalysisCreateModel.java
deleted file mode 100644
index 04af77592e5..00000000000
--- a/automl/src/main/java/com/example/automl/LanguageSentimentAnalysisCreateModel.java
+++ /dev/null
@@ -1,69 +0,0 @@
-/*
- * 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_language_sentiment_analysis_create_model]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.LocationName;
-import com.google.cloud.automl.v1.Model;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.cloud.automl.v1.TextSentimentModelMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class LanguageSentimentAnalysisCreateModel {
-
- static void createModel() throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String datasetId = "YOUR_DATASET_ID";
- String displayName = "YOUR_DATASET_NAME";
- createModel(projectId, datasetId, displayName);
- }
-
- // Create a model
- static void createModel(String projectId, String datasetId, String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- // Set model metadata.
- System.out.println(datasetId);
- TextSentimentModelMetadata metadata = TextSentimentModelMetadata.newBuilder().build();
- Model model =
- Model.newBuilder()
- .setDisplayName(displayName)
- .setDatasetId(datasetId)
- .setTextSentimentModelMetadata(metadata)
- .build();
-
- // Create a model with the model metadata in the region.
- OperationFuture future =
- client.createModelAsync(projectLocation, model);
- // OperationFuture.get() will block until the model is created, which may take several hours.
- // You can use OperationFuture.getInitialFuture to get a future representing the initial
- // response to the request, which contains information while the operation is in progress.
- System.out.format("Training operation name: %s\n", future.getInitialFuture().get().getName());
- System.out.println("Training started...");
- }
- }
-}
-// [END automl_language_sentiment_analysis_create_model]
diff --git a/automl/src/main/java/com/example/automl/LanguageSentimentAnalysisPredict.java b/automl/src/main/java/com/example/automl/LanguageSentimentAnalysisPredict.java
deleted file mode 100644
index 65945c26023..00000000000
--- a/automl/src/main/java/com/example/automl/LanguageSentimentAnalysisPredict.java
+++ /dev/null
@@ -1,68 +0,0 @@
-/*
- * 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_language_sentiment_analysis_predict]
-import com.google.cloud.automl.v1.AnnotationPayload;
-import com.google.cloud.automl.v1.ExamplePayload;
-import com.google.cloud.automl.v1.ModelName;
-import com.google.cloud.automl.v1.PredictRequest;
-import com.google.cloud.automl.v1.PredictResponse;
-import com.google.cloud.automl.v1.PredictionServiceClient;
-import com.google.cloud.automl.v1.TextSnippet;
-import java.io.IOException;
-
-class LanguageSentimentAnalysisPredict {
-
- static void predict() throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- String content = "text to predict";
- predict(projectId, modelId, content);
- }
-
- static void predict(String projectId, String modelId, String content) 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 (PredictionServiceClient client = PredictionServiceClient.create()) {
- // Get the full path of the model.
- ModelName name = ModelName.of(projectId, "us-central1", modelId);
-
- // For available mime types, see:
- // https://cloud.google.com/automl/docs/reference/rest/v1/projects.locations.models/predict#textsnippet
- TextSnippet textSnippet =
- TextSnippet.newBuilder()
- .setContent(content)
- .setMimeType("text/plain") // Types: text/plain, text/html
- .build();
- ExamplePayload payload = ExamplePayload.newBuilder().setTextSnippet(textSnippet).build();
- PredictRequest predictRequest =
- PredictRequest.newBuilder().setName(name.toString()).setPayload(payload).build();
-
- PredictResponse response = client.predict(predictRequest);
-
- for (AnnotationPayload annotationPayload : response.getPayloadList()) {
- System.out.format("Predicted class name: %s\n", annotationPayload.getDisplayName());
- System.out.format(
- "Predicted sentiment score: %d\n", annotationPayload.getTextSentiment().getSentiment());
- }
- }
- }
-}
-// [END automl_language_sentiment_analysis_predict]
diff --git a/automl/src/main/java/com/example/automl/LanguageTextClassificationCreateDataset.java b/automl/src/main/java/com/example/automl/LanguageTextClassificationCreateDataset.java
deleted file mode 100644
index 9332c06a246..00000000000
--- a/automl/src/main/java/com/example/automl/LanguageTextClassificationCreateDataset.java
+++ /dev/null
@@ -1,82 +0,0 @@
-/*
- * 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_language_text_classification_create_dataset]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.ClassificationType;
-import com.google.cloud.automl.v1.Dataset;
-import com.google.cloud.automl.v1.LocationName;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.cloud.automl.v1.TextClassificationDatasetMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class LanguageTextClassificationCreateDataset {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String displayName = "YOUR_DATASET_NAME";
- createDataset(projectId, displayName);
- }
-
- // Create a dataset
- static void createDataset(String projectId, String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
-
- // Specify the classification type
- // Types:
- // MultiLabel: Multiple labels are allowed for one example.
- // MultiClass: At most one label is allowed per example.
- ClassificationType classificationType = ClassificationType.MULTILABEL;
-
- // Specify the text classification type for the dataset.
- TextClassificationDatasetMetadata metadata =
- TextClassificationDatasetMetadata.newBuilder()
- .setClassificationType(classificationType)
- .build();
- Dataset dataset =
- Dataset.newBuilder()
- .setDisplayName(displayName)
- .setTextClassificationDatasetMetadata(metadata)
- .build();
- OperationFuture future =
- client.createDatasetAsync(projectLocation, dataset);
-
- Dataset createdDataset = future.get();
-
- // Display the dataset information.
- System.out.format("Dataset name: %s\n", createdDataset.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 = createdDataset.getName().split("/");
- String datasetId = names[names.length - 1];
- System.out.format("Dataset id: %s\n", datasetId);
- }
- }
-}
-// [END automl_language_text_classification_create_dataset]
diff --git a/automl/src/main/java/com/example/automl/LanguageTextClassificationCreateModel.java b/automl/src/main/java/com/example/automl/LanguageTextClassificationCreateModel.java
deleted file mode 100644
index bf26db03101..00000000000
--- a/automl/src/main/java/com/example/automl/LanguageTextClassificationCreateModel.java
+++ /dev/null
@@ -1,70 +0,0 @@
-/*
- * 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_language_text_classification_create_model]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.LocationName;
-import com.google.cloud.automl.v1.Model;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.cloud.automl.v1.TextClassificationModelMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class LanguageTextClassificationCreateModel {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String datasetId = "YOUR_DATASET_ID";
- String displayName = "YOUR_DATASET_NAME";
- createModel(projectId, datasetId, displayName);
- }
-
- // Create a model
- static void createModel(String projectId, String datasetId, String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- // Set model metadata.
- TextClassificationModelMetadata metadata =
- TextClassificationModelMetadata.newBuilder().build();
- Model model =
- Model.newBuilder()
- .setDisplayName(displayName)
- .setDatasetId(datasetId)
- .setTextClassificationModelMetadata(metadata)
- .build();
-
- // Create a model with the model metadata in the region.
- OperationFuture future =
- client.createModelAsync(projectLocation, model);
- // OperationFuture.get() will block until the model is created, which may take several hours.
- // You can use OperationFuture.getInitialFuture to get a future representing the initial
- // response to the request, which contains information while the operation is in progress.
- System.out.format("Training operation name: %s\n", future.getInitialFuture().get().getName());
- System.out.println("Training started...");
- }
- }
-}
-// [END automl_language_text_classification_create_model]
diff --git a/automl/src/main/java/com/example/automl/LanguageTextClassificationPredict.java b/automl/src/main/java/com/example/automl/LanguageTextClassificationPredict.java
deleted file mode 100644
index e2da94aa121..00000000000
--- a/automl/src/main/java/com/example/automl/LanguageTextClassificationPredict.java
+++ /dev/null
@@ -1,69 +0,0 @@
-/*
- * 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_language_text_classification_predict]
-import com.google.cloud.automl.v1.AnnotationPayload;
-import com.google.cloud.automl.v1.ExamplePayload;
-import com.google.cloud.automl.v1.ModelName;
-import com.google.cloud.automl.v1.PredictRequest;
-import com.google.cloud.automl.v1.PredictResponse;
-import com.google.cloud.automl.v1.PredictionServiceClient;
-import com.google.cloud.automl.v1.TextSnippet;
-import java.io.IOException;
-
-class LanguageTextClassificationPredict {
-
- public static void main(String[] args) throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- String content = "text to predict";
- predict(projectId, modelId, content);
- }
-
- static void predict(String projectId, String modelId, String content) 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 (PredictionServiceClient client = PredictionServiceClient.create()) {
- // Get the full path of the model.
- ModelName name = ModelName.of(projectId, "us-central1", modelId);
-
- // For available mime types, see:
- // https://cloud.google.com/automl/docs/reference/rest/v1/projects.locations.models/predict#textsnippet
- TextSnippet textSnippet =
- TextSnippet.newBuilder()
- .setContent(content)
- .setMimeType("text/plain") // Types: text/plain, text/html
- .build();
- ExamplePayload payload = ExamplePayload.newBuilder().setTextSnippet(textSnippet).build();
- PredictRequest predictRequest =
- PredictRequest.newBuilder().setName(name.toString()).setPayload(payload).build();
-
- PredictResponse response = client.predict(predictRequest);
-
- for (AnnotationPayload annotationPayload : response.getPayloadList()) {
- System.out.format("Predicted class name: %s\n", annotationPayload.getDisplayName());
- System.out.format(
- "Predicted sentiment score: %.2f\n\n",
- annotationPayload.getClassification().getScore());
- }
- }
- }
-}
-// [END automl_language_text_classification_predict]
diff --git a/automl/src/main/java/com/example/automl/ListDatasets.java b/automl/src/main/java/com/example/automl/ListDatasets.java
deleted file mode 100644
index b766a673ff4..00000000000
--- a/automl/src/main/java/com/example/automl/ListDatasets.java
+++ /dev/null
@@ -1,119 +0,0 @@
-/*
- * 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_language_entity_extraction_list_datasets]
-// [START automl_language_sentiment_analysis_list_datasets]
-// [START automl_language_text_classification_list_datasets]
-// [START automl_translate_list_datasets]
-// [START automl_vision_classification_list_datasets]
-// [START automl_vision_object_detection_list_datasets]
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.Dataset;
-import com.google.cloud.automl.v1.ListDatasetsRequest;
-import com.google.cloud.automl.v1.LocationName;
-import java.io.IOException;
-
-class ListDatasets {
-
- static void listDatasets() throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- listDatasets(projectId);
- }
-
- // List the datasets
- static void listDatasets(String projectId) 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- ListDatasetsRequest request =
- ListDatasetsRequest.newBuilder().setParent(projectLocation.toString()).build();
-
- // List all the datasets available in the region by applying filter.
- System.out.println("List of datasets:");
- for (Dataset dataset : client.listDatasets(request).iterateAll()) {
- // Display the dataset information
- System.out.format("\nDataset 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("Dataset create time:");
- System.out.format("\tseconds: %s\n", dataset.getCreateTime().getSeconds());
- System.out.format("\tnanos: %s\n", dataset.getCreateTime().getNanos());
- // [END automl_language_sentiment_analysis_list_datasets]
- // [END automl_language_text_classification_list_datasets]
- // [END automl_translate_list_datasets]
- // [END automl_vision_classification_list_datasets]
- // [END automl_vision_object_detection_list_datasets]
- System.out.format(
- "Text extraction dataset metadata: %s\n", dataset.getTextExtractionDatasetMetadata());
- // [END automl_language_entity_extraction_list_datasets]
-
- // [START automl_language_sentiment_analysis_list_datasets]
- System.out.format(
- "Text sentiment dataset metadata: %s\n", dataset.getTextSentimentDatasetMetadata());
- // [END automl_language_sentiment_analysis_list_datasets]
-
- // [START automl_language_text_classification_list_datasets]
- System.out.format(
- "Text classification dataset metadata: %s\n",
- dataset.getTextClassificationDatasetMetadata());
- // [END automl_language_text_classification_list_datasets]
-
- // [START automl_translate_list_datasets]
- 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());
- // [END automl_translate_list_datasets]
-
- // [START automl_vision_classification_list_datasets]
- System.out.format(
- "Image classification dataset metadata: %s\n",
- dataset.getImageClassificationDatasetMetadata());
- // [END automl_vision_classification_list_datasets]
-
- // [START automl_vision_object_detection_list_datasets]
- System.out.format(
- "Image object detection dataset metadata: %s\n",
- dataset.getImageObjectDetectionDatasetMetadata());
- // [START automl_language_entity_extraction_list_datasets]
- // [START automl_language_sentiment_analysis_list_datasets]
- // [START automl_language_text_classification_list_datasets]
- // [START automl_translate_list_datasets]
- // [START automl_vision_classification_list_datasets]
- }
- }
- }
-}
-// [END automl_language_entity_extraction_list_datasets]
-// [END automl_language_sentiment_analysis_list_datasets]
-// [END automl_language_text_classification_list_datasets]
-// [END automl_translate_list_datasets]
-// [END automl_vision_classification_list_datasets]
-// [END automl_vision_object_detection_list_datasets]
diff --git a/automl/src/main/java/com/example/automl/ListModelEvaluations.java b/automl/src/main/java/com/example/automl/ListModelEvaluations.java
deleted file mode 100644
index 5b25ec08fe7..00000000000
--- a/automl/src/main/java/com/example/automl/ListModelEvaluations.java
+++ /dev/null
@@ -1,112 +0,0 @@
-/*
- * 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_language_entity_extraction_list_model_evaluations]
-// [START automl_language_sentiment_analysis_list_model_evaluations]
-// [START automl_language_text_classification_list_model_evaluations]
-// [START automl_translate_list_model_evaluations]
-// [START automl_vision_classification_list_model_evaluations]
-// [START automl_vision_object_detection_list_model_evaluations]
-
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.ListModelEvaluationsRequest;
-import com.google.cloud.automl.v1.ModelEvaluation;
-import com.google.cloud.automl.v1.ModelName;
-import java.io.IOException;
-
-class ListModelEvaluations {
-
- public static void main(String[] args) throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- listModelEvaluations(projectId, modelId);
- }
-
- // List model evaluations
- static void listModelEvaluations(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);
- ListModelEvaluationsRequest modelEvaluationsrequest =
- ListModelEvaluationsRequest.newBuilder().setParent(modelFullId.toString()).build();
-
- // List all the model evaluations in the model by applying filter.
- System.out.println("List of model evaluations:");
- for (ModelEvaluation modelEvaluation :
- client.listModelEvaluations(modelEvaluationsrequest).iterateAll()) {
-
- 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());
- // [END automl_language_sentiment_analysis_list_model_evaluations]
- // [END automl_language_text_classification_list_model_evaluations]
- // [END automl_translate_list_model_evaluations]
- // [END automl_vision_classification_list_model_evaluations]
- // [END automl_vision_object_detection_list_model_evaluations]
- System.out.format(
- "Entity Extraction Model Evaluation Metrics: %s\n",
- modelEvaluation.getTextExtractionEvaluationMetrics());
- // [END automl_language_entity_extraction_list_model_evaluations]
-
- // [START automl_language_sentiment_analysis_list_model_evaluations]
- System.out.format(
- "Sentiment Analysis Model Evaluation Metrics: %s\n",
- modelEvaluation.getTextSentimentEvaluationMetrics());
- // [END automl_language_sentiment_analysis_list_model_evaluations]
-
- // [START automl_language_text_classification_list_model_evaluations]
- // [START automl_vision_classification_list_model_evaluations]
- System.out.format(
- "Classification Model Evaluation Metrics: %s\n",
- modelEvaluation.getClassificationEvaluationMetrics());
- // [END automl_language_text_classification_list_model_evaluations]
- // [END automl_vision_classification_list_model_evaluations]
-
- // [START automl_translate_list_model_evaluations]
- System.out.format(
- "Translate Model Evaluation Metrics: %s\n",
- modelEvaluation.getTranslationEvaluationMetrics());
- // [END automl_translate_list_model_evaluations]
-
- // [START automl_vision_object_detection_list_model_evaluations]
- System.out.format(
- "Object Detection Model Evaluation Metrics: %s\n",
- modelEvaluation.getImageObjectDetectionEvaluationMetrics());
- // [START automl_language_entity_extraction_list_model_evaluations]
- // [START automl_language_sentiment_analysis_list_model_evaluations]
- // [START automl_language_text_classification_list_model_evaluations]
- // [START automl_translate_list_model_evaluations]
- // [START automl_vision_classification_list_model_evaluations]
- }
- }
- }
-}
-// [END automl_language_entity_extraction_list_model_evaluations]
-// [END automl_language_sentiment_analysis_list_model_evaluations]
-// [END automl_language_text_classification_list_model_evaluations]
-// [END automl_translate_list_model_evaluations]
-// [END automl_vision_classification_list_model_evaluations]
-// [END automl_vision_object_detection_list_model_evaluations]
diff --git a/automl/src/main/java/com/example/automl/ListModels.java b/automl/src/main/java/com/example/automl/ListModels.java
deleted file mode 100644
index c24f09b28ae..00000000000
--- a/automl/src/main/java/com/example/automl/ListModels.java
+++ /dev/null
@@ -1,70 +0,0 @@
-/*
- * 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_list_models]
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.ListModelsRequest;
-import com.google.cloud.automl.v1.LocationName;
-import com.google.cloud.automl.v1.Model;
-import java.io.IOException;
-
-class ListModels {
-
- static void listModels() throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- listModels(projectId);
- }
-
- // List the models available in the specified location
- static void listModels(String projectId) 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
-
- // Create list models request.
- ListModelsRequest listModelsRequest =
- ListModelsRequest.newBuilder()
- .setParent(projectLocation.toString())
- .setFilter("")
- .build();
-
- // List all the models available in the region by applying filter.
- System.out.println("List of models:");
- for (Model model : client.listModels(listModelsRequest).iterateAll()) {
- // 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_list_models]
diff --git a/automl/src/main/java/com/example/automl/ListOperationStatus.java b/automl/src/main/java/com/example/automl/ListOperationStatus.java
deleted file mode 100644
index a980d41bad5..00000000000
--- a/automl/src/main/java/com/example/automl/ListOperationStatus.java
+++ /dev/null
@@ -1,66 +0,0 @@
-/*
- * 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_list_operation_status]
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.LocationName;
-import com.google.longrunning.ListOperationsRequest;
-import com.google.longrunning.Operation;
-import java.io.IOException;
-
-class ListOperationStatus {
-
- static void listOperationStatus() throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- listOperationStatus(projectId);
- }
-
- // Get the status of an operation
- static void listOperationStatus(String projectId) 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
-
- // Create list operations request.
- ListOperationsRequest listrequest =
- ListOperationsRequest.newBuilder().setName(projectLocation.toString()).build();
-
- // List all the operations names available in the region by applying filter.
- for (Operation operation :
- client.getOperationsClient().listOperations(listrequest).iterateAll()) {
- System.out.println("Operation details:");
- System.out.format("\tName: %s\n", operation.getName());
- System.out.format("\tMetadata Type Url: %s\n", operation.getMetadata().getTypeUrl());
- System.out.format("\tDone: %s\n", operation.getDone());
- if (operation.hasResponse()) {
- System.out.format("\tResponse Type Url: %s\n", operation.getResponse().getTypeUrl());
- }
- if (operation.hasError()) {
- System.out.println("\tResponse:");
- System.out.format("\t\tError code: %s\n", operation.getError().getCode());
- System.out.format("\t\tError message: %s\n\n", operation.getError().getMessage());
- }
- }
- }
- }
-}
-// [END automl_list_operation_status]
diff --git a/automl/src/main/java/com/example/automl/TranslateCreateDataset.java b/automl/src/main/java/com/example/automl/TranslateCreateDataset.java
deleted file mode 100644
index 77769bdbec4..00000000000
--- a/automl/src/main/java/com/example/automl/TranslateCreateDataset.java
+++ /dev/null
@@ -1,76 +0,0 @@
-/*
- * 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_create_dataset]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.Dataset;
-import com.google.cloud.automl.v1.LocationName;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.cloud.automl.v1.TranslationDatasetMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class TranslateCreateDataset {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String displayName = "YOUR_DATASET_NAME";
- createDataset(projectId, displayName);
- }
-
- // Create a dataset
- static void createDataset(String projectId, String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
-
- // Specify the source and target language.
- TranslationDatasetMetadata translationDatasetMetadata =
- TranslationDatasetMetadata.newBuilder()
- .setSourceLanguageCode("en")
- .setTargetLanguageCode("ja")
- .build();
- Dataset dataset =
- Dataset.newBuilder()
- .setDisplayName(displayName)
- .setTranslationDatasetMetadata(translationDatasetMetadata)
- .build();
- OperationFuture future =
- client.createDatasetAsync(projectLocation, dataset);
-
- Dataset createdDataset = future.get();
-
- // Display the dataset information.
- System.out.format("Dataset name: %s\n", createdDataset.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 = createdDataset.getName().split("/");
- String datasetId = names[names.length - 1];
- System.out.format("Dataset id: %s\n", datasetId);
- }
- }
-}
-// [END automl_translate_create_dataset]
diff --git a/automl/src/main/java/com/example/automl/TranslateCreateModel.java b/automl/src/main/java/com/example/automl/TranslateCreateModel.java
deleted file mode 100644
index cddd597c6bb..00000000000
--- a/automl/src/main/java/com/example/automl/TranslateCreateModel.java
+++ /dev/null
@@ -1,69 +0,0 @@
-/*
- * 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_create_model]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.LocationName;
-import com.google.cloud.automl.v1.Model;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.cloud.automl.v1.TranslationModelMetadata;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class TranslateCreateModel {
-
- public static void main(String[] args)
- throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String datasetId = "YOUR_DATASET_ID";
- String displayName = "YOUR_DATASET_NAME";
- createModel(projectId, datasetId, displayName);
- }
-
- // Create a model
- static void createModel(String projectId, String datasetId, String displayName)
- 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()) {
- // A resource that represents Google Cloud Platform location.
- LocationName projectLocation = LocationName.of(projectId, "us-central1");
- TranslationModelMetadata translationModelMetadata =
- TranslationModelMetadata.newBuilder().build();
- Model model =
- Model.newBuilder()
- .setDisplayName(displayName)
- .setDatasetId(datasetId)
- .setTranslationModelMetadata(translationModelMetadata)
- .build();
-
- // Create a model with the model metadata in the region.
- OperationFuture future =
- client.createModelAsync(projectLocation, model);
- // OperationFuture.get() will block until the model is created, which may take several hours.
- // You can use OperationFuture.getInitialFuture to get a future representing the initial
- // response to the request, which contains information while the operation is in progress.
- System.out.format("Training operation name: %s\n", future.getInitialFuture().get().getName());
- System.out.println("Training started...");
- }
- }
-}
-// [END automl_translate_create_model]
diff --git a/automl/src/main/java/com/example/automl/TranslatePredict.java b/automl/src/main/java/com/example/automl/TranslatePredict.java
deleted file mode 100644
index 2385b831c44..00000000000
--- a/automl/src/main/java/com/example/automl/TranslatePredict.java
+++ /dev/null
@@ -1,62 +0,0 @@
-/*
- * 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_predict]
-import com.google.cloud.automl.v1.ExamplePayload;
-import com.google.cloud.automl.v1.ModelName;
-import com.google.cloud.automl.v1.PredictRequest;
-import com.google.cloud.automl.v1.PredictResponse;
-import com.google.cloud.automl.v1.PredictionServiceClient;
-import com.google.cloud.automl.v1.TextSnippet;
-import java.io.IOException;
-import java.nio.file.Files;
-import java.nio.file.Paths;
-
-class TranslatePredict {
-
- public static void main(String[] args) throws IOException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- String filePath = "path_to_local_file.txt";
- predict(projectId, modelId, filePath);
- }
-
- static void predict(String projectId, String modelId, String filePath) 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 (PredictionServiceClient client = PredictionServiceClient.create()) {
- // Get the full path of the model.
- ModelName name = ModelName.of(projectId, "us-central1", modelId);
-
- String content = new String(Files.readAllBytes(Paths.get(filePath)));
-
- TextSnippet textSnippet = TextSnippet.newBuilder().setContent(content).build();
- ExamplePayload payload = ExamplePayload.newBuilder().setTextSnippet(textSnippet).build();
- PredictRequest predictRequest =
- PredictRequest.newBuilder().setName(name.toString()).setPayload(payload).build();
-
- PredictResponse response = client.predict(predictRequest);
- TextSnippet translatedContent =
- response.getPayload(0).getTranslation().getTranslatedContent();
- System.out.format("Translated Content: %s\n", translatedContent.getContent());
- }
- }
-}
-// [END automl_translate_predict]
diff --git a/automl/src/main/java/com/example/automl/UndeployModel.java b/automl/src/main/java/com/example/automl/UndeployModel.java
deleted file mode 100644
index e7ef532e94d..00000000000
--- a/automl/src/main/java/com/example/automl/UndeployModel.java
+++ /dev/null
@@ -1,56 +0,0 @@
-/*
- * 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_undeploy_model]
-import com.google.api.gax.longrunning.OperationFuture;
-import com.google.cloud.automl.v1.AutoMlClient;
-import com.google.cloud.automl.v1.ModelName;
-import com.google.cloud.automl.v1.OperationMetadata;
-import com.google.cloud.automl.v1.UndeployModelRequest;
-import com.google.protobuf.Empty;
-import java.io.IOException;
-import java.util.concurrent.ExecutionException;
-
-class UndeployModel {
-
- static void undeployModel() throws IOException, ExecutionException, InterruptedException {
- // TODO(developer): Replace these variables before running the sample.
- String projectId = "YOUR_PROJECT_ID";
- String modelId = "YOUR_MODEL_ID";
- undeployModel(projectId, modelId);
- }
-
- // Undeploy a model from prediction
- static void undeployModel(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);
- UndeployModelRequest request =
- UndeployModelRequest.newBuilder().setName(modelFullId.toString()).build();
- OperationFuture
+
+Integrating App Engine with Google Analytics.
+
+## Project setup, installation, and configuration
+
+- Register for [Google Analytics](http://www.google.com/analytics/), create
+an application, and get a tracking Id.
+- [Find your tracking Id](https://support.google.com/analytics/answer/1008080?hl=en)
+and set it as an environment variable in [`appengine-web.xml`](src/main/webapp/WEB-INF/appengine-web.xml).
+
+## Running locally
+This example uses the
+[Maven Cloud CLI based plugin](https://cloud.google.com/appengine/docs/java/tools/using-maven).
+To run this sample locally:
+
+ $ mvn appengine:run
+
+## Deploying
+
+ $ mvn clean package appengine:deploy
diff --git a/appengine-java21/ee8/analytics/pom.xml b/appengine-java21/ee8/analytics/pom.xml
new file mode 100644
index 00000000000..c8d726fa071
--- /dev/null
+++ b/appengine-java21/ee8/analytics/pom.xml
@@ -0,0 +1,136 @@
+
+![AppEngine logo](http://storage.cloud.google.com/" + bucket + "/image.jpeg)
");
+ out.println(
+ "![AppEngine logo resized](http://storage.cloud.google.com/"
+ + bucket
+ + "/resizedImage.jpeg)
");
+ out.println(
+ "![AppEngine logo rotated](http://storage.cloud.google.com/"
+ + bucket
+ + "/rotatedImage.jpeg)
");
+ out.println("