diff --git a/gcloud-java-core/pom.xml b/gcloud-java-core/pom.xml index 0a426d50a21b..50155634bd11 100644 --- a/gcloud-java-core/pom.xml +++ b/gcloud-java-core/pom.xml @@ -106,7 +106,7 @@ com.google.api gax - 0.0.14 + 0.0.16 com.google.api.grpc diff --git a/gcloud-java-language/pom.xml b/gcloud-java-language/pom.xml new file mode 100644 index 000000000000..090f6b449f35 --- /dev/null +++ b/gcloud-java-language/pom.xml @@ -0,0 +1,126 @@ + + + 4.0.0 + gcloud-java-language + jar + GCloud Java Natural Language + https://github.com/GoogleCloudPlatform/gcloud-java/tree/master/gcloud-java-language + + Java idiomatic client for Google Cloud Natural Language. + + + com.google.cloud + gcloud-java-pom + 0.2.9-SNAPSHOT + + + gcloud-java-language + + + + io.netty + netty-tcnative-boringssl-static + 1.1.33.Fork17 + + + ${project.groupId} + gcloud-java-core + ${project.version} + + + com.google.api.grpc + grpc-google-cloud-language-v1beta1 + 0.0.7 + + + io.grpc + grpc-all + 0.15.0 + + + com.google.auto.value + auto-value + 1.1 + + + ${project.groupId} + gcloud-java-core + ${project.version} + test-jar + test + + + junit + junit + 4.12 + test + + + org.easymock + easymock + 3.4 + test + + + + + doclint-java8-disable + + [1.8,) + + + + -Xdoclint:none + + + + + + + org.codehaus.mojo + build-helper-maven-plugin + 1.9.1 + + + generate-sources + add-source + + + generated/src/main/java + + + + + + + org.apache.maven.plugins + maven-javadoc-plugin + 2.10.3 + + + attach-javadocs + + jar + + + ${javadoc.opts} + + + + + + maven-compiler-plugin + + + + 3.1 + + 1.7 + 1.7 + UTF-8 + -Xlint:unchecked + + + + + diff --git a/gcloud-java-language/src/main/java/com/google/cloud/language/spi/v1beta1/LanguageServiceApi.java b/gcloud-java-language/src/main/java/com/google/cloud/language/spi/v1beta1/LanguageServiceApi.java new file mode 100644 index 000000000000..836cf1b47fb2 --- /dev/null +++ b/gcloud-java-language/src/main/java/com/google/cloud/language/spi/v1beta1/LanguageServiceApi.java @@ -0,0 +1,402 @@ +/* + * Copyright 2016 Google Inc. All Rights Reserved. + * + * 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.language.spi.v1beta1; + +import com.google.api.gax.grpc.ApiCallable; +import com.google.api.gax.protobuf.PathTemplate; +import com.google.cloud.language.v1beta1.AnalyzeEntitiesRequest; +import com.google.cloud.language.v1beta1.AnalyzeEntitiesResponse; +import com.google.cloud.language.v1beta1.AnalyzeSentimentRequest; +import com.google.cloud.language.v1beta1.AnalyzeSentimentResponse; +import com.google.cloud.language.v1beta1.AnnotateTextRequest; +import com.google.cloud.language.v1beta1.AnnotateTextRequest.Features; +import com.google.cloud.language.v1beta1.AnnotateTextResponse; +import com.google.cloud.language.v1beta1.Document; +import com.google.cloud.language.v1beta1.EncodingType; +import io.grpc.ManagedChannel; +import java.io.Closeable; +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.ScheduledExecutorService; + +// AUTO-GENERATED DOCUMENTATION AND SERVICE +/** + * Service Description: Provides text analysis operations such as sentiment analysis and entity + * recognition. + * + *

This class provides the ability to make remote calls to the backing service through method + * calls that map to API methods. Sample code to get started: + * + * 

+ * 
+ * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+ *   Document document = Document.newBuilder().build();
+ *   AnalyzeSentimentResponse response = languageServiceApi.analyzeSentiment(document);
+ * }
+ * 
+ *
+ * + *

Note: close() needs to be called on the languageServiceApi object to clean up resources such + * as threads. In the example above, try-with-resources is used, which automatically calls + * close(). + * + *

The surface of this class includes several types of Java methods for each of the API's methods: + * + *

    + *
  1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available + * as parameters, and not every API method will have a flattened method entry point. + *
  2. A "request object" method. This type of method only takes one parameter, a request + * object, which must be constructed before the call. Not every API method will have a request + * object method. + *
  3. A "callable" method. This type of method takes no parameters and returns an immutable + * ApiCallable object, which can be used to initiate calls to the service. + *
+ * + *

See the individual methods for example code. + * + *

Many parameters require resource names to be formatted in a particular way. To assist + * with these names, this class includes a format method for each type of name, and additionally + * a parse method to extract the individual identifiers contained within names that are + * returned. + * + *

