TOMCAT

POST 방식에서의 UTF-8 입력

HTTP POST 방식에서 UTF-8 캐릭터 깨짐 현상은 운영체제의 로케일과 톰캣 컨텍스트의 로케일(인코딩)이 다르기 때문에 발생하기 때문에, OS의 로케일을 UTF-8으로 변경해야 한다. OS의 로케일을 변경할 수 없는 경우 어플리케이션의 서블릿 컨트롤러 인코딩을 바꿔 문제를 피할 수 있다. 톰캣에서는 아래와 같이 할 수 있다.

windy@wl ~ $ vi $CATALINA_BASE/conf/web.xml
...
    <filter>
        <filter-name>setCharacterEncodingFilter</filter-name>
        <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
        <async-supported>true</async-supported>
    </filter>
    <filter-mapping>
        <filter-name>setCharacterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
    <filter>
        <filter-name>failedRequestFilter</filter-name>
        <filter-class>
          org.apache.catalina.filters.FailedRequestFilter
        </filter-class>
        <async-supported>true</async-supported>
    </filter>
    <filter-mapping>
        <filter-name>failedRequestFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
...

스프링 프레임워크(Spring Framework)를 사용한 경우 스프링에서 제공하는 필터를 등록해 해결할 수 있다.

root@wl ~ # vi /컨텍스트홈/WEB-INF/web.xml
...
<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/</url-pattern>
</filter-mapping>
...

기본적으로 웹에서 사용할 인코딩과 운영체제에서 사용할 인코딩을 동일하게 가져가는 것이 여러가지 인코딩 문제를 해결하기 좋다. 자바스크립트를 포함한 AJAX 형태로 사용하는 경우 encodeURIComponent() 으로 인코딩해서 전달하는 것도 좋은 방법이다.