2016년 5월 25일 수요일

Vert.x 3.0.0 시작해보기...(3)

제가 요즘 요긴하게 써먹고 있는 Vert.x 을 소개하고자 합니다. 폴리글랏이긴 한데, 저는 Java 만을 사용해서 개발하고 있습니다. 그래서 Java 코드만 올리겠습니다.

장문의 글을 올리기 보다는, 바로 어떤 결과가 나오는 짧은 팁만 올리고, 댓글로 보충 내용을 올리는 쪽으로 해보겠습니다. 방송 형태가 적합하겠지만, 할 줄을 몰라서...(컴맹입니다)

------------------------------------------------------------------------------------------------------

사실 꽤나 글을 새로 못올리고 있었는데, 찾는 분이 없는걸 보니...재미 없기만 한 내용인건 사실인가 봅니다. 그래도 칼을 빼들었으니...5회 정도까지는 글을 적어볼까 합니다.

이번에는, 드디어 Vert.x 의 꽃이라고 할 수 있는 EventBus 를 다뤄볼까 합니다.



EventBus 을 가장 쉽게 이해할 수 있는 방법은...Vert.x 을 위한 비동기 Method...정도로 정의를 내릴 수 있겠네요. 실제 Method 처럼 선언을 하고 사용을 합니다. 단지...좀 사용상의 제약이 있고 비동기로 처리를 한다는 정도의 차이가 있겠네요.

백문이 불여일타...코드를 보면서 설명을 드리겠습니다.

EventBus eventBus = vertx.eventBus();

eventBus.consumer("Test.Login", (Message<JsonObject> message) -> {

 JsonObject param = message.body();

 System.out.println(param.getString("METHOD") + " Start!!!");

 message.reply(param.getString("METHOD") + " End");

});

먼저 EventBus 을 사용하기 위해서는 vertx 개체로부터 eventBus() 을 이용해 개체를 얻어와야 합니다. 그리고 Method 선언과 마찬가지의 작업인 consumer() 을 통해 하나의 EventBus 을 등록하게 됩니다.
첫번째 매개변수는 Method 의 이름과 같은...이름, 그리고 다음 매개변수는 실제 코드 부분입니다. Message 개체 안에 매개변수를 하나의 Bean 처럼 담아서 가져올 수 있는데, 하나의 개체만 받아올 수 있기 때문에 보통 JsonObject 에 필요한 정보를 입력해서 보냅니다. 이렇게 받아온 Message 개체는 body() 을 이용해서 실제 값을 받아올 수 있습니다.

그리고 return 대신에 Message 개체의 reply() 을 통해 호출한 쪽에 결과를 전송할 수 있습니다.



그럼 이번에는 실제 호출 부분을 보겠습니다.

eventBus.send("Test." + method, param, (AsyncResult<Message<String>> result) -> {

 if (result.succeeded()) {

  String returnValue = result.result().body();

  request.response().putHeader("content-type", "application/json");
  request.response().end("{\"METHOD\": \"" + method + "\", \"RESULT\": \"" + returnValue + "\"}");

 } else {

  request.response().putHeader("content-type", "application/json");
  request.response().end("{\"METHOD\": \"" + method + "\", \"ERROR\": \"" + result.cause().getMessage() + "\"}");
  result.cause().printStackTrace();

 }

});

예전 코드에서 조금 확장을 해봤는데, 저는 주로 호출된 URL 을 이용해서 consumer() 로 선언된 EventBus 을 자동으로 호출하고, 결과를 분기해서 처리하는 방법으로 개발합니다. 생각하지 않고 그냥 이렇게 만들어두는게 개인적으로는 편하더군요.

위의 코드들이 모두 적용된 소스는 아래 깃헙에 올라가 있습니다.

이 코드를 실행해 보시면, http://localhost:8080/Login  와 같이 호출을 할 경우 Test.Login 을 호출해서 콘솔에 메세지를 출력하고, 사용자의 브라우저에는 METHOD 와 RESULT 키가 포함된 JSON 구문이 출력될 것입니다. 물론 METHOD 부분의 글자를 조금 바꿔서 보내면...RESULT 대신에 ERROR 가 포함된 JSON 구문이 출력될 것입니다. 아쉽게도 에러 메세지는 부정확하거나 null 이 포함되어 있을 확률이 큽니다. 아직 Vert.x 의 라이브러리의 완성도가 높은 편은 아니거든요. (그렇다고 실제 서비스에 사용하지 못할 정도의 버그가 있는 건 아닙니다. 완성도가 좀 낮을 뿐...)

