[Enterprise Extensions only]

Handling exceptions

The Internationalization Service employs one exception:

java.lang.IllegalStateException

This exception is employed to indicate that an application component attempted an operation not supported by the programming model or that an anomaly occurred that caused the service to disable.

With respect to the programming model, IllegalStateException is thrown whenever a server-side application component attempts to set invocation context. This is a violation of the server-side Internationalization (SSI) context management policy. Under SSI, servlets and Enterprise JavaBeans cannot modify their invocation Internationalization context.

The service also throws IllegalStateException to indicate the service is disabled. For instance, the JNDI lookup on the UserInternationalization URL throws a javax.naming.NamingException containing an instance of IllegalStateException if the service did not properly initialize. In such cases refer to the trace log to determine the reason for failure and if necessary, call IBM Technical Support.