[Vert.x] 버텍스(Vert.x) 코드 분석 정리

verx.t란?  https://rebornbb.tistory.com/entry/JAVA-Vertx-%EC%97%90-%EB%8C%80%ED%95%9C-%EA%B8%B0%EC%B4%88-%EC%84%A4%EB%AA%85

[Vert.x] 버텍스(Vert.x)란?

 

Handler<T>

콜백 함수라고 하면 개발자라면 한 번씩은 들어 봤을 것이다.

말 그대로 어떤 작업이 완료되었을 때 특정 함수를 호출하도록 지정하는 것이다.
Vert.x에서는 이런 콜백을 핸들러라고 명칭하고 별도의 Interface를 제공한다. Handler<T> 인터페이스이다.

 

Vert.x 핸들러는 이벤트를 처리하는 데 사용되는 함수입니다.

핸들러는 이벤트가 발생할 때 호출되며, 이벤트에 대한 응답으로 코드를 실행하거나 다른 이벤트를 발생시킬 수 있습니다.

핸들러는 Handler 인터페이스를 구현합니다.

Handler 인터페이스에는 이벤트를 처리하는 데 사용되는 handle() 메서드가 있습니다.

handle() 메서드는 이벤트에 대한 응답으로 실행할 코드를 받습니다.

 

핸들러는 Vert.x 프레임워크의 다양한 곳에서 사용됩니다.

예를 들어, 핸들러는 HTTP 요청을 처리하거나, 이벤트 버스를 통해 이벤트를 전달하거나,

네트워크 연결을 관리하는 데 사용할 수 있습니다.

핸들러는 Vert.x 프레임워크를 사용하여 애플리케이션을 개발할 때 매우 유용한 도구입니다.

핸들러를 사용하면 이벤트를 쉽게 처리하고 애플리케이션을 더 효율적으로 만들 수 있습니다.

 

다음은 Vert.x 핸들러의 몇 가지 예입니다.

• HTTP 요청을 처리하는 핸들러:

public void handle(RoutingContext context) {
  // Do something with the HTTP request
}

• 이벤트 버스를 통해 이벤트를 전달하는 핸들러:

public void handle(AsyncResult<String> result) {
  // Do something with the result of the event
}

• 네트워크 연결을 관리하는 핸들러:

public void handle(Socket socket) {
  // Do something with the network connection
}

이러한 예는 Vert.x 핸들러의 몇 가지 예일 뿐입니다. 핸들러는 Vert.x 프레임워크의 다양한 곳에서 사용할 수 있습니다.

---

RoutingContext

Vert.x RoutingContext는 Vert.x 웹 애플리케이션에서 현재 요청-응답 주기를 나타내는 객체입니다.

헤더, 본문, 쿠키 및 매개변수와 같은 요청에 대한 모든 정보와 요청에 응답하는 방법에 대한 액세스를 제공합니다.

RoutingContext는 다양한 웹 애플리케이션 기능을 구현하는 데 사용할 수 있는 매우 강력한 도구입니다. 예를 들어 다음과 같이 사용할 수 있습니다.

• 요청 매개변수 확인
• 사용자 인증
• 동적 콘텐츠 생성
• 리디렉션 요청
• 클라이언트로 데이터 스트리밍
• 사용자 지정 HTTP 메서드 구현

RoutingContext는 Vert.x 웹 애플리케이션의 핵심 부분이며 Vert.x 웹 애플리케이션의 작동 방식을 이해하는 데 필수적입니다.

다음은 RoutingContext에서 가장 일반적으로 사용되는 메서드 중 일부입니다.

• getBody(): 요청 본문을 문자열로 반환합니다.
• getHeader(): 지정된 헤더의 값을 반환합니다.
• getParam(): 지정된 매개변수의 값을 반환합니다.
• setBody(): 응답 본문을 설정합니다.
• setHeader(): 지정된 헤더의 값을 설정합니다.
• setParam(): 지정된 매개변수의 값을 설정합니다.

RoutingContext는 또한 다음과 같이 요청에 응답하기 위한 여러 메서드를 제공합니다.

• response(): 응답 객체에 대한 참조를 반환합니다.
• end(): 요청-응답 주기를 종료하고 클라이언트에 응답을 보냅니다.
• next(): 다음 처리기로 요청-응답 주기를 계속합니다.
• fail(): 요청-응답 주기를 중단하는 예외를 throw합니다.

RoutingContext는 다양한 웹 애플리케이션 기능을 구현하는 데 사용할 수 있는 강력한 도구입니다. RoutingContext의 작동 방식을 이해하면 보다 강력하고 정교한 Vert.x 웹 애플리케이션을 작성할 수 있습니다.

---

router.route()

Vetx에서 router.route()는 HTTP 요청을 처리하는 데 사용되는 함수입니다.

이 함수는 경로와 핸들러를 인수로 사용합니다.

경로는 HTTP 요청의 URL을 나타내는 문자열입니다. 핸들러는 HTTP 요청을 처리하는 함수입니다.

router.route() 함수는 요청의 경로가 일치하는 경우 핸들러를 호출합니다.

예를 들어, 다음 코드는 /hello 경로에 대한 핸들러를 정의합니다.

router.route("/hello", (req, res) => {
  res.send("Hello, world!");
});

이 코드를 실행하면 /hello URL로 요청을 보내면 "Hello, world!" 메시지가 응답으로 반환됩니다.

router.route() 함수는 HTTP 요청을 처리하는 데 매우 유용한 함수입니다. 이 함수를 사용하면 HTTP 요청을 쉽게 처리하고 응답을 반환할 수 있습니다.

---

executeBlocking()