다음으로 아래 예제를 통해 node.js 와 마찬가지로 Vert.x 가 가지는 특징을 알아볼 수 있습니다.

Sleep 이라는 METHOD 가 추가되었는데, 실제 두 개의 브라우저를 실행한 뒤, Sleep 을 연달아 각각 호출해보면, 첫 Sleep 의 응답이 10 초 걸릴 동안, 두번째 Sleep 의 호출이 10 + a 초가 걸린다는 것을 알 수 있을 겁니다. a 초는 첫번째 호출 후 두번째 호출을 누를 때까지의 시간을 10초에서 뺀 시간입니다. 같은 EventBus 는 하나의 처리가 끝날 때까지 다음 처리를 기다려야 한다는 조건이 있기 때문입니다. 그리고, 비동기 처리에 익숙하지 않은 분을 위한 또 하나의 팁. 86 라인의 "Send End!!!" 는 첫번째 호출 시 즉시 출력이 됩니다. EventBus 을 호출한 뒤 결과 반환을 기다리지 않고 바로 다음 문장을 실행하는 비동기 프로그래밍의 전형적인 특징입니다. 역시나 node.js 나 javascript 의 callback 등을 많이 다뤄본 분들이라면 너무나 당연한 내용을 것입니다.

문제는 이 파일에서 Sleep 을 실행한 뒤 Login 을 실행해보면, 의도와 다르게 Sleep 을 두 번 실행했을 때와 마찬가지로 앞의 Sleep 이 끝나기 전까지 Login 이 처리되지 않는 것을 알 수 있습니다.

이를 해결하기 위해서는 Verticle 이라는 것을 쪼개서 처리해야 합니다. Test3_2.java 역시 하나의 Verticle 이기 때문에 이를 나누는 것이죠.

Test3_3.java 파일이 기본 파일이고, Test3_4.java, Test3_5.java 파일은 일종의 include 된 파일이라고 생각하셔도 좋습니다. 단지 include 을 하는 것과 달리 별도의 Verticle 로 돌아가기 때문에 Thread 을 쓰는 것과 같은 효과를 볼 수 있습니다.
Test3_3.java 에서 다른 두 파일을 선언하는 것을 Deploy 라고 하고, vertx.deployVerticle() 로 작업을 수행할 수 있습니다.

vertx.deployVerticle("Test3_4.java");

vertx.deployVerticle("Test3_5.java");

그리고 Method 선언과 동일하다고 말씀드린 .consumer() 을 각 파일로 이동시키는 것입니다.

그리고 vertx run Test3_3.java 을 실행한 뒤 Sleep 을 실행한 뒤 바로 Login 을 실행하면 Sleep 와 상관없이 Login 이 바로 실행되는 것을 알 수 있습니다.



그런데, Sleep 을 실행해보면 이상한 메세지들이 출력되는 것을 보실 수 있습니다. 대충 내용을 봐도 뭔가 시간이 오래 걸린다고 불평을 하는 것이라는 걸 알 수 있습니다. Vert.x 의 EventBus 는 하나의 처리에 1 초가 넘어가게 될 경우 메세지가 콘솔로 출력됩니다. 이렇게 장시간의 처리가 필요한 것은 적합하지 않기 때문에 개선을 하라는 의미입니다. 하지만, 또다른 방법으로 오랜 시간이 걸리는 작업은 EventBus 가 아닌 별도로 준비된 Worker Verticle 을 이용해서 처리하면 메세지 출력 없이 처리가 됩니다.

이를 위해 vertx.deployVerticle() 시 두번째 매개변수로 DeploymentOptions 개체를 통해 옵션값을 지정해줘야 합니다.

DeploymentOptions options = new DeploymentOptions().setWorker(true);
vertx.deployVerticle("Test3_5.java", options);


