Attributs d'internationalisation de conteneur
La règle d'internationalisation de chaque servlet CMI et chaque méthode métier d'EJB est dotée d'un attribut d'internationalisation de conteneur qui indique le contexte d'internationalisation que le conteneur étend à son appel.
- Exécuter sous
- Paramètres régionaux
- ID de fuseau horaire
- Servlets CMI dans un module Web
- Méthodes métier de beans enterprise CMI dans un module EJB (Enterprise JavaBeans)
- Méthodes métier de beans session compatibles avec les services Web. Dans les descriptions qui suivent, le terme beans enterprise pris en charge fait référence aux beans enterprise CMI et aux beans session compatibles avec les services Web.
Zone Exécuter sous
Cette zone indique un des trois types de contexte d'appel qu'un conteneur peut étendre à une méthode. Pour les méthodes métier d'EJB et de service de servlet, le conteneur construit le contexte d'internationalisation de l'appel en fonction du paramètre de la zone Exécuter sous et associe ce contexte à l'unité d'exécution en cours, avant de le déléguer à l'implémentation de la méthode.
Par défaut, les appels des méthodes de service de servlet et des méthodes métier d'EJB s'exécutent de façon implicite comme appelant (RunAsCaller), sauf indication contraire dans la zone Exécuter sous de l'attribut d'une règle. Les applications client EJB et les composants de serveur AMI s'exécutent toujours sous forme de serveur (RunAsServer).
- Appelant
- Le conteneur appelle la méthode dans le contexte d'internationalisation du processus appelant. Pour tous les éléments de contexte manquants, le conteneur fournit l'élément de contexte par défaut correspondant de la machine virtuelle Java™. Sélectionnez Exécuter en tant qu'appelant pour que l'appel soit exécuté dans le contexte d'appel du processus appelant.
- Serveur
- Le conteneur appelle la méthode dans le cadre des paramètres régionaux et du fuseau horaire par défaut de la JVM. Sélectionnez Exécuter en tant que serveur pour que l'appel soit exécuté dans le contexte d'appel de la JVM.
- Spécifié
- Le conteneur appelle la méthode dans le contexte d'internationalisation spécifié dans l'attribut. Sélectionnez Exécuter comme spécifié pour que l'appel soit exécuté dans le contexte d'appel personnalisé indiqué dans les règles d'administration, puis indiquez les éléments de contexte personnalisés en complétant les zones Paramètres régionaux et ID fuseau horaire.
Zone Paramètres régionaux
- Code langue. Le code langue correspond idéalement à un des codes à deux caractères minuscules définis par la norme ISO 639 ; cependant, il n'est pas limité aux codes ISO et n'est pas une zone obligatoire. Les paramètres régionaux valides doivent spécifier un code langue s'ils ne spécifient pas de code pays.
- Code pays. Le code pays correspond idéalement à un des codes à deux caractères majuscules définis par la norme ISO 3166 ; cependant, il n'est pas limité aux codes ISO et n'est pas une zone obligatoire. Les paramètres régionaux valides doivent spécifier un code pays s'ils ne spécifient pas de code langue.
- Variante. Il s'agit d'un code spécifique au fournisseur. La variante n'est pas une zone obligatoire et ne sert qu'à compléter les zones de code langue ou pays, en fonction de la configuration requise par l'application ou la plateforme.
Les paramètres régionaux valides doivent indiquer au moins un code langue ou un code pays ; la variante est toujours facultative. Le premier paramètre régional de la liste est renvoyé lors de l'accès au contexte d'appel, à l'aide de la méthode getLocale de l'API du contexte d'internationalisation.
Zone d'ID fuseau horaire
Cette zone indique un identificateur abrégé pour un fuseau horaire que le conteneur limite à un appel. Vous pouvez également configurer la zone ID fuseau horaire pour les méthodes métier des services Web.
Un fuseau horaire représente un décalage temporal et calcule des informations relatives à l'heure d'été. Un ID correct indique un fuseau horaire pris en charge par le type java.util.TimeZone. Un ID valide correspond notamment à tous les ID apparaissant dans la liste d'ID de fuseau horaire renvoyés par la méthode java.util.TimeZone.getAvailableIds(), ou à un ID personnalisé dont le format est GMT[+|-]hh[[:]mm]; par exemple, Amérique/Los_Angeles, GMT-08:00 sont des ID de fuseau horaire valides.