개체 내장 개체

개체 소켓

네트워크 소켓 개체

소켓이 속한net모듈, 생성 방법

1
var s = new net.Socket();

상속 관계

건설자

Socket

소켓 생성자, 새 소켓 객체 생성

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

호출 매개변수:

  • family: 정수, 주소 설정 지정, 기본값은 AF_INET, ipv4

구성원 속성

family

정수, 현재 소켓 개체의 주소 집합을 쿼리합니다.

1
readonly Integer Socket.family;

remoteAddress

문자열, 현재 연결의 피어 주소를 쿼리합니다.

1
readonly String Socket.remoteAddress;

remotePort

정수, 현재 연결의 피어 포트를 쿼리합니다.

1
readonly Integer Socket.remotePort;

localAddress

문자열, 현재 연결의 로컬 주소를 쿼리합니다.

1
readonly String Socket.localAddress;

localPort

정수, 현재 연결의 로컬 포트를 쿼리합니다.

1
readonly Integer Socket.localPort;

timeout

정수, 쿼리 및 타임아웃 설정(밀리초)

1
Integer Socket.timeout;

fd

정수, 쿼리Stream서브클래스에 의해 구현된 해당 파일 설명자 값

1
readonly Integer Socket.fd;

멤버 함수

connect

TCP 연결 설정

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

호출 매개변수:

  • host: 문자열, 상대방의 주소 또는 호스트 이름을 지정하고 유닉스 소켓 및 Windows 파이프의 경로를 가리킬 수도 있음
  • port: 정수, 피어 포트를 지정합니다. 이 매개변수는 유닉스 소켓과 Windows 파이프를 연결할 때 무시됩니다.

bind

현재 소켓을 모든 로컬 주소의 지정된 포트에 바인딩

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

호출 매개변수:

  • port: 정수, 바인드할 포트 지정
  • allowIPv4: 부울, ipv4 연결 수락 여부를 지정합니다. 기본값은 true입니다. 이 매개변수는 ipv6에 유효하며 운영 체제에 따라 다릅니다.

현재 소켓을 지정된 주소의 지정된 포트에 바인드합니다.

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

호출 매개변수:

  • addr: 문자열, 바인딩 주소를 지정하고 유닉스 소켓 및 Windows 파이프 경로를 가리킬 수도 있음
  • port: 정수, 바인드할 포트 지정, 유닉스 소켓과 윈도우즈 파이프 바인딩 시 이 파라미터는 무시
  • allowIPv4: 부울, ipv4 연결 수락 여부를 지정합니다. 기본값은 true입니다. 이 매개변수는 ipv6에 유효하며 운영 체제에 따라 다릅니다.

listen

연결 요청 수신 시작

1
Socket.listen(Integer backlog = 120);

호출 매개변수:

  • backlog: 정수, 요청 대기열 길이 지정, 초과 요청은 거부됨, 기본값은 120

accept

연결 대기 및 수락

1
Socket Socket.accept() async;

반환 결과:

  • Socket, 수신된 연결 개체를 반환합니다.

recv

커넥션에서 지정된 크기의 데이터를 읽는다. read 방식과 달리 recv는 필요한 데이터를 읽어준다는 보장이 없고, 데이터를 읽은 후 바로 리턴한다.

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

호출 매개변수:

  • bytes: 정수, 읽을 데이터의 양을 지정하며, 기본적으로 모든 크기의 데이터를 읽습니다.

반환 결과:

  • Buffer, 연결에서 읽은 데이터를 반환합니다.

send

주어진 데이터를 연결에 씁니다. 이 방법은 쓰기 방법과 동일합니다.

1
Socket.send(Buffer data) async;

호출 매개변수:

  • data:Buffer, 쓸 데이터가 주어졌을 때

read

스트림에서 지정된 크기의 데이터 읽기

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

호출 매개변수:

  • bytes: 정수, 읽을 데이터 양 지정, 기본값은 임의 크기의 데이터 블록 읽기, 읽기 데이터 크기는 장치에 따라 다름

반환 결과:

  • Buffer, 스트림에서 읽은 데이터를 반환하거나 읽을 데이터가 없거나 연결이 중단된 경우 null을 반환합니다.

write

주어진 데이터를 스트림에 씁니다.

1
Socket.write(Buffer data) async;

호출 매개변수:

  • data:Buffer, 쓸 데이터가 주어졌을 때

flush

파일 버퍼의 내용을 물리적 장치에 씁니다.

1
Socket.flush() async;

close

현재 스트림 개체를 닫습니다.

1
Socket.close() async;

copyTo

스트림 데이터를 대상 스트림에 복사

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

호출 매개변수:

  • stm:Stream, 대상 스트림 객체
  • bytes: Long, 복사된 바이트 수

반환 결과:

  • Long, 복사된 바이트 수를 반환합니다.

toString

개체의 문자열 표현을 반환하고 일반적으로 "[네이티브 개체]"를 반환하며 개체는 자체 특성에 따라 다시 구현될 수 있습니다.

1
String Socket.toString();

반환 결과:

  • String, 객체의 문자열 표현을 반환합니다.

toJSON

개체의 JSON 형식 표현을 반환하며 일반적으로 개체에 의해 정의된 읽기 가능한 속성 모음을 반환합니다.

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

호출 매개변수:

  • key: 문자열, 사용하지 않음

반환 결과:

  • Value, JSON 직렬화 가능 값을 반환합니다.