그리고, 하나의 Verticle 은 하나의 Instance 만 생성해서 처리하기 때문에 위의 예제에서는 Sleep 이 하나가 처리되기 전까지 다음 Sleep 은 앞의 Sleep 이 끝날 때까지 기다려야 하는 문제가 발생합니다. node.js 는 이를 여러개를 직접 실행하는 방법으로 약간은 무식(?)하게 해결하곤 하는데, Vert.x 에서는 그냥 Instance 수를 여러개 지정해서 띄워버리면 동시 처리개수를 늘려버릴 수 있습니다. 이는 JVM 을 사용하기 때문에 가질 수 있는 이점이기도 합니다

DeploymentOptions options = new DeploymentOptions().setWorker(true).setInstances(2);
vertx.deployVerticle("Test3_5.java", options);


이번에는 Vert.x 의 핵심이라 볼 수 있는 EventBus 의 기본적인 사용법과 간단한 특성을 잠깐 살펴봤습니다. 저번 글을 적고 난 뒤에 코드가 좀 길어질 것 같고 실수하는게 많아져서 아예 깃헙에 코드를 올리는 쪽으로 생각을 바꿨습니다. 설명이 자세하지 않더라도 소스를 실행해보시면 크게 어렵지는 않으실 겁니다. 질문 사항이 있으시면 언제든지 댓글로 올려주십시오.

오늘은 여기까지...





