Merge "TransactionTooLargeException: doc clarification" am: e51328b36c

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

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: Idbcceec59b82cb8e6cba1af67d7b81297e1451b2
This commit is contained in:
Steven Moreland
2021-01-05 18:48:52 +00:00
committed by Automerger Merge Worker

View File

@@ -23,9 +23,11 @@ import android.os.RemoteException;
* During a remote procedure call, the arguments and the return value of the call
* are transferred as {@link Parcel} objects stored in the Binder transaction buffer.
* If the arguments or the return value are too large to fit in the transaction buffer,
* then the call will fail and {@link TransactionTooLargeException} will be thrown.
* then the call will fail. {@link TransactionTooLargeException} is thrown as a
* heuristic when a transaction is large, and it fails, since these are the transactions
* which are most likely to overfill the transaction buffer.
* </p><p>
* The Binder transaction buffer has a limited fixed size, currently 1Mb, which
* The Binder transaction buffer has a limited fixed size, currently 1MB, which
* is shared by all transactions in progress for the process. Consequently this
* exception can be thrown when there are many transactions in progress even when
* most of the individual transactions are of moderate size.