Translate sample

translate/README.md

@@ -0,0 +1,66 @@
+# Google Cloud Translate Sample
+
+This sample demonstrates the use of [Google Cloud Translate
+API][Translate-Docs] for translating and detecting language text.
+
+[Translate-Docs]: https://cloud.google.com/translate/docs/
+
+## Java Version
+
+This sample requires you to have
+[Java8](https://docs.oracle.com/javase/8/docs/technotes/guides/install/install_overview.html).
+
+## Download Maven
+
+This sample uses the [Apache Maven][maven] build system. Before getting started,
+be
+sure to [download][maven-download] and [install][maven-install] it. When you use
+Maven as described here, it will automatically download the needed client
+libraries.
+
+[maven]: https://maven.apache.org
+[maven-download]: https://maven.apache.org/download.cgi
+[maven-install]: https://maven.apache.org/install.html
+
+## Run the sample
+
+To build the sample, we use Maven.
+
+```bash
+mvn clean compile assembly:single
+```
+
+We can then run the assembled JAR file with the `java` command. The variable
+$COMMAND takes three values `langsupport`, `detect` and `translate`.
+
+```
+JAR_FILE=target/translate-1.0-SNAPSHOT-jar-with-dependencies.jar
+java -jar $JAR_FILE <detect|translate|langsupport> <text>
+    <optional_source> <optional_target>
+```
+
+Example Usage:
+
+```
+INPUT="A quick brown fox jumped over a lazy dog."
+SOURCE_LANG="en"
+TARGET_LANG="fr"
+```
+
+Translate API Features:
+
+ * List the languages supported by the API
+   ```
+   java -jar $JAR_FILE langsupport
+   ```
+
+ * Detect input text language
+   ```
+   java -jar $JAR_FILE detect "$INPUT"
+  ```
+
+ * Translate input text (with options)
+   ```
+   java -jar $JAR_FILE translate "$INPUT"
+   java -jar $JAR_FILE translate "$INPUT" $SOURCE_LANG $TARGET_LANG
+   ```

translate/pom.xml

@@ -0,0 +1,69 @@
+<!--
+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.
+-->
+<project>
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>com.google.cloud.translate.samples</groupId>
+  <artifactId>translate</artifactId>
+  <version>1.0-SNAPSHOT</version>
+  <name>translate</name>
+  <url>http://maven.apache.org</url>
+  <properties>
+    <maven.compiler.target>1.8</maven.compiler.target>
+    <maven.compiler.source>1.8</maven.compiler.source>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+  <parent>
+    <groupId>com.google.cloud</groupId>
+    <artifactId>shared-configuration</artifactId>
+    <version>1.0.0</version>
+    <relativePath>../java-repo-tools</relativePath>
+  </parent>
+  <dependencies>
+    <dependency>
+      <groupId>com.google.cloud</groupId>
+      <artifactId>google-cloud-translate</artifactId>
+      <version>0.3.0</version>
+    </dependency>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>4.12</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.google.truth</groupId>
+      <artifactId>truth</artifactId>
+      <version>0.30</version>
+    </dependency>
+  </dependencies>
+  <build>
+    <plugins>
+    <plugin>
+      <artifactId>maven-assembly-plugin</artifactId>
+        <configuration>
+          <archive>
+            <manifest>
+              <mainClass>com.google.cloud.translate.samples.TranslateText</mainClass>
+            </manifest>
+          </archive>
+          <descriptorRefs>
+            <descriptorRef>jar-with-dependencies</descriptorRef>
+          </descriptorRefs>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+</project>

translate/src/main/java/com/google/cloud/translate/samples/TranslateText.java

@@ -0,0 +1,143 @@
+/*
+ * 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.translate.samples;
+
+import com.google.cloud.RetryParams;
+import com.google.cloud.translate.Detection;
+import com.google.cloud.translate.Language;
+import com.google.cloud.translate.Translate;
+import com.google.cloud.translate.Translate.TranslateOption;
+import com.google.cloud.translate.TranslateOptions;
+import com.google.cloud.translate.Translation;
+import com.google.common.collect.ImmutableList;
+
+import java.io.PrintStream;
+import java.util.List;
+
+public class TranslateText {
+  /**
+   * Detect the language of input text.
+   *
+   * @param sourceText source text to be detected for language
+   * @param out print stream
+   */
+  public static void detectLanguage(String sourceText, PrintStream out) {
+    Translate translate = createTranslateService();
+    List<Detection> detections = translate.detect(ImmutableList.of(sourceText));
+    System.out.println("Language(s) detected:");
+    for (Detection detection : detections) {
+      out.printf("\t%s\n", detection);
+    }
+  }
+
+  /**
+   * Translates the source text in any language to english.
+   *
+   * @param sourceText source text to be translated
+   * @param out print stream
+   */
+  public static void translateText(String sourceText, PrintStream out) {
+    Translate translate = createTranslateService();
+    Translation translation = translate.translate(sourceText);
+    out.printf("Source Text:\n\t%s\n", sourceText);
+    out.printf("Translated Text:\n\t%s\n", translation.translatedText());
+  }
+
+  /**
+   * Translate the source text from source to target language.
+   *
+   * @param sourceText source text to be translated
+   * @param sourceLang source language of the text
+   * @param targetLang target language of translated text
+   * @param out print stream
+   */
+  public static void translateTextWithOptions(
+      String sourceText,
+      String sourceLang,
+      String targetLang,
+      PrintStream out) {
+
+    Translate translate = createTranslateService();
+    TranslateOption srcLang = TranslateOption.sourceLanguage(sourceLang);
+    TranslateOption tgtLang = TranslateOption.targetLanguage(targetLang);
+
+    Translation translation = translate.translate(sourceText, srcLang, tgtLang);
+    out.printf("Source Text:\n\tLang: %s, Text: %s\n", sourceLang, sourceText);
+    out.printf("TranslatedText:\n\tLang: %s, Text: %s\n", targetLang, translation.translatedText());
+  }
+
+  /**
+   * Displays a list of supported languages and codes.
+   *
+   * @param out print stream
+   */
+  public static void displaySupportedLanguages(PrintStream out) {
+    Translate translate = createTranslateService();
+    List<Language> languages = translate.listSupportedLanguages();
+
+    for (Language language : languages) {
+      out.printf("Name: %s, Code: %s\n", language.name(), language.code());
+    }
+  }
+
+  /**
+   * Create Google Translate API Service.
+   *
+   * @return Google Translate Service
+   */
+  public static Translate createTranslateService() {
+    TranslateOptions translateOption = TranslateOptions.builder()
+        .retryParams(retryParams())
+        .connectTimeout(60000)
+        .readTimeout(60000)
+        .build();
+    return translateOption.service();
+  }
+
+  /**
+   * Retry params for the Translate API.
+   */
+  private static RetryParams retryParams() {
+    return RetryParams.builder()
+        .retryMaxAttempts(3)
+        .maxRetryDelayMillis(30000)
+        .totalRetryPeriodMillis(120000)
+        .initialRetryDelayMillis(250)
+        .build();
+  }
+
+  public static void main(String[] args) {
+    String command = args[0];
+    String text;
+
+    if (command.equals("detect")) {
+      text = args[1];
+      TranslateText.detectLanguage(text, System.out);
+    } else if (command.equals("translate")) {
+      text = args[1];
+      try {
+        String sourceLang = args[2];
+        String targetLang = args[3];
+        TranslateText.translateTextWithOptions(text, sourceLang, targetLang, System.out);
+      } catch (ArrayIndexOutOfBoundsException ex) {
+        TranslateText.translateText(text, System.out);
+      }
+    } else if (command.equals("langsupport")) {
+      TranslateText.displaySupportedLanguages(System.out);
+    }
+  }
+}