Propiedades de usuario
La interfaz SIMessage y el selector de configuración de mediación proporcionan soporte para las propiedades de usuario. La API de JMS da soporte a las propiedades de usuario de envoltura primitiva o tipos de serie. El nombre de propiedad puede ser cualquier identificador Java™ válido, siempre que no tenga el prefijo JMS. La API de SIMessage también da soporte a las propiedades de usuario de envoltura primitiva y tipos de serie y soporta adicionalmente byte[] y los tipos serializables. Los objetos serializables arbitrarios se almacenan como matrices de bytes y se seleccionan como matrices de bytes únicamente (utilizando sólo signos de igual).
Las propiedades de usuario a las que da soporte la API de SIMessage deben tener el prefijo user. Puede establecer y acceder a estas propiedades utilizandogetMessageProperty, setMessageProperty y deleteMessageProperty.
Interacción con JMS
Alternativamente, puede establecer y acceder a las propiedades de usuario utilizando los métodos xxxUserProperty. En este caso, se debe omitir el prefijo user. El nombre de la propiedad, excluido el prefijo user, existe en el mismo espacio de nombres que las propiedades de usuario JMS.
setStringProperty("color", "green");
Una mediación puede acceder a la propiedad realizando una de las llamadas siguientes:getMessageProperty("user.color");
getUserProperty("color");
- clearProperties() sólo borra las propiedades soportadas por JMS.
- propertyExists() sólo devuelve true cuando el tipo de propiedad está soportado por JMS.
- getPropertyNames() sólo incluye aquellas propiedades cuyos tipos están soportados por JMS.
- setObjectProperty("xxxx", null); borra una propiedad sólo si está soportada por JMS.