com.google.firebase.tasks.Task Maven / Gradle / Ivy
Show all versions of firebase-admin Show documentation
/*
* Copyright 2017 Google Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.firebase.tasks;
import com.google.firebase.internal.NonNull;
import com.google.firebase.internal.Nullable;
import java.util.concurrent.Executor;
/**
* Represents an asynchronous operation.
*
* @param the type of the result of the operation
* @deprecated {@code Task} has been deprecated in favor of
* {@code ApiFuture}.
* For every method x() that returns a {@code Task}, you should be able to find a
* corresponding xAsync() method that returns an {@code ApiFuture}.
*/
public abstract class Task {
/**
* Returns {@code true} if the Task is complete; {@code false} otherwise.
*/
public abstract boolean isComplete();
/**
* Returns {@code true} if the Task has completed successfully; {@code false} otherwise.
*/
public abstract boolean isSuccessful();
/**
* Gets the result of the Task, if it has already completed.
*
* @throws IllegalStateException if the Task is not yet complete
* @throws RuntimeExecutionException if the Task failed with an exception
*/
public abstract T getResult();
/**
* Gets the result of the Task, if it has already completed.
*
* @throws IllegalStateException if the Task is not yet complete
* @throws X if the Task failed with an exception of type X
* @throws RuntimeExecutionException if the Task failed with an exception that was not of type X
*/
public abstract T getResult(@NonNull Class exceptionType) throws X;
/**
* Returns the exception that caused the Task to fail. Returns {@code null} if the Task is not yet
* complete, or completed successfully.
*/
@Nullable
public abstract Exception getException();
/**
* Adds a listener that is called if the Task completes successfully.
*
* The listener will be called on a shared thread pool. If the Task has already completed
* successfully, a call to the listener will be immediately scheduled. If multiple listeners are
* added, they will be called in the order in which they were added.
*
* @return this Task
*
* @deprecated Use {@link #addOnSuccessListener(Executor, OnSuccessListener)}
*/
@NonNull
public abstract Task addOnSuccessListener(@NonNull OnSuccessListener listener);
/**
* Adds a listener that is called if the Task completes successfully.
*
* If multiple listeners are added, they will be called in the order in which they were added.
* If the Task has already completed successfully, a call to the listener will be immediately
* scheduled.
*
* @param executor the executor to use to call the listener
* @return this Task
*/
@NonNull
public abstract Task addOnSuccessListener(
@NonNull Executor executor, @NonNull OnSuccessListener listener);
/**
* Adds a listener that is called if the Task fails.
*
* The listener will be called on a shared thread pool. If the Task has already failed, a call
* to the listener will be immediately scheduled. If multiple listeners are added, they will be
* called in the order in which they were added.
*
* @return this Task
*
* @deprecated Use {@link #addOnFailureListener(Executor, OnFailureListener)}
*/
@NonNull
public abstract Task addOnFailureListener(@NonNull OnFailureListener listener);
/**
* Adds a listener that is called if the Task fails.
*
* If the Task has already failed, a call to the listener will be immediately scheduled. If
* multiple listeners are added, they will be called in the order in which they were added.
*
* @param executor the executor to use to call the listener
* @return this Task
*/
@NonNull
public abstract Task addOnFailureListener(
@NonNull Executor executor, @NonNull OnFailureListener listener);
/**
* Adds a listener that is called when the Task completes.
*
* The listener will be called on a shared thread pool. If the Task is already complete, a call
* to the listener will be immediately scheduled. If multiple listeners are added, they will be
* called in the order in which they were added.
*
* @return this Task
*
* @deprecated Use {@link #addOnCompleteListener(Executor, OnCompleteListener)}
*/
@NonNull
public Task addOnCompleteListener(@NonNull OnCompleteListener listener) {
throw new UnsupportedOperationException("addOnCompleteListener is not implemented");
}
/**
* Adds a listener that is called when the Task completes.
*
* If the Task is already complete, a call to the listener will be immediately scheduled. If
* multiple listeners are added, they will be called in the order in which they were added.
*
* @param executor the executor to use to call the listener
* @return this Task
*/
@NonNull
public Task addOnCompleteListener(
@NonNull Executor executor, @NonNull OnCompleteListener listener) {
throw new UnsupportedOperationException("addOnCompleteListener is not implemented");
}
/**
* Returns a new Task that will be completed with the result of applying the specified
* Continuation to this Task.
*
* If the Continuation throws an exception, the returned Task will fail with that exception.
*
*
The Continuation will be called on a shared thread pool.
*
* @deprecated Use {@link #continueWith(Executor, Continuation)}.
*/
@NonNull
public Task continueWith(@NonNull Continuation continuation) {
throw new UnsupportedOperationException("continueWith is not implemented");
}
/**
* Returns a new Task that will be completed with the result of applying the specified
* Continuation to this Task.
*
* If the Continuation throws an exception, the returned Task will fail with that exception.
*
* @param executor the executor to use to call the Continuation
* @see Continuation#then(Task)
*/
@NonNull
public Task continueWith(
@NonNull Executor executor, @NonNull Continuation continuation) {
throw new UnsupportedOperationException("continueWith is not implemented");
}
/**
* Returns a new Task that will be completed with the result of applying the specified
* Continuation to this Task.
*
* If the Continuation throws an exception, the returned Task will fail with that exception.
*
*
The Continuation will be called on a shared thread pool.
*
* @deprecated Use {@link #continueWithTask(Executor, Continuation)}
*/
@NonNull
public Task continueWithTask(@NonNull Continuation> continuation) {
throw new UnsupportedOperationException("continueWithTask is not implemented");
}
/**
* Returns a new Task that will be completed with the result of applying the specified
* Continuation to this Task.
*
* If the Continuation throws an exception, the returned Task will fail with that exception.
*
* @param executor the executor to use to call the Continuation
* @see Continuation#then(Task)
*/
@NonNull
public Task continueWithTask(
@NonNull Executor executor, @NonNull Continuation> continuation) {
throw new UnsupportedOperationException("continueWithTask is not implemented");
}
}