summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
author Steven Moreland <smoreland@google.com> 2021-01-05 19:33:20 +0000
committer Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com> 2021-01-05 19:33:20 +0000
commit9209ce0c1930184f2350adc776e7a537beb0cd6c (patch)
tree68cf5df6da75b24f937364dc765f4ca4f47e1878
parent59fb3f9d21974adb9d04c3c09b7678d0d99c7f99 (diff)
parentdb1696ee2103a9288281e8d2750e5b5fedec23e3 (diff)
Merge "TransactionTooLargeException: doc clarification" am: e51328b36c am: db1696ee21
Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1537983 MUST ONLY BE SUBMITTED BY AUTOMERGER Change-Id: I5128044c589118624c216cd640bc19e68c19a17c
-rw-r--r--core/java/android/os/TransactionTooLargeException.java6
1 files changed, 4 insertions, 2 deletions
diff --git a/core/java/android/os/TransactionTooLargeException.java b/core/java/android/os/TransactionTooLargeException.java
index 10abf26420f1..4d5b2a10f3fe 100644
--- a/core/java/android/os/TransactionTooLargeException.java
+++ b/core/java/android/os/TransactionTooLargeException.java
@@ -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.