CompletableFuture Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
que Future se puede completar explícitamente (estableciendo su valor y estado), y se puede usar como , CompletionStageque admite funciones dependientes y acciones que se desencadenan tras su finalización.
[Android.Runtime.Register("java/util/concurrent/CompletableFuture", ApiSince=24, DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public class CompletableFuture : Java.Lang.Object, IDisposable, Java.Util.Concurrent.ICompletionStage, Java.Util.Concurrent.IFuture[<Android.Runtime.Register("java/util/concurrent/CompletableFuture", ApiSince=24, DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
type CompletableFuture = class
inherit Object
interface ICompletionStage
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IFuture- Herencia
- Atributos
- Implementaciones
Comentarios
que Future se puede completar explícitamente (estableciendo su valor y estado), y se puede usar como , CompletionStageque admite funciones dependientes y acciones que se desencadenan tras su finalización.
Cuando dos o más subprocesos intentan , #complete complete#completeExceptionally completeExceptionallyo #cancel cancel completableFuture, solo uno de ellos se realiza correctamente.
Además de estos métodos y relacionados para manipular directamente el estado y los resultados, CompletableFuture implementa la interfaz CompletionStage con las siguientes directivas: <ul>
<Las acciones li>proporcionadas para finalizaciones dependientes de <los métodos em>no asincrónicos</em> pueden realizarse mediante el subproceso que completa la completableFuture actual o cualquier otro autor de llamada de un método de finalización.
<li>Todos los<> métodos asincrónicos</em> sin un argumento Executor explícito se realizan mediante ForkJoinPool#commonPool() (a menos que no admita un nivel de paralelismo de al menos dos, en cuyo caso, se crea un nuevo subproceso para ejecutar cada tarea). Para simplificar la supervisión, depuración y seguimiento, todas las tareas asincrónicas generadas son instancias de la interfaz AsynchronousCompletionTaskde marcador . Las operaciones con retrasos de tiempo pueden usar métodos de adaptador definidos en esta clase, por ejemplo: supplyAsync(supplier, delayedExecutor(timeout, timeUnit)). Para admitir métodos con retrasos y tiempos de espera, esta clase mantiene como máximo un subproceso de demonio para desencadenar y cancelar acciones, no para ejecutarlos.
<li>Todos los métodos CompletionStage se implementan independientemente de otros métodos públicos, por lo que el comportamiento de un método no se ve afectado por invalidaciones de otras en subclases.
</ul>
CompletableFuture también se Future implementa con las siguientes directivas: <ul>
<li>Desde (a diferencia FutureTaskde ) esta clase no tiene control directo sobre el cálculo que hace que se complete, la cancelación se trata como una forma de finalización excepcional. El método #cancel cancel tiene el mismo efecto que completeExceptionally(new CancellationException()). El método #isCompletedExceptionally se puede usar para determinar si una CompletableFuture se completó de forma excepcional.
<li>En caso de finalización excepcional con una CompletionException, los métodos #get() e #get(long, TimeUnit) inician una ExecutionException con la misma causa que se mantiene en la excepción CompletionException correspondiente. Para simplificar el uso en la mayoría de los contextos, esta clase también define los métodos #join() y #getNow , en su lugar, inicia CompletionException directamente en estos casos.
</ul>
Los argumentos usados para pasar un resultado de finalización (es decir, para los parámetros de tipo T) para los métodos que los aceptan pueden ser NULL, pero pasar un valor NULL para cualquier otro parámetro dará como resultado que se produzca una NullPointerException excepción .
Agregado en la versión 1.8.
Java documentación para java.util.concurrent.CompletableFuture.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Constructores
| Nombre | Description |
|---|---|
| CompletableFuture() |
Crea una nueva completableFuture incompleta. |
| CompletableFuture(IntPtr, JniHandleOwnership) |
que |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| IsCancelled |
Devuelve |
| IsCompletedExceptionally |
Devuelve |
| IsDone |
Devuelve |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
que |
| JniPeerMembers |
que |
| NumberOfDependents |
Devuelve el número estimado de CompletableFutures cuyas finalizaciones están esperando la finalización de esta CompletableFuture. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| ThresholdClass |
que |
| ThresholdType |
que |
Métodos
| Nombre | Description |
|---|---|
| AcceptEither(ICompletionStage, IConsumer) |
que |
| AcceptEitherAsync(ICompletionStage, IConsumer, IExecutor) |
que |
| AcceptEitherAsync(ICompletionStage, IConsumer) |
que |
| AllOf(CompletableFuture[]) |
Devuelve un nuevo CompletableFuture que se completa cuando se completan todas las CompletasbleFutures especificadas. |
| AnyOf(CompletableFuture[]) |
Devuelve un nuevo Elemento CompletableFuture que se completa cuando se completa cualquiera de las CompletasbleFutures especificadas, con el mismo resultado. |
| ApplyToEither(ICompletionStage, IFunction) |
que |
| ApplyToEitherAsync(ICompletionStage, IFunction, IExecutor) |
que |
| ApplyToEitherAsync(ICompletionStage, IFunction) |
que |
| Cancel(Boolean) |
Si aún no se ha completado, completa este Elemento CompletableFuture con un |
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| Complete(Object) |
Si aún no se ha completado, establece el valor devuelto por |
| CompleteAsync(ISupplier, IExecutor) |
Completa este CompletableFuture con el resultado de la función proveedor especificada invocada desde una tarea asincrónica mediante el ejecutor especificado. |
| CompleteAsync(ISupplier) |
Completa esta clase CompletableFuture con el resultado de la función Proveedor especificada invocada desde una tarea asincrónica mediante el ejecutor predeterminado. |
| CompletedFuture(Object) |
Devuelve un nuevo Elemento CompletableFuture que ya se ha completado con el valor especificado. |
| CompletedStage(Object) |
Devuelve un nuevo completedStage que ya se ha completado con el valor especificado y solo admite esos métodos en la interfaz |
| CompleteExceptionally(Throwable) |
Si aún no se ha completado, hace que las invocaciones de |
| CompleteOnTimeout(Object, Int64, TimeUnit) |
Completa este Elemento CompletableFuture con el valor especificado si no se completa antes del tiempo de espera especificado. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
que |
| Copy() |
Devuelve un nuevo CompletableFuture que se completa normalmente con el mismo valor que este CompletableFuture cuando se completa normalmente. |
| DefaultExecutor() |
Devuelve el ejecutor predeterminado usado para los métodos asincrónicos que no especifican un Ejecutor. |
| DelayedExecutor(Int64, TimeUnit, IExecutor) |
Devuelve un nuevo Ejecutor que envía una tarea al ejecutor base especificado después del retraso especificado (o ningún retraso si no es positivo). |
| DelayedExecutor(Int64, TimeUnit) |
Devuelve un nuevo ejecutor que envía una tarea al ejecutor predeterminado después del retraso especificado (o ningún retraso si no es positivo). |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
que |
| Equals(Object) |
que |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| Exceptionally(IFunction) |
Devuelve un nuevo CompletableFuture que se completa cuando se completa esta CompletableFuture, con el resultado de la función dada de la excepción que desencadena la finalización de esta CompletableFuture cuando se completa excepcionalmente; De lo contrario, si completa esta CompletableFuture normalmente, la clase CompletableFuture devuelta también se completa normalmente con el mismo valor. |
| ExceptionallyAsync(IFunction, IExecutor) |
que |
| ExceptionallyAsync(IFunction) |
que |
| ExceptionallyCompose(IFunction) |
que |
| ExceptionallyComposeAsync(IFunction, IExecutor) |
que |
| ExceptionallyComposeAsync(IFunction) |
que |
| ExceptionNow() |
que |
| FailedFuture(Throwable) |
Devuelve un nuevo CompletableFuture que ya se ha completado excepcionalmente con la excepción dada. |
| FailedStage(Throwable) |
Devuelve un nuevo objeto CompletionStage que ya se ha completado excepcionalmente con la excepción dada y solo admite esos métodos en la interfaz |
| Get() |
Espera si es necesario para que se complete este futuro y, a continuación, devuelve su resultado. |
| Get(Int64, TimeUnit) |
Espera si es necesario para que se complete este futuro como máximo y, a continuación, devuelve su resultado, si está disponible. |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| GetNow(Object) |
Devuelve el valor de resultado (o produce cualquier excepción encontrada) si se ha completado; de lo contrario, devuelve el valor especificadoIfAbsent. |
| Handle(IBiFunction) |
que |
| HandleAsync(IBiFunction, IExecutor) |
que |
| HandleAsync(IBiFunction) |
que |
| JavaFinalize() |
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| Join() |
Devuelve el valor de resultado cuando se completa o produce una excepción (desactivada) si se completa de forma excepcional. |
| MinimalCompletionStage() |
Devuelve un nuevo CompletedStage que se completa normalmente con el mismo valor que este CompletableFuture cuando se completa normalmente, y no se puede completar de forma independiente o usarse de otra manera de maneras no definidas por los métodos de la interfaz |
| NewIncompleteFuture() |
Devuelve una nueva CompletableFuture incompleta del tipo que va a devolver un método CompletionStage. |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| ObtrudeException(Throwable) |
La fuerza hace que las invocaciones posteriores del método |
| ObtrudeValue(Object) |
Establece o restablece el valor devuelto posteriormente por método |
| OrTimeout(Int64, TimeUnit) |
Excepcionalmente completa esta CompletableFuture con un |
| ResultNow() |
que |
| RunAfterBoth(ICompletionStage, IRunnable) |
que |
| RunAfterBothAsync(ICompletionStage, IRunnable, IExecutor) |
que |
| RunAfterBothAsync(ICompletionStage, IRunnable) |
que |
| RunAfterEither(ICompletionStage, IRunnable) |
que |
| RunAfterEitherAsync(ICompletionStage, IRunnable, IExecutor) |
que |
| RunAfterEitherAsync(ICompletionStage, IRunnable) |
que |
| RunAsync(IRunnable, IExecutor) |
Devuelve un nuevo Elemento CompletableFuture completado de forma asincrónica por una tarea que se ejecuta en el ejecutor especificado después de ejecutar la acción especificada. |
| RunAsync(IRunnable) |
Devuelve un nuevo Elemento CompletableFuture completado de forma asincrónica por una tarea que se ejecuta en |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
que |
| State() |
que |
| SupplyAsync(ISupplier, IExecutor) |
Devuelve un nuevo Elemento CompletableFuture completado de forma asincrónica por una tarea que se ejecuta en el ejecutor especificado con el valor obtenido llamando al proveedor especificado. |
| SupplyAsync(ISupplier) |
Devuelve un nuevo Elemento CompletableFuture completado de forma asincrónica por una tarea que se ejecuta en con |
| ThenAccept(IConsumer) |
que |
| ThenAcceptAsync(IConsumer, IExecutor) |
que |
| ThenAcceptAsync(IConsumer) |
que |
| ThenAcceptBoth(ICompletionStage, IBiConsumer) |
que |
| ThenAcceptBothAsync(ICompletionStage, IBiConsumer, IExecutor) |
que |
| ThenAcceptBothAsync(ICompletionStage, IBiConsumer) |
que |
| ThenApply(IFunction) |
que |
| ThenApplyAsync(IFunction, IExecutor) |
que |
| ThenApplyAsync(IFunction) |
que |
| ThenCombine(ICompletionStage, IBiFunction) |
que |
| ThenCombineAsync(ICompletionStage, IBiFunction, IExecutor) |
que |
| ThenCombineAsync(ICompletionStage, IBiFunction) |
que |
| ThenCompose(IFunction) |
que |
| ThenComposeAsync(IFunction, IExecutor) |
que |
| ThenComposeAsync(IFunction) |
que |
| ThenRun(IRunnable) |
que |
| ThenRunAsync(IRunnable, IExecutor) |
que |
| ThenRunAsync(IRunnable) |
que |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToCompletableFuture() |
Devuelve este CompletableFuture. |
| ToString() |
Devuelve una representación de cadena del objeto . (Heredado de Object) |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| Wait() |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| WhenComplete(IBiConsumer) |
que |
| WhenCompleteAsync(IBiConsumer, IExecutor) |
que |
| WhenCompleteAsync(IBiConsumer) |
que |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
que |
| IJavaPeerable.Finalized() |
que |
| IJavaPeerable.JniObjectReferenceControlBlock |
que |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
que |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
que |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
que |
| IJavaPeerable.UnregisterFromRuntime() |
que |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetAsync(IFuture, Int64, TimeUnit) |
que |
| GetAsync(IFuture) |
que |
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
que |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |