Threading in Worker

Wenn Sie einen Worker verwenden, ruft WorkManager automatisch Worker.doWork() in einem Hintergrundthread auf. Der Hintergrundthread stammt aus dem Executor, der in der Configuration von WorkManager angegeben ist. Standardmäßig richtet WorkManager einen Executor für Sie ein. Sie können aber auch einen eigenen konfigurieren. Sie können beispielsweise einen vorhandenen Hintergrund-Executor in Ihrer App freigeben, einen Single-Thread-Executor erstellen, damit alle Hintergrundaufgaben nacheinander ausgeführt werden, oder sogar einen benutzerdefinierten Executor angeben. Wenn Sie Executor anpassen möchten, müssen Sie WorkManager manuell initialisieren.

Wenn Sie WorkManager manuell konfigurieren, können Sie Ihre Executor so angeben:

WorkManager.initialize(
    context,
    Configuration.Builder()
        // Uses a fixed thread pool of size 8 threads.
        .setExecutor(Executors.newFixedThreadPool(8))
        .build()
)

Hier ist ein Beispiel für ein einfaches Worker, das den Inhalt einer Webseite 100-mal herunterlädt:

class DownloadWorker(context: Context, params: WorkerParameters) : Worker(context, params) {

    override fun doWork(): ListenableWorker.Result {
        repeat(100) {
            try {
                downloadSynchronously("https://www.google.com")
            } catch (e: IOException) {
                return ListenableWorker.Result.failure()
            }
        }

        return ListenableWorker.Result.success()
    }
}

Beachten Sie, dass Worker.doWork() ein synchroner Aufruf ist. Sie müssen die gesamte Hintergrundarbeit blockierend ausführen und sie beenden, wenn die Methode beendet wird. Wenn Sie eine asynchrone API in doWork() aufrufen und ein Result zurückgeben, funktioniert der Callback möglicherweise nicht richtig. In diesem Fall sollten Sie einen ListenableWorker verwenden (siehe Threading in ListenableWorker).

Wenn ein aktuell ausgeführter Worker aus irgendeinem Grund beendet wird, erhält er einen Aufruf an Worker.onStopped(). Überschreiben Sie diese Methode oder rufen Sie Worker.isStopped() auf, um Ihren Code zu prüfen und bei Bedarf Ressourcen freizugeben. Wenn der Worker im obigen Beispiel beendet wird, befindet er sich möglicherweise mitten in der Schleife zum Herunterladen von Elementen und fährt damit fort, obwohl er beendet wurde. Um dieses Verhalten zu optimieren, können Sie Folgendes tun:

class DownloadWorker(context: Context, params: WorkerParameters) : Worker(context, params) {

    override fun doWork(): ListenableWorker.Result {
        for (i in 0 until 100) {
            if (isStopped) {
                break
            }

            try {
                downloadSynchronously("https://www.google.com")
            } catch (e: IOException) {
                return ListenableWorker.Result.failure()
            }
        }

        return ListenableWorker.Result.success()
    }
}

Sobald ein Worker beendet wurde, ist es egal, was Sie von Worker.doWork() zurückgeben. Der Result wird ignoriert.