Internationalization Elements

Internationalization elements are as follows:

• parameter-encoding

• locale-charset-info

• locale-charset-map

parameter-encoding

Specifies a hidden field or default charset that determines the character encoding the web container. This web container is used to decode parameters for request.getParameter calls when the charset is not set in the request's Content-Type.

For encodings you can use, see:

http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html

Subelements

none

Attributes

The following table describes attributes for the parameter-encoding element. The left column lists the attribute name, the middle column indicates the default value, and the right column describes what the attribute does.

Table 6–43 parameter-encoding Attributes

Attribute	Default Value	Description
form-hint-field	j_encoding	The value of the hidden field in the form that specifies the parameter encoding.
default-charset	none	This value is used for parameter encoding if neither request.setCharacterEncoding() is called nor form-hint-field is found in the request.

locale-charset-info

Specifies the mapping between the locale and the character encoding that should be set in the Content-type header of the response if a servlet or JSP sets the response locale using the ServletResponse.setLocale method. This overrides the web container's default locale-to-charset mapping.

Subelements

The following table describes subelements for the locale-charset-info element. The left column lists the subelement name, the middle column indicates the requirement rule, and the right column describes what the element does.

Table 6–44 locale-charset-info Subelements

Element	Required	Description
locale-charset-map	one or more	Maps a locale to a character set.
parameter-encoding	zero or one	Deprecated. Use the parameter-encoding element under sun-web-app instead. This is supported only for backward compatibility with applications developed under Sun Java System Application Server 7.

Attributes

The following table describes attributes for the locale-charset-info element. The left column lists the attribute name, the middle column indicates the default value, and the right column describes what the attribute does.

Table 6–45 locale-charset-info Attributes

Attribute	Default Value	Description
default-locale	none	Ignored in Sun Java System Web Server 6.1.

locale-charset-map

Maps a locale to a specific character encoding.

For encodings you can use, see:

http://java.sun.com/j2se/1.4.2/docs/guide/intl/encoding.doc.html

Attributes

The following table describes attributes for the locale-charset-map element. The left column lists the attribute name, the middle column indicates the default value, and the right column describes what the attribute does.

Table 6–46 locale-charset-map Attributes

Attribute	Default Value	Description
locale	none	Specifies the locale name.
agent	none	Ignored in Sun Java System Web Server 6.1.
charset	none	Specifies the character set for that locale.

The following table provides a locale-charset-map example, listing the locale and the corresponding charset:

Table 6–47 locale-charset-map Example

Locale	Charset
ja	EUC-JP
zh	UTF-8