summaryrefslogtreecommitdiff
path: root/core/java/android/os/Parcel.java
diff options
context:
space:
mode:
authorHao Ke <haok@google.com>2022-02-28 21:03:49 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>2022-02-28 21:03:49 +0000
commitdbb831447cbf43ae9c94824f6140dc31b1feaed2 (patch)
tree8494b6a52d7398db43294f331af50378cfd8cae1 /core/java/android/os/Parcel.java
parentd8764bf5335b684b498c8cfd686761f7afaaf3da (diff)
parentd38ca191d57e72414eb238cb713293c1d7e72fee (diff)
Merge "Update JavaDoc to replace deprecated Parcel read APIs." am: 06ee57cda1 am: d1fdbdff31 am: d38ca191d5
Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1977155 Change-Id: I7572a1f8842f45ec3b748b8dda3bba0d19626077
Diffstat (limited to 'core/java/android/os/Parcel.java')
-rw-r--r--core/java/android/os/Parcel.java15
1 files changed, 14 insertions, 1 deletions
diff --git a/core/java/android/os/Parcel.java b/core/java/android/os/Parcel.java
index 09cfb6e70cba..f9bf025b2c74 100644
--- a/core/java/android/os/Parcel.java
+++ b/core/java/android/os/Parcel.java
@@ -201,7 +201,7 @@ import java.util.function.Supplier;
* The methods to use are {@link #writeFileDescriptor(FileDescriptor)},
* {@link #readFileDescriptor()}.
*
- * <h3>Untyped Containers</h3>
+ * <h3>Parcelable Containers</h3>
*
* <p>A final class of methods are for writing and reading standard Java
* containers of arbitrary types. These all revolve around the
@@ -213,6 +213,19 @@ import java.util.function.Supplier;
* {@link #writeMap(Map)}, {@link #readMap(Map, ClassLoader)},
* {@link #writeSparseArray(SparseArray)},
* {@link #readSparseArray(ClassLoader)}.
+ *
+ * <h3>Restricted Parcelable Containers</h3>
+ *
+ * <p>A final class of methods are for reading standard Java containers of restricted types.
+ * These methods replace methods for reading containers of arbitrary types from previous section
+ * starting from Android {@link Build.VERSION_CODES#TIRAMISU}. The pairing writing methods are
+ * still the same from previous section.
+ * These methods accepts additional {@code clazz} parameters as the required types.
+ * The Restricted Parcelable container methods are {@link #readArray(ClassLoader, Class)},
+ * {@link #readList(List, ClassLoader, Class)},
+ * {@link #readArrayList(ClassLoader, Class)},
+ * {@link #readMap(Map, ClassLoader, Class, Class)},
+ * {@link #readSparseArray(ClassLoader, Class)}.
*/
public final class Parcel {