19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.os; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.text.TextUtils; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.SparseArray; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.SparseBooleanArray; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.ByteArrayInputStream; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.ByteArrayOutputStream; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.FileDescriptor; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.FileNotFoundException; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.IOException; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.ObjectInputStream; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.ObjectOutputStream; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.Serializable; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.reflect.Field; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.ArrayList; 34a28b83ee04ca25100781f37a50665d6e1b05e3a2Elliott Hughesimport java.util.Arrays; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.HashMap; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.List; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.Map; 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.Set; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Container for a message (data and object references) that can 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sent through an IBinder. A Parcel can contain both flattened data 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that will be unflattened on the other side of the IPC (using the various 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * methods here for writing specific types, or the general 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Parcelable} interface), and references to live {@link IBinder} 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * objects that will result in the other side receiving a proxy IBinder 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected with the original IBinder in the Parcel. 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p class="note">Parcel is <strong>not</strong> a general-purpose 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * serialization mechanism. This class (and the corresponding 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Parcelable} API for placing arbitrary objects into a Parcel) is 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * designed as a high-performance IPC transport. As such, it is not 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * appropriate to place any Parcel data in to persistent storage: changes 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the underlying implementation of any of the data in the Parcel can 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * render older data unreadable.</p> 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The bulk of the Parcel API revolves around reading and writing data 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of various types. There are six major classes of such functions available.</p> 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <h3>Primitives</h3> 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The most basic data functions are for writing and reading primitive 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * data types: {@link #writeByte}, {@link #readByte}, {@link #writeDouble}, 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readDouble}, {@link #writeFloat}, {@link #readFloat}, {@link #writeInt}, 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readInt}, {@link #writeLong}, {@link #readLong}, 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeString}, {@link #readString}. Most other 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * data operations are built on top of these. The given data is written and 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * read using the endianess of the host CPU.</p> 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <h3>Primitive Arrays</h3> 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>There are a variety of methods for reading and writing raw arrays 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of primitive objects, which generally result in writing a 4-byte length 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * followed by the primitive data items. The methods for reading can either 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * read the data into an existing array, or create and return a new array. 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * These available types are:</p> 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link #writeBooleanArray(boolean[])}, 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readBooleanArray(boolean[])}, {@link #createBooleanArray()} 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link #writeByteArray(byte[])}, 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeByteArray(byte[], int, int)}, {@link #readByteArray(byte[])}, 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #createByteArray()} 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link #writeCharArray(char[])}, {@link #readCharArray(char[])}, 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #createCharArray()} 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link #writeDoubleArray(double[])}, {@link #readDoubleArray(double[])}, 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #createDoubleArray()} 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link #writeFloatArray(float[])}, {@link #readFloatArray(float[])}, 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #createFloatArray()} 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link #writeIntArray(int[])}, {@link #readIntArray(int[])}, 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #createIntArray()} 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link #writeLongArray(long[])}, {@link #readLongArray(long[])}, 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #createLongArray()} 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link #writeStringArray(String[])}, {@link #readStringArray(String[])}, 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #createStringArray()}. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link #writeSparseBooleanArray(SparseBooleanArray)}, 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readSparseBooleanArray()}. 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <h3>Parcelables</h3> 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The {@link Parcelable} protocol provides an extremely efficient (but 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * low-level) protocol for objects to write and read themselves from Parcels. 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You can use the direct methods {@link #writeParcelable(Parcelable, int)} 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and {@link #readParcelable(ClassLoader)} or 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeParcelableArray} and 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readParcelableArray(ClassLoader)} to write or read. These 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * methods write both the class type and its data to the Parcel, allowing 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that class to be reconstructed from the appropriate class loader when 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * later reading.</p> 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>There are also some methods that provide a more efficient way to work 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with Parcelables: {@link #writeTypedArray}, 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeTypedList(List)}, 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readTypedArray} and {@link #readTypedList}. These methods 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * do not write the class information of the original object: instead, the 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller of the read function must know what type to expect and pass in the 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * appropriate {@link Parcelable.Creator Parcelable.Creator} instead to 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * properly construct the new object and read its data. (To more efficient 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * write and read a single Parceable object, you can directly call 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Parcelable#writeToParcel Parcelable.writeToParcel} and 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Parcelable.Creator#createFromParcel Parcelable.Creator.createFromParcel} 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * yourself.)</p> 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <h3>Bundles</h3> 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>A special type-safe container, called {@link Bundle}, is available 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for key/value maps of heterogeneous values. This has many optimizations 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for improved performance when reading and writing data, and its type-safe 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * API avoids difficult to debug type errors when finally marshalling the 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * data contents into a Parcel. The methods to use are 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeBundle(Bundle)}, {@link #readBundle()}, and 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readBundle(ClassLoader)}. 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <h3>Active Objects</h3> 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>An unusual feature of Parcel is the ability to read and write active 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * objects. For these objects the actual contents of the object is not 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * written, rather a special token referencing the object is written. When 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reading the object back from the Parcel, you do not get a new instance of 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the object, but rather a handle that operates on the exact same object that 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * was originally written. There are two forms of active objects available.</p> 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>{@link Binder} objects are a core facility of Android's general cross-process 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * communication system. The {@link IBinder} interface describes an abstract 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * protocol with a Binder object. Any such interface can be written in to 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Parcel, and upon reading you will receive either the original object 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * implementing that interface or a special proxy implementation 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that communicates calls back to the original object. The methods to use are 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeStrongBinder(IBinder)}, 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeStrongInterface(IInterface)}, {@link #readStrongBinder()}, 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeBinderArray(IBinder[])}, {@link #readBinderArray(IBinder[])}, 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #createBinderArray()}, 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeBinderList(List)}, {@link #readBinderList(List)}, 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #createBinderArrayList()}.</p> 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>FileDescriptor objects, representing raw Linux file descriptor identifiers, 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can be written and {@link ParcelFileDescriptor} objects returned to operate 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on the original file descriptor. The returned file descriptor is a dup 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the original file descriptor: the object and fd is different, but 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operating on the same underlying file stream, with the same position, etc. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The methods to use are {@link #writeFileDescriptor(FileDescriptor)}, 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readFileDescriptor()}. 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <h3>Untyped Containers</h3> 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>A final class of methods are for writing and reading standard Java 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * containers of arbitrary types. These all revolve around the 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeValue(Object)} and {@link #readValue(ClassLoader)} methods 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which define the types of objects allowed. The container methods are 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeArray(Object[])}, {@link #readArray(ClassLoader)}, 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeList(List)}, {@link #readList(List, ClassLoader)}, 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readArrayList(ClassLoader)}, 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeMap(Map)}, {@link #readMap(Map, ClassLoader)}, 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeSparseArray(SparseArray)}, 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readSparseArray(ClassLoader)}. 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class Parcel { 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final boolean DEBUG_RECYCLE = false; 1805b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick private static final String TAG = "Parcel"; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings({"UnusedDeclaration"}) 183047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private int mNativePtr; // used by native code 184047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 185047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey /** 186047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey * Flag indicating if {@link #mNativePtr} was allocated by this object, 187047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey * indicating that we're responsible for its lifecycle. 188047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey */ 189047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private boolean mOwnsNativeParcelObject; 190047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private RuntimeException mStack; 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int POOL_SIZE = 6; 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final Parcel[] sOwnedPool = new Parcel[POOL_SIZE]; 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final Parcel[] sHolderPool = new Parcel[POOL_SIZE]; 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_NULL = -1; 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_STRING = 0; 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_INTEGER = 1; 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_MAP = 2; 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_BUNDLE = 3; 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_PARCELABLE = 4; 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_SHORT = 5; 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_LONG = 6; 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_FLOAT = 7; 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_DOUBLE = 8; 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_BOOLEAN = 9; 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_CHARSEQUENCE = 10; 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_LIST = 11; 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_SPARSEARRAY = 12; 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_BYTEARRAY = 13; 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_STRINGARRAY = 14; 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_IBINDER = 15; 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_PARCELABLEARRAY = 16; 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_OBJECTARRAY = 17; 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_INTARRAY = 18; 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_LONGARRAY = 19; 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_BYTE = 20; 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_SERIALIZABLE = 21; 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_SPARSEBOOLEANARRAY = 22; 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int VAL_BOOLEANARRAY = 23; 22208bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert private static final int VAL_CHARSEQUENCEARRAY = 24; 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2245b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // The initial int32 in a Binder call's reply Parcel header: 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int EX_SECURITY = -1; 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int EX_BAD_PARCELABLE = -2; 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int EX_ILLEGAL_ARGUMENT = -3; 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int EX_NULL_POINTER = -4; 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int EX_ILLEGAL_STATE = -5; 2305b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick private static final int EX_HAS_REPLY_HEADER = -128; // special; see below 2315b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick 232047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native int nativeDataSize(int nativePtr); 233047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native int nativeDataAvail(int nativePtr); 234047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native int nativeDataPosition(int nativePtr); 235047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native int nativeDataCapacity(int nativePtr); 236047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeSetDataSize(int nativePtr, int size); 237047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeSetDataPosition(int nativePtr, int pos); 238047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeSetDataCapacity(int nativePtr, int size); 239047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 240047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native boolean nativePushAllowFds(int nativePtr, boolean allowFds); 241047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeRestoreAllowFds(int nativePtr, boolean lastValue); 242047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 243047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeWriteByteArray(int nativePtr, byte[] b, int offset, int len); 244047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeWriteInt(int nativePtr, int val); 245047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeWriteLong(int nativePtr, long val); 246047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeWriteFloat(int nativePtr, float val); 247047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeWriteDouble(int nativePtr, double val); 248047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeWriteString(int nativePtr, String val); 249047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeWriteStrongBinder(int nativePtr, IBinder val); 250047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeWriteFileDescriptor(int nativePtr, FileDescriptor val); 251047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 252047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native byte[] nativeCreateByteArray(int nativePtr); 253047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native int nativeReadInt(int nativePtr); 254047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native long nativeReadLong(int nativePtr); 255047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native float nativeReadFloat(int nativePtr); 256047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native double nativeReadDouble(int nativePtr); 257047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native String nativeReadString(int nativePtr); 258047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native IBinder nativeReadStrongBinder(int nativePtr); 259047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native FileDescriptor nativeReadFileDescriptor(int nativePtr); 260047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 261047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native int nativeCreate(); 262047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeFreeBuffer(int nativePtr); 263047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeDestroy(int nativePtr); 264047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 265047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native byte[] nativeMarshall(int nativePtr); 266047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeUnmarshall( 267047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey int nativePtr, byte[] data, int offest, int length); 268047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeAppendFrom( 269047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey int thisNativePtr, int otherNativePtr, int offset, int length); 270047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native boolean nativeHasFileDescriptors(int nativePtr); 271047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeWriteInterfaceToken(int nativePtr, String interfaceName); 272047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private static native void nativeEnforceInterface(int nativePtr, String interfaceName); 273047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static Parcelable.Creator<String> STRING_CREATOR 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<String>() { 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String createFromParcel(Parcel source) { 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return source.readString(); 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String[] newArray(int size) { 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new String[size]; 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve a new Parcel object from the pool. 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Parcel obtain() { 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Parcel[] pool = sOwnedPool; 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (pool) { 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel p; 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<POOL_SIZE; i++) { 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project p = pool[i]; 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (p != null) { 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pool[i] = null; 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (DEBUG_RECYCLE) { 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project p.mStack = new RuntimeException(); 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return p; 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Parcel(0); 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Put a Parcel object back into the pool. You must not touch 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the object after this call. 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void recycle() { 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (DEBUG_RECYCLE) mStack = null; 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project freeBuffer(); 312047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 313047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey final Parcel[] pool; 314047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey if (mOwnsNativeParcelObject) { 315047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey pool = sOwnedPool; 316047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } else { 317047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey mNativePtr = 0; 318047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey pool = sHolderPool; 319047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 320047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (pool) { 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<POOL_SIZE; i++) { 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (pool[i] == null) { 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pool[i] = this; 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the total amount of data contained in the parcel. 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 334047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final int dataSize() { 335047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeDataSize(mNativePtr); 336047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the amount of data remaining to be read from the 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * parcel. That is, {@link #dataSize}-{@link #dataPosition}. 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 342047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final int dataAvail() { 343047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeDataAvail(mNativePtr); 344047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the current position in the parcel data. Never 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more than {@link #dataSize}. 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 350047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final int dataPosition() { 351047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeDataPosition(mNativePtr); 352047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the total amount of space in the parcel. This is always 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * >= {@link #dataSize}. The difference between it and dataSize() is the 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * amount of room left until the parcel needs to re-allocate its 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * data buffer. 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 360047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final int dataCapacity() { 361047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeDataCapacity(mNativePtr); 362047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change the amount of data in the parcel. Can be either smaller or 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * larger than the current size. If larger than the current capacity, 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * more memory will be allocated. 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param size The new number of bytes in the Parcel. 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 371047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void setDataSize(int size) { 372047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeSetDataSize(mNativePtr, size); 373047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Move the current read/write position in the parcel. 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos New offset in the parcel; must be between 0 and 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #dataSize}. 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 380047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void setDataPosition(int pos) { 381047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeSetDataPosition(mNativePtr, pos); 382047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Change the capacity (current available space) of the parcel. 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param size The new capacity of the parcel, in bytes. Can not be 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * less than {@link #dataSize} -- that is, you can not drop existing data 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with this method. 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 391047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void setDataCapacity(int size) { 392047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeSetDataCapacity(mNativePtr, size); 393047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3959ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn /** @hide */ 396047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final boolean pushAllowFds(boolean allowFds) { 397047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativePushAllowFds(mNativePtr, allowFds); 398047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 399c04db7e06737c5b9bae276ac462858d44002672eDianne Hackborn 400c04db7e06737c5b9bae276ac462858d44002672eDianne Hackborn /** @hide */ 401047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void restoreAllowFds(boolean lastValue) { 402047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeRestoreAllowFds(mNativePtr, lastValue); 403047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 4049ecebbfbf768fd63e9a6c9a09c86d81c7737ee2dDianne Hackborn 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the raw bytes of the parcel. 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p class="note">The data you retrieve here <strong>must not</strong> 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be placed in any kind of persistent storage (on local disk, across 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a network, etc). For that, you should use standard serialization 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or another kind of general serialization mechanism. The Parcel 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * marshalled representation is highly optimized for local IPC, and as 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * such does not attempt to maintain compatibility with data created 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in different versions of the platform. 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 416047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final byte[] marshall() { 417047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeMarshall(mNativePtr); 418047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the bytes in data to be the raw bytes of this Parcel. 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 423047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void unmarshall(byte[] data, int offest, int length) { 424047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeUnmarshall(mNativePtr, data, offest, length); 425047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 427047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void appendFrom(Parcel parcel, int offset, int length) { 428047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeAppendFrom(mNativePtr, parcel.mNativePtr, offset, length); 429047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Report whether the parcel contains any marshalled file descriptors. 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 434047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final boolean hasFileDescriptors() { 435047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeHasFileDescriptors(mNativePtr); 436047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Store or read an IBinder interface token in the parcel at the current 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #dataPosition}. This is used to validate that the marshalled 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transaction is intended for the target interface. 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 443047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void writeInterfaceToken(String interfaceName) { 444047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeWriteInterfaceToken(mNativePtr, interfaceName); 445047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 446047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 447047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void enforceInterface(String interfaceName) { 448047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeEnforceInterface(mNativePtr, interfaceName); 449047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 452a28b83ee04ca25100781f37a50665d6e1b05e3a2Elliott Hughes * Write a byte array into the parcel at the current {@link #dataPosition}, 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing {@link #dataCapacity} if needed. 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b Bytes to place into the parcel. 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeByteArray(byte[] b) { 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeByteArray(b, 0, (b != null) ? b.length : 0); 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 461f76a50ce8fdc6aea22cabc77b2977a1a15a79630Ken Wakasa * Write a byte array into the parcel at the current {@link #dataPosition}, 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing {@link #dataCapacity} if needed. 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b Bytes to place into the parcel. 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Index of first byte to be written. 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param len Number of bytes to write. 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeByteArray(byte[] b, int offset, int len) { 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (b == null) { 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 472a28b83ee04ca25100781f37a50665d6e1b05e3a2Elliott Hughes Arrays.checkOffsetAndCount(b.length, offset, len); 473047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeWriteByteArray(mNativePtr, b, offset, len); 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write an integer value into the parcel at the current dataPosition(), 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 480047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void writeInt(int val) { 481047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeWriteInt(mNativePtr, val); 482047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a long integer value into the parcel at the current dataPosition(), 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 488047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void writeLong(long val) { 489047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeWriteLong(mNativePtr, val); 490047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a floating point value into the parcel at the current 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataPosition(), growing dataCapacity() if needed. 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 496047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void writeFloat(float val) { 497047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeWriteFloat(mNativePtr, val); 498047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a double precision floating point value into the parcel at the 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current dataPosition(), growing dataCapacity() if needed. 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 504047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void writeDouble(double val) { 505047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeWriteDouble(mNativePtr, val); 506047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a string value into the parcel at the current dataPosition(), 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 512047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void writeString(String val) { 513047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeWriteString(mNativePtr, val); 514047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 51708bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert * Write a CharSequence value into the parcel at the current dataPosition(), 51808bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert * growing dataCapacity() if needed. 51908bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert * @hide 52008bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert */ 52108bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert public final void writeCharSequence(CharSequence val) { 52208bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert TextUtils.writeToParcel(val, this, 0); 52308bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert } 52408bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert 52508bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert /** 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write an object into the parcel at the current dataPosition(), 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 529047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void writeStrongBinder(IBinder val) { 530047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeWriteStrongBinder(mNativePtr, val); 531047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write an object into the parcel at the current dataPosition(), 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeStrongInterface(IInterface val) { 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeStrongBinder(val == null ? null : val.asBinder()); 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a FileDescriptor into the parcel at the current dataPosition(), 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. 544b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * 545b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * <p class="caution">The file descriptor will not be closed, which may 546b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * result in file descriptor leaks when objects are returned from Binder 547b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * calls. Use {@link ParcelFileDescriptor#writeToParcel} instead, which 548b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * accepts contextual flags and will close the original file descriptor 549b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * if {@link Parcelable#PARCELABLE_WRITE_RETURN_VALUE} is set.</p> 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 551047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final void writeFileDescriptor(FileDescriptor val) { 552047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeWriteFileDescriptor(mNativePtr, val); 553047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 556f76a50ce8fdc6aea22cabc77b2977a1a15a79630Ken Wakasa * Write a byte value into the parcel at the current dataPosition(), 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeByte(byte val) { 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(val); 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Please use {@link #writeBundle} instead. Flattens a Map into the parcel 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * at the current dataPosition(), 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. The Map keys must be String objects. 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The Map values are written using {@link #writeValue} and must follow 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specification there. 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>It is strongly recommended to use {@link #writeBundle} instead of 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this method, since the Bundle class provides a type-safe API that 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * allows you to avoid mysterious type errors at the point of marshalling. 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeMap(Map val) { 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeMapInternal((Map<String,Object>) val); 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten a Map into the parcel at the current dataPosition(), 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. The Map keys must be String objects. 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5826aff905048ba3b03724f17e2aba9089872e14cd2Dianne Hackborn /* package */ void writeMapInternal(Map<String,Object> val) { 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val == null) { 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Set<Map.Entry<String,Object>> entries = val.entrySet(); 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(entries.size()); 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (Map.Entry<String,Object> e : entries) { 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeValue(e.getKey()); 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeValue(e.getValue()); 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten a Bundle into the parcel at the current dataPosition(), 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeBundle(Bundle val) { 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val == null) { 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6056aff905048ba3b03724f17e2aba9089872e14cd2Dianne Hackborn val.writeToParcel(this, 0); 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten a List into the parcel at the current dataPosition(), growing 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataCapacity() if needed. The List values are written using 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeValue} and must follow the specification there. 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeList(List val) { 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val == null) { 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.size(); 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i=0; 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (i < N) { 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeValue(val.get(i)); 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project i++; 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten an Object array into the parcel at the current dataPosition(), 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * growing dataCapacity() if needed. The array values are written using 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeValue} and must follow the specification there. 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeArray(Object[] val) { 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val == null) { 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.length; 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i=0; 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (i < N) { 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeValue(val[i]); 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project i++; 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten a generic SparseArray into the parcel at the current 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataPosition(), growing dataCapacity() if needed. The SparseArray 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values are written using {@link #writeValue} and must follow the 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specification there. 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeSparseArray(SparseArray<Object> val) { 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val == null) { 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.size(); 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i=0; 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (i < N) { 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(val.keyAt(i)); 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeValue(val.valueAt(i)); 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project i++; 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeSparseBooleanArray(SparseBooleanArray val) { 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val == null) { 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.size(); 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i=0; 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (i < N) { 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(val.keyAt(i)); 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeByte((byte)(val.valueAt(i) ? 1 : 0)); 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project i++; 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeBooleanArray(boolean[] val) { 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val != null) { 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.length; 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(val[i] ? 1 : 0); 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean[] createBooleanArray() { 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // >>2 as a fast divide-by-4 works in the create*Array() functions 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // because dataAvail() will never return a negative number. 4 is 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the size of a stored boolean in the stream. 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N >= 0 && N <= (dataAvail() >> 2)) { 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean[] val = new boolean[N]; 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readInt() != 0; 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return val; 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readBooleanArray(boolean[] val) { 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N == val.length) { 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readInt() != 0; 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("bad array lengths"); 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeCharArray(char[] val) { 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val != null) { 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.length; 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt((int)val[i]); 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final char[] createCharArray() { 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N >= 0 && N <= (dataAvail() >> 2)) { 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] val = new char[N]; 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = (char)readInt(); 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return val; 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readCharArray(char[] val) { 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N == val.length) { 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = (char)readInt(); 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("bad array lengths"); 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeIntArray(int[] val) { 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val != null) { 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.length; 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(val[i]); 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int[] createIntArray() { 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N >= 0 && N <= (dataAvail() >> 2)) { 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] val = new int[N]; 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readInt(); 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return val; 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readIntArray(int[] val) { 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N == val.length) { 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readInt(); 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("bad array lengths"); 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeLongArray(long[] val) { 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val != null) { 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.length; 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeLong(val[i]); 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final long[] createLongArray() { 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // >>3 because stored longs are 64 bits 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N >= 0 && N <= (dataAvail() >> 3)) { 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long[] val = new long[N]; 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readLong(); 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return val; 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readLongArray(long[] val) { 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N == val.length) { 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readLong(); 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("bad array lengths"); 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeFloatArray(float[] val) { 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val != null) { 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.length; 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeFloat(val[i]); 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final float[] createFloatArray() { 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // >>2 because stored floats are 4 bytes 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N >= 0 && N <= (dataAvail() >> 2)) { 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] val = new float[N]; 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readFloat(); 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return val; 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readFloatArray(float[] val) { 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N == val.length) { 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readFloat(); 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("bad array lengths"); 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeDoubleArray(double[] val) { 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val != null) { 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.length; 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeDouble(val[i]); 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final double[] createDoubleArray() { 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // >>3 because stored doubles are 8 bytes 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N >= 0 && N <= (dataAvail() >> 3)) { 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project double[] val = new double[N]; 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readDouble(); 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return val; 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readDoubleArray(double[] val) { 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N == val.length) { 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readDouble(); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("bad array lengths"); 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeStringArray(String[] val) { 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val != null) { 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.length; 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeString(val[i]); 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final String[] createStringArray() { 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N >= 0) { 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] val = new String[N]; 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readString(); 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return val; 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readStringArray(String[] val) { 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N == val.length) { 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readString(); 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("bad array lengths"); 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeBinderArray(IBinder[] val) { 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val != null) { 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.length; 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeStrongBinder(val[i]); 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 95208bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert /** 95308bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert * @hide 95408bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert */ 95508bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert public final void writeCharSequenceArray(CharSequence[] val) { 95608bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert if (val != null) { 95708bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert int N = val.length; 95808bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert writeInt(N); 95908bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert for (int i=0; i<N; i++) { 96008bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert writeCharSequence(val[i]); 96108bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert } 96208bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert } else { 96308bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert writeInt(-1); 96408bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert } 96508bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert } 96608bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final IBinder[] createBinderArray() { 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N >= 0) { 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBinder[] val = new IBinder[N]; 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readStrongBinder(); 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return val; 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readBinderArray(IBinder[] val) { 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N == val.length) { 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = readStrongBinder(); 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("bad array lengths"); 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten a List containing a particular object type into the parcel, at 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the current dataPosition() and growing dataCapacity() if needed. The 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * type of the objects in the list must be one that implements Parcelable. 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlike the generic writeList() method, however, only the raw data of the 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * objects is written and not their type, so you must use the corresponding 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * readTypedList() to unmarshall them. 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param val The list of objects to be written. 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #createTypedArrayList 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #readTypedList 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Parcelable 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T extends Parcelable> void writeTypedList(List<T> val) { 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val == null) { 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.size(); 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i=0; 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (i < N) { 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project T item = val.get(i); 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (item != null) { 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(1); 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project item.writeToParcel(this, 0); 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(0); 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project i++; 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten a List containing String objects into the parcel, at 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the current dataPosition() and growing dataCapacity() if needed. They 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can later be retrieved with {@link #createStringArrayList} or 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readStringList}. 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param val The list of strings to be written. 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #createStringArrayList 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #readStringList 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeStringList(List<String> val) { 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val == null) { 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.size(); 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i=0; 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (i < N) { 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeString(val.get(i)); 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project i++; 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten a List containing IBinder objects into the parcel, at 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the current dataPosition() and growing dataCapacity() if needed. They 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can later be retrieved with {@link #createBinderArrayList} or 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readBinderList}. 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param val The list of strings to be written. 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #createBinderArrayList 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #readBinderList 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeBinderList(List<IBinder> val) { 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val == null) { 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.size(); 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i=0; 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (i < N) { 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeStrongBinder(val.get(i)); 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project i++; 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten a heterogeneous array containing a particular object type into 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the parcel, at 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the current dataPosition() and growing dataCapacity() if needed. The 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * type of the objects in the array must be one that implements Parcelable. 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlike the {@link #writeParcelableArray} method, however, only the 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * raw data of the objects is written and not their type, so you must use 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #readTypedArray} with the correct corresponding 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Parcelable.Creator} implementation to unmarshall them. 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param val The array of objects to be written. 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param parcelableFlags Contextual flags as per 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Parcelable#writeToParcel(Parcel, int) Parcelable.writeToParcel()}. 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #readTypedArray 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeParcelableArray 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Parcelable.Creator 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T extends Parcelable> void writeTypedArray(T[] val, 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int parcelableFlags) { 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (val != null) { 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = val.length; 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project T item = val[i]; 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (item != null) { 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(1); 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project item.writeToParcel(this, parcelableFlags); 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(0); 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten a generic object in to a parcel. The given Object value may 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * currently be one of the following types: 1115b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> null 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> String 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Byte 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Short 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Integer 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Long 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Float 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Double 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Boolean 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> String[] 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> boolean[] 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> byte[] 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> int[] 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> long[] 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Object[] (supporting objects of the same type defined here). 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link Bundle} 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Map (as supported by {@link #writeMap}). 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Any object that implements the {@link Parcelable} protocol. 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Parcelable[] 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> CharSequence (as supported by {@link TextUtils#writeToParcel}). 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> List (as supported by {@link #writeList}). 1138b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * <li> {@link SparseArray} (as supported by {@link #writeSparseArray(SparseArray)}). 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> {@link IBinder} 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li> Any object that implements Serializable (but see 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeSerializable} for caveats). Note that all of the 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previous types have relatively efficient implementations for 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * writing to a Parcel; having to rely on the generic serialization 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * approach is much less efficient and should be avoided whenever 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * possible. 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 1147b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * 1148b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * <p class="caution">{@link Parcelable} objects are written with 1149b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * {@link Parcelable#writeToParcel} using contextual flags of 0. When 1150b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * serializing objects containing {@link ParcelFileDescriptor}s, 1151b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * this may result in file descriptor leaks when they are returned from 1152b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * Binder calls (where {@link Parcelable#PARCELABLE_WRITE_RETURN_VALUE} 1153b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * should be used).</p> 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeValue(Object v) { 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (v == null) { 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_NULL); 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof String) { 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_STRING); 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeString((String) v); 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Integer) { 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_INTEGER); 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt((Integer) v); 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Map) { 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_MAP); 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeMap((Map) v); 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Bundle) { 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Must be before Parcelable 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_BUNDLE); 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeBundle((Bundle) v); 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Parcelable) { 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_PARCELABLE); 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeParcelable((Parcelable) v, 0); 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Short) { 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_SHORT); 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(((Short) v).intValue()); 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Long) { 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_LONG); 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeLong((Long) v); 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Float) { 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_FLOAT); 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeFloat((Float) v); 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Double) { 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_DOUBLE); 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeDouble((Double) v); 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Boolean) { 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_BOOLEAN); 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt((Boolean) v ? 1 : 0); 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof CharSequence) { 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Must be after String 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_CHARSEQUENCE); 119208bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert writeCharSequence((CharSequence) v); 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof List) { 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_LIST); 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeList((List) v); 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof SparseArray) { 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_SPARSEARRAY); 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeSparseArray((SparseArray) v); 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof boolean[]) { 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_BOOLEANARRAY); 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeBooleanArray((boolean[]) v); 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof byte[]) { 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_BYTEARRAY); 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeByteArray((byte[]) v); 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof String[]) { 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_STRINGARRAY); 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeStringArray((String[]) v); 120808bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert } else if (v instanceof CharSequence[]) { 120908bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert // Must be after String[] and before Object[] 121008bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert writeInt(VAL_CHARSEQUENCEARRAY); 121108bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert writeCharSequenceArray((CharSequence[]) v); 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof IBinder) { 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_IBINDER); 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeStrongBinder((IBinder) v); 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Parcelable[]) { 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_PARCELABLEARRAY); 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeParcelableArray((Parcelable[]) v, 0); 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Object[]) { 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_OBJECTARRAY); 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeArray((Object[]) v); 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof int[]) { 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_INTARRAY); 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeIntArray((int[]) v); 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof long[]) { 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_LONGARRAY); 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeLongArray((long[]) v); 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Byte) { 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_BYTE); 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt((Byte) v); 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (v instanceof Serializable) { 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Must be last 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(VAL_SERIALIZABLE); 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeSerializable((Serializable) v); 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Parcel: unable to marshal value " + v); 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Flatten the name of the class of the Parcelable and its contents 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the parcel. 1242b3e4ef37021a9e5518fdbc7d0cbb0a1709d5301bDan Egnor * 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param p The Parcelable object to be written. 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param parcelableFlags Contextual flags as per 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Parcelable#writeToParcel(Parcel, int) Parcelable.writeToParcel()}. 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeParcelable(Parcelable p, int parcelableFlags) { 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (p == null) { 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeString(null); 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String name = p.getClass().getName(); 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeString(name); 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project p.writeToParcel(this, parcelableFlags); 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a generic serializable object in to a Parcel. It is strongly 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * recommended that this method be avoided, since the serialization 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * overhead is extremely large, and this approach will be much slower than 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * using the other approaches to writing data in to a Parcel. 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeSerializable(Serializable s) { 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (s == null) { 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeString(null); 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String name = s.getClass().getName(); 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeString(name); 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ByteArrayOutputStream baos = new ByteArrayOutputStream(); 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ObjectOutputStream oos = new ObjectOutputStream(baos); 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project oos.writeObject(s); 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project oos.close(); 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeByteArray(baos.toByteArray()); 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ioe) { 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Parcelable encountered " + 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "IOException writing serializable object (name = " + name + 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ")", ioe); 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Special function for writing an exception result at the header of 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a parcel, to be used when returning an exception from a transaction. 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that this currently only supports a few exception types; any other 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exception will be re-thrown by this function as a RuntimeException 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (to be caught by the system's last-resort exception handling when 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dispatching a transaction). 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The supported exception types are: 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>{@link BadParcelableException} 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>{@link IllegalArgumentException} 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>{@link IllegalStateException} 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>{@link NullPointerException} 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>{@link SecurityException} 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param e The Exception to be written. 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeNoException 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #readException 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeException(Exception e) { 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int code = 0; 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (e instanceof SecurityException) { 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = EX_SECURITY; 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof BadParcelableException) { 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = EX_BAD_PARCELABLE; 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof IllegalArgumentException) { 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = EX_ILLEGAL_ARGUMENT; 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof NullPointerException) { 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = EX_NULL_POINTER; 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (e instanceof IllegalStateException) { 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project code = EX_ILLEGAL_STATE; 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(code); 1321703e5d3c7fbeb8ca0978045db01d40318f838612Brad Fitzpatrick StrictMode.clearGatheredViolations(); 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (code == 0) { 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (e instanceof RuntimeException) { 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw (RuntimeException) e; 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException(e); 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeString(e.getMessage()); 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Special function for writing information at the front of the Parcel 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * indicating that no exception occurred. 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeException 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #readException 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void writeNoException() { 13395b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // Despite the name of this function ("write no exception"), 13405b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // it should instead be thought of as "write the RPC response 13415b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // header", but because this function name is written out by 13425b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // the AIDL compiler, we're not going to rename it. 13435b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // 13445b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // The response header, in the non-exception case (see also 13455b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // writeException above, also called by the AIDL compiler), is 13465b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // either a 0 (the default case), or EX_HAS_REPLY_HEADER if 13475b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // StrictMode has gathered up violations that have occurred 13485b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // during a Binder call, in which case we write out the number 13495b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // of violations and their details, serialized, before the 13505b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // actual RPC respons data. The receiving end of this is 13515b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // readException(), below. 13525b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick if (StrictMode.hasGatheredViolations()) { 13535b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick writeInt(EX_HAS_REPLY_HEADER); 13545b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick final int sizePosition = dataPosition(); 13555b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick writeInt(0); // total size of fat header, to be filled in later 13565b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick StrictMode.writeGatheredViolationsToParcel(this); 13575b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick final int payloadPosition = dataPosition(); 13585b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick setDataPosition(sizePosition); 13595b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick writeInt(payloadPosition - sizePosition); // header size 13605b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick setDataPosition(payloadPosition); 13615b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick } else { 13625b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick writeInt(0); 13635b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick } 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Special function for reading an exception result from the header of 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a parcel, to be used after receiving the result of a transaction. This 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will throw the exception for you if it had been written to the Parcel, 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * otherwise return and let you read the normal result data from the Parcel. 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeException 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeNoException 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readException() { 13765b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick int code = readExceptionCode(); 13775b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick if (code != 0) { 13785b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick String msg = readString(); 13795b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick readException(code, msg); 13805b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick } 13815b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick } 13825b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick 13835b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick /** 13845b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * Parses the header of a Binder call's response Parcel and 13855b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * returns the exception code. Deals with lite or fat headers. 13865b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * In the common successful case, this header is generally zero. 13875b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * In less common cases, it's a small negative number and will be 13885b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * followed by an error string. 13895b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * 13905b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * This exists purely for android.database.DatabaseUtils and 13915b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * insulating it from having to handle fat headers as returned by 13925b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * e.g. StrictMode-induced RPC responses. 13935b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * 13945b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick * @hide 13955b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick */ 13965b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick public final int readExceptionCode() { 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int code = readInt(); 13985b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick if (code == EX_HAS_REPLY_HEADER) { 13995b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick int headerSize = readInt(); 14005b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick if (headerSize == 0) { 14015b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick Log.e(TAG, "Unexpected zero-sized Parcel reply header."); 14025b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick } else { 14035b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // Currently the only thing in the header is StrictMode stacks, 14045b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // but discussions around event/RPC tracing suggest we might 14055b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // put that here too. If so, switch on sub-header tags here. 14065b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // But for now, just parse out the StrictMode stuff. 14075b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick StrictMode.readAndHandleBinderCallViolations(this); 14085b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick } 14095b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // And fat response headers are currently only used when 14105b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick // there are no exceptions, so return no error: 14115b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick return 0; 14125b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick } 14135b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick return code; 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use this function for customized exception handling. 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * customized method call this method for all unknown case 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param code exception code 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param msg exception message 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readException(int code, String msg) { 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (code) { 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case EX_SECURITY: 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new SecurityException(msg); 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case EX_BAD_PARCELABLE: 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new BadParcelableException(msg); 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case EX_ILLEGAL_ARGUMENT: 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException(msg); 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case EX_NULL_POINTER: 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(msg); 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case EX_ILLEGAL_STATE: 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(msg); 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Unknown exception code: " + code 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " msg " + msg); 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read an integer value from the parcel at the current dataPosition(). 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1442047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final int readInt() { 1443047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeReadInt(mNativePtr); 1444047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read a long integer value from the parcel at the current dataPosition(). 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1449047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final long readLong() { 1450047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeReadLong(mNativePtr); 1451047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read a floating point value from the parcel at the current 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataPosition(). 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1457047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final float readFloat() { 1458047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeReadFloat(mNativePtr); 1459047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read a double precision floating point value from the parcel at the 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current dataPosition(). 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1465047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final double readDouble() { 1466047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeReadDouble(mNativePtr); 1467047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read a string value from the parcel at the current dataPosition(). 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1472047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final String readString() { 1473047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeReadString(mNativePtr); 1474047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 147708bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert * Read a CharSequence value from the parcel at the current dataPosition(). 147808bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert * @hide 147908bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert */ 148008bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert public final CharSequence readCharSequence() { 148108bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert return TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(this); 148208bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert } 148308bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert 148408bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert /** 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read an object from the parcel at the current dataPosition(). 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1487047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final IBinder readStrongBinder() { 1488047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeReadStrongBinder(mNativePtr); 1489047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read a FileDescriptor from the parcel at the current dataPosition(). 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final ParcelFileDescriptor readFileDescriptor() { 1495047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey FileDescriptor fd = nativeReadFileDescriptor(mNativePtr); 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return fd != null ? new ParcelFileDescriptor(fd) : null; 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ static native FileDescriptor openFileDescriptor(String file, 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mode) throws FileNotFoundException; 15019a84983a9fd9959671e102045eaf185b83291269Dianne Hackborn /*package*/ static native FileDescriptor dupFileDescriptor(FileDescriptor orig) 15029a84983a9fd9959671e102045eaf185b83291269Dianne Hackborn throws IOException; 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /*package*/ static native void closeFileDescriptor(FileDescriptor desc) 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws IOException; 1505c9119f5034d36f548bbddd8f60291e24ab4e270bDianne Hackborn /*package*/ static native void clearFileDescriptor(FileDescriptor desc); 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read a byte value from the parcel at the current dataPosition(). 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final byte readByte() { 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (byte)(readInt() & 0xff); 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Please use {@link #readBundle(ClassLoader)} instead (whose data must have 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been written with {@link #writeBundle}. Read into an existing Map object 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from the parcel at the current dataPosition(). 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readMap(Map outVal, ClassLoader loader) { 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project readMapInternal(outVal, N, loader); 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read into an existing List object from the parcel at the current 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataPosition(), using the given class loader to load any enclosed 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Parcelables. If it is null, the default class loader is used. 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readList(List outVal, ClassLoader loader) { 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project readListInternal(outVal, N, loader); 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Please use {@link #readBundle(ClassLoader)} instead (whose data must have 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been written with {@link #writeBundle}. Read and return a new HashMap 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * object from the parcel at the current dataPosition(), using the given 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * class loader to load any enclosed Parcelables. Returns null if 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the previously written map object was null. 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final HashMap readHashMap(ClassLoader loader) 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N < 0) { 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project HashMap m = new HashMap(N); 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project readMapInternal(m, N, loader); 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return m; 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new Bundle object from the parcel at the current 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataPosition(). Returns null if the previously written Bundle object was 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null. 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Bundle readBundle() { 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readBundle(null); 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new Bundle object from the parcel at the current 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataPosition(), using the given class loader to initialize the class 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * loader of the Bundle for later retrieval of Parcelable objects. 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns null if the previously written Bundle object was null. 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Bundle readBundle(ClassLoader loader) { 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = readInt(); 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (length < 0) { 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15726aff905048ba3b03724f17e2aba9089872e14cd2Dianne Hackborn 15736aff905048ba3b03724f17e2aba9089872e14cd2Dianne Hackborn final Bundle bundle = new Bundle(this, length); 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (loader != null) { 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bundle.setClassLoader(loader); 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bundle; 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a byte[] object from the parcel. 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1583047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey public final byte[] createByteArray() { 1584047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey return nativeCreateByteArray(mNativePtr); 1585047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read a byte[] object from the parcel and copy it into the 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * given byte array. 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readByteArray(byte[] val) { 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // TODO: make this a native method to avoid the extra copy. 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] ba = createByteArray(); 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (ba.length == val.length) { 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project System.arraycopy(ba, 0, val, 0, ba.length); 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("bad array lengths"); 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a String[] object from the parcel. 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final String[] readStringArray() { 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] array = null; 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = readInt(); 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (length >= 0) 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project array = new String[length]; 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0 ; i < length ; i++) 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project { 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project array[i] = readString(); 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return array; 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 162308bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert * Read and return a CharSequence[] object from the parcel. 162408bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert * {@hide} 162508bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert */ 162608bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert public final CharSequence[] readCharSequenceArray() { 162708bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert CharSequence[] array = null; 162808bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert 162908bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert int length = readInt(); 163008bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert if (length >= 0) 163108bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert { 163208bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert array = new CharSequence[length]; 163308bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert 163408bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert for (int i = 0 ; i < length ; i++) 163508bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert { 163608bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert array[i] = readCharSequence(); 163708bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert } 163808bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert } 163908bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert 164008bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert return array; 164108bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert } 164208bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert 164308bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert /** 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new ArrayList object from the parcel at the current 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataPosition(). Returns null if the previously written list object was 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null. The given class loader will be used to load any enclosed 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Parcelables. 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final ArrayList readArrayList(ClassLoader loader) { 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N < 0) { 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ArrayList l = new ArrayList(N); 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project readListInternal(l, N, loader); 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return l; 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new Object array from the parcel at the current 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataPosition(). Returns null if the previously written array was 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null. The given class loader will be used to load any enclosed 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Parcelables. 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Object[] readArray(ClassLoader loader) { 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N < 0) { 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Object[] l = new Object[N]; 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project readArrayInternal(l, N, loader); 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return l; 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new SparseArray object from the parcel at the current 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataPosition(). Returns null if the previously written list object was 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null. The given class loader will be used to load any enclosed 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Parcelables. 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final SparseArray readSparseArray(ClassLoader loader) { 16829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N < 0) { 16849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project SparseArray sa = new SparseArray(N); 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project readSparseArrayInternal(sa, N, loader); 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sa; 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new SparseBooleanArray object from the parcel at the current 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dataPosition(). Returns null if the previously written list object was 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null. 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final SparseBooleanArray readSparseBooleanArray() { 16979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 16989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N < 0) { 16999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project SparseBooleanArray sa = new SparseBooleanArray(N); 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project readSparseBooleanArrayInternal(sa, N); 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sa; 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new ArrayList containing a particular object type from 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the parcel that was written with {@link #writeTypedList} at the 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current dataPosition(). Returns null if the 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previously written list object was null. The list <em>must</em> have 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previously been written via {@link #writeTypedList} with the same object 17129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * type. 17139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A newly created ArrayList containing objects with the same data 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as those that were previously written. 17169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeTypedList 17189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T> ArrayList<T> createTypedArrayList(Parcelable.Creator<T> c) { 17209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 17219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N < 0) { 17229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 17239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ArrayList<T> l = new ArrayList<T>(N); 17259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (N > 0) { 17269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (readInt() != 0) { 17279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project l.add(c.createFromParcel(this)); 17289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 17299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project l.add(null); 17309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project N--; 17329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return l; 17349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read into the given List items containing a particular object type 17389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that were written with {@link #writeTypedList} at the 17399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current dataPosition(). The list <em>must</em> have 17409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previously been written via {@link #writeTypedList} with the same object 17419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * type. 17429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A newly created ArrayList containing objects with the same data 17449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as those that were previously written. 17459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeTypedList 17479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T> void readTypedList(List<T> list, Parcelable.Creator<T> c) { 17499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int M = list.size(); 17509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 17519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i = 0; 17529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; i < M && i < N; i++) { 17539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (readInt() != 0) { 17549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.set(i, c.createFromParcel(this)); 17559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 17569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.set(i, null); 17579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; i<N; i++) { 17609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (readInt() != 0) { 17619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.add(c.createFromParcel(this)); 17629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.add(null); 17649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; i<M; i++) { 17679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.remove(N); 17689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new ArrayList containing String objects from 17739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the parcel that was written with {@link #writeStringList} at the 17749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current dataPosition(). Returns null if the 17759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previously written list object was null. 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A newly created ArrayList containing strings with the same data 17789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as those that were previously written. 17799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeStringList 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final ArrayList<String> createStringArrayList() { 17839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 17849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N < 0) { 17859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 17869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ArrayList<String> l = new ArrayList<String>(N); 17889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (N > 0) { 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project l.add(readString()); 17909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project N--; 17919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return l; 17939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new ArrayList containing IBinder objects from 17979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the parcel that was written with {@link #writeBinderList} at the 17989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current dataPosition(). Returns null if the 17999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previously written list object was null. 18009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A newly created ArrayList containing strings with the same data 18029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as those that were previously written. 18039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeBinderList 18059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final ArrayList<IBinder> createBinderArrayList() { 18079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 18089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N < 0) { 18099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 18109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ArrayList<IBinder> l = new ArrayList<IBinder>(N); 18129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (N > 0) { 18139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project l.add(readStrongBinder()); 18149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project N--; 18159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return l; 18179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read into the given List items String objects that were written with 18219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeStringList} at the current dataPosition(). 18229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A newly created ArrayList containing strings with the same data 18249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as those that were previously written. 18259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeStringList 18279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readStringList(List<String> list) { 18299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int M = list.size(); 18309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 18319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i = 0; 18329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; i < M && i < N; i++) { 18339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.set(i, readString()); 18349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; i<N; i++) { 18369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.add(readString()); 18379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; i<M; i++) { 18399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.remove(N); 18409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read into the given List items IBinder objects that were written with 18459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #writeBinderList} at the current dataPosition(). 18469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A newly created ArrayList containing strings with the same data 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as those that were previously written. 18499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeBinderList 18519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void readBinderList(List<IBinder> list) { 18539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int M = list.size(); 18549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int i = 0; 18569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; i < M && i < N; i++) { 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.set(i, readStrongBinder()); 18589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; i<N; i++) { 18609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.add(readStrongBinder()); 18619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; i<M; i++) { 18639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project list.remove(N); 18649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new array containing a particular object type from 18699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the parcel at the current dataPosition(). Returns null if the 18709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previously written array was null. The array <em>must</em> have 18719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previously been written via {@link #writeTypedArray} with the same 18729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * object type. 18739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A newly created array containing objects with the same data 18759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as those that were previously written. 18769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeTypedArray 18789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T> T[] createTypedArray(Parcelable.Creator<T> c) { 18809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 18819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N < 0) { 18829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 18839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project T[] l = c.newArray(N); 18859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 18869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (readInt() != 0) { 18879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project l[i] = c.createFromParcel(this); 18889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return l; 18919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T> void readTypedArray(T[] val, Parcelable.Creator<T> c) { 18949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 18959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N == val.length) { 18969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 18979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (readInt() != 0) { 18989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = c.createFromParcel(this); 18999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 19009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project val[i] = null; 19019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 19049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("bad array lengths"); 19059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated 19109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 19119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Deprecated 19139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T> T[] readTypedArray(Parcelable.Creator<T> c) { 19149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createTypedArray(c); 19159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a heterogeneous array of Parcelable objects into the Parcel. 19199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Each object in the array is written along with its class name, so 19209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that the correct class can later be instantiated. As a result, this 19219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has significantly more overhead than {@link #writeTypedArray}, but will 19229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * correctly handle an array containing more than one type of object. 19239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param value The array of objects to be written. 19259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param parcelableFlags Contextual flags as per 19269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link Parcelable#writeToParcel(Parcel, int) Parcelable.writeToParcel()}. 19279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #writeTypedArray 19299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T extends Parcelable> void writeParcelableArray(T[] value, 19319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int parcelableFlags) { 19329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (value != null) { 19339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = value.length; 19349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(N); 19359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<N; i++) { 19369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeParcelable(value[i], parcelableFlags); 19379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 19399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project writeInt(-1); 19409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read a typed object from a parcel. The given class loader will be 19459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * used to load any enclosed Parcelables. If it is null, the default class 19469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * loader will be used. 19479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Object readValue(ClassLoader loader) { 19499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int type = readInt(); 19509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (type) { 19529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_NULL: 19539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 19549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_STRING: 19569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readString(); 19579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_INTEGER: 19599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readInt(); 19609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_MAP: 19629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readHashMap(loader); 19639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_PARCELABLE: 19659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readParcelable(loader); 19669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_SHORT: 19689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (short) readInt(); 19699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_LONG: 19719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readLong(); 19729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_FLOAT: 19749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readFloat(); 19759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_DOUBLE: 19779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readDouble(); 19789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_BOOLEAN: 19809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readInt() == 1; 19819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_CHARSEQUENCE: 198308bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert return readCharSequence(); 19849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_LIST: 19869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readArrayList(loader); 19879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_BOOLEANARRAY: 19899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBooleanArray(); 19909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_BYTEARRAY: 19929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createByteArray(); 19939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_STRINGARRAY: 19959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readStringArray(); 19969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199708bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert case VAL_CHARSEQUENCEARRAY: 199808bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert return readCharSequenceArray(); 199908bbffb049c135c5dfd40d261118c90d1a6dc111Bjorn Bringert 20009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_IBINDER: 20019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readStrongBinder(); 20029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_OBJECTARRAY: 20049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readArray(loader); 20059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_INTARRAY: 20079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createIntArray(); 20089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_LONGARRAY: 20109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createLongArray(); 20119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_BYTE: 20139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readByte(); 20149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_SERIALIZABLE: 20169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readSerializable(); 20179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_PARCELABLEARRAY: 20199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readParcelableArray(loader); 20209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_SPARSEARRAY: 20229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readSparseArray(loader); 20239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_SPARSEBOOLEANARRAY: 20259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readSparseBooleanArray(); 20269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case VAL_BUNDLE: 20289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return readBundle(loader); // loading will be deferred 20299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 20319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int off = dataPosition() - 4; 20329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException( 20339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "Parcel " + this + ": Unmarshalling unknown type code " + type + " at offset " + off); 20349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 20389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new Parcelable from the parcel. The given class loader 20399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be used to load any enclosed Parcelables. If it is null, the default 20409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * class loader will be used. 20419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param loader A ClassLoader from which to instantiate the Parcelable 20429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * object, or null for the default class loader. 20439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the newly created Parcelable, or null if a null 20449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * object has been written. 20459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws BadParcelableException Throws BadParcelableException if there 20469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * was an error trying to instantiate the Parcelable. 20479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 20489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T extends Parcelable> T readParcelable(ClassLoader loader) { 20499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String name = readString(); 20509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (name == null) { 20519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 20529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcelable.Creator<T> creator; 20549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mCreators) { 20559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project HashMap<String,Parcelable.Creator> map = mCreators.get(loader); 20569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (map == null) { 20579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project map = new HashMap<String,Parcelable.Creator>(); 20589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCreators.put(loader, map); 20599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project creator = map.get(name); 20619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (creator == null) { 20629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 20639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Class c = loader == null ? 20649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Class.forName(name) : Class.forName(name, true, loader); 20659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Field f = c.getField("CREATOR"); 20669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project creator = (Parcelable.Creator)f.get(null); 20679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project catch (IllegalAccessException e) { 20695b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick Log.e(TAG, "Class not found when unmarshalling: " 20709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + name + ", e: " + e); 20719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new BadParcelableException( 20729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "IllegalAccessException when unmarshalling: " + name); 20739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project catch (ClassNotFoundException e) { 20755b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick Log.e(TAG, "Class not found when unmarshalling: " 20769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + name + ", e: " + e); 20779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new BadParcelableException( 20789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "ClassNotFoundException when unmarshalling: " + name); 20799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project catch (ClassCastException e) { 20819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new BadParcelableException("Parcelable protocol requires a " 20829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + "Parcelable.Creator object called " 20839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " CREATOR on class " + name); 20849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project catch (NoSuchFieldException e) { 20869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new BadParcelableException("Parcelable protocol requires a " 20879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + "Parcelable.Creator object called " 20889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " CREATOR on class " + name); 20899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (creator == null) { 20919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new BadParcelableException("Parcelable protocol requires a " 20929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + "Parcelable.Creator object called " 20939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " CREATOR on class " + name); 20949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 20969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project map.put(name, creator); 20979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 20999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2100b46ed7636be9341b6ce0b158b3d86f34a437e6daDianne Hackborn if (creator instanceof Parcelable.ClassLoaderCreator<?>) { 2101b46ed7636be9341b6ce0b158b3d86f34a437e6daDianne Hackborn return ((Parcelable.ClassLoaderCreator<T>)creator).createFromParcel(this, loader); 2102b46ed7636be9341b6ce0b158b3d86f34a437e6daDianne Hackborn } 21039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return creator.createFromParcel(this); 21049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new Parcelable array from the parcel. 21089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The given class loader will be used to load any enclosed 21099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Parcelables. 21109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Parcelable array, or null if the array is null 21119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Parcelable[] readParcelableArray(ClassLoader loader) { 21139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int N = readInt(); 21149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (N < 0) { 21159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 21169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcelable[] p = new Parcelable[N]; 21189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < N; i++) { 21199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project p[i] = (Parcelable) readParcelable(loader); 21209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return p; 21229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 21259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Read and return a new Serializable object from the parcel. 21269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Serializable object, or null if the Serializable name 21279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * wasn't found in the parcel. 21289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Serializable readSerializable() { 21309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String name = readString(); 21319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (name == null) { 21329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // For some reason we were unable to read the name of the Serializable (either there 21339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // is nothing left in the Parcel to read, or the next value wasn't a String), so 21349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // return null, which indicates that the name wasn't found in the parcel. 21359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 21369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] serializedData = createByteArray(); 21399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ByteArrayInputStream bais = new ByteArrayInputStream(serializedData); 21409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 21419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ObjectInputStream ois = new ObjectInputStream(bais); 21429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (Serializable) ois.readObject(); 21439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IOException ioe) { 21449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Parcelable encountered " + 21459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "IOException reading a Serializable object (name = " + name + 21469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ")", ioe); 21479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (ClassNotFoundException cnfe) { 21489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Parcelable encountered" + 21499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "ClassNotFoundException reading a Serializable object (name = " 21509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + name + ")", cnfe); 21519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Cache of previously looked up CREATOR.createFromParcel() methods for 21559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // particular classes. Keys are the names of the classes, values are 21569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Method objects. 21579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final HashMap<ClassLoader,HashMap<String,Parcelable.Creator>> 21589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCreators = new HashMap<ClassLoader,HashMap<String,Parcelable.Creator>>(); 21599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static protected final Parcel obtain(int obj) { 21619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Parcel[] pool = sHolderPool; 21629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (pool) { 21639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel p; 21649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i=0; i<POOL_SIZE; i++) { 21659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project p = pool[i]; 21669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (p != null) { 21679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pool[i] = null; 21689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (DEBUG_RECYCLE) { 21699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project p.mStack = new RuntimeException(); 21709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project p.init(obj); 21729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return p; 21739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Parcel(obj); 21779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2179047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private Parcel(int nativePtr) { 21809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (DEBUG_RECYCLE) { 21819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mStack = new RuntimeException(); 21829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 21835b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick //Log.i(TAG, "Initializing obj=0x" + Integer.toHexString(obj), mStack); 2184047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey init(nativePtr); 2185047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 2186047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 2187047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private void init(int nativePtr) { 2188047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey if (nativePtr != 0) { 2189047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey mNativePtr = nativePtr; 2190047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey mOwnsNativeParcelObject = false; 2191047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } else { 2192047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey mNativePtr = nativeCreate(); 2193047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey mOwnsNativeParcelObject = true; 2194047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 2195047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 2196047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 2197047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private void freeBuffer() { 2198047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey if (mOwnsNativeParcelObject) { 2199047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeFreeBuffer(mNativePtr); 2200047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 2201047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 2202047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey 2203047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey private void destroy() { 2204047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey if (mNativePtr != 0) { 2205047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey if (mOwnsNativeParcelObject) { 2206047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey nativeDestroy(mNativePtr); 2207047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 2208047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey mNativePtr = 0; 2209047238ced42eea812de9d39a9f32e94d002bfa5cJeff Sharkey } 22109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 22139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 22149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (DEBUG_RECYCLE) { 22159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mStack != null) { 22165b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick Log.w(TAG, "Client did not call Parcel.recycle()", mStack); 22179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project destroy(); 22209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22226aff905048ba3b03724f17e2aba9089872e14cd2Dianne Hackborn /* package */ void readMapInternal(Map outVal, int N, 22239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ClassLoader loader) { 22249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (N > 0) { 22259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Object key = readValue(loader); 22269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Object value = readValue(loader); 22279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outVal.put(key, value); 22289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project N--; 22299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void readListInternal(List outVal, int N, 22339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ClassLoader loader) { 22349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (N > 0) { 22359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Object value = readValue(loader); 22365b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick //Log.d(TAG, "Unmarshalling value=" + value); 22379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outVal.add(value); 22389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project N--; 22399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void readArrayInternal(Object[] outVal, int N, 22439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ClassLoader loader) { 22449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < N; i++) { 22459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Object value = readValue(loader); 22465b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick //Log.d(TAG, "Unmarshalling value=" + value); 22479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outVal[i] = value; 22489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void readSparseArrayInternal(SparseArray outVal, int N, 22529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ClassLoader loader) { 22539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (N > 0) { 22549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int key = readInt(); 22559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Object value = readValue(loader); 22565b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick //Log.i(TAG, "Unmarshalling key=" + key + " value=" + value); 22579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outVal.append(key, value); 22589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project N--; 22599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void readSparseBooleanArrayInternal(SparseBooleanArray outVal, int N) { 22649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (N > 0) { 22659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int key = readInt(); 22669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean value = this.readByte() == 1; 22675b747191ff8ad43a54d41faf50436271d1d7fcc8Brad Fitzpatrick //Log.i(TAG, "Unmarshalling key=" + key + " value=" + value); 22689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outVal.append(key, value); 22699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project N--; 22709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2273