Mit Nachrichteneigenschaften arbeiten
Sie können durch Bearbeitung der Nachrichteneigenschaften die nachfolgende Bearbeitung beeinflussen.
Vorbereitende Schritte
Informationen zu diesem Vorgang
- Systemeigenschaften (einschließlich JMS-Headern, JMSX-Eigenschaften und JMS_IBM_properties)
- Benutzereigenschaften
Durch die Bearbeitung der Nachrichteneigenschaften können Sie bestimmen, welche Nachrichten von einer späteren Mediation verarbeitet werden sollen, und wie Nachrichten durch eine nachgeordnete Anwendung oder Mediation verarbeitet werden sollen. Die Regel, die im Feld "Selektor" während der Konfiguration einer Mediation angegeben wird, testet die Werte in den Nachrichteneigenschaften.
Die Eigenschaften können mit der Schnittstelle "SIMessage", die im Artikel SIMessage beschrieben wird, aufgerufen, geändert und gelöscht werden. Es gibt drei Gruppen von Methoden:
- Die folgenden Methoden arbeiten mit Systemeigenschaften und Benutzereigenschaften, wenn dem Namen das Präfix
user. vorangestellt wird:
- getMessageProperty
- setMessageProperty
- deleteMessageProperty
- clearMessageProperties
- Die folgenden Methoden arbeiten nur mit Benutzereigenschaften, die ohne das Präfix user. angegeben werden können:
- getUserProperty
- setUserProperty
- deletUserProperty
- clearUserProperties
- getUserPropertyNames gibt eine Liste mit den Namen der Benutzereigenschaften in der Nachricht zurück.
Vorgehensweise
Beispiel
Das folgende Codefragment ist ein Beispiel für einen Mediationsfunktionscode für die Bearbeitung von Nachrichteneigenschaften:
String task = (String)msg1.getUserProperty("task");
if (task != null) {
if (task.equals("addColor")) {
msg1.setMessageProperty(SIProperties.JMS_IBM_Format, "colorful");
msg1.setUserProperty("background","green");
msg1.setUserProperty("foreground","purple");
msg1.setUserProperty("depth",new Integer(3));
msg1.deleteUserProperty("task");
}
else {
msg1.clearUserProperties();
}
}