com.oreilly.servlet

类 LocaleNegotiator

java.lang.Object

com.oreilly.servlet.LocaleNegotiator

public class LocaleNegotiator
extends java.lang.Object

A class to aid in servlet internationalization. It determines, from a client request, the best charset, locale, and resource bundle to use with the response.

LocaleNegotiator works by scanning through the client's language preferences (sent by browsers in the Accept-Language header) looking for any language for which there exists is a corresponding resource bundle. When it finds a correspondence, it uses the LocaleToCharsetMap class to determine the charset. If there's any problem, it tries to fall back to US English. The logic currently ignores the client's charset preferences (sent in the Accept-Charset header).

It can be used like this:

 String bundleName = "BundleName";
 String acceptLanguage = req.getHeader("Accept-Language");
 String acceptCharset = req.getHeader("Accept-Charset");
  
 LocaleNegotiator negotiator =
   new LocaleNegotiator(bundleName, acceptLanguage, acceptCharset);
  
 Locale locale = negotiator.getLocale();
 String charset = negotiator.getCharset();
 ResourceBundle bundle = negotiator.getBundle();  // may be null
  
 res.setContentType("text/plain; charset=" + charset);
 res.setHeader("Content-Language", locale.getLanguage());
 res.setHeader("Vary", "Accept-Language");
  
 PrintWriter out = res.getWriter();
  
 out.println(bundle.getString("resource"));
 

版本:

1.0, 98/09/18

作者:

Jason Hunter, Copyright © 1998

另请参阅:

LocaleToCharsetMap

构造器概要

构造器

构造器和说明
LocaleNegotiator(java.lang.String bundleName, java.lang.String languages, java.lang.String charsets) Constructs a new LocaleNegotiator for the given bundle name, language list, and charset list.

方法概要

方法

限定符和类型	方法和说明
java.util.ResourceBundle	getBundle() Gets the chosen bundle.
java.lang.String	getCharset() Gets the chosen charset.
protected java.lang.String	getCharsetForLocale(java.util.Locale loc, java.lang.String charsets) Gets the best charset for a given locale, selecting from a charset list.
java.util.Locale	getLocale() Gets the chosen locale.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

LocaleNegotiator

public LocaleNegotiator(java.lang.String bundleName,
                java.lang.String languages,
                java.lang.String charsets)

Constructs a new LocaleNegotiator for the given bundle name, language list, and charset list.

参数:

bundleName - the resource bundle name

languages - the Accept-Language header

charsets - the Accept-Charset header

方法详细资料

getBundle

public java.util.ResourceBundle getBundle()

Gets the chosen bundle.

返回:

the chosen bundle

getLocale

public java.util.Locale getLocale()

Gets the chosen locale.

返回:

the chosen locale

getCharset

public java.lang.String getCharset()

Gets the chosen charset.

返回:

the chosen charset

getCharsetForLocale

protected java.lang.String getCharsetForLocale(java.util.Locale loc,
                                   java.lang.String charsets)

Gets the best charset for a given locale, selecting from a charset list. Currently ignores the charset list. Subclasses can override this method to take the list into account.

参数:

loc - the locale

charsets - a comma-separated charset list

返回:

the best charset for the given locale from the given list