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 perform localizations within Java™ 2
Platform, Enterprise Edition (J2EE) 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 J2EE client
programs and stateless session beans in the same manner that you would use
conventional J2EE 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 J2EE 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 J2EE 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