WebSphere, WebLogic, Tomcat, TC 서버, JBoss의 UTF-8 구성

웹 애플리케이션 환경에서 UTF-8은 표준 문자 인코딩 방식으로 자리매김했습니다.

본 문서에서는 IBM WebSphere, Oracle Weblogic, Tomcat, TC Server, 그리고 JBoss 서버 환경에서 UTF-8 인코딩을 설정하는 구체적인 방법들을 소개합니다.

WebSphere 애플리케이션 서버에서의 UTF-8 설정

  • WebSphere 관리 콘솔에 접속합니다.
  • ‘서버’ 메뉴에서 ‘애플리케이션 서버’를 선택합니다.
  • UTF-8을 적용할 특정 애플리케이션 서버(JVM)를 클릭합니다.
  • ‘서버 인프라’ 섹션에서 ‘Java 및 프로세스 관리’를 확장합니다.
  • ‘프로세스 정의’를 클릭합니다.
  • ‘Java 가상 머신’을 선택합니다.
  • ‘일반 Java 인수’ 필드에 다음 설정을 추가합니다:
-Dclient.encoding.override=UTF-8
  • ‘확인’ 버튼을 클릭하고, 필요한 경우 노드를 동기화합니다.
  • 변경 사항을 적용하려면 애플리케이션 서버(JVM)를 재시작해야 합니다.

Oracle WebLogic 서버에서의 UTF-8 설정

  • WebLogic 도메인 디렉토리로 이동합니다.
  • ‘bin’ 폴더로 들어갑니다.
  • ‘setDomainEnv.sh’ 파일에서 ‘JAVA_OPTS’ 변수 아래에 다음 설정을 추가합니다:
-Dfile.encoding=utf8
  • 변경 사항을 적용하려면 WebLogic 서버를 재시작해야 합니다.

Tomcat 서버에서의 UTF-8 설정

  • Tomcat 설치 폴더로 이동합니다.
  • ‘conf’ 폴더로 이동합니다.
  • ‘server.xml’ 파일에서, ‘Connector’ 포트 설정 아래에 다음 속성을 추가합니다:
URIEncoding="UTF-8"

참고: 여러 개의 ‘Connector’ 포트가 있다면, 각각의 포트 설정에 이 속성을 추가해야 합니다.

  • Tomcat 설치 폴더로 다시 이동합니다.
  • ‘bin’ 폴더로 이동합니다.
  • ‘catalina.sh’ 파일에서, ‘JAVA_OPTS’ 변수 아래에 다음 설정을 추가합니다:
-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8

예시:

JAVA_OPTS="-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8"
  • 변경 사항을 적용하려면 Tomcat 서버를 재시작해야 합니다.

TC 서버에서의 UTF-8 설정

  • TC 서버 인스턴스 폴더로 이동합니다.
  • ‘conf’ 폴더로 이동합니다.
  • ‘server.xml’ 파일에서, ‘Connector’ 포트 설정 아래에 다음 속성을 추가합니다:
URIEncoding="UTF-8"
  • TC 서버 인스턴스 폴더로 다시 이동합니다.
  • ‘bin’ 폴더로 이동합니다.
  • ‘setenv.sh’ 파일에서, ‘CATALINA_OPTS’ 변수 아래에 다음 설정을 추가합니다:
-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8

예시:

CATALINA_OPTS="-Djavax.servlet.request.encoding=UTF-8 -Dfile.encoding=UTF-8"
  • 변경 사항을 적용하려면 TC 서버를 재시작해야 합니다.

JBoss 애플리케이션 서버에서의 UTF-8 설정

  • JBoss 설치 디렉토리로 이동합니다.
  • ‘bin’ 폴더로 이동합니다.
  • ‘standalone.conf’ 파일에서, ‘JAVA_OPTS’ 변수 아래에 다음 설정을 추가합니다:
-Dfile.encoding=UTF-8
  • 변경 사항을 적용하려면 JBoss 서버를 재시작해야 합니다.

UTF-8 유효성 검사 도구

웹 애플리케이션이 UTF-8을 올바르게 지원하는지 다음 온라인 도구를 통해 검증할 수 있습니다.

http://coderstoolbox.net/string/

http://validator.w3.org/

위에 제시된 지침들이 다양한 애플리케이션 서버에서 UTF-8 설정을 구성하는 데 도움이 되었기를 바랍니다.

Oracle WebLogic 관리 기술을 심화하고 싶다면 다음의 Chris Parent 강좌를 확인해 보세요.

이 문서가 유익하셨나요? 다른 사람들과도 공유해 보세요!