i18ns.java

ZK 基础介绍 功能操作 模块 结合数据库操作

/* I18Ns.java

{{IS_NOTE
	Purpose:
		
	Description:
		
	History:
		Thu Jul 13 16:53:47     2006, Created by tomyeh
}}IS_NOTE

Copyright (C) 2006 Potix Corporation. All Rights Reserved.

{{IS_RIGHT
}}IS_RIGHT
*/
package org.zkoss.zk.ui.http;

import java.util.Locale;
import java.util.TimeZone;

import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;

import org.zkoss.util.TimeZones;
import org.zkoss.util.logging.Log;
import org.zkoss.web.Attributes;
import org.zkoss.web.servlet.Charsets;

import org.zkoss.zk.ui.Session;
import org.zkoss.zk.ui.util.Configuration;
import org.zkoss.zk.ui.sys.SessionsCtrl;

/**
 * Internatization utilities.
 *
 * <p>Typical use:
 * <pre><code>
 Object old = I18Ns.setup(session, request, response);
 try {
   ...
 } finally {
   I18Ns.cleanup(old);
 }
 *</code></pre>
 * @author tomyeh
 */
public class I18Ns {
	private static final Log log = Log.lookup(I18Ns.class);

	/** Sets up the internationalization attributes, inclluding locale
	 * and time zone.
	 * @param charset the response's charset. If null or empty,
	 * response.setCharacterEncoding won't be called, i.e., the container's
	 * default is used.
	 */
	public static final Object setup(Session sess,
	ServletRequest request, ServletResponse response, String charset) {
		final Object[] old;
		if (Charsets.hasSetup(request)) {
			old = null;
		} else {
			//Invoke the request interceptors
			sess.getWebApp().getConfiguration()
				.invokeRequestInterceptors(sess, request, response);

			final Object ol = Charsets.setup(request, response, charset);
				//Charsets will handle PREFERRED_LOCALE
			final Object otz = TimeZones.setThreadLocal(
				(TimeZone)sess.getAttribute(Attributes.PREFERRED_TIME_ZONE));

			old = new Object[] {ol, otz};
		}

		SessionsCtrl.setCurrent(sess);
		return old;
	}
	/* Cleans up the inernationalization attributes.
	 *
	 * @param old which must be the value returned by setup.
	 */
	public static final void cleanup(ServletRequest request, Object old) {
		SessionsCtrl.setCurrent(null);

		if (old != null) {
			final Object[] op = (Object[])old;
			TimeZones.setThreadLocal((TimeZone)op[1]);
			Charsets.cleanup(request, op[0]);
		}
	}
}