Vertx는 비동기 이벤트 기반 프레임워크입니다. Vertx는 non-blocking code를 실행할 때 executeBlocking() 메서드를 사용합니다. executeBlocking() 메서드는 비동기 코드를 실행하는 동안 Vertx의 이벤트 루프를 차단합니다.

이로 인해 비동기 코드가 완료될 때까지 다른 모든 코드가 실행되지 않습니다.

executeBlocking() 메서드는 다음과 같이 사용됩니다.

vertx.executeBlocking(future -> {
  // 비동기 코드를 실행합니다.
  future.complete("Hello, world!");
}, res -> {
  // 비동기 코드가 완료되면 실행되는 코드입니다.
  System.out.println(res.result());
});

위의 코드는 "Hello, world!"라는 문자열을 출력합니다.

executeBlocking() 메서드는 비동기 코드를 실행할 때 유용합니다. 비동기 코드는 이벤트 루프를 차단하지 않으므로 다른 코드가 동시에 실행될 수 있습니다. 그러나 executeBlocking() 메서드는 비동기 코드가 완료될 때까지

다른 모든 코드가 실행되지 않기 때문에 비동기 코드가 오래 걸릴 경우 사용하지 않는 것이 좋습니다.

 

future.complete() : 비동기코드 실행 결과

---

ws.frameHandler

Vert.x의 메서드 ws.frameHandler는 들어오고 나가는 WebSocket 프레임을 처리하는 데 사용됩니다.

WebSocket 프레임은 WebSocket 연결을 통해 정보를 전송하는 데 사용되는 데이터 단위입니다.

프레임은 텍스트, 이진 데이터 및 제어 메시지를 보내는 데 사용할 수 있습니다.

이 ws.frameHandler메서드는 각 수신 또는 발신 프레임에 대해 호출되는 함수인 단일 인수를 사용합니다.

함수에는 두 개의 인수가 있습니다. 첫 번째 인수는 프레임이고 두 번째 인수는 프레임이 들어오는지 또는

나가는지 나타내는 boolean 값입니다.

다음 코드는 메서드를 사용하여 ws.frameHandler수신 및 발신 프레임을 처리하는 방법을 보여줍니다.

ws.frameHandler(frame -> {
  if (frame.isIncoming()) {
    // This is an incoming frame
  } else {
    // This is an outgoing frame
  }
});

ws.frameHandler다음은 방법을 사용할 수 있는 방법 에 대한 몇 가지 예입니다 .

• frame.textData()들어오는 텍스트 프레임을 처리하기 위해 메서드를 사용하여 프레임에서 전송된 텍스트 데이터를 가져올 수 있습니다 .
• frame.binaryData()들어오는 바이너리 프레임을 처리하기 위해 메서드를 사용하여 프레임에서 전송된 바이너리 데이터를 가져올 수 있습니다 .
• frame.opcode()제어 프레임을 처리하기 위해 메서드를 사용하여 프레임의 opcode를 가져올 수 있습니다. opcode는 제어 프레임의 유형을 알려줍니다.
• 텍스트 프레임을 보내려면 이 ws.writeTextFrame()방법을 사용할 수 있습니다.
• 이진 프레임을 보내려면 ws.writeBinaryFrame()방법을 사용할 수 있습니다.
• WebSocket 연결을 닫으려면 이 ws.close()방법을 사용할 수 있습니다.

이 ws.frameHandler메서드는 다양한 WebSocket 애플리케이션을 구현하는 데 사용할 수 있는 강력한 도구입니다.

---

@SuppressWarnings

@SuppressWarnings 주석은 컴파일러 경고를 억제하는 데 사용됩니다.

클래스, 메서드 또는 필드에서 사용할 수 있습니다. 주석은 쉼표로 구분된 경고 이름 목록인 단일 인수를 사용합니다.

예를 들어 다음 코드는 "확인되지 않음" 경고를 표시하지 않는 방법을 보여줍니다.

@SuppressWarnings("unchecked")
public void foo() {
  // This method will not generate a "unchecked" warning
}

@SuppressWarnings 주석을 사용하여 다양한 경고를 억제할 수 있습니다. 전체 경고 목록은 Java 언어 사양을 참조하십시오.

억제할 수 있는 가장 일반적인 경고는 다음과 같습니다.

• unchecked: 메서드가 checked 형식으로 선언되지 않은 제네릭 형식 매개 변수를 사용할 때 이 경고가 생성됩니다.
• rawtypes: 이 경고는 메서드가 일반 형식 매개 변수를 지정하지 않는 형식인 원시 형식을 사용할 때 생성됩니다.
• fallthrough: 이 경고는 switch 문에 기본 레이블이 있고 깨지지 않는 case 레이블이 있을 때 생성됩니다.
• 미사용: 이 경고는 변수가 선언되었지만 사용되지 않은 경우 생성됩니다.

@SuppressWarnings 주석은 컴파일러 경고를 억제하는 데 유용한 도구가 될 수 있습니다. 그러나 신중하게 사용하는 것이 중요합니다. 중요한 경고를 표시하지 않으면 코드에 오류가 발생할 수 있습니다.

다음은 @SuppressWarnings 주석 사용에 대한 몇 가지 팁입니다.

• 억제해도 안전하다고 알고 있는 경고만 억제하십시오.
• 경고를 억제해도 안전한지 확실하지 않은 경우 경험이 많은 개발자에게 도움을 요청하십시오.
• @SuppressWarnings 주석의 모든 사용을 문서화하십시오. 이렇게 하면 귀하와 다른 개발자가 경고가 표시되지 않는 이유를 이해하는 데 도움이 됩니다.