Kotlin

Bu sayfa İngilizceden çevrilmiştir. İkisi arasında fark varsa İngilizce sayfa doğrudur. İngilizce sayfayı oku

Kotlin kütüphanesi, Maven Central üzerindeki com.getlingara:lingara-kotlin paketidir. JVM üzerinde çalışır, Java 17 ile Kotlin 2.2 veya üstünü gerektirir ve kotlinx.coroutines ile kotlinx.serialization kullanır.

Kullanımı nasıldır

Her çağrı bir suspend işlevidir. Çağrıyı iptal etmek için coroutine’i iptal edin ya da son süre için withTimeout kullanın; karşınıza sarmalanmış bir istisna değil, her zaman kendi CancellationException istisnanız çıkar.
Bir akış bir EventStream’dir, yani bir kez topladığınız bir Flow. İşiniz bittiğinde kapanması için onu use içinde toplayın. Olaylar sealed bir arayüz altındaki data class’lardır ve when ile eşleştirilir.
Hatalar sealed bir sınıf olan LingaraException sınıfını genişletir, bu yüzden onlar üzerindeki bir when tüm durumları kapsar. retryAfter bir Duration değeridir ya da API bir bekleme süresi belirtmediyse null olur.
LingaraClient { } oluşturucusuyla bir istemci oluşturun. JDK’nın HttpClient sınıfını kullanır; bunu kendinizinkiyle değiştirebilirsiniz.

Aşağıdaki örnekler bağımlılığı ekler, bir istemci oluşturur, bir kelime listesini akış hâlinde alır ve bir hatayı işler.

Kotlin

implementation("com.getlingara:lingara-kotlin:0.1.0-alpha.6")

Kotlin

import com.getlingara.kotlin.LingaraClient

val client =
    LingaraClient {
        clientCredentials(System.getenv("LINGARA_CLIENT_ID"), System.getenv("LINGARA_CLIENT_SECRET"))
    }

Kotlin

import com.getlingara.kotlin.LingaraClient
import com.getlingara.kotlin.model.GenerateVocabularyEvent
import com.getlingara.kotlin.model.VocabRequest

val request = VocabRequest(level = 2, sourceLang = "en", targetLang = "zh", count = 8)
// The request is sent here; collect the stream once, inside use {}.
client.generateVocabulary(request).use { stream ->
    stream.collect { event ->
        when (event) {
            is GenerateVocabularyEvent.Item -> println("${event.data.word} ${event.data.translation}")
            is GenerateVocabularyEvent.Started -> Unit
        }
    }
}

Kotlin

try {
    client.getUsage()
} catch (e: LingaraException) {
    when (e) {
        // A refusal from the API: status, code (stable) and message (localised).
        is ApiException -> println("${e.status} ${e.code} ${e.message}; retry after ${e.retryAfter}")
        // The token endpoint refused the credentials or the scopes.
        is OAuthException -> println("${e.status} ${e.error} ${e.description}")
        is MaintenanceException -> println("under maintenance; retry after ${e.retryAfter}")
        // No usable answer: CONNECT, TLS, RESET, TIMEOUT, and so on.
        is TransportException -> println("transport: ${e.kind}")
    }
}
// A cancelled call throws the caller's own CancellationException instead.

Kotlin

Kullanımı nasıldır

Bu sayfanın sarmaladıkları