웹소켓 API편집자 확인

웹소켓 연결을 수립하는 과정은 프로토콜 핸드셰이크로 시작한다. 이 핸드셰이크는 기존의 HTTP 연결을 웹소켓 프로토콜로 업그레이드하는 형태를 취한다. 클라이언트는 일반적인 HTTP 요청을 보내지만, 이 요청에는 연결을 웹소켓으로 전환하겠다는 특별한 헤더가 포함된다.

핸드셰이크 요청에는 Upgrade: websocket과 Connection: Upgrade 헤더가 필수적으로 포함된다. 또한, 보안을 위해 클라이언트가 생성한 무작위 키를 담은 Sec-WebSocket-Key 헤더를 서버로 보낸다. 서버는 이 키를 받아 표준화된 알고리즘으로 변환한 후, Sec-WebSocket-Accept 헤더에 담아 응답으로 돌려보낸다. 이 과정을 통해 클라이언트는 응답한 상대가 유효한 웹소켓 서버인지 확인할 수 있다.

핸드셰이크가 성공하면, 서버는 101 Switching Protocols라는 HTTP 상태 코드로 응답한다. 이는 프로토콜 전환이 완료되었음을 의미하며, 이후부터는 TCP 연결 위에서 순수한 웹소켓 데이터 프레임이 오가게 된다. 이 초기 핸드셰이크 덕분에 웹소켓은 기존 HTTP 인프라(예: 포트 80 또는 443, 프록시 서버)와 호환성을 유지하면서도 훨씬 효율적인 통신 채널을 열 수 있다.

웹소켓 프로토콜에서 실제 데이터를 주고받는 단위를 데이터 프레임이라고 한다. 웹소켓 API를 통해 애플리케이션에서 전송하는 메시지는 이 데이터 프레임 형식으로 인코딩되어 TCP 연결을 통해 전송된다. 데이터 프레임은 작은 헤더와 페이로드로 구성되어 오버헤드가 매우 적으며, 이는 HTTP의 반복적인 헤더 오버헤드 문제를 해결하는 웹소켓의 핵심 장점 중 하나이다.

데이터 프레임의 구조는 IETF의 RFC 6455 표준에 정의되어 있다. 프레임은 최종 비트(Fin), 예약 비트, 오피코드(Opcode), 마스킹 여부, 페이로드 길이, 마스킹 키(필요 시), 그리고 실제 데이터 페이로드로 이루어진다. 오피코드는 이 프레임이 텍스트나 바이너리 데이터를 담은 데이터 프레임인지, 아니면 연결 종료나 핑/퐁 같은 제어 프레임인지를 구분한다. 특히 텍스트 데이터는 UTF-8로 인코딩되어 전송되어야 한다.

하나의 논리적 메시지는 여러 개의 데이터 프레임으로 분할되어 전송될 수 있다. 이는 대용량 메시지를 효율적으로 전송하거나 전송 중에 메시지를 스트리밍할 때 유용하다. 애플리케이션 레벨의 웹소켓 API는 일반적으로 이러한 프레임의 조립과 분할을 자동으로 처리하여, 개발자가 프레임 단위가 아닌 완전한 메시지 단위로 송수신에 집중할 수 있게 한다.

웹소켓 연결은 TCP 연결 위에서 동작하며, 연결 수명 동안 특정 상태를 거친다. 웹소켓 API를 사용하는 클라이언트 애플리케이션은 WebSocket 객체의 readyState 속성을 통해 현재 연결 상태를 확인할 수 있다. 이 속성은 CONNECTING, OPEN, CLOSING, CLOSED 네 가지 상수 값을 가지며, 각각 연결의 특정 단계를 나타낸다.

CONNECTING 값은 핸드셰이크가 진행 중인 초기 상태를 의미한다. 서버와의 TCP 연결은 수립되었지만, 웹소켓 프로토콜 업그레이드 요청에 대한 응답이 아직 완료되지 않은 상태이다. 핸드셰이크가 성공적으로 완료되면 상태는 OPEN으로 변경된다. OPEN 상태에서는 양방향 통신 채널이 정상적으로 구축되어 애플리케이션이 send() 메서드를 통해 데이터를 전송하고 onmessage 이벤트를 통해 데이터를 수신할 수 있다.

연결 종료 절차가 시작되면 상태는 CLOSING으로 바뀐다. 이는 한쪽 끝점에서 닫기 프레임을 전송했거나 close() 메서드가 호출되었음을 나타낸다. 이 상태에서는 더 이상 새로운 데이터를 전송할 수 없다. 최종적으로 TCP 연결이 완전히 종료되면 상태는 CLOSED가 되며, 이때 WebSocket 객체는 더 이상 사용할 수 없다. 이러한 상태 변화는 onopen, onclose와 같은 이벤트 핸들러를 통해 애플리케이션에서 모니터링하고 대응할 수 있다.

WebSocket 객체는 웹소켓 API의 핵심 구성 요소로, 자바스크립트를 사용하여 웹 브라우저에서 웹소켓 연결을 생성하고 관리하는 데 사용된다. 이 객체는 생성자를 호출하여 인스턴스화되며, 서버의 URL을 지정하여 연결을 초기화한다. 생성된 객체는 연결의 수명 주기 동안 서버와의 통신 채널을 대표하며, 메시지를 주고받고 연결 상태를 모니터링하는 모든 작업의 진입점이 된다.

