Java

Halaman ini diterjemahkan dari bahasa Inggris. Jika keduanya berbeda, halaman bahasa Inggris yang benar. Baca halaman bahasa Inggris

Pustaka Java adalah com.getlingara:lingara-java di Maven Central. Pustaka ini membutuhkan Java 17 atau lebih baru dan menggunakan java.net.http.HttpClient bawaan JDK, dengan Jackson untuk JSON.

Cara pemakaiannya

Panggilan bersifat sinkron. Untuk banyak panggilan sekaligus, jalankan di virtual thread atau executor.
Stream adalah sebuah EventStream, yang sekaligus Iterable dan AutoCloseable: baca dengan perulangan for di dalam try-with-resources. Event berupa record di bawah sealed interface, sehingga switch atasnya bersifat menyeluruh.
Untuk membatalkan, interupsi thread-nya atau panggil close() dari thread lain. Panggilan kemudian melempar CancellationException, yang bukan salah satu error pustaka.
Error merupakan turunan LingaraException, sebuah unchecked exception. retryAfter() mengembalikan Optional<Duration>.
Bangun klien dengan LingaraClient.builder(). Panggilan yang tidak melakukan streaming tidak punya batas waktu sampai Anda mengatur requestTimeout.

Contoh di bawah ini menambahkan dependensi, membuat klien, men-stream daftar kosakata, dan menangani error.

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 pemakaiannya

Yang dibungkus halaman ini