Parcel: document enforceInterface (d0c8e40b) · Commits · e / os / android_frameworks_base

core/java/android/os/Parcel.java

+9 −2

Original line number	Original line	Diff line number	Diff line
	@@ -681,12 +681,19 @@ public final class Parcel {
	/**		/**
	* Store or read an IBinder interface token in the parcel at the current		* Store or read an IBinder interface token in the parcel at the current
	* {@link #dataPosition}. This is used to validate that the marshalled		* {@link #dataPosition}. This is used to validate that the marshalled
	* transaction is intended for the target interface.		* transaction is intended for the target interface. This is typically written
			* at the beginning of transactions as a header.
	*/		*/
	public final void writeInterfaceToken(@NonNull String interfaceName) {		public final void writeInterfaceToken(@NonNull String interfaceName) {
	nativeWriteInterfaceToken(mNativePtr, interfaceName);		nativeWriteInterfaceToken(mNativePtr, interfaceName);
	}		}

			/**
			* Read the header written by writeInterfaceToken and verify it matches
			* the interface name in question. If the wrong interface type is present,
			* {@link SecurityException} is thrown. When used over binder, this exception
			* should propagate to the caller.
			*/
	public final void enforceInterface(@NonNull String interfaceName) {		public final void enforceInterface(@NonNull String interfaceName) {
	nativeEnforceInterface(mNativePtr, interfaceName);		nativeEnforceInterface(mNativePtr, interfaceName);
	}		}