IntentSender.java revision 6c418d585e0a91054b168fde3130188afd006c98
11ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu/* 21ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Copyright (C) 2006 The Android Open Source Project 31ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 41ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Licensed under the Apache License, Version 2.0 (the "License"); 51ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * you may not use this file except in compliance with the License. 61ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * You may obtain a copy of the License at 71ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 81ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * http://www.apache.org/licenses/LICENSE-2.0 91ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 101ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Unless required by applicable law or agreed to in writing, software 111ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * distributed under the License is distributed on an "AS IS" BASIS, 121ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 131ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * See the License for the specific language governing permissions and 141ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * limitations under the License. 151ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 161ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 171ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapupackage android.content; 181ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 19860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackbornimport android.app.ActivityManagerNative; 201ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.Context; 211ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.Intent; 221ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentSender; 231ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentReceiver; 241ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.Bundle; 251ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.RemoteException; 261ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.Handler; 271ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.IBinder; 281ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.Parcel; 291ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.Parcelable; 301ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.util.AndroidException; 311ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 321ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 331ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu/** 341ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * A description of an Intent and target action to perform with it. 351ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * The returned object can be 361ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * handed to other applications so that they can perform the action you 371ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * described on your behalf at a later time. 381ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 391ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * <p>By giving a IntentSender to another application, 401ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * you are granting it the right to perform the operation you have specified 411ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * as if the other application was yourself (with the same permissions and 421ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * identity). As such, you should be careful about how you build the IntentSender: 431ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * often, for example, the base Intent you supply will have the component 441ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * name explicitly set to one of your own components, to ensure it is ultimately 451ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * sent there and nowhere else. 461ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 471ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * <p>A IntentSender itself is simply a reference to a token maintained by 481ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * the system describing the original data used to retrieve it. This means 491ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * that, even if its owning application's process is killed, the 501ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * IntentSender itself will remain usable from other processes that 511ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * have been given it. If the creating application later re-retrieves the 521ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * same kind of IntentSender (same operation, same Intent action, data, 531ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * categories, and components, and same flags), it will receive a IntentSender 541ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * representing the same token if that is still valid. 551ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 567f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn * <p>Instances of this class can not be made directly, but rather must be 577f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn * created from an existing {@link android.app.PendingIntent} with 587f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn * {@link android.app.PendingIntent#getIntentSender() PendingIntent.getIntentSender()}. 591ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 601ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapupublic class IntentSender implements Parcelable { 611ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private final IIntentSender mTarget; 621ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 631ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 641ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Exception thrown when trying to send through a PendingIntent that 651ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * has been canceled or is otherwise no longer able to execute the request. 661ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 671ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static class SendIntentException extends AndroidException { 681ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public SendIntentException() { 691ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 701ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 711ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public SendIntentException(String name) { 721ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu super(name); 731ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 741ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 751ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public SendIntentException(Exception cause) { 761ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu super(cause); 771ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 781ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 791ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 801ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 811ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Callback interface for discovering when a send operation has 821ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * completed. Primarily for use with a IntentSender that is 831ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * performing a broadcast, this provides the same information as 841ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * calling {@link Context#sendOrderedBroadcast(Intent, String, 851ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * android.content.BroadcastReceiver, Handler, int, String, Bundle) 861ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Context.sendBroadcast()} with a final BroadcastReceiver. 871ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 881ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public interface OnFinished { 891ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 901ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Called when a send operation as completed. 911ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 921ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param IntentSender The IntentSender this operation was sent through. 931ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param intent The original Intent that was sent. 941ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param resultCode The final result code determined by the send. 951ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param resultData The final data collected by a broadcast. 961ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param resultExtras The final extras collected by a broadcast. 971ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 981ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu void onSendFinished(IntentSender IntentSender, Intent intent, 991ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu int resultCode, String resultData, Bundle resultExtras); 1001ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1011ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 1021ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private static class FinishedDispatcher extends IIntentReceiver.Stub 1031ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu implements Runnable { 1041ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private final IntentSender mIntentSender; 1051ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private final OnFinished mWho; 1061ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private final Handler mHandler; 1071ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private Intent mIntent; 1081ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private int mResultCode; 1091ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private String mResultData; 1101ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private Bundle mResultExtras; 1111ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu FinishedDispatcher(IntentSender pi, OnFinished who, Handler handler) { 1121ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mIntentSender = pi; 1131ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mWho = who; 1141ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mHandler = handler; 1151ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1161ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public void performReceive(Intent intent, int resultCode, 11768d881cf2d2b252f6f795cd64d43e316a1d736e5Dianne Hackborn String data, Bundle extras, boolean serialized, boolean sticky) { 1181ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mIntent = intent; 1191ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mResultCode = resultCode; 1201ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mResultData = data; 1211ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mResultExtras = extras; 1221ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu if (mHandler == null) { 1231ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu run(); 1241ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } else { 1251ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mHandler.post(this); 1261ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1271ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1281ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public void run() { 1291ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mWho.onSendFinished(mIntentSender, mIntent, mResultCode, 1301ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mResultData, mResultExtras); 1311ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1321ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1331ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 1341ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 1351ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Perform the operation associated with this IntentSender, allowing the 1361ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * caller to specify information about the Intent to use and be notified 1371ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * when the send has completed. 1381ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 1391ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param context The Context of the caller. This may be null if 1401ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * <var>intent</var> is also null. 1411ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param code Result code to supply back to the IntentSender's target. 1421ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param intent Additional Intent data. See {@link Intent#fillIn 1431ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Intent.fillIn()} for information on how this is applied to the 1441ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * original Intent. Use null to not modify the original Intent. 1451ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param onFinished The object to call back on when the send has 1461ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * completed, or null for no callback. 1471ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param handler Handler identifying the thread on which the callback 1481ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * should happen. If null, the callback will happen from the thread 1491ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * pool of the process. 1501ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 1511ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 1521ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @throws SendIntentException Throws CanceledIntentException if the IntentSender 1531ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * is no longer allowing more intents to be sent through it. 1541ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 1551ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public void sendIntent(Context context, int code, Intent intent, 1561ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu OnFinished onFinished, Handler handler) throws SendIntentException { 1576c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn sendIntent(context, code, intent, onFinished, handler, null); 1586c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn } 1596c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn 1606c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn /** 1616c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Perform the operation associated with this IntentSender, allowing the 1626c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * caller to specify information about the Intent to use and be notified 1636c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * when the send has completed. 1646c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 1656c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param context The Context of the caller. This may be null if 1666c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * <var>intent</var> is also null. 1676c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param code Result code to supply back to the IntentSender's target. 1686c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param intent Additional Intent data. See {@link Intent#fillIn 1696c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * Intent.fillIn()} for information on how this is applied to the 1706c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * original Intent. Use null to not modify the original Intent. 1716c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param onFinished The object to call back on when the send has 1726c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * completed, or null for no callback. 1736c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param handler Handler identifying the thread on which the callback 1746c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * should happen. If null, the callback will happen from the thread 1756c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * pool of the process. 1766c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @param requiredPermission Name of permission that a recipient of the PendingIntent 1776c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is required to hold. This is only valid for broadcast intents, and 1786c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * corresponds to the permission argument in 1796c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * {@link Context#sendBroadcast(Intent, String) Context.sendOrderedBroadcast(Intent, String)}. 1806c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * If null, no permission is required. 1816c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 1826c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * 1836c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * @throws SendIntentException Throws CanceledIntentException if the IntentSender 1846c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn * is no longer allowing more intents to be sent through it. 1856c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn */ 1866c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn public void sendIntent(Context context, int code, Intent intent, 1876c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn OnFinished onFinished, Handler handler, String requiredPermission) 1886c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn throws SendIntentException { 1891ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu try { 1901ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu String resolvedType = intent != null ? 1911ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu intent.resolveTypeIfNeeded(context.getContentResolver()) 1921ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu : null; 1931ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu int res = mTarget.send(code, intent, resolvedType, 1941ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu onFinished != null 1956c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn ? new FinishedDispatcher(this, onFinished, handler) 1966c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn : null, 1976c418d585e0a91054b168fde3130188afd006c98Dianne Hackborn requiredPermission); 1981ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu if (res < 0) { 1991ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu throw new SendIntentException(); 2001ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2011ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } catch (RemoteException e) { 2021ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu throw new SendIntentException(); 2031ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2041ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2051ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2061ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 207860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * Return the package name of the application that created this 208860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * IntentSender, that is the identity under which you will actually be 209860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * sending the Intent. The returned string is supplied by the system, so 210860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * that an application can not spoof its package. 211860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * 212860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * @return The package name of the PendingIntent, or null if there is 213860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * none associated with it. 214860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn */ 215860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn public String getTargetPackage() { 216860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn try { 217860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn return ActivityManagerNative.getDefault() 218860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn .getPackageForIntentSender(mTarget); 219860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn } catch (RemoteException e) { 220860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn // Should never happen. 221860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn return null; 222860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn } 223860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn } 224860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn 225860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn /** 2261ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Comparison operator on two IntentSender objects, such that true 2271ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * is returned then they both represent the same operation from the 2281ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * same package. 2291ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 2301ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu @Override 2311ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public boolean equals(Object otherObj) { 2321ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu if (otherObj instanceof IntentSender) { 2331ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return mTarget.asBinder().equals(((IntentSender)otherObj) 2341ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu .mTarget.asBinder()); 2351ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2361ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return false; 2371ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2381ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2391ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu @Override 2401ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public int hashCode() { 2411ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return mTarget.asBinder().hashCode(); 2421ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2431ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2441ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu @Override 2451ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public String toString() { 2461ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu StringBuilder sb = new StringBuilder(128); 2471ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append("IntentSender{"); 2481ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append(Integer.toHexString(System.identityHashCode(this))); 2491ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append(": "); 2501ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append(mTarget != null ? mTarget.asBinder() : null); 2511ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append('}'); 2521ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return sb.toString(); 2531ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2541ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2551ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public int describeContents() { 2561ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return 0; 2571ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2581ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2591ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public void writeToParcel(Parcel out, int flags) { 2601ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu out.writeStrongBinder(mTarget.asBinder()); 2611ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2621ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2631ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static final Parcelable.Creator<IntentSender> CREATOR 2641ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu = new Parcelable.Creator<IntentSender>() { 2651ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender createFromParcel(Parcel in) { 2661ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu IBinder target = in.readStrongBinder(); 2671ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return target != null ? new IntentSender(target) : null; 2681ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2691ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2701ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender[] newArray(int size) { 2711ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return new IntentSender[size]; 2721ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2731ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu }; 2741ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2751ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 2761ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Convenience function for writing either a IntentSender or null pointer to 2771ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * a Parcel. You must use this with {@link #readIntentSenderOrNullFromParcel} 2781ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * for later reading it. 2791ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 2801ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param sender The IntentSender to write, or null. 2811ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param out Where to write the IntentSender. 2821ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 2831ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static void writeIntentSenderOrNullToParcel(IntentSender sender, 2841ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu Parcel out) { 2851ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu out.writeStrongBinder(sender != null ? sender.mTarget.asBinder() 2861ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu : null); 2871ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2881ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2891ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 2901ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Convenience function for reading either a Messenger or null pointer from 2911ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * a Parcel. You must have previously written the Messenger with 2921ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * {@link #writeIntentSenderOrNullToParcel}. 2931ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 2941ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param in The Parcel containing the written Messenger. 2951ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 2961ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @return Returns the Messenger read from the Parcel, or null if null had 2971ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * been written. 2981ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 2991ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static IntentSender readIntentSenderOrNullFromParcel(Parcel in) { 3001ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu IBinder b = in.readStrongBinder(); 3011ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return b != null ? new IntentSender(b) : null; 3021ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 3031ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 3047f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn /** @hide */ 305fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn public IIntentSender getTarget() { 306fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn return mTarget; 307fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn } 308fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn 309fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn /** @hide */ 3107f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn public IntentSender(IIntentSender target) { 3111ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mTarget = target; 3121ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 3131ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 3147f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn /** @hide */ 3157f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn public IntentSender(IBinder target) { 3161ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mTarget = IIntentSender.Stub.asInterface(target); 3171ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 3181ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu} 319