localservice.java

Google s android SDK

/* 
 * Copyright (C) 2007 Google Inc.
 *
 * 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 com.google.android.samples.app;

import android.app.Notification;
import android.app.NotificationManager;
import android.app.Service;
import android.content.Intent;
import android.os.BinderNative;
import android.os.IBinder;
import android.os.Parcel;

// Need the following import to get access to the app resources, since this
// class is in a sub-package.
import com.google.android.samples.R;

/**
 * This is an example of implementing an application service that runs locally
 * in the same process as the application.  The {@link LocalServiceController}
 * and {@link LocalServiceBinding} classes show how to interact with the
 * service.
 *
 * <p>Notice the use of the {@link NotificationManager} when interesting things
 * happen in the service.  This is generally how background services should
 * interact with the user, rather than doing something more disruptive such as
 * calling startActivity().
 */
public class LocalService extends Service
{
    @Override
    protected void onCreate()
    {
        mNM = (NotificationManager)getSystemService(NOTIFICATION_SERVICE);

        // This is who should be launched if the user selects our persistent
        // notification.
        Intent intent = new Intent();
        intent.setClass(this, LocalServiceController.class);

        // Display a notification about us starting.  We use both a transient
        // notification and a persistent notification in the status bar.
        mNM.notifyWithText(R.string.local_service_started,
                   getText(R.string.local_service_started),
                   NotificationManager.LENGTH_SHORT,
                   new Notification(
                       R.drawable.stat_sample,
                       getText(R.string.local_service_label),
                       intent,
                       null,
                       null));
    }

    @Override
    protected void onDestroy()
    {
        // Cancel the persistent notification.
        mNM.cancel(R.string.local_service_started);

        // Tell the user we stopped.
        mNM.notifyWithText(R.string.local_service_stopped,
                   getText(R.string.local_service_stopped),
                   NotificationManager.LENGTH_SHORT,
                   null);
    }

    @Override
    public IBinder getBinder()
    {
        return mBinder;
    }

    // This is the object that receives interactions from clients.  See
    // RemoteService for a more complete example.
    private final IBinder mBinder = new BinderNative()
    {
        @Override
        protected boolean onTransact(int code, Parcel data, Parcel reply, int flags) {
            return super.onTransact(code, data, reply, flags);
        }
    };

    private NotificationManager mNM;
}