Çalışma durumunu bildirme

Bu kılavuzda, arka plan hizmetinde çalıştırılan bir iş isteğinin durumunun isteği gönderen bileşene nasıl bildirileceği gösterilmektedir. Bu, örneğin, bir Activity nesnesinin kullanıcı arayüzünde isteğin durumunu raporlamanıza olanak tanır. Durumu gönderip almak için önerilen yöntem, yayın Intent nesnelerini kendi uygulamanızdaki bileşenlerle sınırlayan bir LocalBroadcastManager kullanmaktır.

JobIntentService'ten durumu bildirme

JobIntentService içindeki bir iş isteğinin durumunu diğer bileşenlere göndermek için önce genişletilmiş verilerinde durumu içeren bir Intent oluşturun. Alternatif olarak, bu Intent öğesine bir işlem ve veri URI'si ekleyebilirsiniz.

Ardından, LocalBroadcastManager.sendBroadcast() numaralı telefonu arayarak Intent numaralı telefonu gönderin. Bu işlem, Intent öğesini almak için kaydolmuş uygulamanızda bulunan herhangi bir bileşene gönderir. LocalBroadcastManager örneğini almak için getInstance() numaralı telefonu arayın.

Örneğin:

...
// Defines a custom Intent action
const val BROADCAST_ACTION = "com.example.android.threadsample.BROADCAST"
...
// Defines the key for the status "extra" in an Intent
const val EXTENDED_DATA_STATUS = "com.example.android.threadsample.STATUS"
...
class RSSPullService : JobIntentService() {
    ...
    /*
     * Creates a new Intent containing a Uri object
     * BROADCAST_ACTION is a custom Intent action
     */
    val localIntent = Intent(BROADCAST_ACTION).apply {
        // Puts the status into the Intent
        putExtra(EXTENDED_DATA_STATUS, status)
    }
    // Broadcasts the Intent to receivers in this app.
    LocalBroadcastManager.getInstance(this).sendBroadcast(localIntent)
    ...
}

public final class Constants {
    ...
    // Defines a custom Intent action
    public static final String BROADCAST_ACTION =
        "com.example.android.threadsample.BROADCAST";
    ...
    // Defines the key for the status "extra" in an Intent
    public static final String EXTENDED_DATA_STATUS =
        "com.example.android.threadsample.STATUS";
    ...
}
public class RSSPullService extends JobIntentService {
...
    /*
     * Creates a new Intent containing a Uri object
     * BROADCAST_ACTION is a custom Intent action
     */
    Intent localIntent =
            new Intent(Constants.BROADCAST_ACTION)
            // Puts the status into the Intent
            .putExtra(Constants.EXTENDED_DATA_STATUS, status);
    // Broadcasts the Intent to receivers in this app.
    LocalBroadcastManager.getInstance(this).sendBroadcast(localIntent);
...
}

Sonraki adım, orijinal çalışma isteğini gönderen bileşende gelen Intent yayını nesnelerini işlemektir.

Bir JobIntentService'ten durum yayınları alma

Yayınlanan Intent nesnelerini almak için BroadcastReceiver alt sınıfını kullanın. Alt sınıfta, Intent aldığında LocalBroadcastManager tarafından çağırılan BroadcastReceiver.onReceive() geri çağırma yöntemini uygulayın. LocalBroadcastManager, gelen Intent değerini BroadcastReceiver.onReceive() cihazına iletir.

Örneğin:

// Broadcast receiver for receiving status updates from the IntentService.
private class DownloadStateReceiver : BroadcastReceiver() {

    override fun onReceive(context: Context, intent: Intent) {
        ...
        /*
         * Handle Intents here.
         */
        ...
    }
}

// Broadcast receiver for receiving status updates from the IntentService.
private class DownloadStateReceiver extends BroadcastReceiver
{
    // Called when the BroadcastReceiver gets an Intent it's registered to receive
    @Override
    public void onReceive(Context context, Intent intent) {
...
        /*
         * Handle Intents here.
         */
...
    }
}

