[vert.x] Hello Vert.x Module

Vert.x는 Verticle이라는 클래스를 상속한 .Java 파일을 실행할 수도 있고 프로젝트를 모듈화한 모듈을 실행할 수도 있습니다.

http://vertx.io/manual.html#interacting-with-vertx

자세한 내용은 위 링크를 참조하시구요. .java를 실행하는 예제는 쉽기 때문에 별다른 설명은 필요없을 것 같고, 저는 모듈을 실행하는 방법을 설명하겠습니다.

그러려면 모듈 프로젝트를 만들어야 하는게 이게 좀 일이죠. 그래서 제가 기본 골격을 만들어 두었습니다.

https://github.com/keesun/mod-sample

이 프로젝트를 받아서 각자 자신의 모듈을 만드실 때 사용하시면 됩니다.

git clone git://github.com/keesun/mod-sample.git

Git 지우기

받으신 다음에 mod-sample 디렉토리로 이동해서 .git/ 디렉토리를 지워주시면 깔끔합니다. 요즘은 svn도 이렇게 한곳에만 파일을 둔다는데 이전에는 굉장히 지져분하게 디렉토리별로 .svn이 생겼었죠. 그래서 그걸 전부 지우는 스크립트도 사용하고 그랬었는데.. git은 안그래도 됩니다.

빌드하기

빌드툴은 gradle을 사용합니다. 이유는 잘 모르겠고, 아마 스프링소스에서 그루비를 밀어주려고 그래들을 사용하는게 아닐까 싶기도 하고 메이븐이 너무 복잡하니까 그래들을 사용하는 것 같기도 하고 여러가지 추정은 가지만 뭐.. 팀 폭스가 그래들을 쓰니깐.. 저도 그래들.

유닉스/리눅스 계열 유저는 ./mk 를 사용하시면 되고 윈도 유저는 ./wmk를 사용하시면 됩니다.

./mk tasks라고 입력하신 다음에 커피를 한잔 드세요. 처음 빌드 하신 분들은 인터넷과 컴터 사양에 따라 대략 10분 ~ 15분 정도 걸립니다.

사용하는 IDE 파일 생성하기

이클립스나 IDEA 유저가 대부분일텐데요. 그러한 IDE 관련 파일은 절대로 버전 관리에 넣으시면 안 되는거 아시죠? 그거 개인 마다 다 달라지는 파일이라서 보통 버전 관리에 넣지 않아요. 그거 넣으면 뭔가... 이 사람 협업을 많이 안 해 봤나... 아님 초본가... 하는 생각이 드니까 조심하시기 바랍니다.

그래서 보통 로컬에서 생성해서 사용합니다. 그걸 직접할리는 없고 그래들 빌드를 돌리면 생성됩니다.

IDEA 유저는 ./mk idea 이클립스 유저는 ./mk eclipse 라고 하면 IDE 관련 파일들이 생겨서 IDE에서 프로젝트를 열거나 import 하실 수 있습니다.

IDE로 보면 대략 이런 모습인데요. 여기서 중요한 파일이 src/main/mod.json입니다. 이 파일이 모듈 설정 파일인데, 저도 정확히 어떤 속성들이 존재하는지 모르겠습니다.

아마도 Vert.x 코드를 까보면 보일텐데;; 제가 지금 아는 수준은 매뉴얼에서 설정하는 수준 뿐입니다.

http://vertx.io/mods_manual.html

모듈을 크게 둘로 나눠서 실행 가능한 모듈(실행 모듈)과 그렇지 않은 모듈(비실행 모듈)이 있는데 지금 제가 샘플로 제공하는 것은 실행 가능한 모듈입니다. 물론 이걸 조금 수정해서 비실행 모듈로 만들 수도 있습니다. 구분은 main이라는 속성으로 합니다.

{
"main": "me.whiteship.HelloVertxModule"
}

지금 mod.json을 보면 이렇게 main 이라는 속성에 Verticle을 상속받은 클래스 전체 경로를 적어둔 것을 볼 수 있습니다.

[gist id=3488388]

Verticle을 상속받으면 start()라는 메서드를 구현해야 하는데 위와 같이 구현하면 아주 단순한 웹 서버를 만들 수 있습니다.

모듈 만들기

이제 다시 콘솔로 이동해서 이 프로젝트를 모듈로 빌드해보죠.

./mk clean dist

./mk dist라고만 해도 될듯한데 그냥 깨끗하게 빌드 하려고 저는 ./mk clean으로 빌드 디렉토리 다 지운담에 다시 dist로 빌드 하도록 ./mk clean dist를 주로 씁니다.

빌드가 되면 프로젝트홈/build/mod 라는 디렉토리에 모듈이 생깁니다.

아차;; 빌드 하기전에 build.gradle에서

compile "org.vert-x:vertx-core:$vertxVersion"
compile "org.vert-x:vertx-platform:$vertxVersion"

이걸

provided "org.vert-x:vertx-core:$vertxVersion"
provided "org.vert-x:vertx-platform:$vertxVersion"

이렇게 바꿔주세요. 코딩할 때 필요해서 compile 스코프로 넣어뒀는데 빌드하고 난 뒤에 실행할 때는 이 두개가 vert.x에서 제공해주는 라이브러리를 쓰도록 provided 스코프로 해주는게 맞습니다.

자 어쨌든 build/mod/로 가시면 모듈 디렉토리가 생긴걸 볼 수 있습니다.

/work/mod-sample/build/mod > ls
me.whiteship.mod-sample-v0.1

이렇게요.

모듈 실행하기

모듈 기본 디렉토리를 mods라는 디렉토리입니다. 즉 아까 생성된 모듈을 mods 라는 디렉토리 밑으로 옮겨야 하죠. 그런데 mods라는 디렉토리가 없죠? 프로젝트홈 디렉토리에 하나 마들어 주세요.

mkdir mods

그리고 그 밑으로 아까 생성된 모듈 디렉토리를 통쨰로 복사하거나 옮겨오세요.

/work/mod-sample/mods > ls
me.whiteship.mod-sample-v0.1

이렇게요.

이제 프로젝트홈에서 다음과 같이 모듈을 실행하시면 됩니다.

/work/mod-sample > vertx runmod me.whiteship.mod-sample-v0.1
server is running on http://localhost:9090/

브라우저에서 해보시거나 콘솔창을 하나 더 열고

~ > curl http://localhost:9090/
Hello Vert.x

끝.