화분

[WebSocket] WebSocketHandler 번역 본문

Study/Spring Framework

[WebSocket] WebSocketHandler 번역

ExcellEast 2024. 1. 21. 09:54

WebSocketHandler란?
 웹소켓 메시지와 수명 주기 이벤트를 위한 핸들러입니다.
 
 이 인터페이스의 구현은 예외를 로컬에서 처리하는 것이 좋습니다.
 예외를 로컬에서 처리하는 것이 좋으며, 그렇지 않은 경우 기본적으로 예외를 버블 처리합니다.
 예외가 기록되고 세션이 다음과 같이 닫힙니다. SERVER_ERROR(1011)
 전략은 다음과 같이 제공됩니다. ExceptionWebSocketHandlerDecorator
 ExceptionWebSocketHandlerDecorator에 의해 제공되며, 사용자 정의하거나 다음을 장식하여 대체할 수 있습니다.
 다른 데코레이터로 웹소켓 핸들러를 장식하여 사용자 정의하거나 대체할 수 있습니다.


public interface WebSocketHandler {

/**
 * 웹소켓 협상이 성공하고 웹소켓 연결이
 * 열리고 사용할 준비가 되었을 때 호출됩니다.
 * 이 메서드는 예외를 처리하거나 전파할 수 있습니다.
 * 자바독을 참조하십시오.
 */
void afterConnectionEstablished(WebSocketSession session) throw Exception;

/**
 * 새로운 WebSocket 메시지가 도착하면 호출됩니다.
 * 이 메서드는 예외를 처리하거나 전파할 수 있습니다; 자세한 내용은 클래스 레벨을 참조하세요.
 * 자바독을 참조하세요.
 */
void handleMessage(WebSocketSession 세션, WebSocketMessage<?> 메시지) throws Exception;

/**
 * 하부 WebSocket 메시지 전송의 에러를 처리합니다.
 * 이 메서드는 예외를 처리하거나 전파할 수 있습니다; 클래스 레벨을 참조하십시오.
 * 자바독을 참조하십시오.
 */
void handleTransportError(WebSocketSession 세션, Throw 가능 예외) throw Exception;

/**
 * 웹 소켓 연결이 어느 쪽에서든 닫힌 후, 또는
 * 전송 에러가 발생한 후에 호출됩니다. 기술적으로는 세션이 여전히 열려 있을 수 있지만,
 * 기본 구현에 따라, 이 시점에서 메시지를 보내는 것은
 * 성공하지 못할 가능성이 높습니다.
 * 이 메서드는 예외를 처리하거나 전파할 수 있습니다(자세한 내용은 클래스 수준 참조).
 * 자바독을 참조하세요.
 */
void afterConnectionClosed(WebSocketSession 세션, CloseStatus closeStatus) throws Exception;

/**
 * WebSocketHandler가 부분 메시지를 처리할지 여부입니다. 이 플래그가
 * {@코드 참}으로 설정되어 있고 하부 WebSocket 서버가 부분 메시지를 지원한다면,
 * 큰 웹소켓 메시지나 알 수 없는 크기의 메시지를 분할하여
 * 여러 번의 호출을 통해 수신될 수 있습니다.
 * {@link #handleMessage(WebSocketSession, WebSocketMessage)}. 플래그
 * {@link org.springframework.web.socket.WebSocketMessage#isLast()}는 다음과 같은 경우를 나타냅니다.
 * 메시지가 부분적인지, 마지막 부분인지 여부를 나타냅니다.
 */
부울 supportsPartialMessages();

}

Translated with DeepL.com (free version)