API del contexto de internacionalización: referencia de programación
Los componentes de aplicación gestionan mediante programación el contexto de internacionalización a través de las interfaces UserInternationalization, Internationalization e InvocationInternationalization que hay en el paquete com.ibm.websphere.i18n.context.
public interface UserInternationalization {
public Internationalization getCallerInternationalization();
public InvocationInternationalization
getInvocationInternationalization();
}
public interface Internationalization {
public java.util.Locale[] getLocales();
public java.util.Locale getLocale();
public java.util.TimeZone getTimeZone();
}
public interface InvocationInternationalization
extends Internationalization {
public void setLocales(java.util.Locale[] locales);
public void setLocale(java.util.Locale jmLocale);
public void setTimeZone(java.util.TimeZonetimeZone);
public void setTimeZone(String timeZoneId);
}
Interfaz UserInternationalization
La interfaz UserInternationalization proporciona métodos de fábrica para obtener referencias para los objetos de contexto CallerInternationalization y InvocationInternationalization. Utilice estas referencias para acceder a los elementos del llamante y a los contextos de invocación correlacionados con la hebra actual.
- Internationalization getCallerInternationalization()
- Devuelve una referencia que implementa la interfaz Internationalization que permite acceder a los elementos del contexto de internacionalización del llamante correlacionado a la hebra actual. Si el servicio no está habilitado, este método genera una excepción IllegalStateException.
- InvocationInternationalization getInvocationInternationalization()
- Devuelve una referencia que implementa la interfaz InvocationInternationalization. Si el servicio no está habilitado, este método genera una excepción IllegalStateException.
Interfaz Internationalization
La interfaz Internationalization declara métodos que proporcionan acceso de sólo lectura al contexto de internacionalización. Dado un objeto de contexto de internacionalización de invocación o llamante creado con la interfaz UserInternationalization, enlace el objeto con la interfaz Internationalization para obtener elementos de dicho tipo de contexto. Observe que sólo se puede acceder al contexto de internacionalización del llamante a través de esta interfaz.
- Locale[] getLocales()
- Devuelve la cadena de entornos locales del contexto de internacionalización (objeto) enlazada con la interfaz, siempre que la cadena no tenga el valor nulo; si lo tuviera, este método devuelve una cadena de longitud (1) que contiene el entorno local predeterminado de la JVM (máquina virtual de Java™).
- Locale getLocale()
- Devuelve el primero de la cadena de entornos locales del contexto de internacionalización (objeto) enlazado con la interfaz, siempre que la cadena no tenga el valor nulo; si lo tuviera, este método devuelve el entorno local predeterminado de la JVM.
- TimeZone getTimeZone()
- Devuelve el huso horario (es decir la instancia SimpleTimeZone) del llamante asociada a la hebra actual, siempre que dicho huso horario no tenga el valor nulo; si lo tuviera, este método devuelve el huso horario del proceso.
Interfaz InvocationInternationalization
La interfaz InvocationInternationalization declara métodos que otorgan acceso de lectura y grabación al contexto InvocationInternationalization (internacionalización de invocación). Dado un objeto de contexto de internacionalización de invocación creado con la interfaz UserInternationalization, enlace el objeto con la interfaz InvocationInternationalization para obtener y establecer los elementos del contexto de invocación.
Según la política de internacionalización gestionada por contenedor (CMI), todos tos métodos establecidos, setXxx(), generan una excepción IllegalStateException cuando se invocan dentro de un servlet CMI o enterprise bean.
- void setLocales(java.util.Locale[] locales)
- Establece la cadena de entornos locales para la cadena proporcionada, locales, dentro del contexto de internacionalización de invocación. La cadena suministrada puede tener el valor nulo o el valor de longitud length(>= 0). Cuando la cadena de entornos locales suministrada tiene un valor nulo o una longitud (0), el servicio establece la lista de entornos locales de invocación en una matriz de longitud (1) que contiene el entorno local predeterminado de la JVM. Pueden haber entradas con valor nulo dentro de la lista de entornos locales proporcionada, para el que el servicio sustituye el entorno local predeterminado de la JVM en invocaciones remotas.
- void setLocale(java.util.Locale locale)
- Establece la cadena de entornos locales dentro del contexto de internacionalización de invocación para una matriz de longitud (1) que contiene el entorno local suministrado, locale. El entorno local suministrado puede tener un valor nulo, en cuyo caso el servicio establecerá la cadena en una matriz de longitud (1) que contiene el entorno local predeterminado de la JVM.
- void setTimeZone(java.util.TimeZone timeZone)
- Establece el huso horario del contexto de internacionalización de invocación para el huso horario suministrado, timezone. Si la zona horaria proporcionada no es una instancia exacta de java.util.SimpleTimeZone o tiene el valor nulo, el servicio establece en su lugar el huso horario de invocación en el huso horario predeterminado de JVM.
- void setTimeZone(String timeZoneId)
- Establece el huso horario del contexto de internacionalización de invocación para java.util.SimpleTimeZone que tiene el ID suministrado, timeZoneId. Si el ID de huso horario tiene el valor nulo o no es válido (es decir, el ID no aparece en la lista de identificadores devueltos por el método java.util.TimeZone.getAvailableIds), el servicio establece el huso horario de invocación en un huso horario sencilla que tiene como ID, GMT, el desplazamiento 00:00 y por otra parte campos no válidos.