AsynchronousChannelGroup Klasse

Definition

[Android.Runtime.Register("java/nio/channels/AsynchronousChannelGroup", ApiSince=26, DoNotGenerateAcw=true)]
public abstract class AsynchronousChannelGroup : Java.Lang.Object

[<Android.Runtime.Register("java/nio/channels/AsynchronousChannelGroup", ApiSince=26, DoNotGenerateAcw=true)>]
type AsynchronousChannelGroup = class
    inherit Object

Vererbung

Object

Object

AsynchronousChannelGroup

Attribute

RegisterAttribute

Hinweise

Eine Gruppierung asynchroner Kanäle zum Zweck der Ressourcenfreigabe.

Eine asynchrone Kanalgruppe kapselt die Mechanik, die zum Verarbeiten des Abschlusses von E/A-Vorgängen erforderlich ist, die an AsynchronousChannel asynchronous channels die Gruppe gebunden sind. Eine Gruppe verfügt über einen zugeordneten Threadpool, an den Aufgaben übermittelt werden, um E/A-Ereignisse zu verarbeiten und an CompletionHandler completion-handlers die das Ergebnis asynchroner Vorgänge zu senden, die für Kanäle in der Gruppe ausgeführt werden. Zusätzlich zur Behandlung von E/A-Ereignissen können die zusammengefassten Threads auch andere Aufgaben ausführen, die erforderlich sind, um die Ausführung asynchroner E/A-Vorgänge zu unterstützen.

Eine asynchrone Kanalgruppe wird durch Aufrufen der #withFixedThreadPool withFixedThreadPool hier definierten Methoden #withCachedThreadPool withCachedThreadPool erstellt. Kanäle werden an eine Gruppe gebunden, indem sie beim Erstellen des Kanals die Gruppe angibt. Der zugeordnete Threadpool gehört<></em> der Gruppe. Die Beendigung der Gruppe führt zum Herunterfahren des zugeordneten Threadpools.

Zusätzlich zu explizit erstellten Gruppen verwaltet der virtuelle Java-Computer eine systemweite <Em-Standardgruppe></em>, die automatisch erstellt wird. Asynchrone Kanäle, die zur Erstellungszeit keine Gruppe angeben, sind an die Standardgruppe gebunden. Die Standardgruppe verfügt über einen zugeordneten Threadpool, der bei Bedarf neue Threads erstellt. Die Standardgruppe kann mithilfe von Systemeigenschaften konfiguriert werden, die in der folgenden Tabelle definiert sind. Wenn die java.util.concurrent.ThreadFactory ThreadFactory Standardgruppe nicht konfiguriert ist, sind Thread#isDaemon daemon die gepoolten Threads der Standardgruppe Threads.

<table class="striped"><caption style="display:none:">System properties</caption><thead><tr><th scope="col">System property/th th<>scope="col">Description</th/th<>/thead<>tbody<><>tr>< th scope="row"java.nio.channels.DefaultThreadPool.threadFactory<>/th><td> The value of this property< is taken to be the fully-qualified name of a concrete java.util.concurrent.ThreadFactory ThreadFactory class. Die Klasse wird mit dem Systemklassenladeprogramm geladen und instanziiert. Die Factorymethode java.util.concurrent.ThreadFactory#newThread newThread wird aufgerufen, um jeden Thread für den Threadpool der Standardgruppe zu erstellen. Wenn der Prozess zum Laden und Instanziieren des Werts der Eigenschaft fehlschlägt, wird während der Erstellung der Standardgruppe ein nicht angegebener Fehler ausgelöst. </td></tr tr>><<th scope="row"java.nio.channels.DefaultThreadPool.initialSize<>/th><td> Der Wert des initialSize Parameters für die Standardgruppe (siehe ).#withCachedThreadPool withCachedThreadPool Der Wert der Eigenschaft wird als Darstellung eines Integer Parameters für die String anfängliche Größe verwendet. Wenn der Wert nicht analysiert werden kann, wird Integer während der Erstellung der Standardgruppe ein nicht angegebener Fehler ausgelöst. </td></tr></tbody></table>

"Threading"><h2>Threading</h2>

Der Abschlusshandler für einen E/A-Vorgang, der für einen Kanal initiiert wurde, der an eine Gruppe gebunden ist, wird garantiert von einem der gruppierten Threads in der Gruppe aufgerufen. Dadurch wird sichergestellt, dass der Abschlusshandler von einem Thread mit der erwarteten <Em-Identität<>/em> ausgeführt wird.

Wenn ein E/A-Vorgang sofort abgeschlossen wird und der initiierende Thread einer der in der Gruppe zusammengefassten Threads ist, kann der Abschlusshandler direkt vom initiierenden Thread aufgerufen werden. Um Stapelüberlauf zu vermeiden, kann eine Implementierung einen Grenzwert für die Anzahl der Aktivierungen im Threadstapel auferlegen. Einige E/A-Vorgänge verhindern möglicherweise, dass der Abschlusshandler direkt vom initiierenden Thread aufgerufen wird (siehe AsynchronousServerSocketChannel#accept(Object,CompletionHandler) accept).

"Herunterfahren"><h2>Herunterfahren und Beenden</h2>

Die #shutdown() shutdown Methode wird verwendet, um ein geordnetes <Herunterfahren</Em>> einer Gruppe zu initiieren. Ein geordnetes Herunterfahren markiert die Gruppe als Herunterfahren; weitere Versuche, einen Kanal zu erstellen, der an die Gruppe gebunden wird, wird ausgelöst ShutdownChannelGroupException. Ob eine Gruppe heruntergefahren wird, kann mit der #isShutdown() isShutdown Methode getestet werden. Nach dem Herunterfahren wird die Gruppe <em>beendet</em> beendet, wenn alle asynchronen Kanäle, die an die Gruppe gebunden sind, geschlossen werden, alle aktiv ausgeführten Abschlusshandler ausgeführt wurden, und ressourcen, die von der Gruppe verwendet werden. Es wird kein Versuch unternommen, Threads zu beenden oder zu unterbrechen, die Abschlusshandler ausführen. Die #isTerminated() isTerminated Methode wird verwendet, um zu testen, ob die Gruppe beendet wurde, und die #awaitTermination awaitTermination Methode kann verwendet werden, um zu blockieren, bis die Gruppe beendet wurde.

Die #shutdownNow() shutdownNow Methode kann verwendet werden, um ein <erzwungenes>Herunterfahren</Em> der Gruppe zu initiieren. Zusätzlich zu den Aktionen, die durch ein geordnetes Herunterfahren ausgeführt werden, schließt die shutdownNow Methode alle geöffneten Kanäle in der Gruppe, als ob sie die AsynchronousChannel#close close Methode aufrufen.

In 1.7 hinzugefügt.

Java-Dokumentation für java.nio.channels.AsynchronousChannelGroup.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für: