ObjectSocket

obxecto socket de rede

Socket pertence anetmódulo, método de creación

1
var s = new net.Socket();

relación de herdanza

Construtor

Socket

Construtor de socket, crea un novo obxecto Socket

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

Parámetros de chamada:

• family: Número enteiro, especifique o conxunto de enderezos, o valor predeterminado é AF_INET, ipv4

propiedades dos membros

family

Enteiro, consulta o conxunto de enderezos do obxecto Socket actual

1
readonly Integer Socket.family;

---

remoteAddress

String, consulta o enderezo da outra parte da conexión actual

1
readonly String Socket.remoteAddress;

---

remotePort

Enteiro, consulta o porto do mesmo conectado actualmente

1
readonly Integer Socket.remotePort;

---

localAddress

Cadea, consulta o enderezo local da conexión actual

1
readonly String Socket.localAddress;

---

localPort

Enteiro, consulta o porto local da conexión actual

1
readonly Integer Socket.localPort;

---

timeout

Unidade de tempo de espera enteiro, consulta e establece milisegundos

1
Integer Socket.timeout;

---

fd

Número enteiro, consultaStreamO valor do descritor do ficheiro correspondente, implementado por subclases

1
readonly Integer Socket.fd;

función de membro

connect

Establece unha conexión tcp

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

Parámetros de chamada:

• host: Cadea, especifica o enderezo ou o nome de host da outra parte, ou pode apuntar ao socket Unix e ás rutas de canalización de Windows
• port: Enteiro, especifica o porto da outra parte. Cando se conecta un socket Unix e a tubería de Windows, este parámetro debe ser 0
• timeout: Número enteiro, especifica o tempo de espera, a unidade é milisegundos, o valor predeterminado é 0

---

bind

Vincule o Socket actual ao porto especificado de todos os enderezos locais

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

Parámetros de chamada:

• port: Enteiro, especifica o porto vinculado
• allowIPv4: Booleano, especifica se se aceptan conexións ipv4, o valor predeterminado é verdadeiro. Este parámetro é válido para ipv6 e depende do sistema operativo

---

Vincule o Socket actual ao porto especificado no enderezo especificado

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

Parámetros de chamada:

• addr: String, especifica o enderezo de vinculación e tamén pode apuntar a unix socket e rutas de canalización de Windows
• port: Número enteiro, especifica o porto vinculado. Este parámetro ignórase cando se vincula un socket Unix e un tubo de Windows.
• allowIPv4: Booleano, especifica se se aceptan conexións ipv4, o valor predeterminado é verdadeiro. Este parámetro é válido para ipv6 e depende do sistema operativo

---

listen

Comeza a escoitar solicitudes de conexión

1
Socket.listen(Integer backlog = 120);

Parámetros de chamada:

• backlog: Número enteiro, especifica a lonxitude da cola de solicitudes. Rexeitaranse as solicitudes que superen o límite. O valor predeterminado é 120.

---

accept

Agarda e acepta unha conexión

1
Socket Socket.accept() async;

Resultados de devolución:

• Socket, devolve o obxecto de conexión recibido

---

recv

Ler datos dun tamaño especificado desde a conexión. A diferenza do método de lectura, recv non garante que se leran os datos necesarios, pero volve inmediatamente despois de ler os datos.

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

Parámetros de chamada:

• bytes: Número enteiro, especifica a cantidade de datos que se van ler. Por defecto, len datos de calquera tamaño.

Resultados de devolución:

• Buffer, devolve os datos lidos desde a conexión

---

send

Escribe os datos dados na conexión. Este método é equivalente ao método de escritura.

1
Socket.send(Buffer data) async;

Parámetros de chamada:

• data:Buffer, dados os datos a escribir

---

read

Ler datos do tamaño especificado do fluxo

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

Parámetros de chamada:

• bytes: Número enteiro, especifica a cantidade de datos que se van ler. O valor predeterminado é ler bloques de datos de tamaño aleatorio. O tamaño dos datos lidos depende do dispositivo.

Resultados de devolución:

• Buffer, devolve os datos lidos do fluxo. Se non hai datos para ler ou se interrompe a conexión, devólvese nulo.

---

write

Escribe os datos dados no fluxo

1
Socket.write(Buffer data) async;

Parámetros de chamada:

• data:Buffer, dados os datos a escribir

---

flush

Escribe o contido do búfer de ficheiros no dispositivo físico

1
Socket.flush() async;

---

close

Pecha o obxecto de fluxo actual

1
Socket.close() async;

---

copyTo

Copia os datos do fluxo no fluxo de destino

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

Parámetros de chamada:

• stm:Stream, obxecto de fluxo de destino
• bytes: Longo, número de bytes copiados

Resultados de devolución:

• Long, devolve o número de bytes copiados

---

toString

Devolve a representación en cadea do obxecto. Polo xeral, devólvese "[Obxecto nativo]". O obxecto pódese volver implementar segundo as súas propias características.

1
String Socket.toString();

Resultados de devolución:

• String, devolve a representación en cadea do obxecto

---

toJSON

Devolve unha representación en formato JSON do obxecto, devolvendo xeralmente unha colección de propiedades lexibles definidas polo obxecto.

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

Parámetros de chamada:

• key: Cadena, non usada

Resultados de devolución:

• Value, devolve un valor que contén JSON serializable