Struts2 에서의 국제화

Struts2 의 국제화는 Struts2의 TextProvider에 의해 이루어진다. 내부적으로는 PropertyResourceBundle 을 사용하고 있어서 기본적으로는 한글을 사용할 수가 없다.

Java의 properties 파일은 ISO-8859-1 인코딩을 사용하고 있기 때문이다. properties 파일의 인코딩을 UTF-8로 바꾼다 해도 내부적으로 ISO-8859-1로 취급해버린다.

Struts의 소스 코드를 건드리지 않고 한글을 제대로 출력할 수 없을까 하고 생각해보았다.

또한 Struts2 i18n layout에 익숙한 사용자도 있을 것이기 때문에 xml 로 resource bundle을 바꾸기도 좀 그렇기 때문에 기존의 properties 파일을 사용하는 방법으로 고민해보았다.

<s:text>태그에서는 Action Class 의 getText() method를 호출하기 때문에 getText() method를 바꾸기로 하였다.

각 Action 에서는 다음 class 를 상속하여 구현하고, properties 파일의 인코딩을 UTF-8로 바꾸면 국제화에 문제가 없을 것이다.

AbstractAction.java

package com.fguy.action;

import java.io.UnsupportedEncodingException;
import java.util.List;
import java.util.PropertyResourceBundle;
import java.util.ResourceBundle;

import com.fguy.util.UTF8ResourceBundle;
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.util.ValueStack;

@SuppressWarnings("unchecked")
public abstract class AbstractAction extends ActionSupport {
	private static final long serialVersionUID = 5107762886506915539L;

	@Override
	public String getText(String textName) {
		return convertResource(super.getText(textName));
	}

	@Override
	public String getText(String textName, List args) {
		return convertResource(super.getText(textName, args));
	}

	@Override
	public String getText(String key, String defaultValue, List args,
			ValueStack stack) {
		return convertResource(super.getText(key, defaultValue, args, stack));
	}

	@Override
	public String getText(String textName, String defaultValue, List args) {
		return convertResource(super.getText(textName, defaultValue, args));
	}

	@Override
	public String getText(String textName, String defaultValue, String obj) {
		return convertResource(super.getText(textName, defaultValue, obj));
	}

	@Override
	public String getText(String key, String defaultValue, String[] args,
			ValueStack stack) {
		return convertResource(super.getText(key, defaultValue, args, stack));
	}

	@Override
	public String getText(String key, String defaultValue, String[] args) {
		return convertResource(super.getText(key, defaultValue, args));
	}

	@Override
	public String getText(String textName, String defaultValue) {
		return convertResource(super.getText(textName, defaultValue));
	}

	@Override
	public String getText(String key, String[] args) {
		return convertResource(super.getText(key, args));
	}

	@Override
	public ResourceBundle getTexts() {
		return new UTF8ResourceBundle((PropertyResourceBundle) super.getTexts());
	}

	@Override
	public ResourceBundle getTexts(String bundleName) {
		return new UTF8ResourceBundle((PropertyResourceBundle) super
				.getTexts(bundleName));
	}

	/**
	 * Convert localized string from properties file
	 *
	 * @param text
	 * @return
	 */
	private static final String convertResource(String text) {
		String result = text;
		try {
			result = new String(result.getBytes("ISO-8859-1"), "UTF-8");
		} catch (UnsupportedEncodingException e) {
			throw new RuntimeException(e);
		}
		return result;
	}
}

UTF8ResourceBundle.java

package com.fguy.util;

import java.io.UnsupportedEncodingException;
import java.util.Enumeration;
import java.util.PropertyResourceBundle;
import java.util.ResourceBundle;

@SuppressWarnings("unchecked")
public class UTF8ResourceBundle extends ResourceBundle {
	PropertyResourceBundle bundle;

	public UTF8ResourceBundle(PropertyResourceBundle bundle) {
		this.bundle = bundle;
	}

	/*
	 * (non-Javadoc)
	 *
	 * @see java.util.ResourceBundle#getKeys()
	 */
	public Enumeration getKeys() {
		return bundle.getKeys();
	}

	/*
	 * (non-Javadoc)
	 *
	 * @see java.util.ResourceBundle#handleGetObject(java.lang.String)
	 */
	protected Object handleGetObject(String key) {
		String value = (String) bundle.handleGetObject(key);
		try {
			return new String(value.getBytes("ISO-8859-1"), "UTF-8");
		} catch (UnsupportedEncodingException e) {
			// Shouldn't fail - but should we still add logging message?
			throw new RuntimeException(e);
		}
	}
}