Java

Halaman ini diterjemahkan daripada bahasa Inggeris. Jika kedua-duanya berbeza, halaman bahasa Inggeris adalah yang betul. Baca halaman bahasa Inggeris

Pustaka Java ialah com.getlingara:lingara-java di Maven Central. Ia memerlukan Java 17 atau lebih baharu dan menggunakan java.net.http.HttpClient milik JDK sendiri, dengan Jackson untuk JSON.

Cara ia digunakan

Panggilan adalah segerak. Untuk banyak panggilan serentak, jalankan pada virtual thread atau executor.
Strim ialah sebuah EventStream, yang merupakan Iterable dan juga AutoCloseable: bacanya dengan gelung for di dalam try-with-resources. Peristiwa ialah record di bawah sealed interface, jadi switch ke atasnya adalah menyeluruh.
Untuk membatalkan, sampuk thread atau panggil close() dari thread lain. Panggilan itu kemudian melontarkan CancellationException, yang bukan salah satu ralat pustaka.
Ralat melanjutkan LingaraException, sebuah unchecked exception. retryAfter() memulangkan Optional<Duration>.
Bina klien dengan LingaraClient.builder(). Panggilan yang tidak menstrim tiada had masa sehingga anda menetapkan requestTimeout.

Contoh di bawah menambah kebergantungan, mencipta klien, menstrim senarai perbendaharaan kata dan mengendalikan ralat.

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

Cara ia digunakan

Perkara yang dibalut oleh halaman ini