Basic Usage

This section will guide you through the basic usage of AT4J.

Simple Hello World Translation

import io.github.brenoepics.at4j.AzureApi;
import io.github.brenoepics.at4j.AzureApiBuilder;
import io.github.brenoepics.at4j.data.request.TranslateParams;
import io.github.brenoepics.at4j.data.response.TranslationResponse;

import java.util.List;
import java.util.Optional;

public class ExampleApi {
  private static AzureApi azureApi;
  
 public static void main(String[] args) {
  // Insert your Azure key and region here
  String azureKey = "<Your Azure Subscription Key>";
  String azureRegion = "<Your Azure Subscription Region>";
  azureApi = new AzureApiBuilder().setKey(azureKey).region(azureRegion).build();

    translate(args.join(" "), List.of("pt", "es", "fr"));
 }

  private static void translate(String inputText, List<String> targetLanguages) {
    TranslateParams params = new TranslateParams(inputText, targetLanguages);
    Optional<TranslationResponse> result = azureApi.translate(params).join();

    result.ifPresent(response ->
      response.getFirstResult().getTranslations().forEach(ExampleApi::log));
  }
  
  public static void log(Translation translation) {
    System.out.println(translation.getLanguageCode() + ": " + translation.getText());
  }
}

Input

Hello, World!

Result

pt: Olá, Mundo!
es: ¡Hola mundo!
fr: Salut tout le monde!

The above example demonstrates the core feature of AT4J:

• AzureApi: Serves as the primary entry point for interacting with the Azure Translator API. It provides a set of methods to perform various translation-related tasks.

You may already have questions—don't worry. We will cover every little detail in the rest of the documentation. For now, please read along, so you can have a high-level understanding of what AT4J offers.

Prerequisites

The rest of the documentation assumes basic familiarity with Java and Azure Portal. If you are totally new to backend development, it's recommended to familiarize yourself with Java programming and the Azure Portal before proceeding with the rest of the documentation. Here are some brief pointers to help you get started: Java and Azure if needed.

Still Got Questions?

Check out our GitHub Discussions page for more information and to ask questions.