RCB-542 1.9 release (#118)

* Added java.version to User-Agent

* WS-1272 Multilingual Example

* Example updates

Author: cp2boston

api/src/main/java/com/basistech/rosette/api/HttpRosetteAPI.java

@@ -82,7 +82,7 @@ public class HttpRosetteAPI extends AbstractRosetteAPI {
     public static final String DEFAULT_URL_BASE = "https://api.rosette.com/rest/v1";
     public static final String SERVICE_NAME = "RosetteAPI";
     public static final String BINDING_VERSION = getVersion();
-    public static final String USER_AGENT_STR = SERVICE_NAME + "-Java/" + BINDING_VERSION;
+    public static final String USER_AGENT_STR = SERVICE_NAME + "-Java/" + BINDING_VERSION + "/" + System.getProperty("java.version");
     private static final Logger LOG = LoggerFactory.getLogger(HttpRosetteAPI.class);
     private String urlBase = DEFAULT_URL_BASE;
     private int failureRetries = 1;

examples/src/main/java/com/basistech/rosette/examples/EntitiesExample.java

@@ -35,7 +35,7 @@ public static void main(String[] args) {
     }
 
     private void run() throws IOException {
-        String entitiesTextData = "Bill Murray will appear in new Ghostbusters film: Dr. Peter Venkman was spotted filming a cameo in Boston this… http://dlvr.it/BnsFfS";
+        String entitiesTextData = "The Securities and Exchange Commission today announced the leadership of the agency’s trial unit.  Bridget Fitzpatrick has been named Chief Litigation Counsel of the SEC and David Gottesman will continue to serve as the agency’s Deputy Chief Litigation Counsel. Since December 2016, Ms. Fitzpatrick and Mr. Gottesman have served as Co-Acting Chief Litigation Counsel.  In that role, they were jointly responsible for supervising the trial unit at the agency’s Washington D.C. headquarters as well as coordinating with litigators in the SEC’s 11 regional offices around the country.";
         HttpRosetteAPI rosetteApi = new HttpRosetteAPI.Builder()
                                 .key(getApiKeyFromSystemProperty())
                                 .url(getAltUrlFromSystemProperty())

examples/src/main/java/com/basistech/rosette/examples/LanguageMultilingualExample.java

@@ -0,0 +1,57 @@
+/*
+* Copyright 2014 Basis Technology Corp.
+*
+* 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.basistech.rosette.examples;
+
+import com.basistech.rosette.api.HttpRosetteAPI;
+import com.basistech.rosette.apimodel.DocumentRequest;
+import com.basistech.rosette.apimodel.LanguageOptions;
+import com.basistech.rosette.apimodel.LanguageResponse;
+
+import java.io.IOException;
+
+/**
+ * Example which demonstrates the language detection api with the multilingual option.
+ */
+public final class LanguageMultilingualExample extends ExampleBase {
+    public static void main(String[] args) {
+        try {
+            new LanguageMultilingualExample().run();
+        } catch (Exception e) {
+            e.printStackTrace();
+            System.exit(1);
+        }
+    }
+
+    private void run() throws IOException {
+        String languageMultilingualData = "On Thursday, as protesters gathered in Washington D.C., the United States Federal Communications Commission under Chairman Ajit Pai voted 3-2 to overturn a 2015 decision, commonly called Net Neutrality, that forbade Internet service providers (ISPs) such as Verizon, Comcast, and AT&T from blocking individual websites or charging websites or customers more for faster load times.  Quatre femmes ont été nommées au Conseil de rédaction de la loi du Qatar. Jeudi, le décret royal du Qatar a annoncé que 28 nouveaux membres ont été nommés pour le Conseil de la Choura du pays.  ذكرت مصادر أمنية يونانية، أن 9 موقوفين من منظمة \"د هـ ك ب ج\" الذين كانت قد أوقفتهم الشرطة اليونانية في وقت سابق كانوا يخططون لاغتيال الرئيس التركي رجب طيب أردوغان.";
+
+        HttpRosetteAPI rosetteApi = new HttpRosetteAPI.Builder()
+                                    .key(getApiKeyFromSystemProperty())
+                                    .url(getAltUrlFromSystemProperty())
+                                    .build();
+        //The api object creates an http client, but to provide your own:
+        //rosetteApi.httpClient(CloseableHttpClient)
+
+        LanguageOptions options = LanguageOptions.builder().multilingual(true).build();
+
+        DocumentRequest<LanguageOptions> request = DocumentRequest.<LanguageOptions>builder()
+            .content(languageMultilingualData)
+            .options(options)
+            .build();
+        LanguageResponse response = rosetteApi.perform(HttpRosetteAPI.LANGUAGE_SERVICE_PATH, request, LanguageResponse.class);
+        System.out.println(responseToJson(response));
+    }
+}

examples/src/main/java/com/basistech/rosette/examples/MorphologyCompleteExample.java

@@ -37,7 +37,7 @@ public static void main(String[] args) {
     }
 
     private void run() throws IOException {
-        String morphologyCompleteData = "The quick brown fox jumped over the lazy dog. Yes he did.";
+        String morphologyCompleteData = "The quick brown fox jumped over the lazy dog. 👍🏾 Yes he did. B)";
 
         HttpRosetteAPI rosetteApi = new HttpRosetteAPI.Builder()
                                     .key(getApiKeyFromSystemProperty())

examples/src/main/java/com/basistech/rosette/examples/RelationshipsExample.java

@@ -36,7 +36,7 @@ public static void main(String[] args) {
     }
 
     private void run() throws IOException {
-        String relationshipsTextData = "Bill Gates, Microsoft's former CEO, is a philanthropist.";
+        String relationshipsTextData = "FLIR Systems is headquartered in Oregon and produces thermal imaging, night vision, and infrared cameras and sensor systems.  According to the SEC’s order instituting a settled administrative proceeding, FLIR entered into a multi-million dollar contract to provide thermal binoculars to the Saudi government in November 2008.  Timms and Ramahi were the primary sales employees responsible for the contract, and also were involved in negotiations to sell FLIR’s security cameras to the same government officials.  At the time, Timms was the head of FLIR’s Middle East office in Dubai.";
 
         HttpRosetteAPI rosetteApi = new HttpRosetteAPI.Builder()
                 .key(getApiKeyFromSystemProperty())

examples/src/main/java/com/basistech/rosette/examples/SentencesExample.java

@@ -35,7 +35,7 @@ public static void main(String[] args) {
     }
 
     private void run() throws IOException {
-        String sentencesData = "This land is your land. This land is my land\nFrom California to the New York island;\nFrom the red wood forest to the Gulf Stream waters\n\nThis land was made for you and Me.\n\nAs I was walking that ribbon of highway,\nI saw above me that endless skyway:\nI saw below me that golden valley:\nThis land was made for you and me.";
+        String sentencesData = "This land is your land. This land is my land, from California to the New York island; from the red wood forest to the Gulf Stream waters. This land was made for you and Me. As I was walking that ribbon of highway, I saw above me that endless skyway: I saw below me that golden valley: This land was made for you and me.";
 
         HttpRosetteAPI rosetteApi = new HttpRosetteAPI.Builder()
                 .key(getApiKeyFromSystemProperty())

examples/src/main/java/com/basistech/rosette/examples/TransliterationExample.java

@@ -37,7 +37,7 @@ public static void main(String[] args) {
     }
 
     private void run() throws IOException {
-        String transliterationData = "haza ya7taj fakat ila an takoun ba3dh el-nousous allati na7n ymkn an tata7awal ila al-3arabizi.";
+        String transliterationData = "ana r2ye7 el gam3a el sa3a 3 el 3asr";
 
         HttpRosetteAPI rosetteApi = new HttpRosetteAPI.Builder()
                 .key(getApiKeyFromSystemProperty())