it.jaschke.alexandria.receiver.NotificationBroadcastReceiver.java Source code

Introduction

Here is the source code for it.jaschke.alexandria.receiver.NotificationBroadcastReceiver.java

Source

/*
 * Copyright 2015 Jess Adolfo Garca Pasquel
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package it.jaschke.alexandria.receiver;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.support.v4.content.LocalBroadcastManager;
import android.util.Log;
import android.widget.Toast;

import org.parceler.Parcels;

import de.greenrobot.event.EventBus;
import it.jaschke.alexandria.R;
import it.jaschke.alexandria.model.domain.Book;
import it.jaschke.alexandria.model.event.BookAdditionEvent;
import it.jaschke.alexandria.service.BookService;

/**
 * Handles notifications broadcasted by {@link BookService}. Receives
 * {@link Intent}s with action  {@link BookService#ACTION_NOTIFY} and
 * displays messages using a {@link Toast} based on the {@link Intent}s
 * category (e.g. {@link BookService#CATEGORY_DOWNLOAD_ERROR}). In case of
 * {@link BookService#CATEGORY_SUCCESSFULLY_ADDED} or
 * {@link BookService#CATEGORY_ALREADY_REGISTERED} publishes a
 * {@link BookAdditionEvent} on the {@link EventBus}.
 *
 * @author Jess Adolfo Garca Pasquel
 */
public class NotificationBroadcastReceiver extends BroadcastReceiver {

    /**
     * Identifies the messages written to the log by this class.
     */
    private static final String LOG_TAG = NotificationBroadcastReceiver.class.getSimpleName();

    @Override
    public void onReceive(Context context, Intent intent) {
        if (intent.getCategories() == null || intent.getCategories().size() != 1) {
            Log.e(LOG_TAG, "Expected one category.");
            return;
        }
        String message = null;
        final String category = intent.getCategories().iterator().next();
        if (BookService.CATEGORY_NO_RESULT.equals(category)) {
            message = context.getString(R.string.msg_no_result);
        } else if (BookService.CATEGORY_DOWNLOAD_ERROR.equals(category)) {
            message = context.getString(R.string.msg_download_error);
        } else if (BookService.CATEGORY_RESULT_PROCESSING_ERROR.equals(category)) {
            message = context.getString(R.string.msg_response_processing_error);
        } else if (BookService.CATEGORY_ALREADY_REGISTERED.equals(category)
                || BookService.CATEGORY_SUCCESSFULLY_ADDED.equals(category)) {
            Book book = Parcels.unwrap(intent.getParcelableExtra(BookService.EXTRA_BOOK));
            message = context.getString(R.string.msg_book_added, book.getId());
            EventBus.getDefault().post(new BookAdditionEvent(book));
        } else {
            Log.e(LOG_TAG, "Unexpected notification category " + category);
        }
        if (message != null) {
            Toast.makeText(context, message, Toast.LENGTH_LONG).show();
        }
    }

    /**
     * Creates a new instance of {@link NotificationBroadcastReceiver},
     * assigns and registers it on the {@link LocalBroadcastManager}.
     *
     * @param context the {@link Context} used to get the
     *     {@link LocalBroadcastManager}.
     * @return the registered {@link NotificationBroadcastReceiver}.
     */
    public static NotificationBroadcastReceiver registerLocalReceiver(Context context) {
        NotificationBroadcastReceiver broadcastReceiver = new NotificationBroadcastReceiver();
        IntentFilter filter = new IntentFilter(BookService.ACTION_NOTIFY);
        filter.addCategory(BookService.CATEGORY_NO_RESULT);
        filter.addCategory(BookService.CATEGORY_DOWNLOAD_ERROR);
        filter.addCategory(BookService.CATEGORY_RESULT_PROCESSING_ERROR);
        filter.addCategory(BookService.CATEGORY_ALREADY_REGISTERED);
        filter.addCategory(BookService.CATEGORY_SUCCESSFULLY_ADDED);
        LocalBroadcastManager.getInstance(context).registerReceiver(broadcastReceiver, filter);
        return broadcastReceiver;
    }

    /**
     * Unregisters the specified {@link NotificationBroadcastReceiver} from
     * the {@link LocalBroadcastManager}.
     *
     * @param context {@link Context} used to get the {@link LocalBroadcastManager}.
     * @param broadcastReceiver the {@link NotificationBroadcastReceiver} to
     *                          unregister.
     */
    public static void unregisterLocalReceiver(Context context, NotificationBroadcastReceiver broadcastReceiver) {
        LocalBroadcastManager.getInstance(context).unregisterReceiver(broadcastReceiver);
    }

}