Merge branch 'master' of https://github.com/GoogleCloudPlatform/java-docs-samples into vision-beta

Author: nirupa-kumar

READONLY

@@ -0,0 +1 @@
+/google/src/files/201106159/depot

appengine-java8/tasks/README.md

@@ -0,0 +1,101 @@
+# Google Cloud Tasks App Engine Queue Samples
+
+Sample command-line program for interacting with the Cloud Tasks API
+using App Engine queues.
+
+App Engine queues push tasks to an App Engine HTTP target. This directory
+contains both the App Engine app to deploy, as well as the snippets to run
+locally to push tasks to it, which could also be called on App Engine.
+
+`CreateTask.java` is a simple command-line program to create
+tasks to be pushed to the App Engine app.
+
+`TaskServlet.java` is the main App Engine app. This app serves as an endpoint to receive
+App Engine task attempts.
+
+
+## Initial Setup
+
+ * Set up a Google Cloud Project and enable billing.
+ * Enable the
+ [Cloud Tasks API](https://console.cloud.google.com/launcher/details/google/cloudtasks.googleapis.com).
+ * Download and install the [Cloud SDK](https://cloud.google.com/sdk).
+ * Download and install [Maven](http://maven.apache.org/install.html).
+
+## Creating a queue
+
+To create a queue using the Cloud SDK, use the following gcloud command:
+
+```
+gcloud beta tasks queues create-app-engine-queue my-appengine-queue
+```
+
+Note: A newly created queue will route to the default App Engine service and
+version unless configured to do otherwise.
+
+## Deploying the App Engine app
+[Using Maven and the App Engine Plugin](https://cloud.google.com/appengine/docs/flexible/java/using-maven)
+& [Maven Plugin Goals and Parameters](https://cloud.google.com/appengine/docs/flexible/java/maven-reference)
+
+### Running locally
+
+```
+mvn appengine:run
+```
+### Deploying
+
+```
+mvn appengine:deploy
+```
+
+## Running the Sample
+
+Set environment variables:
+
+First, your project ID:
+
+```
+export GOOGLE_CLOUD_PROJECT=<YOUR_PROJECT_ID>
+```
+
+Then the queue ID, as specified at queue creation time. Queue IDs already
+created can be listed with `gcloud beta tasks queues list`.
+
+```
+export QUEUE_ID=my-appengine-queue
+```
+
+And finally the location ID, which can be discovered with
+`gcloud beta tasks queues describe $QUEUE_ID`, with the location embedded in
+the "name" value (for instance, if the name is
+"projects/my-project/locations/us-central1/queues/my-appengine-queue", then the
+location is "us-central1").
+
+```
+export LOCATION_ID=<YOUR_ZONE>
+```
+
+Create a task, targeted at the `/tasks/create` endpoint, with a payload specified:
+
+```
+mvn exec:java -Dexec.mainClass="com.example.task.CreateTask" \
+    -Dexec.args="--project-id $GOOGLE_CLOUD_PROJECT \
+    --queue $QUEUE_ID --location $LOCATION_ID --payload hello"
+```
+
+The App Engine app serves as a target for the push requests. It has an
+endpoint `/tasks/create` that reads the payload (i.e., the request body) of the
+HTTP POST request and logs it. The log output can be viewed with:
+
+```
+gcloud app logs read
+```
+
+Create a task that will be scheduled for a time in the future using the
+`--in-seconds` flag:
+
+```
+mvn exec:java -Dexec.mainClass="com.example.task.CreateTask" \
+    -Dexec.args="--project-id $GOOGLE_CLOUD_PROJECT \
+    --queue $QUEUE_ID --location $LOCATION_ID --payload hello --in-seconds 30"
+```

appengine-java8/tasks/pom.xml

@@ -37,7 +37,6 @@ Copyright 2018 Google LLC
   <properties>
     <maven.compiler.target>1.8</maven.compiler.target>
     <maven.compiler.source>1.8</maven.compiler.source>
-    <maven-exec-plugin.version>1.6.0</maven-exec-plugin.version>
   </properties>
 
   <dependencies>
@@ -86,7 +85,7 @@ Copyright 2018 Google LLC
       <plugin>
         <groupId>org.codehaus.mojo</groupId>
         <artifactId>exec-maven-plugin</artifactId>
-        <version>${maven-exec-plugin.version}</version>
+        <version>1.6.0</version>
         <configuration>
           <mainClass>com.example.task.CreateTask</mainClass>
           <cleanupDaemonThreads>false</cleanupDaemonThreads>

jobs/cjd_sample/src/main/java/com/google/samples/AutoCompleteSample.java

@@ -20,19 +20,8 @@
 import com.google.api.services.jobs.v2.JobService.V2.Complete;
 import com.google.api.services.jobs.v2.model.Company;
 import com.google.api.services.jobs.v2.model.CompleteQueryResponse;
-import com.google.api.services.jobs.v2.model.CompletionResult;
-import com.google.api.services.jobs.v2.model.CreateJobRequest;
-import com.google.api.services.jobs.v2.model.HistogramFacets;
 import com.google.api.services.jobs.v2.model.Job;
-import com.google.api.services.jobs.v2.model.JobQuery;
-import com.google.api.services.jobs.v2.model.MatchingJob;
-import com.google.api.services.jobs.v2.model.RequestMetadata;
-import com.google.api.services.jobs.v2.model.SearchJobsRequest;
-import com.google.api.services.jobs.v2.model.SearchJobsResponse;
 import java.io.IOException;
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.List;
 
 /**
  * The samples in this file introduced how to do the auto complete, including:
@@ -43,7 +32,7 @@
  */
 public final class AutoCompleteSample {
 
-  private static JobService jobService = JobServiceUtils.getJobService();
+  private static JobService jobService = JobServiceQuickstart.getJobService();
 
   //[START auto_complete_job_title]
 

jobs/cjd_sample/src/main/java/com/google/samples/BasicCompanySample.java

@@ -38,7 +38,7 @@
  */
 public final class BasicCompanySample {
 
-  private static JobService jobService = JobServiceUtils.getJobService();
+  private static JobService jobService = JobServiceQuickstart.getJobService();
 
   // [START basic_company]
 

jobs/cjd_sample/src/main/java/com/google/samples/BasicJobSample.java

@@ -42,7 +42,7 @@
  */
 public final class BasicJobSample {
 
-  private static JobService jobService = JobServiceUtils.getJobService();
+  private static JobService jobService = JobServiceQuickstart.getJobService();
 
   // [START basic_job]
 

jobs/cjd_sample/src/main/java/com/google/samples/BatchOperationSample.java

@@ -45,7 +45,7 @@
  */
 public final class BatchOperationSample {
 
-  private static JobService jobService = JobServiceUtils.getJobService();
+  private static JobService jobService = JobServiceQuickstart.getJobService();
 
   // [START batch_job_create]
   public static List<Job> batchCreateJobs(String companyName) throws IOException {

jobs/cjd_sample/src/main/java/com/google/samples/CommuteSearchSample.java

@@ -36,7 +36,7 @@
  */
 public final class CommuteSearchSample {
 
-  private static JobService jobService = JobServiceUtils.getJobService();
+  private static JobService jobService = JobServiceQuickstart.getJobService();
 
   // [START commute_search]
 

jobs/cjd_sample/src/main/java/com/google/samples/CustomAttributeSample.java

@@ -18,12 +18,8 @@
 
 import com.google.api.services.jobs.v2.JobService;
 import com.google.api.services.jobs.v2.model.Company;
-import com.google.api.services.jobs.v2.model.CreateJobRequest;
 import com.google.api.services.jobs.v2.model.CustomAttribute;
-import com.google.api.services.jobs.v2.model.CustomField;
-import com.google.api.services.jobs.v2.model.CustomFieldFilter;
 import com.google.api.services.jobs.v2.model.Job;
-import com.google.api.services.jobs.v2.model.JobFilters;
 import com.google.api.services.jobs.v2.model.JobQuery;
 import com.google.api.services.jobs.v2.model.RequestMetadata;
 import com.google.api.services.jobs.v2.model.SearchJobsRequest;
@@ -44,7 +40,7 @@
  */
 public final class CustomAttributeSample {
 
-  private static JobService jobService = JobServiceUtils.getJobService();
+  private static JobService jobService = JobServiceQuickstart.getJobService();
 
   // [START custom_attribute_job]