Java

Cette page est traduite de l'anglais. En cas de différence, la page anglaise fait foi. Lire la page en anglais

La bibliothèque Java est com.getlingara:lingara-java sur Maven Central. Elle nécessite Java 17 ou version ultérieure et utilise le java.net.http.HttpClient propre au JDK, avec Jackson pour le JSON.

À quoi elle ressemble

Les appels sont synchrones. Pour en exécuter plusieurs à la fois, lancez-les sur des threads virtuels ou un exécuteur.
Un flux est un EventStream, à la fois Iterable et AutoCloseable : lisez-le avec une boucle for dans un try-with-resources. Les événements sont des records sous une interface scellée, si bien qu’un switch sur eux est exhaustif.
Pour annuler, interrompez le thread ou appelez close() depuis un autre thread. L’appel lève alors CancellationException, qui ne fait pas partie des erreurs de la bibliothèque.
Les erreurs étendent LingaraException, une exception non vérifiée. retryAfter() renvoie un Optional<Duration>.
Construisez un client avec LingaraClient.builder(). Un appel sans flux n’a aucun délai d’expiration tant que vous ne définissez pas requestTimeout.

Les exemples ci-dessous ajoutent la dépendance, créent un client, diffusent une liste de vocabulaire et gèrent une erreur.

Java

<dependency>
  <groupId>com.getlingara</groupId>
  <artifactId>lingara-java</artifactId>
  <version>0.1.0-alpha.6</version>
</dependency>

Java

import com.getlingara.client.LingaraClient;

LingaraClient client =
    LingaraClient.builder()
        .clientCredentials(
            System.getenv("LINGARA_CLIENT_ID"), System.getenv("LINGARA_CLIENT_SECRET"))
        .build();

Java

import com.getlingara.client.model.GenerateVocabularyEvent;
import com.getlingara.client.model.VocabRequest;

VocabRequest request = new VocabRequest().level(2).sourceLang("en").targetLang("zh").count(8);
try (EventStream<GenerateVocabularyEvent> stream = client.generateVocabulary(request)) {
  for (GenerateVocabularyEvent event : stream) {
    if (event instanceof GenerateVocabularyEvent.Item item) {
      System.out.println(item.data().getWord() + " " + item.data().getTranslation());
    }
  }
}

Java

try {
  client.getUsage();
} catch (LingaraException e) {
  if (e instanceof ApiException api) {
    // A refusal from the API: status(), code() (stable) and getMessage() (localised).
    System.out.println(api.status() + " " + api.code() + " " + api.getMessage());
    api.retryAfter().ifPresent(wait -> System.out.println("retry after " + wait));
  } else if (e instanceof OAuthException oauth) {
    // The token endpoint refused the credentials or the scopes.
    System.out.println(oauth.status() + " " + oauth.error() + " " + oauth.description());
  } else if (e instanceof MaintenanceException maintenance) {
    System.out.println("under maintenance");
    maintenance.retryAfter().ifPresent(wait -> System.out.println("retry after " + wait));
  } else if (e instanceof TransportException transport) {
    // No usable answer: CONNECT, TLS, RESET, TIMEOUT, and so on.
    System.out.println("transport: " + transport.kind());
  }
}
// An interrupted call throws java.util.concurrent.CancellationException instead.

Java

À quoi elle ressemble

Ce que cette page encapsule