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.

Beispielsweise ruft eine JMS-Anwendung eine Eigenschaft wie folgt auf:
setStringProperty("color", "green");
Eine Mediation kann mit den folgenden Aufrufen auf die Eigenschaft zugreifen:
  • getMessageProperty("user.color");  
  • getUserProperty("color");
Anmerkung: Mediationsnachrichtenselektoren müssen das Präfix user enthalten.
JMS-Eigenschaftenmethoden wirken sich nur auf Benutzereigenschaften aus, die einen Typ haben, der von der JMS-API unterstützt wird:
  • 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.
Beachten Sie, dass setxxxxProperty("xxxx", value) eine Benutzereigenschaft jedes Typs überschreibt, wenn der Wert nicht null ist.

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjp0027_
Dateiname:rjp0027_.html