ObjectSocket

Netzwerk-Socket-Objekt

Socket gehört dazunetModul, Erstellungsmethode

1
var s = new net.Socket();

Erbschaftsverhältnis

Konstrukteur

Socket

Socket-Konstruktor, erstellt ein neues Socket-Objekt

1
new Socket(Integer family = net.AF_INET);

Aufrufparameter:

• family: Ganzzahl, geben Sie den Adresssatz an. Der Standardwert ist AF_INET, IPv4

Mitgliedereigenschaften

family

Ganzzahl, fragen Sie den Adresssatz des aktuellen Socket-Objekts ab

1
readonly Integer Socket.family;

---

remoteAddress

Zeichenfolge, fragen Sie die Adresse der anderen Partei der aktuellen Verbindung ab

1
readonly String Socket.remoteAddress;

---

remotePort

Ganzzahl, fragen Sie den aktuell verbundenen Peer-Port ab

1
readonly Integer Socket.remotePort;

---

localAddress

String, fragen Sie die lokale Adresse der aktuellen Verbindung ab

1
readonly String Socket.localAddress;

---

localPort

Ganzzahl, fragen Sie den lokalen Port der aktuellen Verbindung ab

1
readonly Integer Socket.localPort;

---

timeout

Ganzzahl, Abfrage und festgelegte Timeout-Einheit in Millisekunden

1
Integer Socket.timeout;

---

fd

Ganzzahl, AbfrageStreamDer entsprechende Dateideskriptorwert, implementiert durch Unterklassen

1
readonly Integer Socket.fd;

Mitgliedsfunktion

connect

Stellen Sie eine TCP-Verbindung her

1
2
3
Socket.connect(String host,
    Integer port,
    Integer timeout = 0) async;

Aufrufparameter:

• host: Zeichenfolge, gibt die Adresse oder den Hostnamen der anderen Partei an oder kann auf Unix-Socket- und Windows-Pipe-Pfade verweisen
• port: Ganzzahl, gibt den Port der anderen Partei an. Beim Verbinden von Unix-Socket und Windows-Pipe muss dieser Parameter 0 sein
• timeout: Ganzzahl, gibt den Timeout an, die Einheit ist Millisekunden, der Standardwert ist 0

---

bind

Binden Sie den aktuellen Socket an den angegebenen Port aller lokalen Adressen

1
2
Socket.bind(Integer port,
    Boolean allowIPv4 = true);

Aufrufparameter:

• port: Ganzzahl, gibt den gebundenen Port an
• allowIPv4: Boolean, gibt an, ob IPv4-Verbindungen akzeptiert werden sollen, der Standardwert ist true. Dieser Parameter ist für IPv6 gültig und abhängig vom Betriebssystem

---

Binden Sie den aktuellen Socket an den angegebenen Port an der angegebenen Adresse

1
2
3
Socket.bind(String addr,
    Integer port = 0,
    Boolean allowIPv4 = true);

Aufrufparameter:

• addr: String, gibt die Bindungsadresse an und kann auch auf Unix-Socket- und Windows-Pipe-Pfade verweisen
• port: Ganzzahl, gibt den gebundenen Port an. Dieser Parameter wird beim Binden von Unix-Socket und Windows-Pipe ignoriert.
• allowIPv4: Boolean, gibt an, ob IPv4-Verbindungen akzeptiert werden sollen, der Standardwert ist true. Dieser Parameter ist für IPv6 gültig und abhängig vom Betriebssystem

---

listen

Fangen Sie an, auf Verbindungsanfragen zu warten

1
Socket.listen(Integer backlog = 120);

Aufrufparameter:

• backlog: Ganzzahl, gibt die Länge der Anforderungswarteschlange an. Anforderungen, die den Grenzwert überschreiten, werden abgelehnt. Der Standardwert ist 120.

---

accept

Warten Sie auf eine Verbindung und akzeptieren Sie sie

1
Socket Socket.accept() async;

Rückgabeergebnisse:

• Socket, gibt das empfangene Verbindungsobjekt zurück

---

recv

Liest Daten einer bestimmten Größe aus der Verbindung. Im Gegensatz zur Lesemethode garantiert recv nicht, dass die erforderlichen Daten gelesen wurden, sondern kehrt sofort nach dem Lesen der Daten zurück.

1
Buffer Socket.recv(Integer bytes = -1) async;

Aufrufparameter:

• bytes: Ganzzahl, gibt die Menge der zu lesenden Daten an. Standardmäßig werden Daten beliebiger Größe gelesen.

Rückgabeergebnisse:

• Buffer, gibt die von der Verbindung gelesenen Daten zurück

---

send

Schreiben Sie die angegebenen Daten in die Verbindung. Diese Methode entspricht der Schreibmethode.

1
Socket.send(Buffer data) async;

Aufrufparameter:

• data:Buffer, angesichts der zu schreibenden Daten

---

read

Liest Daten der angegebenen Größe aus dem Stream

1
Buffer Socket.read(Integer bytes = -1) async;

Aufrufparameter:

• bytes: Ganzzahl, gibt die Menge der zu lesenden Daten an. Standardmäßig werden Datenblöcke zufälliger Größe gelesen. Die Größe der gelesenen Daten hängt vom Gerät ab.

Rückgabeergebnisse:

• Buffer, gibt die aus dem Stream gelesenen Daten zurück. Wenn keine Daten zum Lesen vorhanden sind oder die Verbindung unterbrochen ist, wird null zurückgegeben.

---

write

Schreiben Sie die angegebenen Daten in den Stream

1
Socket.write(Buffer data) async;

Aufrufparameter:

• data:Buffer, angesichts der zu schreibenden Daten

---

flush

Schreiben Sie den Inhalt des Dateipuffers auf das physische Gerät

1
Socket.flush() async;

---

close

Schließen Sie das aktuelle Stream-Objekt

1
Socket.close() async;

---

copyTo

Streamdaten in den Zielstream kopieren

1
2
Long Socket.copyTo(Stream stm,
    Long bytes = -1) async;

Aufrufparameter:

• stm:Stream, Ziel-Stream-Objekt
• bytes: Lang, Anzahl der kopierten Bytes

Rückgabeergebnisse:

• Long, gibt die Anzahl der kopierten Bytes zurück

---

toString

Gibt die Zeichenfolgendarstellung des Objekts zurück. Im Allgemeinen wird „[Native Object]“ zurückgegeben. Das Objekt kann gemäß seinen eigenen Eigenschaften neu implementiert werden.

1
String Socket.toString();

Rückgabeergebnisse:

• String, gibt die Zeichenfolgendarstellung des Objekts zurück

---

toJSON

Gibt eine Darstellung des Objekts im JSON-Format zurück und gibt im Allgemeinen eine Sammlung lesbarer Eigenschaften zurück, die vom Objekt definiert werden.

1
Value Socket.toJSON(String key = "");

Aufrufparameter:

• key: Zeichenfolge, nicht verwendet

Rückgabeergebnisse:

• Value, gibt einen Wert zurück, der JSON serialisierbar enthält