Stay organized with collections
Save and categorize content based on your preferences.
@UnstableApi
@RequiresApi(value = 23)
public final class BinderStressCreator implements AutoCloseable
A utility for creating artificial stress on the system process binder.
While the class is active, any attempt to call a binder method to the system process will be much slower.
This class should be used in a try-with-resources block.
Use verifyNoSystemBinderCalls to verify no system binder calls happen in a test.
Summary
Public methods |
void |
|
static void |
Verifies that the provided system-under-test does not exercise any system binder calls by comparing the run time with and without additional stress caused by BinderStressCreator.
|
Public methods
public static void <T> verifyNoSystemBinderCalls(
Supplier<T> systemUnderTest,
Consumer<T> cleanUp
)
Verifies that the provided system-under-test does not exercise any system binder calls by comparing the run time with and without additional stress caused by BinderStressCreator.
| Parameters |
Supplier<T> systemUnderTest |
The system-under-test that can return a test object for later clean-up.
|
Consumer<T> cleanUp |
The clean-up stage for the system-under-test.
|
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# BinderStressCreator\n===================\n\nArtifact: [androidx.media3:media3-test-utils](/jetpack/androidx/releases/media3) \n[View Source](https://cs.android.com/search?q=file:androidx/media3/test/utils/BinderStressCreator.java+class:androidx.media3.test.utils.BinderStressCreator)\n\n*** ** * ** ***\n\n[Kotlin](/reference/kotlin/androidx/media3/test/utils/BinderStressCreator \"View this page in Kotlin\") \\|Java\n\n\n```\n@UnstableApi\n@RequiresApi(value = 23)\npublic final class BinderStressCreator implements AutoCloseable\n```\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nA utility for creating artificial stress on the system process binder.\n\nWhile the class is active, any attempt to call a binder method to the system process will be much slower.\n\nThis class should be used in a try-with-resources block.\n\nUse [verifyNoSystemBinderCalls](/reference/androidx/media3/test/utils/BinderStressCreator#verifyNoSystemBinderCalls(com.google.common.base.Supplier\u003cT\u003e,androidx.media3.common.util.Consumer\u003cT\u003e)) to verify no system binder calls happen in a test.\n\nSummary\n-------\n\n| ### Public constructors |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [BinderStressCreator](/reference/androidx/media3/test/utils/BinderStressCreator#BinderStressCreator(android.content.Context))`(`[Context](https://developer.android.com/reference/android/content/Context.html)` context)` |\n\n| ### Public methods |\n|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `void` | [close](/reference/androidx/media3/test/utils/BinderStressCreator#close())`()` |\n| `static void` | `\u003cT\u003e `[verifyNoSystemBinderCalls](/reference/androidx/media3/test/utils/BinderStressCreator#verifyNoSystemBinderCalls(com.google.common.base.Supplier\u003cT\u003e,androidx.media3.common.util.Consumer\u003cT\u003e))`(` ` `[Supplier](https://guava.dev/releases/18.0/api/docs/com/google/common/base/Supplier.html)`\u003cT\u003e systemUnderTest,` ` `[Consumer](/reference/androidx/media3/common/util/Consumer)`\u003cT\u003e cleanUp` `)` Verifies that the provided system-under-test does not exercise any system binder calls by comparing the run time with and without additional stress caused by . |\n\nPublic constructors\n-------------------\n\n### BinderStressCreator\n\n```\npublic BinderStressCreator(Context context)\n``` \n\nPublic methods\n--------------\n\n### close\n\n```\npublic void close()\n``` \n\n| Throws |\n|-----------------------------------------------------------------------------------------|---|\n| [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception.html) | |\n\n### verifyNoSystemBinderCalls\n\n```\npublic static void \u003cT\u003e verifyNoSystemBinderCalls(\n Supplier\u003cT\u003e systemUnderTest,\n Consumer\u003cT\u003e cleanUp\n)\n```\n\nVerifies that the provided system-under-test does not exercise any system binder calls by comparing the run time with and without additional stress caused by . \n\n| Parameters |\n|----------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------|\n| [Supplier](https://guava.dev/releases/18.0/api/docs/com/google/common/base/Supplier.html)`\u003cT\u003e systemUnderTest` | The system-under-test that can return a test object for later clean-up. |\n| [Consumer](/reference/androidx/media3/common/util/Consumer)`\u003cT\u003e cleanUp` | The clean-up stage for the system-under-test. |\n\n| Throws |\n|-----------------------------------------------------------------------------------------|---|\n| [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception.html) | |"]]
