Kotlin

Questa pagina è tradotta dall'inglese. Se le due versioni differiscono, fa fede la pagina in inglese. Leggi la pagina in inglese

La libreria Kotlin è com.getlingara:lingara-kotlin su Maven Central. Gira sulla JVM, richiede Java 17 e Kotlin 2.2 o successivo, e usa kotlinx.coroutines e kotlinx.serialization.

Come si usa

Ogni chiamata è una funzione suspend. Annulla la coroutine per annullare la chiamata, oppure usa withTimeout per una scadenza; vedi la tua CancellationException, mai una incapsulata.
Uno stream è un EventStream, un Flow che raccogli una sola volta. Raccoglilo dentro use, così si chiude quando hai finito. Gli eventi sono data class sotto un’interfaccia sealed, distinte con when.
Gli errori estendono la classe sealed LingaraException, quindi un when su di essi è esaustivo. retryAfter è una Duration, oppure null quando l’API non ha indicato alcuna attesa.
Crea un client con il builder LingaraClient { }. Usa lo HttpClient del JDK, che puoi sostituire con il tuo.

Gli esempi qui sotto aggiungono la dipendenza, creano un client, ricevono in streaming un elenco di vocaboli e gestiscono un errore.

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

Come si usa

Cosa incapsula questa pagina