2016년 5월 25일 수요일

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)에만 공개되는 글입니다. 퍼 가는 것은 금해주시고, 링크로 대신해주시기 바랍니다. 당연히 상업적 용도로 이용하시면...저랑 경찰서에서 정모하셔야 합니다. ^^;;;

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

2016년 4월 15일 금요일

Spring RestController 의 응답결과에 값 추가하기

Spring RestController 을 이용해서 쉽게 JSON 이나 XML 형태의 값을 클라이언트에게 전송할 수 있습니다. 하지만, 때론 Controller 까지 그 값을 넣어주지 않았는데 일괄적으로 그 값을 보내줘야 할 때가 있습니다.

그럴 경우 하나의 방법으로 WebMvcConfigurerAdapter 을 상속받은 클래스를 만들어 configureMessageConverters 을 Override 하는 방법이 있습니다.

JSON 의 예를 들어보면, Spring 에서 JSON 은 Jackson 을 기본으로 합니다. 그럼 아래와 같은 형태의 Override 을 구현해야 합니다.

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {

    }

매개변수로 받게 되는 converters 에 새로운 MessageConverter 을 추가(add method 이용)하는 방식입니다. Jackson 은 AbstractJackson2HttpMessageConverter 을 제공하기 때문에, 이것을 이용해서 writeInternal 을 Override 해서 구현하면 됩니다. 물론 wirteInternal 에 대한 소스는 오픈소스이기 때문에 쉽게 구할 수 있기 때문에, objectWriter.writeValue(generator, value); 이전에 value 에 원하는 값을 추가하면 JSON 에 값이 추가됩니다.

configureMessageConverters 일 이용하면 JSON 뿐만 아니라 Spring 에서 기본 제공하지 않는 MessagePack 같은 것도 converter 로 추가하는 등의 작업이 가능합니다.

2016년 4월 8일 금요일

Spring Web 에서 request parameter 추가

Spring Web 에서 Client 가 요청한 주소에 기반해서 값을 request 에서 가져올 수 있지만, 가끔 그 매개변수에 서버 쪽에서 어떤 값을 추가해서 받아야 할 필요가 있을 때가 있습니다. 저의 경우는 Spring MVC 에서 실제 요청을 받은 Controller 의 method 명을 알고자 할 때 강제로 Exception 을 발생시켜 첫번째 라인의 method 명을 알아내는 방식보다는, 이 방식으로 요청되는 주소에서 값을 얻어서(주소에 method 명이 유추되도록 구성되어야 하겠죠) request 에 추가하도록 처리하였습니다.

원리는 간단하면서도 살짝 복잡합니다. 일단 HttpServletRequest 라는 개체는 setParameter 라는 것이 존재하지 않습니다. 이와 같이 매개변수를 개발자가 마음대로 조작할 수 있을 경우 문제가 더 클 수 있기 때문입니다. 그래서 약간의 우회적인 방법이 필요합니다.

먼저, Filter 을 등록해야 합니다. Interceptor 는 불가능한 것으로 압니다. Filter 에서 doFilter method 등을 Override 받아 구현할 때 HttpServletRequest, HttpServletResponse, FilterChain 을 매개변수를 받을 것입니다. 이 때 매개변수로 받은 HttpServletRequest 개체를 생성자로 받아서 이를 확장할 HttpServletRequestWrapper 클래스를 상속받아 구현하는 것입니다. 통상적으로 request 의 getParameterMap() 을 이용해 Map 에 매개변수들을 저장한 뒤 getParameter(), getParameterMap(), getParameterNames(), getParameterValues() 등을 Override 해서 구현하고, setParameter() 을 새롭게 구현(setParameter() 는 2 개의 오버로드된 method 로 구현합니다)하는 형태가 됩니다.

이렇게 구현된 HttpServletRequestWrapper 는 HttpServletRequest 의 구현체 중 하나이기 때문에 Controller 로 전송되어도 사용에 크게 문제가 없습니다(OOP Design Pattern 의 장점).



저는 보통 이렇게 구현해놓고 씁니다.


public class HttpRequestWithModifiableParameters extends HttpServletRequestWrapper {

    Map<String, String[]> params;

    public HttpRequestWithModifiableParameters(HttpServletRequest request) {

        super(request);
        this.params = request.getParameterMap();

    }

    @Override
    public String getParameter(String name) {

        String[] paramArray = getParameterValues(name);

        if (paramArray != null && paramArray.length > 0) {

            return paramArray[0];

        } else {

            return null;

        }

    }

    @Override
    public Map<String, String[]> getParameterMap() {

        return Collections.unmodifiableMap(params);

    }

    @Override
    public Enumeration<String> getParameterNames() {

        return Collections.enumeration(params.keySet());

    }

    @Override
    public String[] getParameterValues(String name) {

        String[] result = null;
        String[] temp = params.get(name);

        if (temp != null) {

            result = new String[temp.length];
            System.arraycopy(temp, 0, result, 0, temp.length);

        }

        return result;
    }

    public void setParameter(String name, String value) {

        String[] oneParam = {value};
        setParameter(name, oneParam);

    }

    public void setParameter(String name, String[] values) {

        params.put(name, values);

    }

}


그래도 남용은 하지 말아야겠습니다.