IntentSender.java revision 860755faa6bdd3c2aeae49c05b87b5bc080ae60c
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 { 1571ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu try { 1581ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu String resolvedType = intent != null ? 1591ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu intent.resolveTypeIfNeeded(context.getContentResolver()) 1601ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu : null; 1611ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu int res = mTarget.send(code, intent, resolvedType, 1621ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu onFinished != null 1631ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu ? new FinishedDispatcher(this, onFinished, handler) 1641ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu : null); 1651ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu if (res < 0) { 1661ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu throw new SendIntentException(); 1671ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1681ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } catch (RemoteException e) { 1691ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu throw new SendIntentException(); 1701ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1711ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1721ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 1731ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 174860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * Return the package name of the application that created this 175860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * IntentSender, that is the identity under which you will actually be 176860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * sending the Intent. The returned string is supplied by the system, so 177860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * that an application can not spoof its package. 178860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * 179860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * @return The package name of the PendingIntent, or null if there is 180860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn * none associated with it. 181860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn */ 182860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn public String getTargetPackage() { 183860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn try { 184860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn return ActivityManagerNative.getDefault() 185860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn .getPackageForIntentSender(mTarget); 186860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn } catch (RemoteException e) { 187860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn // Should never happen. 188860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn return null; 189860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn } 190860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn } 191860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn 192860755faa6bdd3c2aeae49c05b87b5bc080ae60cDianne Hackborn /** 1931ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Comparison operator on two IntentSender objects, such that true 1941ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * is returned then they both represent the same operation from the 1951ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * same package. 1961ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 1971ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu @Override 1981ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public boolean equals(Object otherObj) { 1991ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu if (otherObj instanceof IntentSender) { 2001ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return mTarget.asBinder().equals(((IntentSender)otherObj) 2011ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu .mTarget.asBinder()); 2021ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2031ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return false; 2041ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2051ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2061ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu @Override 2071ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public int hashCode() { 2081ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return mTarget.asBinder().hashCode(); 2091ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2101ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2111ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu @Override 2121ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public String toString() { 2131ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu StringBuilder sb = new StringBuilder(128); 2141ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append("IntentSender{"); 2151ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append(Integer.toHexString(System.identityHashCode(this))); 2161ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append(": "); 2171ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append(mTarget != null ? mTarget.asBinder() : null); 2181ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append('}'); 2191ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return sb.toString(); 2201ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2211ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2221ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public int describeContents() { 2231ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return 0; 2241ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2251ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2261ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public void writeToParcel(Parcel out, int flags) { 2271ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu out.writeStrongBinder(mTarget.asBinder()); 2281ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2291ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2301ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static final Parcelable.Creator<IntentSender> CREATOR 2311ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu = new Parcelable.Creator<IntentSender>() { 2321ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender createFromParcel(Parcel in) { 2331ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu IBinder target = in.readStrongBinder(); 2341ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return target != null ? new IntentSender(target) : null; 2351ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2361ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2371ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender[] newArray(int size) { 2381ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return new IntentSender[size]; 2391ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2401ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu }; 2411ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2421ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 2431ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Convenience function for writing either a IntentSender or null pointer to 2441ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * a Parcel. You must use this with {@link #readIntentSenderOrNullFromParcel} 2451ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * for later reading it. 2461ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 2471ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param sender The IntentSender to write, or null. 2481ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param out Where to write the IntentSender. 2491ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 2501ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static void writeIntentSenderOrNullToParcel(IntentSender sender, 2511ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu Parcel out) { 2521ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu out.writeStrongBinder(sender != null ? sender.mTarget.asBinder() 2531ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu : null); 2541ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2551ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2561ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 2571ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Convenience function for reading either a Messenger or null pointer from 2581ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * a Parcel. You must have previously written the Messenger with 2591ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * {@link #writeIntentSenderOrNullToParcel}. 2601ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 2611ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param in The Parcel containing the written Messenger. 2621ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 2631ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @return Returns the Messenger read from the Parcel, or null if null had 2641ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * been written. 2651ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 2661ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static IntentSender readIntentSenderOrNullFromParcel(Parcel in) { 2671ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu IBinder b = in.readStrongBinder(); 2681ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return b != null ? new IntentSender(b) : null; 2691ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2701ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2717f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn /** @hide */ 272fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn public IIntentSender getTarget() { 273fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn return mTarget; 274fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn } 275fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn 276fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn /** @hide */ 2777f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn public IntentSender(IIntentSender target) { 2781ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mTarget = target; 2791ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2801ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2817f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn /** @hide */ 2827f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn public IntentSender(IBinder target) { 2831ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mTarget = IIntentSender.Stub.asInterface(target); 2841ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2851ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu} 286