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 191ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.Context; 201ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.Intent; 211ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentSender; 221ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.content.IIntentReceiver; 231ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.Bundle; 241ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.RemoteException; 251ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.Handler; 261ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.IBinder; 271ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.Parcel; 281ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.os.Parcelable; 291ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapuimport android.util.AndroidException; 301ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 311ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 321ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu/** 331ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * A description of an Intent and target action to perform with it. 341ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * The returned object can be 351ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * handed to other applications so that they can perform the action you 361ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * described on your behalf at a later time. 371ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 381ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * <p>By giving a IntentSender to another application, 391ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * you are granting it the right to perform the operation you have specified 401ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * as if the other application was yourself (with the same permissions and 411ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * identity). As such, you should be careful about how you build the IntentSender: 421ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * often, for example, the base Intent you supply will have the component 431ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * name explicitly set to one of your own components, to ensure it is ultimately 441ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * sent there and nowhere else. 451ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 461ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * <p>A IntentSender itself is simply a reference to a token maintained by 471ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * the system describing the original data used to retrieve it. This means 481ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * that, even if its owning application's process is killed, the 491ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * IntentSender itself will remain usable from other processes that 501ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * have been given it. If the creating application later re-retrieves the 511ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * same kind of IntentSender (same operation, same Intent action, data, 521ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * categories, and components, and same flags), it will receive a IntentSender 531ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * representing the same token if that is still valid. 541ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 557f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn * <p>Instances of this class can not be made directly, but rather must be 567f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn * created from an existing {@link android.app.PendingIntent} with 577f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn * {@link android.app.PendingIntent#getIntentSender() PendingIntent.getIntentSender()}. 581ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 591ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapupublic class IntentSender implements Parcelable { 601ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private final IIntentSender mTarget; 611ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 621ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 631ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Exception thrown when trying to send through a PendingIntent that 641ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * has been canceled or is otherwise no longer able to execute the request. 651ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 661ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static class SendIntentException extends AndroidException { 671ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public SendIntentException() { 681ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 691ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 701ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public SendIntentException(String name) { 711ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu super(name); 721ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 731ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 741ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public SendIntentException(Exception cause) { 751ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu super(cause); 761ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 771ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 781ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 791ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 801ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Callback interface for discovering when a send operation has 811ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * completed. Primarily for use with a IntentSender that is 821ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * performing a broadcast, this provides the same information as 831ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * calling {@link Context#sendOrderedBroadcast(Intent, String, 841ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * android.content.BroadcastReceiver, Handler, int, String, Bundle) 851ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Context.sendBroadcast()} with a final BroadcastReceiver. 861ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 871ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public interface OnFinished { 881ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 891ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Called when a send operation as completed. 901ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 911ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param IntentSender The IntentSender this operation was sent through. 921ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param intent The original Intent that was sent. 931ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param resultCode The final result code determined by the send. 941ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param resultData The final data collected by a broadcast. 951ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param resultExtras The final extras collected by a broadcast. 961ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 971ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu void onSendFinished(IntentSender IntentSender, Intent intent, 981ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu int resultCode, String resultData, Bundle resultExtras); 991ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1001ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 1011ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private static class FinishedDispatcher extends IIntentReceiver.Stub 1021ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu implements Runnable { 1031ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private final IntentSender mIntentSender; 1041ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private final OnFinished mWho; 1051ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private final Handler mHandler; 1061ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private Intent mIntent; 1071ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private int mResultCode; 1081ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private String mResultData; 1091ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu private Bundle mResultExtras; 1101ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu FinishedDispatcher(IntentSender pi, OnFinished who, Handler handler) { 1111ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mIntentSender = pi; 1121ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mWho = who; 1131ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mHandler = handler; 1141ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1151ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public void performReceive(Intent intent, int resultCode, 11668d881cf2d2b252f6f795cd64d43e316a1d736e5Dianne Hackborn String data, Bundle extras, boolean serialized, boolean sticky) { 1171ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mIntent = intent; 1181ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mResultCode = resultCode; 1191ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mResultData = data; 1201ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mResultExtras = extras; 1211ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu if (mHandler == null) { 1221ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu run(); 1231ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } else { 1241ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mHandler.post(this); 1251ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1261ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1271ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public void run() { 1281ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mWho.onSendFinished(mIntentSender, mIntent, mResultCode, 1291ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mResultData, mResultExtras); 1301ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1311ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1321ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 1331ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 1341ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Perform the operation associated with this IntentSender, allowing the 1351ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * caller to specify information about the Intent to use and be notified 1361ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * when the send has completed. 1371ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 1381ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param context The Context of the caller. This may be null if 1391ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * <var>intent</var> is also null. 1401ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param code Result code to supply back to the IntentSender's target. 1411ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param intent Additional Intent data. See {@link Intent#fillIn 1421ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Intent.fillIn()} for information on how this is applied to the 1431ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * original Intent. Use null to not modify the original Intent. 1441ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param onFinished The object to call back on when the send has 1451ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * completed, or null for no callback. 1461ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param handler Handler identifying the thread on which the callback 1471ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * should happen. If null, the callback will happen from the thread 1481ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * pool of the process. 1491ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 1501ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 1511ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @throws SendIntentException Throws CanceledIntentException if the IntentSender 1521ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * is no longer allowing more intents to be sent through it. 1531ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 1541ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public void sendIntent(Context context, int code, Intent intent, 1551ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu OnFinished onFinished, Handler handler) throws SendIntentException { 1561ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu try { 1571ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu String resolvedType = intent != null ? 1581ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu intent.resolveTypeIfNeeded(context.getContentResolver()) 1591ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu : null; 1601ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu int res = mTarget.send(code, intent, resolvedType, 1611ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu onFinished != null 1621ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu ? new FinishedDispatcher(this, onFinished, handler) 1631ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu : null); 1641ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu if (res < 0) { 1651ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu throw new SendIntentException(); 1661ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1671ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } catch (RemoteException e) { 1681ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu throw new SendIntentException(); 1691ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1701ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1711ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 1721ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 1731ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Comparison operator on two IntentSender objects, such that true 1741ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * is returned then they both represent the same operation from the 1751ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * same package. 1761ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 1771ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu @Override 1781ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public boolean equals(Object otherObj) { 1791ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu if (otherObj instanceof IntentSender) { 1801ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return mTarget.asBinder().equals(((IntentSender)otherObj) 1811ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu .mTarget.asBinder()); 1821ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1831ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return false; 1841ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1851ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 1861ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu @Override 1871ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public int hashCode() { 1881ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return mTarget.asBinder().hashCode(); 1891ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 1901ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 1911ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu @Override 1921ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public String toString() { 1931ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu StringBuilder sb = new StringBuilder(128); 1941ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append("IntentSender{"); 1951ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append(Integer.toHexString(System.identityHashCode(this))); 1961ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append(": "); 1971ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append(mTarget != null ? mTarget.asBinder() : null); 1981ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu sb.append('}'); 1991ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return sb.toString(); 2001ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2011ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2021ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public int describeContents() { 2031ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return 0; 2041ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2051ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2061ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public void writeToParcel(Parcel out, int flags) { 2071ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu out.writeStrongBinder(mTarget.asBinder()); 2081ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2091ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2101ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static final Parcelable.Creator<IntentSender> CREATOR 2111ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu = new Parcelable.Creator<IntentSender>() { 2121ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender createFromParcel(Parcel in) { 2131ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu IBinder target = in.readStrongBinder(); 2141ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return target != null ? new IntentSender(target) : null; 2151ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2161ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2171ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public IntentSender[] newArray(int size) { 2181ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return new IntentSender[size]; 2191ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2201ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu }; 2211ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2221ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 2231ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Convenience function for writing either a IntentSender or null pointer to 2241ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * a Parcel. You must use this with {@link #readIntentSenderOrNullFromParcel} 2251ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * for later reading it. 2261ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 2271ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param sender The IntentSender to write, or null. 2281ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param out Where to write the IntentSender. 2291ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 2301ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static void writeIntentSenderOrNullToParcel(IntentSender sender, 2311ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu Parcel out) { 2321ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu out.writeStrongBinder(sender != null ? sender.mTarget.asBinder() 2331ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu : null); 2341ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2351ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2361ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu /** 2371ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * Convenience function for reading either a Messenger or null pointer from 2381ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * a Parcel. You must have previously written the Messenger with 2391ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * {@link #writeIntentSenderOrNullToParcel}. 2401ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 2411ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @param in The Parcel containing the written Messenger. 2421ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * 2431ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * @return Returns the Messenger read from the Parcel, or null if null had 2441ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu * been written. 2451ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu */ 2461ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu public static IntentSender readIntentSenderOrNullFromParcel(Parcel in) { 2471ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu IBinder b = in.readStrongBinder(); 2481ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu return b != null ? new IntentSender(b) : null; 2491ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2501ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2517f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn /** @hide */ 252fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn public IIntentSender getTarget() { 253fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn return mTarget; 254fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn } 255fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn 256fa82f22f1d8c4c828bdf9b670006be4f4fec772eDianne Hackborn /** @hide */ 2577f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn public IntentSender(IIntentSender target) { 2581ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mTarget = target; 2591ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2601ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu 2617f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn /** @hide */ 2627f2054392e9957d3ba8579ef08c29cfb27df564eDianne Hackborn public IntentSender(IBinder target) { 2631ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu mTarget = IIntentSender.Stub.asInterface(target); 2641ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu } 2651ccac75e1f1b97eccb916a8de04fc1012b30f6e5Suchi Amalapurapu} 266