Stay organized with collections
Save and categorize content based on your preferences.
public abstract class ResultCallbacks
<R extends Result
> implements ResultCallback
Callbacks for receiving a Result
from a as an asynchronous callback. Contains separate callbacks for success and failure.
These methods are called on the main thread, unless overridden by setHandler
.
Summary
Public methods
public abstract void onSuccess
(@ NonNull
R result)
Called when the Result
is ready and was successful.
It is the responsibility of the callback to release any resources associated with the result if onSuccess
is called. Some result types may implement Releasable
, in which case release
should be used to free the associated resources. If a failure occurs the result will be released automatically.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-31 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 2024-10-31 UTC."],[[["\u003cp\u003e\u003ccode\u003eResultCallbacks\u003c/code\u003e provides a way to handle asynchronous results from API calls, with separate callbacks for success (\u003ccode\u003eonSuccess\u003c/code\u003e) and failure (\u003ccode\u003eonFailure\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThese callbacks are executed on the main thread by default but can be overridden using a custom handler.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eonFailure\u003c/code\u003e is called with a non-null, unsuccessful \u003ccode\u003eStatus\u003c/code\u003e object when the API call fails.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eonSuccess\u003c/code\u003e is called with a non-null \u003ccode\u003eResult\u003c/code\u003e object when the API call is successful, and the callback is responsible for releasing any associated resources.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eResolvingResultCallbacks\u003c/code\u003e is a subclass that automatically handles resolutions for failures.\u003c/p\u003e\n"]]],[],null,["# ResultCallbacks\n===============\n\n[Kotlin](/android/reference/kotlin/com/google/android/gms/common/api/ResultCallbacks \"View this page in Kotlin\") \\|Java \n\n\n```\npublic abstract class ResultCallbacks\u003cR extends Result\u003e implements ResultCallback\n```\n\n\u003cbr /\u003e\n\nKnown direct subclasses \n[ResolvingResultCallbacks](/android/reference/com/google/android/gms/common/api/ResolvingResultCallbacks) \n\n|-----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|\n| [ResolvingResultCallbacks](/android/reference/com/google/android/gms/common/api/ResolvingResultCallbacks) | [ResultCallbacks](/android/reference/com/google/android/gms/common/api/ResultCallbacks) which automatically start resolutions for failures. |\n\n*** ** * ** ***\n\nCallbacks for receiving a [Result](/android/reference/com/google/android/gms/common/api/Result) from a as an asynchronous callback. Contains separate callbacks for success and failure.\n\nThese methods are called on the main thread, unless overridden by [setHandler](/android/reference/com/google/android/gms/common/api/GoogleApiClient.Builder#setHandler(android.os.Handler)).\n\nSummary\n-------\n\n| ### Public constructors |\n|---------------------------------------------------------------------------------------------------------------|\n| [ResultCallbacks](/android/reference/com/google/android/gms/common/api/ResultCallbacks#ResultCallbacks())`()` |\n\n| ### Public methods |\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `abstract void` | [onFailure](/android/reference/com/google/android/gms/common/api/ResultCallbacks#onFailure(com.google.android.gms.common.api.Status))`(@`[NonNull](https://developer.android.com/reference/androidx/annotation/NonNull.html)` `[Status](/android/reference/com/google/android/gms/common/api/Status)` result)` Called when the [Result](/android/reference/com/google/android/gms/common/api/Result) is ready and a failure occurred. |\n| `abstract void` | [onSuccess](/android/reference/com/google/android/gms/common/api/ResultCallbacks#onSuccess(R))`(@`[NonNull](https://developer.android.com/reference/androidx/annotation/NonNull.html)` R result)` Called when the [Result](/android/reference/com/google/android/gms/common/api/Result) is ready and was successful. |\n\nPublic constructors\n-------------------\n\n### ResultCallbacks\n\n```\npublic ResultCallbacks()\n``` \n\nPublic methods\n--------------\n\n### onFailure\n\n```\npublic abstract void onFailure(@NonNull Status result)\n```\n\nCalled when the [Result](/android/reference/com/google/android/gms/common/api/Result) is ready and a failure occurred. \n\n| Parameters |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------|\n| `@`[NonNull](https://developer.android.com/reference/androidx/annotation/NonNull.html)` `[Status](/android/reference/com/google/android/gms/common/api/Status)` result` | Status resulting from the API call. Guaranteed to be non-null and unsuccessful. |\n\n### onSuccess\n\n```\npublic abstract void onSuccess(@NonNull R result)\n```\n\nCalled when the [Result](/android/reference/com/google/android/gms/common/api/Result) is ready and was successful.\n\nIt is the responsibility of the callback to release any resources associated with the result if [onSuccess](/android/reference/com/google/android/gms/common/api/ResultCallbacks#onSuccess(R)) is called. Some result types may implement [Releasable](/android/reference/com/google/android/gms/common/api/Releasable), in which case [release](/android/reference/com/google/android/gms/common/api/Releasable#release()) should be used to free the associated resources. If a failure occurs the result will be released automatically. \n\n| Parameters |\n|---------------------------------------------------------------------------------------------------|-------------------------------------------|\n| `@`[NonNull](https://developer.android.com/reference/androidx/annotation/NonNull.html)` R result` | The result from the API call. Never null. |"]]
