[java] Tomcat의 WebSockets 지원과 실시간 통신 기능

28 Nov 2023

java

소개

WebSockets는 HTML5 표준으로, 실시간 통신 기능을 제공하는 프로토콜입니다. 이를 통해 서버와 클라이언트 간에 양방향 통신이 가능해지며, 실시간 애플리케이션에서 매우 유용하게 사용됩니다. 이번 글에서는 Apache Tomcat의 WebSockets 지원 기능에 대해 알아보겠습니다.

Tomcat의 WebSockets 지원 설정

Tomcat은 버전 7 이후부터 WebSockets를 지원합니다. WebSockets를 사용하기 위해서는 다음과 같은 설정이 필요합니다.

server.xml 파일의 <Connector> 요소에 다음과 같은 속성을 추가합니다. ```xml

2. `web.xml` 파일에 다음과 같은 설정을 추가합니다.
```xml
<filter>
    <filter-name>httpUpgradeFilter</filter-name>
    <filter-class>org.apache.catalina.filters.HttpUpgradeFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>httpUpgradeFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

위의 설정을 통해 Tomcat은 WebSockets 프로토콜을 사용할 수 있게 됩니다.

Tomcat에서의 WebSockets 사용

Tomcat에서 WebSockets를 사용하기 위해서는 다음과 같은 절차를 따르면 됩니다.

웹 애플리케이션 프로젝트를 생성하고, WebSocketServlet을 상속받은 클래스를 작성합니다. ```java import javax.websocket.*; import java.io.IOException;

@javax.websocket.server.ServerEndpoint(“/ws”) public class MyWebSocketEndpoint {

@OnOpen
public void onOpen(Session session) {
    // 클라이언트가 접속했을 때 호출되는 메서드
}
  
@OnMessage
public void onMessage(String message, Session session) {
    // 클라이언트로부터 메시지를 받았을 때 호출되는 메서드
}
  
@OnClose
public void onClose(Session session) {
    // 클라이언트가 접속을 종료했을 때 호출되는 메서드
}

@OnError
public void onError(Session session, Throwable error) {
    // 에러가 발생했을 때 호출되는 메서드
}

}

2. 위에서 작성한 클래스를 웹 애플리케이션에 등록합니다. `web.xml` 파일에 다음과 같이 등록합니다.
```xml
<websocket-endpoint>
    <endpoint-class>com.example.MyWebSocketEndpoint</endpoint-class>
    <endpoint-name>MyWebSocketEndpoint</endpoint-name>
</websocket-endpoint>

클라이언트에서 WebSocket 연결을 설정합니다.

var socket = new WebSocket("ws://localhost:8080/ws");
socket.onopen = function() {
 // 서버에 연결되었을 때 호출되는 함수
};
socket.onmessage = function(event) {
 // 서버로부터 메시지를 받았을 때 호출되는 함수
};
socket.onclose = function() {
 // 서버와의 연결이 종료되었을 때 호출되는 함수
};
socket.send("Hello"); // 서버로 메시지 전송

위의 절차를 따르면 Tomcat에서 WebSockets를 사용할 수 있게 됩니다.

결론

Tomcat은 WebSockets를 통한 실시간 통신을 지원하며, 위에서 소개한 설정을 통해 쉽게 사용할 수 있습니다. WebSockets는 실시간 애플리케이션을 개발할 때 매우 유용한 프로토콜이므로, 애플리케이션 개발에 활용해 보시기 바랍니다.

References: