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.
setStringProperty("color", "green");
Une
médiation peut accéder à la propriété en effectuant l'un des appels suivants :getMessageProperty("user.color");
getUserProperty("color");
- 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.