Enviar solicitações de trabalho para o serviço em segundo plano

A lição anterior mostrou como criar uma classe JobIntentService. Esta lição mostra como acionar o JobIntentService para executar uma operação enfileirando o trabalho com um Intent. Essa Intent pode conter dados para o JobIntentService processar.

Criar e enviar uma solicitação de trabalho para um JobIntentService

Para criar uma solicitação de trabalho e enviá-la para um JobIntentService, crie uma Intent e coloque-a na fila para ser executada chamando enqueueWork(). Opcionalmente, adicione dados à intent (na forma de extras) para o JobIntentService processar. Para saber mais sobre como criar intents, leia a seção Como criar uma intent em Intents e filtros de intent.

Os snippets de código a seguir demonstram esse processo:

1. Crie um novo Intent para o JobIntentService chamado RSSPullService.
   

   Kotlin

   /*
    * Creates a new Intent to start the RSSPullService
    * JobIntentService. Passes a URI in the
    * Intent's "data" field.
    */
   serviceIntent = Intent().apply {
       putExtra("download_url", dataUrl)
   }
   

   Java

   /*
    * Creates a new Intent to start the RSSPullService
    * JobIntentService. Passes a URI in the
    * Intent's "data" field.
    */
   serviceIntent = new Intent();
   serviceIntent.putExtra("download_url", dataUrl));
   

2. Chamar enqueueWork()
   

   Kotlin

   private const val RSS_JOB_ID = 1000
   RSSPullService.enqueueWork(context, RSSPullService::class.java, RSS_JOB_ID, serviceIntent)
   

   Java

   // Starts the JobIntentService
   private static final int RSS_JOB_ID = 1000;
   RSSPullService.enqueueWork(getContext(), RSSPullService.class, RSS_JOB_ID, serviceIntent);
   

Você pode enviar a solicitação de trabalho de qualquer lugar em uma atividade ou fragmento. Por exemplo, se você precisa receber a entrada do usuário primeiro, pode enviar a solicitação a partir de um callback que responda a um clique de botão ou a um gesto semelhante.

Depois de chamar enqueueWork(), o JobIntentService faz o trabalho definido no método onHandleWork() e, em seguida, para.

A próxima etapa é informar os resultados da solicitação de trabalho de volta à atividade ou ao fragmento de origem. A próxima lição mostra como fazer isso com um BroadcastReceiver.