ObjectSocket

objecte socket de xarxa

Socket pertany anetmòdul, mètode de creació

1
var s = new net.Socket();

relació hereditària

Constructor

Socket

Constructor de socket, crea un nou objecte Socket

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

Paràmetres de trucada:

• family: Enter, especifiqueu el conjunt d'adreces, el valor per defecte és AF_INET, ipv4

propietats dels membres

family

Enter, consulteu el conjunt d'adreces de l'objecte Socket actual

1
readonly Integer Socket.family;

---

remoteAddress

String, consulta l'adreça de l'altra part de la connexió actual

1
readonly String Socket.remoteAddress;

---

remotePort

Enter, consulteu el port igual connectat actualment

1
readonly Integer Socket.remotePort;

---

localAddress

Cadena, consulta l'adreça local de la connexió actual

1
readonly String Socket.localAddress;

---

localPort

Enter, consulteu el port local de la connexió actual

1
readonly Integer Socket.localPort;

---

timeout

Enter, consultar i establir la unitat de temps d'espera mil·lisegons

1
Integer Socket.timeout;

---

fd

Enter, consultaStreamEl valor del descriptor de fitxer corresponent, implementat per subclasses

1
readonly Integer Socket.fd;

funció de membre

connect

Establiu una connexió tcp

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

Paràmetres de trucada:

• host: Cadena, especifica l'adreça o el nom d'amfitrió de l'altra part, o pot apuntar a un endoll Unix i a les rutes de canonades de Windows
• port: Enter, especifica el port de l'altra part. Quan es connecta el sòcol Unix i la canonada de Windows, aquest paràmetre ha de ser 0
• timeout: Sencer, especifica el temps d'espera, la unitat és de mil·lisegons, el valor predeterminat és 0

---

bind

Enllaceu el Socket actual al port especificat de totes les adreces locals

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

Paràmetres de trucada:

• port: Enter, especifica el port enllaçat
• allowIPv4: Booleà, especifica si s'acceptaran connexions ipv4, el valor predeterminat és cert. Aquest paràmetre és vàlid per a ipv6 i depèn del sistema operatiu

---

Enllaceu el socket actual al port especificat a l'adreça especificada

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

Paràmetres de trucada:

• addr: String, especifica l'adreça d'enllaç i també pot apuntar a les rutes del sòcol Unix i de la canonada de Windows
• port: Enter, especifica el port enllaçat. Aquest paràmetre s'ignora quan s'enllaça el sòcol Unix i la canonada de Windows.
• allowIPv4: Booleà, especifica si s'acceptaran connexions ipv4, el valor predeterminat és cert. Aquest paràmetre és vàlid per a ipv6 i depèn del sistema operatiu

---

listen

Comenceu a escoltar les sol·licituds de connexió

1
Socket.listen(Integer backlog = 120);

Paràmetres de trucada:

• backlog: Sencer, especifica la longitud de la cua de sol·licituds. Es rebutjaran les sol·licituds que superin el límit. El valor predeterminat és 120.

---

accept

Espereu i accepteu una connexió

1
Socket Socket.accept() async;

Resultats de retorn:

• Socket, retorna l'objecte de connexió rebut

---

recv

Llegir dades d'una mida especificada de la connexió. A diferència del mètode read, recv no garanteix que s'hagin llegit les dades requerides, però torna immediatament després de llegir les dades.

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

Paràmetres de trucada:

• bytes: Sencer, especifica la quantitat de dades a llegir. Per defecte, es llegeixen dades de qualsevol mida.

Resultats de retorn:

• Buffer, retorna les dades llegides des de la connexió

---

send

Escriu les dades donades a la connexió. Aquest mètode és equivalent al mètode d'escriptura.

1
Socket.send(Buffer data) async;

Paràmetres de trucada:

• data:Buffer, donades les dades a escriure

---

read

Llegiu dades de la mida especificada del flux

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

Paràmetres de trucada:

• bytes: Sencer, especifica la quantitat de dades que s'han de llegir. El valor predeterminat és llegir blocs de dades de mida aleatòria. La mida de les dades llegides depèn del dispositiu.

Resultats de retorn:

• Buffer, retorna les dades llegides del flux. Si no hi ha dades per llegir o la connexió s'interromp, es retorna null.

---

write

Escriu les dades donades al flux

1
Socket.write(Buffer data) async;

Paràmetres de trucada:

• data:Buffer, donades les dades a escriure

---

flush

Escriu el contingut de la memòria intermèdia del fitxer al dispositiu físic

1
Socket.flush() async;

---

close

Tanca l'objecte del flux actual

1
Socket.close() async;

---

copyTo

Copieu les dades del flux al flux de destinació

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

Paràmetres de trucada:

• stm:Stream, objecte de flux de destinació
• bytes: llarg, nombre de bytes copiats

Resultats de retorn:

• Long, retorna el nombre de bytes copiats

---

toString

Retorna la representació de cadena de l'objecte. En general, es retorna "[Objecte natiu]". L'objecte es pot tornar a implementar segons les seves pròpies característiques.

1
String Socket.toString();

Resultats de retorn:

• String, retorna la representació de cadena de l'objecte

---

toJSON

Retorna una representació en format JSON de l'objecte, generalment retornant una col·lecció de propietats llegibles definides per l'objecte.

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

Paràmetres de trucada:

• key: Corda, no utilitzada

Resultats de retorn:

• Value, retorna un valor que conté JSON serializable