Propriétés des utilisateurs

La prise en charge des propriétés utilisateur est fournie par l'interface SIMessage et le sélecteur de configuration des médiations. L'API JMS prend en charge les propriétés utilisateur de type encapsuleur primitif et chaîne. Le nom de la propriété peut correspondre à tout identificateur Java™ valide à condition de ne pas commencer par le préfixe JMS. L'API SIMessage prend également en charge les propriétés utilisateur de type encapsuleur primitif et chaîne, mais accepte en plus les types byte[] et sérialisable. Des objets sérialisables arbitraires sont stockés sous forme de tableaux d'octets et ne sont sélectionnés que comme tableaux d'octets (à l'aide de signes "égal" uniquement).

Les propriétés utilisateur prises en charge par l'API SIMessage doivent commencer par le préfixe user. Vous pouvez définir ces propriétés et y accéder à l'aide de getMessageProperty, setMessageProperty et deleteMessageProperty.

Interaction avec JMS

Vous pouvez également définir des propriétés utilisateur et y accéder à l'aide des méthodes xxxUserProperty. Dans ce cas, le préfixe user doit être omis. Le nom de la propriété, sans le préfixe user, existe dans le même espace de nom que les propriétés de l'utilisateur JMS.

Par exemple, une application JMS appelle une propriété de la manière suivante :
setStringProperty("color", "green");
Une médiation peut accéder à la propriété en effectuant l'un des appels suivants :
  • getMessageProperty("user.color");  
  • getUserProperty("color");
Remarque : Les sélecteurs de message de médiation doivent contenir le préfixe user.
Les méthodes des propriétés JMS n'affectent que les propriétés utilisateur dont les types sont pris en charge par l'API JMS :
  • clearProperties() n'efface que les propriétés prises en charge par JMS.
  • propertyExists() ne renvoie true que si le type de propriété est pris en charge par JMS.
  • getPropertyNames() n'inclut que les propriétés dont les types sont pris en charge par JMS.
  • setObjectProperty("xxxx", null); n'efface une propriété que si elle est prise en charge par JMS.
Notez que setxxxxProperty("xxxx", valeur) remplace une propriété utilisateur de tout type lorsque la valeur n'est pas null.

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjp0027_
Nom du fichier : rjp0027_.html