CompletableFuture Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Eine Future , die explizit abgeschlossen werden kann (Festlegen des Werts und Status) und kann als CompletionStageeine, unterstützende abhängige Funktionen und Aktionen verwendet werden, die nach Abschluss des Vorgangs ausgelöst werden.
[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- Vererbung
- Attribute
- Implementiert
Hinweise
Eine Future , die explizit abgeschlossen werden kann (Festlegen des Werts und Status) und kann als CompletionStageeine, unterstützende abhängige Funktionen und Aktionen verwendet werden, die nach Abschluss des Vorgangs ausgelöst werden.
Wenn zwei oder mehr Threads versuchen, #complete completeoder ein CompletableFuture- oder #completeExceptionally completeExceptionally CompletableFuture-Vorgang #cancel cancelauszuführen, ist nur einer davon erfolgreich.
Zusätzlich zu diesen und verwandten Methoden zum direkten Bearbeiten von Status und Ergebnissen implementiert CompletableFuture die Schnittstelle CompletionStage mit den folgenden Richtlinien: <ul>
<li-Aktionen>, die für abhängige Vervollständigungen von <em-nicht-async></em-Methoden> bereitgestellt werden, können vom Thread ausgeführt werden, der den aktuellen CompletableFuture oder von einem anderen Aufrufer einer Abschlussmethode abschließt.
<li>All <em>async</em> methods without an explicit Executor argument are perform using the ForkJoinPool#commonPool() (unless it does not support a parallelism level of at least two, in which case, a new Thread is created to run each task). Um die Überwachung, das Debuggen und die Nachverfolgung zu vereinfachen, sind alle generierten asynchronen Aufgaben Instanzen der Markierungsschnittstelle AsynchronousCompletionTask. Vorgänge mit Zeitverzögerungen können Adaptermethoden verwenden, die in dieser Klasse definiert sind, z. B.: supplyAsync(supplier, delayedExecutor(timeout, timeUnit)). Um Methoden mit Verzögerungen und Timeouts zu unterstützen, verwaltet diese Klasse höchstens einen Daemon-Thread zum Auslösen und Abbrechen von Aktionen, nicht für die Ausführung.
<li>Alle CompletionStage-Methoden werden unabhängig von anderen öffentlichen Methoden implementiert, sodass das Verhalten einer Methode nicht durch Außerkraftsetzungen anderer in Unterklassen beeinflusst wird.
</ul>
CompletableFuture implementiert Future auch mit den folgenden Richtlinien: <ul>
<li>Da (im Gegensatz FutureTask) diese Klasse keine direkte Kontrolle über die Berechnung hat, die dazu führt, dass sie abgeschlossen wird, wird der Abbruch als nur eine andere Form von außergewöhnlichem Abschluss behandelt. Die Methode #cancel cancel hat die gleiche Wirkung wie completeExceptionally(new CancellationException()). Die Methode #isCompletedExceptionally kann verwendet werden, um zu bestimmen, ob ein CompletableFuture auf außergewöhnliche Weise abgeschlossen wurde.
<li>Im Falle eines außergewöhnlichen Abschlusses mit einer CompletionException, Methoden #get() und #get(long, TimeUnit) Auslösen einer ExecutionException mit der gleichen Ursache wie in der entsprechenden CompletionException. Um die Verwendung in den meisten Kontexten zu vereinfachen, definiert diese Klasse auch Methoden #join() und #getNow löst stattdessen die CompletionException direkt in diesen Fällen aus.
</ul>
Argumente, die verwendet werden, um ein Abschlussergebnis (d. h. für Parameter vom Typ T) für Methoden zu übergeben, die sie akzeptieren, können null sein, aber das Übergeben eines NULL-Werts für einen anderen Parameter führt zu einem NullPointerException Auslösen.
Hinzugefügt in 1.8.
Java Dokumentation für java.util.concurrent.CompletableFuture.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| CompletableFuture() |
Erstellt eine neue unvollständige CompletableFuture. |
| CompletableFuture(IntPtr, JniHandleOwnership) |
Eine |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| IsCancelled |
Gibt zurück |
| IsCompletedExceptionally |
Gibt zurück |
| IsDone |
Gibt zurück |
| JniIdentityHashCode |
Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object) |
| JniManagedPeerState |
Eine |
| JniPeerMembers |
Eine |
| NumberOfDependents |
Gibt die geschätzte Anzahl von CompletableFutures zurück, deren Fertigstellungen auf den Abschluss dieses CompletableFuture warten. |
| PeerReference |
Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object) |
| ThresholdClass |
Eine |
| ThresholdType |
Eine |
Methoden
| Name | Beschreibung |
|---|---|
| AcceptEither(ICompletionStage, IConsumer) |
Eine |
| AcceptEitherAsync(ICompletionStage, IConsumer, IExecutor) |
Eine |
| AcceptEitherAsync(ICompletionStage, IConsumer) |
Eine |
| AllOf(CompletableFuture[]) |
Gibt eine neue CompletableFuture zurück, die abgeschlossen ist, wenn alle der angegebenen CompletableFutures abgeschlossen sind. |
| AnyOf(CompletableFuture[]) |
Gibt eine neue CompletableFuture zurück, die abgeschlossen wird, wenn eines der angegebenen CompletableFutures abgeschlossen ist, mit demselben Ergebnis. |
| ApplyToEither(ICompletionStage, IFunction) |
Eine |
| ApplyToEitherAsync(ICompletionStage, IFunction, IExecutor) |
Eine |
| ApplyToEitherAsync(ICompletionStage, IFunction) |
Eine |
| Cancel(Boolean) |
Wenn noch nicht abgeschlossen, schließt dieses CompletableFuture mit einem |
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| Complete(Object) |
Wenn noch nicht abgeschlossen, wird der von |
| CompleteAsync(ISupplier, IExecutor) |
Schließt diese CompletableFuture mit dem Ergebnis der angegebenen Lieferantenfunktion ab, die von einer asynchronen Aufgabe mithilfe des angegebenen Executors aufgerufen wird. |
| CompleteAsync(ISupplier) |
Schließt diese CompletableFuture mit dem Ergebnis der angegebenen Lieferantenfunktion ab, die von einer asynchronen Aufgabe mithilfe des Standardausführers aufgerufen wird. |
| CompletedFuture(Object) |
Gibt eine neue CompletableFuture zurück, die bereits mit dem angegebenen Wert abgeschlossen ist. |
| CompletedStage(Object) |
Gibt eine neue CompletionStage zurück, die bereits mit dem angegebenen Wert abgeschlossen ist und nur diese Methoden in der Schnittstelle |
| CompleteExceptionally(Throwable) |
Wenn noch nicht abgeschlossen, werden Aufrufe und |
| CompleteOnTimeout(Object, Int64, TimeUnit) |
Schließt dieses CompletableFuture-Steuerelement mit dem angegebenen Wert ab, wenn er nicht andernfalls vor dem angegebenen Timeout abgeschlossen wurde. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Eine |
| Copy() |
Gibt eine neue CompletableFuture zurück, die normalerweise mit demselben Wert wie diese CompletableFuture abgeschlossen wird, wenn sie normal abgeschlossen ist. |
| DefaultExecutor() |
Gibt den standardmäßigen Executor zurück, der für asynchrone Methoden verwendet wird, die keinen Executor angeben. |
| DelayedExecutor(Int64, TimeUnit, IExecutor) |
Gibt einen neuen Executor zurück, der eine Aufgabe nach der angegebenen Verzögerung an den angegebenen Basisausführer sendet (oder keine Verzögerung, wenn dies nicht positiv ist). |
| DelayedExecutor(Int64, TimeUnit) |
Gibt einen neuen Executor zurück, der eine Aufgabe nach der angegebenen Verzögerung an den Standardausführer sendet (oder keine Verzögerung, wenn dies nicht positiv ist). |
| Dispose() |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| Dispose(Boolean) |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| DisposeUnlessReferenced() |
Eine |
| Equals(Object) |
Eine |
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| Exceptionally(IFunction) |
Gibt eine neue CompletableFuture zurück, die abgeschlossen ist, wenn diese CompletableFuture abgeschlossen ist, wobei das Ergebnis der gegebenen Funktion der Ausnahme, die den Abschluss dieses CompletableFuture auslöst, wenn sie außergewöhnlich abgeschlossen wird; andernfalls, wenn dieser CompletableFuture normal abgeschlossen ist, wird die zurückgegebene CompletableFuture auch normal mit demselben Wert abgeschlossen. |
| ExceptionallyAsync(IFunction, IExecutor) |
Eine |
| ExceptionallyAsync(IFunction) |
Eine |
| ExceptionallyCompose(IFunction) |
Eine |
| ExceptionallyComposeAsync(IFunction, IExecutor) |
Eine |
| ExceptionallyComposeAsync(IFunction) |
Eine |
| ExceptionNow() |
Eine |
| FailedFuture(Throwable) |
Gibt eine neue CompletableFuture zurück, die bereits außergewöhnlich mit der gegebenen Ausnahme abgeschlossen ist. |
| FailedStage(Throwable) |
Gibt eine neue CompletionStage zurück, die bereits außergewöhnlich mit der angegebenen Ausnahme abgeschlossen ist und nur diese Methoden in der Schnittstelle |
| Get() |
Wartet, falls erforderlich, bis diese Zukunft abgeschlossen ist, und gibt dann das Ergebnis zurück. |
| Get(Int64, TimeUnit) |
Wartet, falls erforderlich, bis diese Zukunft abgeschlossen ist, und gibt dann, falls verfügbar, das Ergebnis zurück. |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| GetNow(Object) |
Gibt den Ergebniswert zurück (oder löst eine gefundene Ausnahme aus), falls abgeschlossen, andernfalls wird der angegebene WertIfAbsent zurückgegeben. |
| Handle(IBiFunction) |
Eine |
| HandleAsync(IBiFunction, IExecutor) |
Eine |
| HandleAsync(IBiFunction) |
Eine |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| Join() |
Gibt den Ergebniswert zurück, wenn er abgeschlossen ist, oder löst eine (deaktivierte) Ausnahme aus, wenn dies ausnahmsweise abgeschlossen ist. |
| MinimalCompletionStage() |
Gibt einen neuen CompletionStage-Wert zurück, der normalerweise mit demselben Wert wie dieser CompletableFuture abgeschlossen wird, wenn er normal abgeschlossen wird und nicht unabhängig abgeschlossen oder auf andere Weise verwendet werden kann, die nicht durch die Methoden der Schnittstelle |
| NewIncompleteFuture() |
Gibt einen neuen unvollständigen CompletableFuture des Typs zurück, der von einer CompletionStage-Methode zurückgegeben werden soll. |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| ObtrudeException(Throwable) |
Die anschließende Aufrufe von Methoden |
| ObtrudeValue(Object) |
Anschließend wird der von Der Methode |
| OrTimeout(Int64, TimeUnit) |
Schließt dieses CompletableFuture ausnahmsweise mit einem |
| ResultNow() |
Eine |
| RunAfterBoth(ICompletionStage, IRunnable) |
Eine |
| RunAfterBothAsync(ICompletionStage, IRunnable, IExecutor) |
Eine |
| RunAfterBothAsync(ICompletionStage, IRunnable) |
Eine |
| RunAfterEither(ICompletionStage, IRunnable) |
Eine |
| RunAfterEitherAsync(ICompletionStage, IRunnable, IExecutor) |
Eine |
| RunAfterEitherAsync(ICompletionStage, IRunnable) |
Eine |
| RunAsync(IRunnable, IExecutor) |
Gibt eine neue CompletableFuture zurück, die asynchron von einer Aufgabe abgeschlossen wird, die im angegebenen Executor ausgeführt wird, nachdem sie die angegebene Aktion ausgeführt hat. |
| RunAsync(IRunnable) |
Gibt einen neuen CompletableFuture-Wert zurück, der asynchron von einer Aufgabe abgeschlossen wird, die nach dem |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Eine |
| State() |
Eine |
| SupplyAsync(ISupplier, IExecutor) |
Gibt eine neue CompletableFuture zurück, die asynchron von einer Aufgabe abgeschlossen wird, die im angegebenen Executor ausgeführt wird, mit dem Wert, der durch Aufrufen des angegebenen Lieferanten abgerufen wird. |
| SupplyAsync(ISupplier) |
Gibt einen neuen CompletableFuture-Wert zurück, der asynchron von einer Aufgabe abgeschlossen wird, die mit dem |
| ThenAccept(IConsumer) |
Eine |
| ThenAcceptAsync(IConsumer, IExecutor) |
Eine |
| ThenAcceptAsync(IConsumer) |
Eine |
| ThenAcceptBoth(ICompletionStage, IBiConsumer) |
Eine |
| ThenAcceptBothAsync(ICompletionStage, IBiConsumer, IExecutor) |
Eine |
| ThenAcceptBothAsync(ICompletionStage, IBiConsumer) |
Eine |
| ThenApply(IFunction) |
Eine |
| ThenApplyAsync(IFunction, IExecutor) |
Eine |
| ThenApplyAsync(IFunction) |
Eine |
| ThenCombine(ICompletionStage, IBiFunction) |
Eine |
| ThenCombineAsync(ICompletionStage, IBiFunction, IExecutor) |
Eine |
| ThenCombineAsync(ICompletionStage, IBiFunction) |
Eine |
| ThenCompose(IFunction) |
Eine |
| ThenComposeAsync(IFunction, IExecutor) |
Eine |
| ThenComposeAsync(IFunction) |
Eine |
| ThenRun(IRunnable) |
Eine |
| ThenRunAsync(IRunnable, IExecutor) |
Eine |
| ThenRunAsync(IRunnable) |
Eine |
| ToArray<T>() |
Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object) |
| ToCompletableFuture() |
Gibt diesen CompletableFuture zurück. |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object) |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| WhenComplete(IBiConsumer) |
Eine |
| WhenCompleteAsync(IBiConsumer, IExecutor) |
Eine |
| WhenCompleteAsync(IBiConsumer) |
Eine |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IJavaPeerable.Disposed() |
Eine |
| IJavaPeerable.Finalized() |
Eine |
| IJavaPeerable.JniObjectReferenceControlBlock |
Eine |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Eine |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Eine |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Eine |
| IJavaPeerable.UnregisterFromRuntime() |
Eine |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetAsync(IFuture, Int64, TimeUnit) |
Eine |
| GetAsync(IFuture) |
Eine |
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Eine |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |