API du contexte d'internationalisation : Guide de référence de programmation
Les composants d'application gèrent par le biais d'un programme le contexte d'internationalisation via les interfaces UserInternationalization, Internationalization et InvocationInternationalization dans le module 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);
}
Interface UserInternationalization
L'interface UserInternationalization fournit des méthodes de fabrique permettant d'obtenir des références aux contextes CallerInternationalization et InvocationInternationalization. Utilisez ces références pour accéder aux éléments des contextes d'appelant et d'appel mis en corrélation avec l'unité d'exécution en cours.
- Internationalization getCallerInternationalization()
- Renvoie une référence mettant en oeuvre l'interface Internationalization qui prend en charge l'accès aux éléments du contexte d'internationalisation de l'appelant mis en corrélation avec l'unité d'exécution en cours. Si le service est désactivé, cette méthode génère une exception IllegalStateException.
- InvocationInternationalization getInvocationInternationalization()
- Renvoie une référence mettant en oeuvre l'interface InvocationInternationalization. Si le service est désactivé, cette méthode génère une exception IllegalStateException.
Interface Internationalization
L'interface Internationalization déclare des méthodes permettant un accès en lecture seule au contexte d'internationalisation. Compte tenu d'un objet contexte d'internationalisation d'appelant ou d'appel créé à l'aide de l'interface UserInternationalization, associez l'objet à l'interface Internationalization afin d'obtenir des éléments de ce type de contexte. Notez que le contexte d'internationalisation de l'appelant n'est accessible que via cette interface.
- Locale[] getLocales()
- Renvoie la chaîne des paramètres régionaux du contexte d'internationalisation (objet) associé à l'interface, à condition que la chaîne ne soit pas nulle ; dans le cas contraire, cette méthode renvoie une chaîne de longueur(1) contenant les paramètres régionaux par défaut de la machine virtuelle Java™ (JVM).
- Locale getLocale()
- Renvoie le premier élément de la chaîne des paramètres régionaux du contexte d'internationalisation (objet) associé à l'interface, à condition que la chaîne ne soit pas nulle ; dans le cas contraire, cette méthode renvoie les paramètres régionaux par défaut de la JVM.
- TimeZone getTimeZone()
- Renvoie le fuseau horaire de l'appelant (c'est-à-dire l'instance SimpleTimeZone) associé à l'unité d'exécution en cours, à condition que le fuseau horaire soit non nul ; dans le cas contraire, cette méthode renvoie le fuseau horaire du processus.
Interface InvocationInternationalization
L'interface InvocationInternationalization déclare des méthodes permettant d'accéder en lecture et en écriture au contexte InvocationInternationalization. Compte tenu d'un objet contexte d'internationalisation d'appel créé à l'aide de l'interface UserInternationalization, associez l'objet à l'interface InvocationInternationalization afin d'obtenir et de définir des éléments du contexte d'appel.
Selon la règle d'internationalisation gérée par conteneur, toutes les méthodes set, setXxx(), génèrent une exception IllegalStateException lorsqu'elles sont appelées dans un servlet CMI ou un bean enterprise.
- void setLocales(java.util.Locale[] locales)
- Paramètre la chaîne des paramètres régionaux sur la chaîne fournie, locales, dans le contexte d'internationalisation d'appel. La chaîne fournie peut être nulle ou avoir une longueur (>= 0). Lorsque la chaîne fournie est nulle ou comporte une longueur(0), le service paramètre la chaîne des paramètres régionaux d'appel sur un tableau de longueur(1) contenant les paramètres régionaux par défaut de la JVM. La liste de paramètres régionaux fournis peut contenir des entrées nulles que le service remplace par les paramètres régionaux par défaut de la JVM lors des appels à distance.
- void setLocale(java.util.Locale locale)
- Paramètre la chaîne des paramètres régionaux dans le contexte d'internationalisation d'appel sur un tableau de longueur(1) contenant les paramètres régionaux fournis, locale. Les paramètres régionaux fournis peuvent être nuls, auquel cas le service paramètre la chaîne sur un tableau de longueur(1) contenant les paramètres régionaux par défaut de la JVM.
- void setTimeZone(java.util.TimeZone timeZone)
- Paramètre le fuseau horaire du contexte d'internationalisation d'appel sur le fuseau horaire fourni, time zone . Si le fuseau horaire fourni ne correspond pas à une instance exacte de java.util.SimpleTimeZone ou s'il est nul, le service paramètre le fuseau horaire d'appel sur le fuseau horaire par défaut de la JVM.
- void setTimeZone(String timeZoneId)
- Paramètre le fuseau horaire du contexte d'internationalisation d'appel sur java.util.SimpleTimeZone dont l'ID est fourni (timeZoneId). Si l'ID de fuseau horaire indiqué est nul ou s'il est incorrect (c'est-à-dire, l'ID n'est pas affiché dans la liste des ID renvoyés par la méthode java.util.TimeZone.getAvailableIds), le service paramètre le fuseau horaire d'appel sur un fuseau horaire simple comportant un ID de GMT, un décalage de 00:00 et des zones incorrectes.