Merge "Update JavaDoc to replace deprecated Parcel read APIs." am: 06ee57cda1

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1977155

Change-Id: I98148f4c4640ff531c43a6b63565a6361e312c80
This commit is contained in:
Hao Ke
2022-02-25 18:25:54 +00:00
committed by Automerger Merge Worker

View File

@@ -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 {