BroadcastReceiver öğesini tanımladıktan sonra bunun için belirli işlemler, kategoriler ve verilerle eşleşen filtreler tanımlayabilirsiniz. Bunun için bir IntentFilter oluşturun. Bu ilk snippet'te, filtrenin nasıl tanımlanacağı gösterilmektedir:

// Class that displays photos
class DisplayActivity : FragmentActivity() {
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        ...
        super.onCreate(savedInstanceState)
        ...
        // The filter's action is BROADCAST_ACTION
        var statusIntentFilter = IntentFilter(BROADCAST_ACTION).apply {
            // Adds a data filter for the HTTP scheme
            addDataScheme("http")
        }
        ...

// Class that displays photos
public class DisplayActivity extends FragmentActivity {
    ...
    public void onCreate(Bundle stateBundle) {
        ...
        super.onCreate(stateBundle);
        ...
        // The filter's action is BROADCAST_ACTION
        IntentFilter statusIntentFilter = new IntentFilter(
                Constants.BROADCAST_ACTION);

        // Adds a data filter for the HTTP scheme
        statusIntentFilter.addDataScheme("http");
        ...

BroadcastReceiver ve IntentFilter öğelerini sisteme kaydetmek için LocalBroadcastManager örneği alın ve registerReceiver() yöntemini çağırın. Aşağıdaki snippet, BroadcastReceiver ve IntentFilter öğesinin nasıl kaydedileceğini gösterir:

        // Instantiates a new DownloadStateReceiver
        val downloadStateReceiver = DownloadStateReceiver()
        // Registers the DownloadStateReceiver and its intent filters
        LocalBroadcastManager.getInstance(this)
                .registerReceiver(downloadStateReceiver, statusIntentFilter)
        ...

        // Instantiates a new DownloadStateReceiver
        DownloadStateReceiver downloadStateReceiver =
                new DownloadStateReceiver();
        // Registers the DownloadStateReceiver and its intent filters
        LocalBroadcastManager.getInstance(this).registerReceiver(
                downloadStateReceiver,
                statusIntentFilter);
        ...

Tek bir BroadcastReceiver, her biri kendi işlemine sahip olan birden fazla Intent yayın nesnesi türünü işleyebilir. Bu özellik, her işlem için ayrı bir BroadcastReceiver tanımlamanıza gerek kalmadan her işlem için farklı kod çalıştırmanızı sağlar. Aynı BroadcastReceiver için başka bir IntentFilter tanımlamak isterseniz IntentFilter öğesini oluşturup çağrıyı registerReceiver() için tekrarlayın. Örneğin:

        /*
         * Instantiates a new action filter.
         * No data filter is needed.
         */
        statusIntentFilter = IntentFilter(ACTION_ZOOM_IMAGE)
        // Registers the receiver with the new filter
        LocalBroadcastManager.getInstance(this)
                .registerReceiver(downloadStateReceiver, statusIntentFilter)

        /*
         * Instantiates a new action filter.
         * No data filter is needed.
         */
        statusIntentFilter = new IntentFilter(Constants.ACTION_ZOOM_IMAGE);
        // Registers the receiver with the new filter
        LocalBroadcastManager.getInstance(this).registerReceiver(
                downloadStateReceiver,
                statusIntentFilter);

Bir yayın Intent gönderildiğinde Activity işlemi başlatılmaz veya devam ettirilmez. Activity için BroadcastReceiver, uygulamanız arka plandayken bile Intent nesnelerini alır ve işler, ancak uygulamanızı ön plana zorlamaz. Uygulamanız görünür değilken arka planda gerçekleşen bir etkinliği kullanıcıya bildirmek istiyorsanız Notification kullanın. Gelen bir Intent yayınına yanıt olarak hiçbir zaman Activity başlatmayın.