| /* |
| * Copyright (C) 2007 The Android Open Source Project |
| * |
| * 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.example.android.apis.app; |
| |
| import android.app.Notification; |
| import android.app.NotificationManager; |
| import android.app.PendingIntent; |
| import android.app.Service; |
| import android.content.Intent; |
| import android.os.RemoteException; |
| import android.os.Handler; |
| import android.os.IBinder; |
| import android.os.Message; |
| import android.os.Process; |
| import android.os.RemoteCallbackList; |
| import android.widget.Toast; |
| |
| // Need the following import to get access to the app resources, since this |
| // class is in a sub-package. |
| import com.example.android.apis.R; |
| |
| /** |
| * This is an example of implementing an application service that runs in a |
| * different process than the application. Because it can be in another |
| * process, we must use IPC to interact with it. The |
| * {@link RemoteServiceController} and {@link RemoteServiceBinding} classes |
| * show how to interact with the service. |
| */ |
| public class RemoteService extends Service { |
| /** |
| * This is a list of callbacks that have been registered with the |
| * service. Note that this is package scoped (instead of private) so |
| * that it can be accessed more efficiently from inner classes. |
| */ |
| final RemoteCallbackList<IRemoteServiceCallback> mCallbacks |
| = new RemoteCallbackList<IRemoteServiceCallback>(); |
| |
| int mValue = 0; |
| NotificationManager mNM; |
| |
| @Override |
| public void onCreate() { |
| mNM = (NotificationManager)getSystemService(NOTIFICATION_SERVICE); |
| |
| // Display a notification about us starting. |
| showNotification(); |
| |
| // While this service is running, it will continually increment a |
| // number. Send the first message that is used to perform the |
| // increment. |
| mHandler.sendEmptyMessage(REPORT_MSG); |
| } |
| |
| @Override |
| public void onDestroy() { |
| // Cancel the persistent notification. |
| mNM.cancel(R.string.remote_service_started); |
| |
| // Tell the user we stopped. |
| Toast.makeText(this, R.string.remote_service_stopped, Toast.LENGTH_SHORT).show(); |
| |
| // Unregister all callbacks. |
| mCallbacks.kill(); |
| |
| // Remove the next pending message to increment the counter, stopping |
| // the increment loop. |
| mHandler.removeMessages(REPORT_MSG); |
| } |
| |
| // BEGIN_INCLUDE(exposing_a_service) |
| @Override |
| public IBinder onBind(Intent intent) { |
| // Select the interface to return. If your service only implements |
| // a single interface, you can just return it here without checking |
| // the Intent. |
| if (IRemoteService.class.getName().equals(intent.getAction())) { |
| return mBinder; |
| } |
| if (ISecondary.class.getName().equals(intent.getAction())) { |
| return mSecondaryBinder; |
| } |
| return null; |
| } |
| |
| /** |
| * The IRemoteInterface is defined through IDL |
| */ |
| private final IRemoteService.Stub mBinder = new IRemoteService.Stub() { |
| public void registerCallback(IRemoteServiceCallback cb) { |
| if (cb != null) mCallbacks.register(cb); |
| } |
| public void unregisterCallback(IRemoteServiceCallback cb) { |
| if (cb != null) mCallbacks.unregister(cb); |
| } |
| }; |
| |
| /** |
| * A secondary interface to the service. |
| */ |
| private final ISecondary.Stub mSecondaryBinder = new ISecondary.Stub() { |
| public int getPid() { |
| return Process.myPid(); |
| } |
| public void basicTypes(int anInt, long aLong, boolean aBoolean, |
| float aFloat, double aDouble, String aString) { |
| } |
| }; |
| // END_INCLUDE(exposing_a_service) |
| |
| private static final int REPORT_MSG = 1; |
| |
| /** |
| * Our Handler used to execute operations on the main thread. This is used |
| * to schedule increments of our value. |
| */ |
| private final Handler mHandler = new Handler() { |
| @Override public void handleMessage(Message msg) { |
| switch (msg.what) { |
| |
| // It is time to bump the value! |
| case REPORT_MSG: { |
| // Up it goes. |
| int value = ++mValue; |
| |
| // Broadcast to all clients the new value. |
| final int N = mCallbacks.beginBroadcast(); |
| for (int i=0; i<N; i++) { |
| try { |
| mCallbacks.getBroadcastItem(i).valueChanged(value); |
| } catch (RemoteException e) { |
| // The RemoteCallbackList will take care of removing |
| // the dead object for us. |
| } |
| } |
| mCallbacks.finishBroadcast(); |
| |
| // Repeat every 1 second. |
| sendMessageDelayed(obtainMessage(REPORT_MSG), 1*1000); |
| } break; |
| default: |
| super.handleMessage(msg); |
| } |
| } |
| }; |
| |
| /** |
| * Show a notification while this service is running. |
| */ |
| private void showNotification() { |
| // In this sample, we'll use the same text for the ticker and the expanded notification |
| CharSequence text = getText(R.string.remote_service_started); |
| |
| // Set the icon, scrolling text and timestamp |
| Notification notification = new Notification(R.drawable.stat_sample, text, |
| System.currentTimeMillis()); |
| |
| // The PendingIntent to launch our activity if the user selects this notification |
| PendingIntent contentIntent = PendingIntent.getActivity(this, 0, |
| new Intent(this, LocalServiceController.class), 0); |
| |
| // Set the info for the views that show in the notification panel. |
| notification.setLatestEventInfo(this, getText(R.string.remote_service_label), |
| text, contentIntent); |
| |
| // Send the notification. |
| // We use a string id because it is a unique number. We use it later to cancel. |
| mNM.notify(R.string.remote_service_started, notification); |
| } |
| } |