Stay organized with collections
Save and categorize content based on your preferences.
public abstract class TransformedResult
<R extends Result
>
Represents a pending result that has been transformed by one or more subsequent API calls.
The result can either be consumed by callbacks set using andFinally
or used as input to another API call using then
. It is an error to call both of these methods, or one of them multiple times, on a single instance.
Summary
Public methods
public abstract @ NonNull
TransformedResult
<S> <S extends Result
> then
(@ NonNull
ResultTransform
< Object
, S> transform)
Transforms the result by making another API call.
If the result is successful, then onSuccess
will be called to make the additional API call that yields the transformed result. If the result is a failure, then onFailure
will be called to (optionally) allow modification of failure status.
If the result implements Releasable
, then release
will be called once the transform has been applied.
{@see PendingResult#then} for more details and sample code.
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\u003eTransformedResult\u003c/code\u003e represents a pending result that is modified by one or more subsequent API calls.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use \u003ccode\u003eandFinally\u003c/code\u003e to set callbacks for when the result is ready or \u003ccode\u003ethen\u003c/code\u003e to use it as input for another API call.\u003c/p\u003e\n"],["\u003cp\u003eIt is crucial to avoid calling \u003ccode\u003eandFinally\u003c/code\u003e and \u003ccode\u003ethen\u003c/code\u003e on the same \u003ccode\u003eTransformedResult\u003c/code\u003e instance more than once, or calling both methods together, as it will lead to an error.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ethen\u003c/code\u003e method allows chaining API calls by transforming the result through an additional API call based on success or failure status.\u003c/p\u003e\n"]]],[],null,["# TransformedResult\n=================\n\n[Kotlin](/android/reference/kotlin/com/google/android/gms/common/api/TransformedResult \"View this page in Kotlin\") \\|Java \n\n\n```\npublic abstract class TransformedResult\u003cR extends Result\u003e\n```\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nRepresents a pending result that has been transformed by one or more subsequent API calls.\n\nThe result can either be consumed by callbacks set using [andFinally](/android/reference/com/google/android/gms/common/api/TransformedResult#andFinally(com.google.android.gms.common.api.ResultCallbacks\u003c? super R\u003e)) or used as input to another API call using [then](/android/reference/com/google/android/gms/common/api/TransformedResult#then(com.google.android.gms.common.api.ResultTransform\u003c? super R,? extends S\u003e)). It is an error to call both of these methods, or one of them multiple times, on a single instance. \n\n| See also |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| [then](/android/reference/com/google/android/gms/common/api/PendingResult#then(com.google.android.gms.common.api.ResultTransform\u003c? super R,? extends S\u003e)) | |\n\nSummary\n-------\n\n| ### Public constructors |\n|---------------------------------------------------------------------------------------------------------------------|\n| [TransformedResult](/android/reference/com/google/android/gms/common/api/TransformedResult#TransformedResult())`()` |\n\n| ### Public methods |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `abstract void` | [andFinally](/android/reference/com/google/android/gms/common/api/TransformedResult#andFinally(com.google.android.gms.common.api.ResultCallbacks\u003c? super R\u003e))`(@`[NonNull](https://developer.android.com/reference/androidx/annotation/NonNull.html)` `[ResultCallbacks](/android/reference/com/google/android/gms/common/api/ResultCallbacks)`\u003c`[Object](https://developer.android.com/reference/java/lang/Object.html)`\u003e callbacks)` Requests that the supplied callbacks are called when the result is ready. |\n| `abstract @`[NonNull](https://developer.android.com/reference/androidx/annotation/NonNull.html)` `[TransformedResult](/android/reference/com/google/android/gms/common/api/TransformedResult)`\u003cS\u003e` | `\u003cS extends `[Result](/android/reference/com/google/android/gms/common/api/Result)`\u003e `[then](/android/reference/com/google/android/gms/common/api/TransformedResult#then(com.google.android.gms.common.api.ResultTransform\u003c? super R,? extends S\u003e))`(@`[NonNull](https://developer.android.com/reference/androidx/annotation/NonNull.html)` `[ResultTransform](/android/reference/com/google/android/gms/common/api/ResultTransform)`\u003c`[Object](https://developer.android.com/reference/java/lang/Object.html)`, S\u003e transform)` Transforms the result by making another API call. |\n\nPublic constructors\n-------------------\n\n### TransformedResult\n\n```\npublic TransformedResult()\n``` \n\nPublic methods\n--------------\n\n### andFinally\n\n```\npublic abstract void andFinally(@NonNull ResultCallbacks\u003cObject\u003e callbacks)\n```\n\nRequests that the supplied callbacks are called when the result is ready. \n\n### then\n\n```\npublic abstract @NonNull TransformedResult\u003cS\u003e \u003cS extends Result\u003e then(@NonNull ResultTransform\u003cObject, S\u003e transform)\n```\n\nTransforms the result by making another API call.\n\nIf the result is successful, then [onSuccess](/android/reference/com/google/android/gms/common/api/ResultTransform#onSuccess(R)) will be called to make the additional API call that yields the transformed result. If the result is a failure, then [onFailure](/android/reference/com/google/android/gms/common/api/ResultTransform#onFailure(com.google.android.gms.common.api.Status)) will be called to (optionally) allow modification of failure status.\n\nIf the result implements [Releasable](/android/reference/com/google/android/gms/common/api/Releasable), then [release](/android/reference/com/google/android/gms/common/api/Releasable#release()) will be called once the transform has been applied.\n\n{@see PendingResult#then} for more details and sample code."]]
