Sun Java System Web Server 7.0 Developer's Guide to Java Web Applications

Internationalization Elements

The internationalization elements are as follows:

parameter-encoding Element

This element specifies a hidden field or default character set that determines the character encoding the web container uses to decode parameters for request.getParameter calls when the character set 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.

Attributes

The following table describes attributes for the parameter-encoding element.

Table A–45 parameter-encoding Attributes

Attribute 

Default Value  

Description  

form-hint-field

none 

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.

Subelements

none

Attributes

none

locale-charset-info Element

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 setting overrides the web container's default locale-to-charset mapping.

Subelements

The following table describes subelements for the locale-charset-info element.

Table A–46 locale-charset-info Subelements

Element  

Required  

Description  

locale-charset-map Element

one or more 

Maps a locale to a character set. 

parameter-encoding Element

zero or one 

Deprecated. Use the parameter-encoding element under sun-web-app instead. This setting is supported only for backward compatibility with applications developed under Sun Java System Web Server 7.0

Attributes

The following table describes the default-locale attributes for the locale-charset-info.

Table A–47 locale-charset-info Attributes

Attribute Value 

Default Value 

default-locale

none 

locale-charset-map Element

This element 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.

Table A–48 locale-charset-map Attributes

Attribute  

Default Value  

Description  

locale

none 

Specifies the locale name. 

agent

none 

Ignored in Sun Java System Web Server 7.0 

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 A–49 locale-charset-map Example

Locale  

Charset  

ja  

EUC-JP  

zh 

UTF-8 

message-destination Element

This element specifies the name of a logical message-destination defined within an application. The message-destination-name matches the corresponding message-destination-name in the corresponding Java EE deployment descriptor file.

Subelements

The following table describes subelements for the message-destination element.

Table A–50 message-destination Subelements

Elements 

Required 

Description 

message-destination-name Element

only one 

Specifies the name of a logical message destination defined within the corresponding Java EE deployment descriptor file  

jndi-name Element

only one 

Specifies the jndi-name of the associated entity

message-destination-name Element

This element specifies the name of a logical message destination defined within the corresponding Java EE deployment descriptor file.

Subelements

none

webservice-description Element

This element specifies a name and optional publish location for a web service.

Subelements

The following table describes subelements for the webservice-description element

Table A–51 webservice-description Subelements

Element 

Required 

Description 

webservice-description-name Element

only one 

Specifies a unique name for the web service within a web 

wsdl-publish-location Element

zero or one 

Specifies the URL of a directory to which the web services WSDL is published during deployment 

Attributes

none

webservice-description-name Element

This element specifies a unique name for the web service within a web.

Subelements

none

Attributes

none

wsdl-publish-location Element

This element specifies the URL of a directory to which a web service's WSDL is published during deployment. Any required files are published to this directory, preserving their location relative to the module-specific WSDL directory (META-INF/wsdl or WEB-INF/wsdl).

Subelements

none

Attributes

none