Java

Ukurasa huu umetafsiriwa kutoka Kiingereza. Ikiwa hizi mbili zinatofautiana, ukurasa wa Kiingereza ndio sahihi. Soma ukurasa wa Kiingereza

Maktaba ya Java ni com.getlingara:lingara-java kwenye Maven Central. Inahitaji Java 17 au toleo jipya zaidi na hutumia java.net.http.HttpClient ya JDK yenyewe, pamoja na Jackson kwa JSON.

Jinsi inavyotumika

Miito inasawazishwa. Kwa miito mingi kwa wakati mmoja, iendeshe kwenye nyuzi pepe au kwenye executor.
Mtiririko ni EventStream, ambayo ni Iterable na pia AutoCloseable: usome kwa kitanzi cha for ndani ya try-with-resources. Matukio ni record chini ya sealed interface, kwa hivyo switch juu yake inashughulikia hali zote.
Ili kughairi, katiza uzi au ita close() kutoka kwenye uzi mwingine. Kisha mwito hurusha CancellationException, ambayo si mojawapo ya hitilafu za maktaba.
Hitilafu hurithi LingaraException, istisna isiyokaguliwa. retryAfter() hurudisha Optional<Duration>.
Unda mteja kwa LingaraClient.builder(). Mwito usiotiririsha hauna kikomo cha muda hadi uweke requestTimeout.

Sampuli zilizo hapa chini huongeza utegemezi, huunda mteja, hutiririsha orodha ya msamiati na hushughulikia hitilafu.

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

Jinsi inavyotumika

Kile ukurasa huu unachofunika