This class can be customized by passing in a custom instance of LanguageServiceSettings to + * create(). For example: + * + * 

+ * 
+ * LanguageServiceSettings languageServiceSettings = LanguageServiceSettings.defaultBuilder()
+ *     .provideChannelWith(myCredentials)
+ *     .build();
+ * LanguageServiceApi languageServiceApi = LanguageServiceApi.create(languageServiceSettings);
+ * 
+ *
+ */ +@javax.annotation.Generated("by GAPIC") +public class LanguageServiceApi implements AutoCloseable { + private final LanguageServiceSettings settings; + private final ManagedChannel channel; + private final ScheduledExecutorService executor; + private final List closeables = new ArrayList<>(); + + private final ApiCallable + analyzeSentimentCallable; + private final ApiCallable + analyzeEntitiesCallable; + private final ApiCallable annotateTextCallable; + + public final LanguageServiceSettings getSettings() { + return settings; + } + + /** + * Constructs an instance of LanguageServiceApi with default settings. + */ + public static final LanguageServiceApi create() throws IOException { + return create(LanguageServiceSettings.defaultBuilder().build()); + } + + /** + * Constructs an instance of LanguageServiceApi, using the given settings. + * The channels are created based on the settings passed in, or defaults for any + * settings that are not set. + */ + public static final LanguageServiceApi create(LanguageServiceSettings settings) + throws IOException { + return new LanguageServiceApi(settings); + } + + /** + * Constructs an instance of LanguageServiceApi, using the given settings. + * This is protected so that it easy to make a subclass, but otherwise, the static + * factory methods should be preferred. + */ + protected LanguageServiceApi(LanguageServiceSettings settings) throws IOException { + this.settings = settings; + this.executor = settings.getExecutorProvider().getOrBuildExecutor(); + this.channel = settings.getChannelProvider().getOrBuildChannel(this.executor); + + this.analyzeSentimentCallable = + ApiCallable.create(settings.analyzeSentimentSettings(), this.channel, this.executor); + this.analyzeEntitiesCallable = + ApiCallable.create(settings.analyzeEntitiesSettings(), this.channel, this.executor); + this.annotateTextCallable = + ApiCallable.create(settings.annotateTextSettings(), this.channel, this.executor); + + if (settings.getChannelProvider().shouldAutoClose()) { + closeables.add( + new Closeable() { + @Override + public void close() throws IOException { + channel.shutdown(); + } + }); + } + if (settings.getExecutorProvider().shouldAutoClose()) { + closeables.add( + new Closeable() { + @Override + public void close() throws IOException { + executor.shutdown(); + } + }); + } + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD + /** + * Analyzes the sentiment of the provided text. + * + * Sample code: + * 

+   * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+   *   Document document = Document.newBuilder().build();
+   *   AnalyzeSentimentResponse response = languageServiceApi.analyzeSentiment(document);
+   * }
+   *
+ * + * @param document Input document. Currently, `analyzeSentiment` only supports English text + * ([Document.language][google.cloud.language.v1beta1.Document.language]="EN"). + * @throws com.google.api.gax.grpc.ApiException if the remote call fails + */ + public final AnalyzeSentimentResponse analyzeSentiment(Document document) { + AnalyzeSentimentRequest request = + AnalyzeSentimentRequest.newBuilder().setDocument(document).build(); + return analyzeSentiment(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD + /** + * Analyzes the sentiment of the provided text. + * + * Sample code: + * 

+   * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+   *   Document document = Document.newBuilder().build();
+   *   AnalyzeSentimentRequest request = AnalyzeSentimentRequest.newBuilder()
+   *     .setDocument(document)
+   *     .build();
+   *   AnalyzeSentimentResponse response = languageServiceApi.analyzeSentiment(request);
+   * }
+   *
+ * + * @param request The request object containing all of the parameters for the API call. + * @throws com.google.api.gax.grpc.ApiException if the remote call fails + */ + private final AnalyzeSentimentResponse analyzeSentiment(AnalyzeSentimentRequest request) { + return analyzeSentimentCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD + /** + * Analyzes the sentiment of the provided text. + * + * Sample code: + * 

+   * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+   *   Document document = Document.newBuilder().build();
+   *   AnalyzeSentimentRequest request = AnalyzeSentimentRequest.newBuilder()
+   *     .setDocument(document)
+   *     .build();
+   *   ListenableFuture<AnalyzeSentimentResponse> future = languageServiceApi.analyzeSentimentCallable().futureCall(request);
+   *   // Do something
+   *   AnalyzeSentimentResponse response = future.get();
+   * }
+   *
+ */ + public final ApiCallable + analyzeSentimentCallable() { + return analyzeSentimentCallable; + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD + /** + * Finds named entities (currently finds proper names) in the text, + * entity types, salience, mentions for each entity, and other properties. + * + * Sample code: + * 

+   * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+   *   Document document = Document.newBuilder().build();
+   *   EncodingType encodingType = EncodingType.NONE;
+   *   AnalyzeEntitiesResponse response = languageServiceApi.analyzeEntities(document, encodingType);
+   * }
+   *
+ * + * @param document Input document. + * @param encodingType The encoding type used by the API to calculate offsets. + * @throws com.google.api.gax.grpc.ApiException if the remote call fails + */ + public final AnalyzeEntitiesResponse analyzeEntities( + Document document, EncodingType encodingType) { + AnalyzeEntitiesRequest request = + AnalyzeEntitiesRequest.newBuilder() + .setDocument(document) + .setEncodingType(encodingType) + .build(); + return analyzeEntities(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD + /** + * Finds named entities (currently finds proper names) in the text, + * entity types, salience, mentions for each entity, and other properties. + * + * Sample code: + * 

+   * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+   *   Document document = Document.newBuilder().build();
+   *   EncodingType encodingType = EncodingType.NONE;
+   *   AnalyzeEntitiesRequest request = AnalyzeEntitiesRequest.newBuilder()
+   *     .setDocument(document)
+   *     .setEncodingType(encodingType)
+   *     .build();
+   *   AnalyzeEntitiesResponse response = languageServiceApi.analyzeEntities(request);
+   * }
+   *
+ * + * @param request The request object containing all of the parameters for the API call. + * @throws com.google.api.gax.grpc.ApiException if the remote call fails + */ + public final AnalyzeEntitiesResponse analyzeEntities(AnalyzeEntitiesRequest request) { + return analyzeEntitiesCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD + /** + * Finds named entities (currently finds proper names) in the text, + * entity types, salience, mentions for each entity, and other properties. + * + * Sample code: + * 

+   * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+   *   Document document = Document.newBuilder().build();
+   *   EncodingType encodingType = EncodingType.NONE;
+   *   AnalyzeEntitiesRequest request = AnalyzeEntitiesRequest.newBuilder()
+   *     .setDocument(document)
+   *     .setEncodingType(encodingType)
+   *     .build();
+   *   ListenableFuture<AnalyzeEntitiesResponse> future = languageServiceApi.analyzeEntitiesCallable().futureCall(request);
+   *   // Do something
+   *   AnalyzeEntitiesResponse response = future.get();
+   * }
+   *
+ */ + public final ApiCallable + analyzeEntitiesCallable() { + return analyzeEntitiesCallable; + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD + /** + * Advanced API that analyzes the document and provides a full set of text + * annotations, including semantic, syntactic, and sentiment information. This + * API is intended for users who are familiar with machine learning and need + * in-depth text features to build upon. + * + * Sample code: + * 

+   * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+   *   Document document = Document.newBuilder().build();
+   *   Features features = Features.newBuilder().build();
+   *   EncodingType encodingType = EncodingType.NONE;
+   *   AnnotateTextResponse response = languageServiceApi.annotateText(document, features, encodingType);
+   * }
+   *
+ * + * @param document Input document. + * @param features The enabled features. + * @param encodingType The encoding type used by the API to calculate offsets. + * @throws com.google.api.gax.grpc.ApiException if the remote call fails + */ + public final AnnotateTextResponse annotateText( + Document document, Features features, EncodingType encodingType) { + AnnotateTextRequest request = + AnnotateTextRequest.newBuilder() + .setDocument(document) + .setFeatures(features) + .setEncodingType(encodingType) + .build(); + return annotateText(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD + /** + * Advanced API that analyzes the document and provides a full set of text + * annotations, including semantic, syntactic, and sentiment information. This + * API is intended for users who are familiar with machine learning and need + * in-depth text features to build upon. + * + * Sample code: + * 

+   * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+   *   Document document = Document.newBuilder().build();
+   *   Features features = Features.newBuilder().build();
+   *   EncodingType encodingType = EncodingType.NONE;
+   *   AnnotateTextRequest request = AnnotateTextRequest.newBuilder()
+   *     .setDocument(document)
+   *     .setFeatures(features)
+   *     .setEncodingType(encodingType)
+   *     .build();
+   *   AnnotateTextResponse response = languageServiceApi.annotateText(request);
+   * }
+   *
+ * + * @param request The request object containing all of the parameters for the API call. + * @throws com.google.api.gax.grpc.ApiException if the remote call fails + */ + public final AnnotateTextResponse annotateText(AnnotateTextRequest request) { + return annotateTextCallable().call(request); + } + + // AUTO-GENERATED DOCUMENTATION AND METHOD + /** + * Advanced API that analyzes the document and provides a full set of text + * annotations, including semantic, syntactic, and sentiment information. This + * API is intended for users who are familiar with machine learning and need + * in-depth text features to build upon. + * + * Sample code: + * 

+   * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+   *   Document document = Document.newBuilder().build();
+   *   Features features = Features.newBuilder().build();
+   *   EncodingType encodingType = EncodingType.NONE;
+   *   AnnotateTextRequest request = AnnotateTextRequest.newBuilder()
+   *     .setDocument(document)
+   *     .setFeatures(features)
+   *     .setEncodingType(encodingType)
+   *     .build();
+   *   ListenableFuture<AnnotateTextResponse> future = languageServiceApi.annotateTextCallable().futureCall(request);
+   *   // Do something
+   *   AnnotateTextResponse response = future.get();
+   * }
+   *
+ */ + public final ApiCallable annotateTextCallable() { + return annotateTextCallable; + } + + /** + * Initiates an orderly shutdown in which preexisting calls continue but new calls are immediately + * cancelled. + */ + @Override + public final void close() throws Exception { + for (AutoCloseable closeable : closeables) { + closeable.close(); + } + } +} diff --git a/gcloud-java-language/src/main/java/com/google/cloud/language/spi/v1beta1/LanguageServiceSettings.java b/gcloud-java-language/src/main/java/com/google/cloud/language/spi/v1beta1/LanguageServiceSettings.java new file mode 100644 index 000000000000..4db00138dbdd --- /dev/null +++ b/gcloud-java-language/src/main/java/com/google/cloud/language/spi/v1beta1/LanguageServiceSettings.java @@ -0,0 +1,362 @@ +/* + * Copyright 2016 Google Inc. All Rights Reserved. + * + * 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.language.spi.v1beta1; + +import com.google.api.gax.core.ConnectionSettings; +import com.google.api.gax.core.RetrySettings; +import com.google.api.gax.grpc.ApiCallSettings; +import com.google.api.gax.grpc.PageStreamingDescriptor; +import com.google.api.gax.grpc.ServiceApiSettings; +import com.google.api.gax.grpc.SimpleCallSettings; +import com.google.auth.Credentials; +import com.google.cloud.language.v1beta1.AnalyzeEntitiesRequest; +import com.google.cloud.language.v1beta1.AnalyzeEntitiesResponse; +import com.google.cloud.language.v1beta1.AnalyzeSentimentRequest; +import com.google.cloud.language.v1beta1.AnalyzeSentimentResponse; +import com.google.cloud.language.v1beta1.AnnotateTextRequest; +import com.google.cloud.language.v1beta1.AnnotateTextResponse; +import com.google.cloud.language.v1beta1.LanguageServiceGrpc; +import com.google.common.collect.ImmutableList; +import com.google.common.collect.ImmutableMap; +import com.google.common.collect.ImmutableSet; +import com.google.common.collect.Lists; +import com.google.common.collect.Sets; +import io.grpc.ManagedChannel; +import io.grpc.Status; +import java.io.IOException; +import java.util.List; +import java.util.concurrent.ScheduledExecutorService; +import org.joda.time.Duration; + +// AUTO-GENERATED DOCUMENTATION AND CLASS +/** + * Settings class to configure an instance of {@link LanguageServiceApi}. + * + *

The default instance has everything set to sensible defaults: + * + *

    + *
  • The default service address (language.googleapis.com) and default port (443) + * are used. + *
  • Credentials are acquired automatically through Application Default Credentials. + *
  • Retries are configured for idempotent methods but not for non-idempotent methods. + *
+ * + *

The builder of this class is recursive, so contained classes are themselves builders. + * When build() is called, the tree of builders is called to create the complete settings + * object. For example, to set the total timeout of analyzeSentiment to 30 seconds: + * + * 

+ * 
+ * LanguageServiceSettings.Builder languageServiceSettingsBuilder =
+ *     LanguageServiceSettings.defaultBuilder();
+ * languageServiceSettingsBuilder.analyzeSentimentSettings().getRetrySettingsBuilder()
+ *     .setTotalTimeout(Duration.standardSeconds(30));
+ * LanguageServiceSettings languageServiceSettings = languageServiceSettingsBuilder.build();
+ * 
+ *
+ */ +@javax.annotation.Generated("by GAPIC") +public class LanguageServiceSettings extends ServiceApiSettings { + /** + * The default address of the service. + */ + private static final String DEFAULT_SERVICE_ADDRESS = "language.googleapis.com"; + + /** + * The default port of the service. + */ + private static final int DEFAULT_SERVICE_PORT = 443; + + /** + * The default scopes of the service. + */ + private static final ImmutableList DEFAULT_SERVICE_SCOPES = + ImmutableList.builder().add("https://www.googleapis.com/auth/cloud-platform").build(); + + /** + * The default connection settings of the service. + */ + public static final ConnectionSettings DEFAULT_CONNECTION_SETTINGS = + ConnectionSettings.newBuilder() + .setServiceAddress(DEFAULT_SERVICE_ADDRESS) + .setPort(DEFAULT_SERVICE_PORT) + .provideCredentialsWith(DEFAULT_SERVICE_SCOPES) + .build(); + + private final SimpleCallSettings + analyzeSentimentSettings; + private final SimpleCallSettings + analyzeEntitiesSettings; + private final SimpleCallSettings annotateTextSettings; + + /** + * Returns the object with the settings used for calls to analyzeSentiment. + */ + public SimpleCallSettings + analyzeSentimentSettings() { + return analyzeSentimentSettings; + } + + /** + * Returns the object with the settings used for calls to analyzeEntities. + */ + public SimpleCallSettings + analyzeEntitiesSettings() { + return analyzeEntitiesSettings; + } + + /** + * Returns the object with the settings used for calls to annotateText. + */ + public SimpleCallSettings annotateTextSettings() { + return annotateTextSettings; + } + + /** + * Returns the default service address. + */ + public static String getDefaultServiceAddress() { + return DEFAULT_SERVICE_ADDRESS; + } + + /** + * Returns the default service port. + */ + public static int getDefaultServicePort() { + return DEFAULT_SERVICE_PORT; + } + + /** + * Returns the default service scopes. + */ + public static ImmutableList getDefaultServiceScopes() { + return DEFAULT_SERVICE_SCOPES; + } + + /** + * Returns a builder for this class with recommended defaults. + */ + public static Builder defaultBuilder() { + return Builder.createDefault(); + } + + /** + * Returns a new builder for this class. + */ + public static Builder newBuilder() { + return new Builder(); + } + + /** + * Returns a builder containing all the values of this settings class. + */ + public Builder toBuilder() { + return new Builder(this); + } + + private LanguageServiceSettings(Builder settingsBuilder) throws IOException { + super( + settingsBuilder.getChannelProvider(), + settingsBuilder.getExecutorProvider(), + settingsBuilder.getGeneratorName(), + settingsBuilder.getGeneratorVersion(), + settingsBuilder.getClientLibName(), + settingsBuilder.getClientLibVersion()); + + analyzeSentimentSettings = settingsBuilder.analyzeSentimentSettings().build(); + analyzeEntitiesSettings = settingsBuilder.analyzeEntitiesSettings().build(); + annotateTextSettings = settingsBuilder.annotateTextSettings().build(); + } + + /** + * Builder for LanguageServiceSettings. + */ + public static class Builder extends ServiceApiSettings.Builder { + private final ImmutableList methodSettingsBuilders; + + private SimpleCallSettings.Builder + analyzeSentimentSettings; + private SimpleCallSettings.Builder + analyzeEntitiesSettings; + private SimpleCallSettings.Builder + annotateTextSettings; + + private static final ImmutableMap> RETRYABLE_CODE_DEFINITIONS; + + static { + ImmutableMap.Builder> definitions = ImmutableMap.builder(); + definitions.put( + "idempotent", + Sets.immutableEnumSet( + Lists.newArrayList( + Status.Code.DEADLINE_EXCEEDED, Status.Code.UNAVAILABLE))); + definitions.put("non_idempotent", Sets.immutableEnumSet(Lists.newArrayList())); + RETRYABLE_CODE_DEFINITIONS = definitions.build(); + } + + private static final ImmutableMap RETRY_PARAM_DEFINITIONS; + + static { + ImmutableMap.Builder definitions = ImmutableMap.builder(); + RetrySettings.Builder settingsBuilder = null; + settingsBuilder = + RetrySettings.newBuilder() + .setInitialRetryDelay(Duration.millis(100L)) + .setRetryDelayMultiplier(1.3) + .setMaxRetryDelay(Duration.millis(60000L)) + .setInitialRpcTimeout(Duration.millis(60000L)) + .setRpcTimeoutMultiplier(1.0) + .setMaxRpcTimeout(Duration.millis(60000L)) + .setTotalTimeout(Duration.millis(600000L)); + definitions.put("default", settingsBuilder); + RETRY_PARAM_DEFINITIONS = definitions.build(); + } + + private Builder() { + super(DEFAULT_CONNECTION_SETTINGS); + + analyzeSentimentSettings = + SimpleCallSettings.newBuilder(LanguageServiceGrpc.METHOD_ANALYZE_SENTIMENT); + + analyzeEntitiesSettings = + SimpleCallSettings.newBuilder(LanguageServiceGrpc.METHOD_ANALYZE_ENTITIES); + + annotateTextSettings = + SimpleCallSettings.newBuilder(LanguageServiceGrpc.METHOD_ANNOTATE_TEXT); + + methodSettingsBuilders = + ImmutableList.of( + analyzeSentimentSettings, analyzeEntitiesSettings, annotateTextSettings); + } + + private static Builder createDefault() { + Builder builder = new Builder(); + + builder + .analyzeSentimentSettings() + .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("idempotent")) + .setRetrySettingsBuilder(RETRY_PARAM_DEFINITIONS.get("default")); + + builder + .analyzeEntitiesSettings() + .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("idempotent")) + .setRetrySettingsBuilder(RETRY_PARAM_DEFINITIONS.get("default")); + + builder + .annotateTextSettings() + .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("idempotent")) + .setRetrySettingsBuilder(RETRY_PARAM_DEFINITIONS.get("default")); + + return builder; + } + + private Builder(LanguageServiceSettings settings) { + super(settings); + + analyzeSentimentSettings = settings.analyzeSentimentSettings.toBuilder(); + analyzeEntitiesSettings = settings.analyzeEntitiesSettings.toBuilder(); + annotateTextSettings = settings.annotateTextSettings.toBuilder(); + + methodSettingsBuilders = + ImmutableList.of( + analyzeSentimentSettings, analyzeEntitiesSettings, annotateTextSettings); + } + + @Override + protected ConnectionSettings getDefaultConnectionSettings() { + return DEFAULT_CONNECTION_SETTINGS; + } + + @Override + public Builder provideExecutorWith(ScheduledExecutorService executor, boolean shouldAutoClose) { + super.provideExecutorWith(executor, shouldAutoClose); + return this; + } + + @Override + public Builder provideChannelWith(ManagedChannel channel, boolean shouldAutoClose) { + super.provideChannelWith(channel, shouldAutoClose); + return this; + } + + @Override + public Builder provideChannelWith(ConnectionSettings settings) { + super.provideChannelWith(settings); + return this; + } + + @Override + public Builder provideChannelWith(Credentials credentials) { + super.provideChannelWith(credentials); + return this; + } + + @Override + public Builder provideChannelWith(List scopes) { + super.provideChannelWith(scopes); + return this; + } + + @Override + public Builder setGeneratorHeader(String name, String version) { + super.setGeneratorHeader(name, version); + return this; + } + + @Override + public Builder setClientLibHeader(String name, String version) { + super.setClientLibHeader(name, version); + return this; + } + + /** + * Applies the given settings to all of the API methods in this service. Only + * values that are non-null will be applied, so this method is not capable + * of un-setting any values. + */ + public Builder applyToAllApiMethods(ApiCallSettings.Builder apiCallSettings) throws Exception { + super.applyToAllApiMethods(methodSettingsBuilders, apiCallSettings); + return this; + } + + /** + * Returns the builder for the settings used for calls to analyzeSentiment. + */ + public SimpleCallSettings.Builder + analyzeSentimentSettings() { + return analyzeSentimentSettings; + } + + /** + * Returns the builder for the settings used for calls to analyzeEntities. + */ + public SimpleCallSettings.Builder + analyzeEntitiesSettings() { + return analyzeEntitiesSettings; + } + + /** + * Returns the builder for the settings used for calls to annotateText. + */ + public SimpleCallSettings.Builder + annotateTextSettings() { + return annotateTextSettings; + } + + @Override + public LanguageServiceSettings build() throws IOException { + return new LanguageServiceSettings(this); + } + } +} diff --git a/gcloud-java-language/src/main/java/com/google/cloud/language/spi/v1beta1/package-info.java b/gcloud-java-language/src/main/java/com/google/cloud/language/spi/v1beta1/package-info.java new file mode 100644 index 000000000000..07c5cc884e39 --- /dev/null +++ b/gcloud-java-language/src/main/java/com/google/cloud/language/spi/v1beta1/package-info.java @@ -0,0 +1,38 @@ +/* + * Copyright 2016 Google Inc. All Rights Reserved. + * + * 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. + */ + +/** + * A client to Google Cloud Natural Language API. + * + * The interfaces provided are listed below, along with a usage sample + * + * ================== + * LanguageServiceApi + * ================== + * + * Service Description: Provides text analysis operations such as sentiment analysis and entity + * recognition. + * + * Sample for LanguageServiceApi: + * 
+ * 
+ * try (LanguageServiceApi languageServiceApi = LanguageServiceApi.create()) {
+ *   Document document = Document.newBuilder().build();
+ *   AnalyzeSentimentResponse response = languageServiceApi.analyzeSentiment(document);
+ * }
+ * 
+ *
+ * + */ +package com.google.cloud.language.spi.v1beta1; diff --git a/gcloud-java-language/src/test/java/com/google/cloud/language/spi/v1beta1/LanguageServiceTest.java b/gcloud-java-language/src/test/java/com/google/cloud/language/spi/v1beta1/LanguageServiceTest.java new file mode 100644 index 000000000000..1e593e8c2e15 --- /dev/null +++ b/gcloud-java-language/src/test/java/com/google/cloud/language/spi/v1beta1/LanguageServiceTest.java @@ -0,0 +1,147 @@ +/* + * Copyright 2016 Google Inc. All Rights Reserved. + * + * 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.language.spi.v1beta1; + +import com.google.api.gax.core.PageAccessor; +import com.google.api.gax.testing.MockGrpcService; +import com.google.api.gax.testing.MockServiceHelper; +import com.google.cloud.language.v1beta1.AnalyzeEntitiesRequest; +import com.google.cloud.language.v1beta1.AnalyzeEntitiesResponse; +import com.google.cloud.language.v1beta1.AnalyzeSentimentRequest; +import com.google.cloud.language.v1beta1.AnalyzeSentimentResponse; +import com.google.cloud.language.v1beta1.AnnotateTextRequest; +import com.google.cloud.language.v1beta1.AnnotateTextRequest.Features; +import com.google.cloud.language.v1beta1.AnnotateTextResponse; +import com.google.cloud.language.v1beta1.Document; +import com.google.cloud.language.v1beta1.EncodingType; +import com.google.common.collect.Lists; +import com.google.protobuf.GeneratedMessage; +import java.io.IOException; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; +import org.junit.After; +import org.junit.AfterClass; +import org.junit.Assert; +import org.junit.Before; +import org.junit.BeforeClass; +import org.junit.Test; + +@javax.annotation.Generated("by GAPIC") +public class LanguageServiceTest { + private static MockLanguageService mockLanguageService; + private static MockServiceHelper serviceHelper; + private LanguageServiceApi api; + + @BeforeClass + public static void startStaticServer() { + mockLanguageService = new MockLanguageService(); + serviceHelper = + new MockServiceHelper("in-process-1", Arrays.asList(mockLanguageService)); + serviceHelper.start(); + } + + @AfterClass + public static void stopServer() { + serviceHelper.stop(); + } + + @Before + public void setUp() throws IOException { + serviceHelper.reset(); + LanguageServiceSettings settings = + LanguageServiceSettings.defaultBuilder() + .provideChannelWith(serviceHelper.createChannel(), true) + .build(); + api = LanguageServiceApi.create(settings); + } + + @After + public void tearDown() throws Exception { + api.close(); + } + + @Test + @SuppressWarnings("all") + public void analyzeSentimentTest() { + String language = "language-1613589672"; + AnalyzeSentimentResponse expectedResponse = + AnalyzeSentimentResponse.newBuilder().setLanguage(language).build(); + List expectedResponses = new ArrayList<>(); + expectedResponses.add(expectedResponse); + mockLanguageService.setResponses(expectedResponses); + + Document document = Document.newBuilder().build(); + + AnalyzeSentimentResponse actualResponse = api.analyzeSentiment(document); + Assert.assertEquals(expectedResponse, actualResponse); + + List actualRequests = mockLanguageService.getRequests(); + Assert.assertEquals(1, actualRequests.size()); + AnalyzeSentimentRequest actualRequest = (AnalyzeSentimentRequest) actualRequests.get(0); + + Assert.assertEquals(document, actualRequest.getDocument()); + } + + @Test + @SuppressWarnings("all") + public void analyzeEntitiesTest() { + String language = "language-1613589672"; + AnalyzeEntitiesResponse expectedResponse = + AnalyzeEntitiesResponse.newBuilder().setLanguage(language).build(); + List expectedResponses = new ArrayList<>(); + expectedResponses.add(expectedResponse); + mockLanguageService.setResponses(expectedResponses); + + Document document = Document.newBuilder().build(); + EncodingType encodingType = EncodingType.NONE; + + AnalyzeEntitiesResponse actualResponse = api.analyzeEntities(document, encodingType); + Assert.assertEquals(expectedResponse, actualResponse); + + List actualRequests = mockLanguageService.getRequests(); + Assert.assertEquals(1, actualRequests.size()); + AnalyzeEntitiesRequest actualRequest = (AnalyzeEntitiesRequest) actualRequests.get(0); + + Assert.assertEquals(document, actualRequest.getDocument()); + Assert.assertEquals(encodingType, actualRequest.getEncodingType()); + } + + @Test + @SuppressWarnings("all") + public void annotateTextTest() { + String language = "language-1613589672"; + AnnotateTextResponse expectedResponse = + AnnotateTextResponse.newBuilder().setLanguage(language).build(); + List expectedResponses = new ArrayList<>(); + expectedResponses.add(expectedResponse); + mockLanguageService.setResponses(expectedResponses); + + Document document = Document.newBuilder().build(); + Features features = Features.newBuilder().build(); + EncodingType encodingType = EncodingType.NONE; + + AnnotateTextResponse actualResponse = api.annotateText(document, features, encodingType); + Assert.assertEquals(expectedResponse, actualResponse); + + List actualRequests = mockLanguageService.getRequests(); + Assert.assertEquals(1, actualRequests.size()); + AnnotateTextRequest actualRequest = (AnnotateTextRequest) actualRequests.get(0); + + Assert.assertEquals(document, actualRequest.getDocument()); + Assert.assertEquals(features, actualRequest.getFeatures()); + Assert.assertEquals(encodingType, actualRequest.getEncodingType()); + } +} diff --git a/gcloud-java-language/src/test/java/com/google/cloud/language/spi/v1beta1/MockLanguageService.java b/gcloud-java-language/src/test/java/com/google/cloud/language/spi/v1beta1/MockLanguageService.java new file mode 100644 index 000000000000..eeb79bcd52a7 --- /dev/null +++ b/gcloud-java-language/src/test/java/com/google/cloud/language/spi/v1beta1/MockLanguageService.java @@ -0,0 +1,50 @@ +/* + * Copyright 2016 Google Inc. All Rights Reserved. + * + * 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.language.spi.v1beta1; + +import com.google.api.gax.testing.MockGrpcService; +import com.google.cloud.language.v1beta1.LanguageServiceGrpc; +import com.google.protobuf.GeneratedMessage; +import io.grpc.ServerServiceDefinition; +import java.util.List; + +@javax.annotation.Generated("by GAPIC") +public class MockLanguageService implements MockGrpcService { + private MockLanguageServiceImpl serviceImpl; + + public MockLanguageService() { + serviceImpl = new MockLanguageServiceImpl(); + } + + @Override + public List getRequests() { + return serviceImpl.getRequests(); + } + + @Override + public void setResponses(List responses) { + serviceImpl.setResponses(responses); + } + + @Override + public ServerServiceDefinition getServiceDefinition() { + return LanguageServiceGrpc.bindService(serviceImpl); + } + + @Override + public void reset() { + serviceImpl.reset(); + } +} diff --git a/gcloud-java-language/src/test/java/com/google/cloud/language/spi/v1beta1/MockLanguageServiceImpl.java b/gcloud-java-language/src/test/java/com/google/cloud/language/spi/v1beta1/MockLanguageServiceImpl.java new file mode 100644 index 000000000000..13379ee13b2b --- /dev/null +++ b/gcloud-java-language/src/test/java/com/google/cloud/language/spi/v1beta1/MockLanguageServiceImpl.java @@ -0,0 +1,81 @@ +/* + * Copyright 2016 Google Inc. All Rights Reserved. + * + * 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.language.spi.v1beta1; + +import com.google.cloud.language.v1beta1.AnalyzeEntitiesRequest; +import com.google.cloud.language.v1beta1.AnalyzeEntitiesResponse; +import com.google.cloud.language.v1beta1.AnalyzeSentimentRequest; +import com.google.cloud.language.v1beta1.AnalyzeSentimentResponse; +import com.google.cloud.language.v1beta1.AnnotateTextRequest; +import com.google.cloud.language.v1beta1.AnnotateTextResponse; +import com.google.cloud.language.v1beta1.LanguageServiceGrpc.LanguageService; +import com.google.common.collect.Lists; +import com.google.protobuf.GeneratedMessage; +import io.grpc.stub.StreamObserver; +import java.util.ArrayList; +import java.util.LinkedList; +import java.util.List; +import java.util.Queue; + +@javax.annotation.Generated("by GAPIC") +public class MockLanguageServiceImpl implements LanguageService { + private ArrayList requests; + private Queue responses; + + public MockLanguageServiceImpl() { + requests = new ArrayList<>(); + responses = new LinkedList<>(); + } + + public List getRequests() { + return requests; + } + + public void setResponses(List responses) { + this.responses = Lists.newLinkedList(responses); + } + + public void reset() { + requests = new ArrayList<>(); + responses = new LinkedList<>(); + } + + @Override + public void analyzeSentiment( + AnalyzeSentimentRequest request, StreamObserver responseObserver) { + AnalyzeSentimentResponse response = (AnalyzeSentimentResponse) responses.remove(); + requests.add(request); + responseObserver.onNext(response); + responseObserver.onCompleted(); + } + + @Override + public void analyzeEntities( + AnalyzeEntitiesRequest request, StreamObserver responseObserver) { + AnalyzeEntitiesResponse response = (AnalyzeEntitiesResponse) responses.remove(); + requests.add(request); + responseObserver.onNext(response); + responseObserver.onCompleted(); + } + + @Override + public void annotateText( + AnnotateTextRequest request, StreamObserver responseObserver) { + AnnotateTextResponse response = (AnnotateTextResponse) responses.remove(); + requests.add(request); + responseObserver.onNext(response); + responseObserver.onCompleted(); + } +} diff --git a/pom.xml b/pom.xml index 8002ac3338d1..cbf599e9da8c 100644 --- a/pom.xml +++ b/pom.xml @@ -101,6 +101,7 @@ gcloud-java-datastore gcloud-java-dns gcloud-java-examples + gcloud-java-language gcloud-java-logging gcloud-java-pubsub gcloud-java-resourcemanager