Kotlin

Ukurasa huu umetafsiriwa kutoka Kiingereza. Ikiwa hizi mbili zinatofautiana, ukurasa wa Kiingereza ndio sahihi. Soma ukurasa wa Kiingereza

Maktaba ya Kotlin ni com.getlingara:lingara-kotlin kwenye Maven Central. Inaendeshwa kwenye JVM, inahitaji Java 17 na Kotlin 2.2 au matoleo mapya zaidi, na hutumia kotlinx.coroutines na kotlinx.serialization.

Jinsi inavyotumika

Kila mwito ni kitendakazi cha suspend. Ghairi coroutine ili kughairi mwito, au tumia withTimeout kwa tarehe ya mwisho; unaona CancellationException yako mwenyewe, kamwe si iliyofungwa ndani ya nyingine.
Mtiririko ni EventStream, Flow unayoikusanya mara moja. Ikusanye ndani ya use, ili ifungwe unapomaliza. Matukio ni data class chini ya sealed interface, yanayolinganishwa kwa when.
Hitilafu hurithi sealed class LingaraException, kwa hivyo when juu yake inashughulikia hali zote. retryAfter ni Duration, au null wakati API haikutaja muda wa kusubiri.
Unda mteja kwa kijenzi cha LingaraClient { }. Hutumia HttpClient ya JDK, ambayo unaweza kuibadilisha kwa yako mwenyewe.

Sampuli zilizo hapa chini huongeza utegemezi, huunda mteja, hutiririsha orodha ya msamiati na hushughulikia hitilafu.

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

Jinsi inavyotumika

Kile ukurasa huu unachofunika