Merge "Added End-of-Parcel check API." am: 93b3eb84ec am: 479f10d9b7

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

Change-Id: I0ed21fae1ba8382b9e6a9c0c4569872ddc4ba488

core/api/current.txt

@@ -31471,6 +31471,7 @@ package android.os {
     method public int dataPosition();
     method public int dataSize();
     method public void enforceInterface(@NonNull String);
+    method public void enforceNoDataAvail();
     method public boolean hasFileDescriptors();
     method public boolean hasFileDescriptors(int, int);
     method public byte[] marshall();

core/java/android/os/Parcel.java

@@ -845,6 +845,19 @@ public final class Parcel {
         nativeEnforceInterface(mNativePtr, interfaceName);
     }
 
+    /**
+     * Verify there are no bytes left to be read on the Parcel.
+     *
+     * @throws BadParcelableException If the current position hasn't reached the end of the Parcel.
+     * When used over binder, this exception should propagate to the caller.
+     */
+    public void enforceNoDataAvail() {
+        final int n = dataAvail();
+        if (n > 0) {
+            throw new BadParcelableException("Parcel data not fully consumed, unread size: " + n);
+        }
+    }
+
     /**
      * Writes the work source uid to the request headers.
      *