JSON Batch Translate

Version:	1.0
Keywords:	Google Translate, Microsoft Translator, Yandex Translate, Java, JSON, bulk translation
Copyright:	Alex Tunyk <alex at tunyk.com>
License:	Apache License version 2.0

JSON Batch Translate library allows you to perform multiple translations within a single call through using JSON object. Exactly the same JSON object will be returned back but with translated values (keys are kept original, only the one request per API invocation is sent for translation). Translation can be based on the one of following services:

• Google Translate
• Microsoft Translator
• Yandex Translate

Example Usage:

Let's say you have this JSON object:

{
    "key": "text to be translated",
    "complex": {
        "obj": "some other text to be translated"
    }
}

... and you need it to be translated in Spanish like this:

{
    "key": "texto a traducir",
    "complex": {
        "obj": "otro texto a traducir"
    }
}

... and you don't want multiple requests to be sent, but just one request as well as to have the possibility to use translation service provided by Google, Microsoft or Yandex.

So here is a code that will do this:

// define JSON string you'd like to translate
String in = "{\"key\":\"text to be translated\",\"complex\":{\"obj\":\"some other text to be translated\"}}";

// convert string to JSONObject
JSONObject jsonObject = new JSONObject(in);

// translate it from English to Spanish
JsonBatchTranslate.DEFAULT.execute(API.MicrosoftTranslatorAPI,
                                   /*INSERT-YOUR-KEY*/,
                                   jsonObject,
                                   Language.ENGLISH,
                                   Language.SPANISH,
                                   /*INSERT-REFERRER-TO-YOUR-WEBSITE*/);

// make sure you have it translated
out.getString("key"); // return translated string: "texto a traducir"
out.getJSONObject("complex").getString("obj"); // return translated string: "otro texto a traducir"

And if you need the JSONObject with translated particular properties only:

// translate the value of property 'key' only
JsonBatchTranslate.DEFAULT.execute(API.MicrosoftTranslatorAPI,
                                   /*INSERT-YOUR-KEY*/,
                                   jsonObject,
                                   Language.ENGLISH,
                                   Language.SPANISH,
                                   Arrays.asList("key")
                                   /*INSERT-REFERRER-TO-YOUR-WEBSITE*/);

// make sure that only the individual properties of JSONObject are translated
out.getString("key"); // return translated string: "texto a traducir"
out.getJSONObject("complex").getString("obj"); // return source string: "some other text to be translated"

You have to get your API key from corresponding service provider to be able to use translation API:

• Google Translate API Key
• Bing Developer API Key
• Yandex.Translate service is not API service. Currently, the Yandex.Translate service is available as a public beta version and provided to the user for personal, non commercial use. More details at Yandex Translate Terms Of Use and Yandex Rules

JSON Batch Translate is available as Maven artifact and distributed via Maven Central Repository and Sonatype OSS Snapshot:

<dependency>
    <groupId>com.tunyk.jsonbatchtranslate</groupId>
    <artifactId>json-batch-translate</artifactId>
    <version>1.1-SNAPSHOT</version>
</dependency>

Source

The source code is available on GitHub at https://github.com/TUNYK/json-batch-translate

git clone https://github.com/TUNYK/json-batch-translate.git

NOTE:

• To run Tests you need to update config.properties with your API keys.
• JSON Batch Translate uses microsoft-translator-java-api and google-api-translate-java.

Issues tracking

Issues tracking is available on GitHub at https://github.com/TUNYK/json-batch-translate/issues.

Bug reports, feature requests, and general inquiries welcome.