WebSocket (개발자 관점)
전이중 장기 접속입니다. HTTP의 '한 번 보내고 한 번 받기'와 달리, WS는 먼저 연결을 수립한 뒤 언제든 프레임을 주고받고, 마지막에 닫습니다.
UI에서의 사용법
- WebSocket 요청을 만듭니다: URL은 완전한 주소를 받습니다(
ws://…/ws/echo또는wss://…/path). 핸드셰이크 헤더는 요청 헤더에 넣습니다. - 연결을 탭해 세션을 수립합니다.
- 세션에서 입력하고 전송합니다. 수신 프레임은 실시간으로 표시됩니다.
- 끝나면 세션을 닫습니다(세션에는 쿼터가 있고, 아이들 세션은 자동 회수됩니다).
평문 vs 암호화
ws://는 평문,wss://는 TLS입니다.- 환경의 WS Pre-URL을 거친다면, 그 베이스 주소는 반드시
ws:///wss://로 작성해야 합니다 —https://는 HTTP로 취급됩니다(concepts 참조).
검증된 동작
텍스트 프레임은 UTF-8 무손상으로 왕복합니다(hello-ws-世界 송수신 동일). /ws/headers는 핸드셰이크 때 보낸 헤더를 에코로 돌려주므로 적용 확인이 쉽습니다. 서브프로토콜·압축·하트비트는 자동화 테스트 케이스가 커버합니다.
주의 사항
- 에코가 수신되지 않음: 서버가 실제로 응답하는지 확인하세요. 장기 접속에서 '전송'은 내보내기만 합니다 — 응답은 나중에 수신 프레임으로 도착합니다.
- 보내지 않고 관찰만 하고 싶을 때: 연결 후 들어오는 프레임을 볼 수 있습니다(예: 서버 푸시).
- 세션 쿼터는 제한적이고, 아이들 세션은 약 5분 후 닫힙니다. 배치로 디버깅할 때는 오래된 세션을 즉시 닫으세요.
관련: 연결/전송 UI 설정은 concepts.