Benutzereigenschaften
Die Unterstützung für Benutzereigenschaften wird über die Schnittstelle "SIMessage" und den Mediationskonfigurationsselektor bereitgestellt. Die JMS-Anwendungsprogrammierschnittstelle unterstützt Benutzereigenschaften des Typs "primitive wrapper" und "string". Der Eigenschaftsname kann jede gültige Java™-ID sein, sofern diese nicht das Präfix JMS hat. Die Anwendungsprogrammierschnittstelle "SIMessage" unterstützt ebenfalls Benutzereigenschaften des Typs "primitive wrapper" und "string" und darüber hinaus die Typen "byte[]" und "serializable". eBeliebig serialisierbare Objekte werden als Bytefeldgruppen gespeichert und nur als Bytefeldgruppen ausgewählt (nur mit Gleichheitszeichen).
Benutzereigenschaften, die von der Anwendungsprogrammierschnittstelle "SIMessage" unterstützt werden, müssen das Präfix user haben. Sie können diese Eigenschaften mit den Methoden getMessageProperty, setMessageProperty und deleteMessageProperty setzen und aufrufen.
Interaktion mit JMS
Alternativ können Sie mit den Methoden xxxUserProperty Benutzereigenschaften setzen und aufrufen. In diesem Fall muss das Präfix user weggelassen werden. Der Eigenschaftsname ohne das Präfix user ist im selben Namespace wie die JMS-Benutzereigenschaften enthalten.
setStringProperty("color", "green");
Eine Mediation
kann mit den folgenden Aufrufen auf die Eigenschaft zugreifen:
getMessageProperty("user.color");
getUserProperty("color");
- clearProperties() löscht nur die von JMS unterstützten Eigenschaften.
- propertyExists() gibt true nur dann zurück, wenn der Eigenschaftstyp von JMS unterstützt wird.
- getPropertyNames() umfasst nur Eigenschaften mit Typen, die von JMS unterstützt werden.
- setObjectProperty("xxxx", null); löscht eine Eigenschaft nur, wenn es von JMS unterstützt wird.