ListenableFuture, eşzamansız bir hesaplamanın sonucunu temsil eder. Bu hesaplama, sonuç üretmeyi tamamlamış veya tamamlamamış olabilir. Hesaplama tamamlandığında veya hesaplama zaten tamamlanmışsa hemen yürütülecek geri çağırmaları kaydetmenize olanak tanıyan bir Future türüdür.
ListenableFuture, Android çerçevesinin bir parçası değildir ve Guava tarafından sağlanır. Bu sınıfın uygulanması hakkında daha fazla bilgi için ListenableFuture açıklaması başlıklı makaleyi inceleyin.
CameraX veya Sağlık Hizmetleri gibi mevcut birçok Jetpack kitaplığında, dönüş türünün yürütme durumunu temsil eden bir ListenableFuture olduğu eşzamansız yöntemler bulunur. Bazı durumlarda, TileService şartlarını karşılamak için ListenableFuture döndüren bir yöntem uygulamanız gerekebilir.
Gerekli kitaplıklar
Groovy
dependencies { implementation "com.google.guava:guava:31.0.1-android" // To use CallbackToFutureAdapter implementation "androidx.concurrent:concurrent-futures:1.3.0" // Kotlin implementation "org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.6.0" }
Kotlin
dependencies { implementation("com.google.guava:guava:31.0.1-android") // To use CallbackToFutureAdapter implementation("androidx.concurrent:concurrent-futures:1.3.0") // Kotlin implementation("org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.6.0") }
ListenableFuture sonucunu alma
Geri çağırma ekleme
Başarılı ve başarısız geri çağırmaları bir ListenableFuture nesnesine eklemek için Futures.addCallback(...) yardımcı yöntemini kullanın.
val future: ListenableFuture<QueryResult> = ... Futures.addCallback( future, object : FutureCallback<QueryResult> { override fun onSuccess(result: QueryResult) { // handle success. } override fun onFailure(t: Throwable) { // handle failure. } }, // causes the callbacks to be executed on the main (UI) thread. context.mainExecutor )
Kotlin'de askıya alma
Kotlin kullanırken ListenableFuture sonucunu beklemenin en kolay yolu await() kullanmaktır.
// import kotlinx.coroutines.guava.await // ... val future: ListenableFuture<QueryResult> = ... val queryResult = future.await() // suspends awaiting success.
RxJava ile birlikte çalışabilirlik
Bir RxJava Single, SingleEmitter içinde geri çağırmalar kaydedilerek bir ListenableFuture öğesinden oluşturulabilir.
val future: ListenableFuture<QueryResult> = ... val single = Single.create<QueryResult> { Futures.addCallback(future, object : FutureCallback<QueryResult> { override fun onSuccess(result: QueryResult) { it.onSuccess(result) } override fun onFailure(t: Throwable) { it.onError(t) } }, executor) }
ListenableFuture oluşturma
Yakın geleceği şekillendirme
API'niz eşzamansız değilse ancak tamamlanan bir işlemin sonucunu ListenableFuture içine sarmalamanız gerekiyorsa ImmediateFuture oluşturabilirsiniz. Bu işlem, Futures.immediateFuture(...) fabrika yöntemi kullanılarak yapılabilir.
fun getResult(): ListenableFuture<QueryResult> { try { val queryResult = getQueryResult() return Futures.immediateFuture(queryResult) } catch (e: Exception) { return Futures.immediateFailedFuture(e) } }
Eş yordam kullanma
Kotlin'de, bir askıya alma işlevinin sonucunu ListenableFuture değerine dönüştürmek için future{ ... } kullanılabilir.
// import kotlinx.coroutines.guava.future suspend fun getResultAsync(): QueryResult = /* ... */ fun getResultFuture(): ListenableFuture<QueryResult> { return coroutineScope.future { getResultAsync() } }
Geri aramayı dönüştürme
Geri çağırma tabanlı bir API'yi ListenableFuture kullanan bir API'ye dönüştürmek için CallbackToFutureAdapter kullanın.
Bu API, androidx.concurrent:concurrent-futures yapısı tarafından sağlanır.
Daha fazla bilgi için androidx.concurrent sayfasına bakın.
RxJava Single'dan dönüştürme
RxJava kullanılırken Single, ListenableFuture'yı uygulayan bir SettableFuture nesnesine dönüştürülebilir.
fun getResult(): ListenableFuture<QueryResult> { val single: Single<QueryResult> = ... val future = SettableFuture.create<QueryResult>() single.subscribe(future::set, future::setException) return future }