Java

ئەم پەڕەیە لە ئینگلیزییەوە وەرگێڕدراوە. ئەگەر هەردووکیان جیاواز بوون، پەڕە ئینگلیزییەکە ڕاستە. پەڕە ئینگلیزییەکە بخوێنەوە

کتێبخانەی Java بریتییە لە com.getlingara:lingara-java لەسەر Maven Central. پێویستی بە Java 17 یان نوێترە و java.net.http.HttpClientـی خودی JDK بەکار دەهێنێت، لەگەڵ Jackson بۆ JSON.

لە کرداردا چۆنە

بانگکردنەکان هاوکاتن. بۆ زۆریان پێکەوە، لەسەر دەزووە مەجازییەکان یان جێبەجێکەرێک کاریان پێ بکە.
ستریمێک EventStreamـێکە، کە هەم Iterableـە و هەم AutoCloseable: بە خولەی for لەناو try-with-resourcesـدا بیخوێنەرەوە. ڕووداوەکان تۆمارن لە ژێر ڕووکارێکی مۆرکراودا، بۆیە switchـێک بەسەریاندا گشتگیرە.
بۆ هەڵوەشاندنەوە، دەزووەکە بپچڕێنە یان لە دەزوویەکی ترەوە close() بانگ بکە. ئەوکات بانگکردنەکە CancellationException فڕێ دەدات، کە یەکێک نییە لە هەڵەکانی کتێبخانەکە.
هەڵەکان لە LingaraException میرات دەگرن، کە ئیستیسنایەکی نەپشکنراوە. retryAfter() Optional<Duration>ـێک دەگەڕێنێتەوە.
کلاینتێک بە LingaraClient.builder() دروست بکە. بانگکردنێک کە ستریم نەکات هیچ ماوەیەکی نییە تا requestTimeout دانەنێیت.

نموونەکانی خوارەوە پشتبەستنەکە زیاد دەکەن، کلاینتێک دروست دەکەن، لیستێکی وشەسازی ستریم دەکەن و هەڵەیەک چارەسەر دەکەن.

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

لە کرداردا چۆنە

ئەم پەڕەیە چی دەپێچێتەوە