AsynchronousSocketChannel Klasse

Definition

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

[<Android.Runtime.Register("java/nio/channels/AsynchronousSocketChannel", ApiSince=26, DoNotGenerateAcw=true)>]
type AsynchronousSocketChannel = class
    inherit Object
    interface IAsynchronousByteChannel
    interface IAsynchronousChannel
    interface IChannel
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Vererbung

Object

JavaObject

Object

AsynchronousSocketChannel

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable ICloseable IAsynchronousByteChannel IAsynchronousChannel IChannel IDisposable

Hinweise

Ein asynchroner Kanal für streamorientierte Verbindungssockets.

Asynchrone Socketkanäle werden auf eine von zwei Arten erstellt. Ein neu erstelltes AsynchronousSocketChannel Element wird durch Aufrufen einer der #open open von dieser Klasse definierten Methoden erstellt. Ein neu erstellter Kanal ist geöffnet, aber noch nicht verbunden. Eine Verbindung AsynchronousSocketChannel wird erstellt, wenn eine Verbindung mit dem Socket eines AsynchronousServerSocketChannel. Es ist nicht möglich, einen asynchronen Socketkanal für einen beliebigen, bereits vorhandenen java.net.Socket socketSocketkanal zu erstellen.

Ein neu erstellter Kanal wird durch Aufrufen seiner #connect connect Methode verbunden. Sobald eine Verbindung hergestellt wurde, bleibt ein Kanal verbunden, bis er geschlossen ist. Gibt an, ob ein Socketkanal verbunden ist, kann durch aufrufende #getRemoteAddress getRemoteAddress Methode bestimmt werden. Ein Versuch, einen E/A-Vorgang bei einem nicht verbundenen Kanal aufzurufen, führt dazu, dass ein NotYetConnectedException Fehler ausgelöst wird.

Kanäle dieses Typs sind sicher für die Verwendung durch mehrere gleichzeitige Threads. Sie unterstützen gleichzeitiges Lesen und Schreiben, obwohl höchstens ein Lesevorgang und ein Schreibvorgang jederzeit ausstehen können. Wenn ein Thread einen Lesevorgang initiiert, bevor ein vorheriger Lesevorgang abgeschlossen wurde, wird ein ReadPendingException Fehler ausgelöst. Ebenso löst ein Versuch, einen Schreibvorgang zu initiieren, bevor ein vorheriger Schreibvorgang abgeschlossen wurde.WritePendingException

Socketoptionen werden mithilfe der #setOption(SocketOption,Object) setOption Methode konfiguriert. Asynchrone Socketkanäle unterstützen die folgenden Optionen: <blockquote><table class="striped"><caption style="display:none">Socket options</caption><thead><tr><th scope="col">Option Name</th th><scope="col">Description</th></tr></thead><tbody><tr><th scope="row">java.net.StandardSocketOptions#SO_SNDBUF SO_SNDBUF</th><td> Die Größe des Sockets senden buffer </td></tr tr><><th scope="row">java.net.StandardSocketOptions#SO_RCVBUF SO_RCVBUF</th><td> The size of the socket receive buffer </td></tr tr><><th scope="row">java.net.StandardSocketOptions#SO_KEEPALIVE SO_KEEPALIVE</th><td> Keep connection alive </td></tr tr><><th scope="row">java.net.StandardSocketOptions#SO_REUSEADDR SO_REUSEADDR</th><td> Re-use address </td></tr tr tr><><th scope="row">java.net.StandardSocketOptions#TCP_NODELAY TCP_NODELAY</th><td> Disable the Nagle algorithm </td></tr></tbody></table></blockquote> Additional (implementation specific) options may be supported.

<h2>Timeouts</h2>

#read(ByteBuffer,long,TimeUnit,Object,CompletionHandler) read Mit #write(ByteBuffer,long,TimeUnit,Object,CompletionHandler) write den von dieser Klasse definierten Methoden kann beim Initiieren eines Lese- oder Schreibvorgangs ein Timeout angegeben werden. Wenn das Timeout vor Abschluss eines Vorgangs verstrichen ist, wird der Vorgang mit der Ausnahme InterruptedByTimeoutExceptionabgeschlossen. Ein Timeout kann den Kanal oder die zugrunde liegende Verbindung in einem inkonsistenten Zustand verlassen. Wenn die Implementierung nicht garantieren kann, dass Bytes nicht aus dem Kanal gelesen wurden, wird der Kanal in einen implementierungsspezifischen <Em-Fehlerstatus></em> versetzt. Ein anschließender Versuch, einen read Vorgang zu initiieren, bewirkt, dass eine nicht angegebene Laufzeitausnahme ausgelöst wird. Wenn ein write Vorgang zu einem Timeout führt und die Implementierung nicht garantieren kann, dass Bytes nicht in den Kanal geschrieben wurden, führen weitere Versuche in write den Kanal, dass eine nicht angegebene Laufzeitausnahme ausgelöst wird. Wenn ein Timeout abgelaufen ist, wird der Zustand des ByteBufferE/A-Vorgangs für den E/A-Vorgang nicht definiert. Puffer sollten verworfen werden, oder es muss mindestens darauf geachtet werden, dass auf die Puffer nicht zugegriffen wird, während der Kanal geöffnet bleibt. Alle Methoden, die Timeoutparameter akzeptieren, behandeln Werte kleiner oder gleich Null, um zu bedeuten, dass der E/A-Vorgang kein Timeout ausführt.

In 1.7 hinzugefügt.

Java Dokumentation für java.nio.channels.AsynchronousSocketChannel.

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.