This topic summarizes the steps involved in using the internationalization
service.
About this task
With the internationalization service, you can
manage the distribution of the internationalization information, or internationalization
context, that is necessary to support globalized Java Platform, Enterprise Edition (Java EE) application components. Supported application
components also include web service client environments and web service-enabled
enterprise beans.
- Use the
internationalization context API within application components
to obtain or manage internationalization context.
Servlet
and enterprise bean business methods can use internationalization
context to perform locale- and time zone-sensitive localizations.
Enterprise JavaBeans (EJB) client applications,
and server components that are configured to manage internationalization
context must use the internationalization context API to set the context
elements scoped to their invocations.
You use the internationalization
context API within Web service-enabled Java EE
client programs and stateless session beans in the same manner that
you would use conventional Java EE
application components, with one exception. Internationalization context
propagated over Web service requests contains a time zone ID, whereas
conventional Remote Method Invocation/ Internet Inter-ORB Protocol
(RMI/IIOP) requests propagate complete time zone information, including
the raw offset, Daylight Savings Time information, and so on.
- Assemble
internationalized applications.
The internationalization
type specifies the internationalization policy that applies to a servlet
or an enterprise bean and, in particular, indicates whether the application
component or its hosting Java EE
container manages internationalization context. Container internationalization
attributes can be specified for container-managed servlet and enterprise
bean business methods. These attributes tailor a policy by indicating
which context the container scopes to an invocation. Configuring internationalization
policies declaratively prescribes, by means of the application deployment
descriptor, the distribution and management of context throughout
an application.
As you edit the deployment descriptor for assembly,
you can also set the internationalization type and configure any container
internationalization attributes for the servlets and enterprise beans
in your application.
You configure internationalization type
and container internationalization attributes for Web service-enabled
stateless session beans in the same manner as you do for conventional
beans.
- Manage
the internationalization service.
Use the administrative
console to enable the service on all application servers.
By
default, the service is enabled within Java EE
client environments but is disabled on application servers. You must
enable the service on all application servers hosting your servlets
and enterprise beans to use internationalization context.
- Troubleshoot the internationalization service as needed.
Use the administrative console to enable the trace service
to log internationalization service messages when debugging your applications.
The trace strings for the internationalization
service follow; use both:
com.ibm.ws.i18n.context.*=all=enabled:com.ibm.websphere.i18n.context.*=all=enabled