sun-web.xml Visual Editor: Locale

See Also

The sun-web.xml visual editor lets you edit the platform-specific web deployment descriptor for Sun Java System Application Server. You open the visual editor by expanding your project's Configuration Files node in the Projects window and double-clicking the sun-web.xml file. A web application only contains a sun-web.xml deployment descriptor if its target server is the Sun Java System Application Server.

The Locale tab of the editor allows you to specify the web application's internationalization settings by adding the desired locales and the character set mappings.

Default Locale Mapping

This property is provided for backward compatibility only. This value is ignored and Default Character Set value of Parameter Encoding is used instead.

Parameter Encoding

Determines the default request character encoding and how the web container decodes parameters from forms for this web application according to a hidden field value. This data can be written to either or both of two locations in the descriptor file: Globally in sun-web-app or local to the locale-charset-info element. If both the sun-web-app and locale-charset-info elements have parameter-encoding subelements, the subelement of sun-web-app takes precedence.

Name Description
Default Character Set Select the default request character encoding. This is an optional step.
Form Hint Field Optionally, type the name of the hidden field in the form that specifies the character encoding the web container uses for request.getParameter and request.getReader calls when the charset is not set in the request's content-type header.

Locale Character Set Mappings

This table displays the mapping of locales and agents to character encodings. These maps are used only for request processing, and only if no Parameter Encoding is defined. This feature is provided only to support backward compatibility.

Click the New button to add a new mapping. In the Locale Character Set Mapping dialog, specify values as mentioned in the following table.

Name Description
Locale Select the locale to which you want to map a character set.
Character Set Select the character set to which the locale is being mapped.
Agent Optionally, specify the type of client that interacts with Application Server. For a given locale, different agents may have different preferred character sets. The value of this attribute must exactly match the value of the user-agent HTTP request header sent by the client.
Description Optionally, type a brief description about the mapping.
See Also

About Deployment Descriptors

Editing a Web Application's Deployment Descriptors
Changing the Target Server
sun-web.xml Visual Editor:
         General
         Session
         Messages
          Cache
         Web Service Descriptor

Legal Notices