WebSocket 객체는 주요 이벤트 핸들러와 메서드를 제공한다. 주요 이벤트로는 연결이 성립되었을 때 발생하는 onopen, 서버로부터 메시지를 수신했을 때 발생하는 onmessage, 연결이 종료되었을 때 발생하는 onclose, 그리고 오류가 발생했을 때 트리거되는 onerror가 있다. 개발자는 이러한 이벤트에 콜백 함수를 할당하여 애플리케이션의 로직을 구현한다.

객체가 제공하는 주요 메서드에는 서버로 데이터를 전송하는 send() 메서드와 연결을 의도적으로 종료하는 close() 메서드가 포함된다. send() 메서드는 문자열, ArrayBuffer, Blob 객체 등 다양한 형식의 데이터를 인자로 받을 수 있다. WebSocket 객체의 readyState 속성을 확인하면 연결의 현재 상태, 즉 연결 중, 열림, 닫힘 등의 정보를 실시간으로 얻을 수 있다.

이 객체는 W3C에 의해 표준화된 웹 API의 일부이며, 현대적인 웹 브라우저와 Node.js와 같은 서버 측 환경에서 광범위하게 지원된다. 이를 통해 개발자는 HTTP의 요청-응답 모델의 제약 없이 효율적인 실시간 통신 기능을 웹 애플리케이션에 쉽게 통합할 수 있다.

웹소켓 API에서 이벤트 핸들러는 WebSocket 객체의 생명주기와 데이터 수신을 비동기적으로 처리하는 핵심 메커니즘이다. 웹소켓 연결의 상태 변화나 메시지 도착과 같은 사건은 이벤트로 발생하며, 개발자는 이러한 이벤트에 반응하는 함수인 이벤트 핸들러를 등록하여 애플리케이션 로직을 구현한다. 주요 이벤트로는 연결이 성공적으로 열렸을 때 발생하는 open, 서버로부터 데이터를 받았을 때 발생하는 message, 연결이 닫혔을 때 발생하는 close, 그리고 통신 중 오류가 발생했을 때 트리거되는 error가 있다.

이벤트 핸들러는 주로 onopen, onmessage, onclose, onerror와 같은 콜백 속성에 함수를 할당하는 방식으로 등록한다. 예를 들어, onmessage 핸들러는 서버로부터 텍스트 또는 바이너리 데이터가 도착할 때마다 호출되며, 이벤트 객체의 data 속성을 통해 실제 메시지 내용에 접근할 수 있다. 이러한 방식은 폴링이나 롱 폴링과 같은 기존 기술에 비해 서버 푸시를 효율적으로 구현할 수 있게 한다.

또한, addEventListener 메서드를 사용하여 동일한 이벤트 유형에 여러 개의 리스너를 등록하는 것도 가능하다. 이벤트 핸들러 내에서는 연결 상태를 확인하거나 수신된 데이터를 파싱하여 DOM을 업데이트하거나 애플리케이션 상태를 변경하는 작업을 수행한다. close 이벤트 핸들러에서는 연결 종료 코드와 사유를 확인하여 정상 종료인지 예외 상황인지를 판단할 수 있다.

이러한 이벤트 기반 아키텍처는 자바스크립트의 단일 스레드 모델에서도 실시간 통신을 원활하게 처리할 수 있도록 하며, 비동기 프로그래밍의 전형적인 예시이다. 이를 통해 개발자는 네트워크 통신의 복잡성을 직접 관리하지 않고도, 고수준의 이벤트에 반응하는 코드에 집중하여 실시간 웹 애플리케이션을 구축할 수 있다.

웹소켓 API의 주요 메서드는 WebSocket 객체를 통해 제공된다. 이 객체는 웹 브라우저의 자바스크립트 환경에서 생성되며, 서버와의 연결을 열고, 데이터를 주고받고, 연결을 종료하는 기능을 수행한다. 가장 핵심적인 메서드는 WebSocket() 생성자로, 이를 호출하면 지정된 URL의 서버와 연결을 시도한다. 연결이 성공적으로 수립되면 readyState 속성이 열린 상태로 변경되고, 이후 데이터 전송이 가능해진다.

데이터를 보내기 위해서는 send() 메서드를 사용한다. 이 메서드는 문자열, ArrayBuffer, Blob 객체 등 다양한 형식의 데이터를 인자로 받아 서버로 전송할 수 있다. 전송은 비동기적으로 이루어지며, 네트워크 버퍼가 준비되면 즉시 큐에 들어간다. send() 메서드를 호출한다고 해서 반드시 데이터가 즉시 네트워크를 통해 전송된다는 보장은 없으며, 이는 내부 송신 버퍼의 상태에 따라 결정된다.

연결을 종료할 때는 close() 메서드를 호출한다. 이 메서드는 선택적으로 닫기 코드와 이유를 설명하는 문자열을 인자로 받을 수 있으며, 웹소켓 프로토콜에 정의된 방법으로 정상적인 연결 종료 절차를 시작한다. 한번 닫힌 연결은 재사용할 수 없으며, 새로운 통신을 위해서는 새로운 WebSocket 객체를 생성해야 한다. 이러한 메서드들은 이벤트 핸들러와 함께 사용되어 실시간 통신 로직을 구성하는 기본 골격을 이룬다.