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

كيف تبدو في الاستخدام

ما تغلّفه هذه الصفحة