이 글은 제 개인 블로그(http://zepinos.blogspot.kr)와 okky(http://okky.kr)에만 공개되는 글입니다. 퍼 가는 것은 금해주시고, 링크로 대신해주시기 바랍니다. 당연히 상업적 용도로 이용하시면...저랑 경찰서에서 정모하셔야 합니다. ^^;;;

위에 작성한 코드 등은 실제 컴파일한 것이 아니라 제가 글을 적으면서 키보드 코딩(?...손 코딩의 친구) 한 것이므로, 오류가 있다면 저에게 알려주시면 고맙겠습니다.

Vert.x 3.0.0 시작해보기...(2)

제가 요즘 요긴하게 써먹고 있는 Vert.x 을 소개하고자 합니다. 폴리글랏이긴 한데, 저는 Java 만을 사용해서 개발하고 있습니다. 그래서 Java 코드만 올리겠습니다.

장문의 글을 올리기 보다는, 바로 어떤 결과가 나오는 짧은 팁만 올리고, 댓글로 보충 내용을 올리는 쪽으로 해보겠습니다. 방송 형태가 적합하겠지만, 할 줄을 몰라서...(컴맹입니다)

------------------------------------------------------------------------------------------------------

이전 글에서 vertx.createHttpServer() 을 이용해서 웹서버를 바로 띄울 수 있다고 알려드렸습니다. 그냥 서버만 뜹니다. 아무런 동작도 하지 않구요. 이번에는 사용자가 요청한 URL 에 따라 동작하도록 한 번 만들어보겠습니다.

먼저 vertx.createHttpServer() 에 옵션을 추가하는 방법입니다.

HttpServerOptions httpServerOptions = new HttpServerOptions();
// httpServerOptions.setAcceptBacklog(10000);
// httpServerOptions.setSendBufferSize(4 * 1024);
// httpServerOptions.setReceiveBufferSize(4 * 1024);
httpServerOptions.setCompressionSupported(true);

vertx.createHttpServer(httpServerOptions)
   .listen(8080);

HttpServerOptions 라는 개체를 통해 옵션을 지정해줄 수 있습니다. 저는 보통 compressionSupported 옵션만을 이용합니다. json 을 결과를 넘겨줄 때 많은 양의 정보를 보내줄 경우 유용합니다. 게임의 기본 데이터를 시작할 때 보내는 경우 몇 메가의 텍스트 데이터를 보내야 하는데, 압축을 하게 되면 1/10 정도까지 용량을 줄여줍니다.

이번에는 사용자의 요청 URI 에 따라서 분기를 하는 방법입니다.

Router router = Router.router(vertx);
Route route = router.route("/:METHOD");

route.handler(routingContext -> {

 HttpServerRequest request = routingContext.request();
 MultiMap params = request.params();

 String method = params.get("METHOD");
 System.out.println(method);

 request.endHandler(empty -> {

  JsonObject param = new JsonObject();
  params.forEach(entry -> param.put(entry.getKey(), entry.getValue()));

 });

});

HttpServerOptions httpServerOptions = new HttpServerOptions();
httpServerOptions.setCompressionSupported(true);

vertx.createHttpServer(httpServerOptions)
  .requestHandler(router::accept)
  .listen(8080);

사용자의 요청 주소를 Router 을 이용해서 일일이 처리하지 않고 URI 의 값에 따라서 분기해서 처리할 수 있도록 만들 수 있습니다. 위에서 /:METHOD 라고 지정되어 있는데 / 뒤에 어떤 주소를 가지느냐에 따라 매개변수 정보에 METHOD 라는 변수에 이 값을 넣어주는 것입니다. Spring MVC 에서도 REST API 에서 비슷한 기능을 보셨을 겁니다.

그래서 위의 문장을 추가한 뒤 vertx run 으로 실행해주면, 이번에는 http://localhost:8080/Login  이나 http://localhost:8080/Index  와 같은 주소 요청에 따라 화면에 Login 이나 Index 가 출력될 것입니다. 물론 아직 return 에 대해서 처리를 하지 않았기 때문에 서버를 실행한 쪽에서 콘솔 출력으로 이 값이 출력되고, 브라우져는 응답을 멍하니 기다리기만 하는 상태이지만요. http://localhost:8080/Login?val1=test1&val2=test2  와 같은 요청도 한 번 해보세요.

눈여겨 보실 점은 모든 매개변수는 MultiMap 형태로 사용자에게 제공된다는 것입니다. 그걸 아래에서 JsonObject 형태로 옮겨 담고 있습니다.(params.forEach() 보이시나요?)

다음에 배울 EventBus 는 vert.x 와 함께 제공되는 JsonObject 나 JsonArray 혹은 자바의 기본 자료형(int, long 등)과 String 등만 전송할 수 있습니다. 그래서 주로 사용하게 될 개체가 바로 JsonObject 가 되겠습니다.

마지막으로, 코드를 좀 더 확장해서 브라우저에 응답을 보내는 것을 해보겠습니다.

Router router = Router.router(vertx);
Route route = router.route("/:METHOD");

route.handler(routingContext -> {

 HttpServerRequest request = routingContext.request();
 MultiMap params = request.params();

 String method = params.get("METHOD");
 System.out.println(method);

 request.endHandler(empty -> {

  JsonObject param = new JsonObject();
  params.forEach(entry -> param.put(entry.getKey(), entry.getValue()));

  request.response().putHeader("content-type", "application/json");
  request.response().end("{\"METHOD\": \"" + method + "\"}");

 });

});

HttpServerOptions httpServerOptions = new HttpServerOptions();
httpServerOptions.setCompressionSupported(true);

vertx.createHttpServer(httpServerOptions)
  .requestHandler(router::accept)
  .listen(8080);

요청 결과를 보내기 위해 HttpServerResponse 개체를 request 에서 얻어올 수 있습니다. 그리고 헤더 정보와 결과 문장을 보내고 연결을 종료합니다. request.response().end() 로 말이죠. 그럼 이 응답에 대한 처리는 끝납니다. 이렇게 연결을 종료하기 전에는 새로운 연결을 받지 못합니다. WAS 처럼 쓰레드를 여러개 생성한 뒤 병렬로 처리하는게 아니라 한 번에 하나씩만 처리하기 때문이죠. 이 부분을 잊지 마세요.

오늘은 여기까지...





이 글은 제 개인 블로그(http://zepinos.blogspot.kr)와 okky(http://okky.kr)에만 공개되는 글입니다. 퍼 가는 것은 금해주시고, 링크로 대신해주시기 바랍니다. 당연히 상업적 용도로 이용하시면...저랑 경찰서에서 정모하셔야 합니다. ^^;;;

위에 작성한 코드 등은 실제 컴파일한 것이 아니라 제가 글을 적으면서 키보드 코딩(?...손 코딩의 친구) 한 것이므로, 오류가 있다면 저에게 알려주시면 고맙겠습니다.

Vert.x 3.0.0 시작해보기...(1)

제가 요즘 요긴하게 써먹고 있는 Vert.x 을 소개하고자 합니다. 폴리글랏이긴 한데, 저는 Java 만을 사용해서 개발하고 있습니다. 그래서 Java 코드만 올리겠습니다.

장문의 글을 올리기 보다는, 바로 어떤 결과가 나오는 짧은 팁만 올리고, 댓글로 보충 내용을 올리는 쪽으로 해보겠습니다. 방송 형태가 적합하겠지만, 할 줄을 몰라서...(컴맹입니다)

------------------------------------------------------------------------------------------------------

Vert.x 는 현재 3.0.0 까지 나온 node.js 에 영감을 받아 개발된 툴킷입니다. http://vertx.io  가 공식 웹사이트이고, 구글 그룹스를 운영하고 있으며, 질문 등은 구글 그룹스에만 올리길 권고하고 있습니다. 하지만, 저 같은 영어포기자들은 안구에 습기가...T.T

웹사이트에서도 "Vert.x is a tool-kit for building reactive applications on the JVM." 라고 소개를 하고 있습니다. JVM 기반에서 돌아가기 때문에 기본은 Java 라고 생각하시면 되고, JVM 을 이용하기 때문에 멀티 쓰레드 지원을 별도로 고려할 필요가 없다는 장점이 있습니다. 또한 JVM 의 GC 을 이용하기 때문에 node.js 의 Javascript 엔진보다는 훨씬 더 효율성이 높고 Azul Systems 의 Zing 와 같은 JVM 을 구입하여 운영할 경우 더욱 성능이 올라가는 장점도 있습니다.

설치는 매우 쉽습니다. 공식 사이트에서 최신 버전의 zip 파일이나 tar.gz 파일을 내려받아 압축을 풀어주면 됩니다. bin 디렉토리에 vertx 나 vertx.bat 파일을 이용해서 개발한 소스를 실행할 수 있습니다. 또는, embeded 형태로 개발하면 기존의 실행형 파일에 기능을 내장할 수도 있고, 웹프로그램 안에도 내장할 수 있습니다. 대신, embeded 형태는 vert.x 의 cluster 기능을 이용하지 못한다거나, 사용할 수 있는 언어가 Java 와 Groovy 정도만 지원됩니다.


설치 후 VERTX_HOME 와 VERTX_OPTS 등을 환경변수에 추가해줄 수 있습니다. bin 디렉토리 역시 PATH 에 추가해두면 실행 시 편하겠죠. VERTX_OPTS 에는 -Dfile.encoding=UTF-8 을 추가해두는 게 좋습니다. 소스 파일 내에 한글을 쓸 경우 이 옵션이 빠졌을 때 컴파일 오류가 발생하거나(vertx 명령어로 실행할 때 컴파일을 합니다. class 파일을 가지고 하는게 아닙니다) 콘솔로 메세지를 출력할 때 메세지가 제대로 안보일 수 있습니다.

앞으로의 팁은 embeded 는 배제하고 vertx 명령을 통해 실행하는 방법만 소개합니다. JDK 는 8 버전을 이용합니다. 왜냐하면, 소스 코드가 짧아지거든요.

먼저 소스 코드를 아래와 같이 작성해봅니다.

import io.vertx.core.AbstractVerticle;

public class Test1 extends AbstractVerticle {

 @Override
 public void start() throws Exception {

  super.start();

  vertx.createHttpServer()
    .requestHandler(httpServerRequest -> {})
    .listen(8080);

 }

 @Override
 public void stop() throws Exception {

 }

}

HTTP 서버를 띄웠습니다. node.js 을 해보신 분들은 금새 아실 내용이겠네요.

그리고 Test1.java 로 저장한 뒤, Test1.java 이 있는 곳으로 이동한 뒤...

vertx run Test1.java

라고 해봅니다.

서버 실행됐습니다! 물론 아무런 동작은 안하지만, netstat -na 등의 명령으로 포트를 확인해보시면 서버가 떴음을 알 수 있습니다.
종료는 Ctrl+C 로 그냥 꺼버리시면 됩니다.

오늘은 여기까지...


이 글은 제 개인 블로그(http://zepinos.blogspot.kr)와 okky(http://okky.kr)에만 공개되는 글입니다. 퍼 가는 것은 금해주시고, 링크로 대신해주시기 바랍니다. 당연히 상업적 용도로 이용하시면...저랑 경찰서에서 정모하셔야 합니다. ^^;;;

위에 작성한 코드 등은 실제 컴파일한 것이 아니라 제가 글을 적으면서 키보드 코딩(?...손 코딩의 친구) 한 것이므로, 오류가 있다면 저에게 알려주시면 고맙겠습니다.