Home | History | Annotate | Download | only in app 
      1 /*
      2  * Copyright (C) 2007 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 package com.example.android.apis.app;
     18 
     19 import android.app.Notification;
     20 import android.app.NotificationManager;
     21 import android.app.PendingIntent;
     22 import android.app.Service;
     23 import android.content.Intent;
     24 import android.os.Binder;
     25 import android.os.IBinder;
     26 import android.os.PowerManager;
     27 import android.util.Log;
     28 import android.widget.Toast;
     29 
     30 // Need the following import to get access to the app resources, since this
     31 // class is in a sub-package.
     32 import com.example.android.apis.R;
     33 
     34 /**
     35  * This is an example of implementing an application service that runs locally
     36  * in the same process as the application.  The {@link LocalServiceActivities.Controller}
     37  * and {@link LocalServiceActivities.Binding} classes show how to interact with the
     38  * service.
     39  *
     40  * <p>Notice the use of the {@link NotificationManager} when interesting things
     41  * happen in the service.  This is generally how background services should
     42  * interact with the user, rather than doing something more disruptive such as
     43  * calling startActivity().
     44  */
     45 //BEGIN_INCLUDE(service)
     46 public class LocalService extends Service {
     47     private NotificationManager mNM;
     48 
     49     // Unique Identification Number for the Notification.
     50     // We use it on Notification start, and to cancel it.
     51     private int NOTIFICATION = R.string.local_service_started;
     52 
     53     /**
     54      * Class for clients to access.  Because we know this service always
     55      * runs in the same process as its clients, we don't need to deal with
     56      * IPC.
     57      */
     58     public class LocalBinder extends Binder {
     59         LocalService getService() {
     60             return LocalService.this;
     61         }
     62     }
     63 
     64     @Override
     65     public void onCreate() {
     66         mNM = (NotificationManager)getSystemService(NOTIFICATION_SERVICE);
     67 
     68         // Display a notification about us starting.  We put an icon in the status bar.
     69         showNotification();
     70     }
     71 
     72     @Override
     73     public int onStartCommand(Intent intent, int flags, int startId) {
     74         Log.i("LocalService", "Received start id " + startId + ": " + intent);
     75         return START_NOT_STICKY;
     76     }
     77 
     78     @Override
     79     public void onDestroy() {
     80         // Cancel the persistent notification.
     81         mNM.cancel(NOTIFICATION);
     82 
     83         // Tell the user we stopped.
     84         Toast.makeText(this, R.string.local_service_stopped, Toast.LENGTH_SHORT).show();
     85     }
     86 
     87     @Override
     88     public IBinder onBind(Intent intent) {
     89         return mBinder;
     90     }
     91 
     92     // This is the object that receives interactions from clients.  See
     93     // RemoteService for a more complete example.
     94     private final IBinder mBinder = new LocalBinder();
     95 
     96     /**
     97      * Show a notification while this service is running.
     98      */
     99     private void showNotification() {
    100         // In this sample, we'll use the same text for the ticker and the expanded notification
    101         CharSequence text = getText(R.string.local_service_started);
    102 
    103         // The PendingIntent to launch our activity if the user selects this notification
    104         PendingIntent contentIntent = PendingIntent.getActivity(this, 0,
    105                 new Intent(this, LocalServiceActivities.Controller.class), 0);
    106 
    107         // Set the info for the views that show in the notification panel.
    108         Notification notification = new Notification.Builder(this)
    109                 .setSmallIcon(R.drawable.stat_sample)  // the status icon
    110                 .setTicker(text)  // the status text
    111                 .setWhen(System.currentTimeMillis())  // the time stamp
    112                 .setContentTitle(getText(R.string.local_service_label))  // the label of the entry
    113                 .setContentText(text)  // the contents of the entry
    114                 .setContentIntent(contentIntent)  // The intent to send when the entry is clicked
    115                 .build();
    116 
    117         // Send the notification.
    118         mNM.notify(NOTIFICATION, notification);
    119     }
    120 }
    121 //END_INCLUDE(service)
    122