Benutzerdefinierte Eigenschaften

Eine benutzerdefinierte Eigenschaft (user-defined property =UDP) ist eine Eigenschaft, die bei der Erstellung eines Nachrichtenflusses im Nachrichtenflusseditor definiert wird. Diese Eigenschaft kann vom ESQL- oder Java-Programm innerhalb von Nachrichtenflussknoten verwendet werden (z. B. in Rechen-Knoten).

UDPs haben den Vorteil, dass Administratoren ihre Werte bei der Implementierungs- und Ausführungszeit ändern können. Eine Änderung Ihrer Anwendungsprogramme ist nicht erforderlich. Wenn Sie beispielsweise UDPs zum Implementieren von Daten Ihres Rechners verwenden möchten, können Sie während der Implementierung einen Nachrichtenfluss für einen bestimmten Computer, eine Task oder Umgebung konfigurieren, ohne den Code auf Nachrichtenknotenebene ändern zu müssen.

Wenn Sie den Nachrichtenflusseditor starten, um einen Nachrichtenfluss zu erstellen oder einen vorhandenen Nachrichtenfluss zu ändern, können Sie die Knoten festlegen, die im Nachrichtenfluss erforderlich sind. Des Weiteren haben Sie die Möglichkeit (über die Registerkarte), für einige benutzerdefinierte Eigenschaften Anfangswerte zu definieren und zuzuordnen. Klicken Sie im unteren Bereich des Editorfensters auf die Registerkarte Benutzerdefinierte Eigenschaften. Weitere Informationen finden Sie unter Nachrichtenflusseditor.

Eine UDP muss nicht nur im Nachrichtenflusseditor definiert werden, sondern entweder auch durch die Anweisung DECLARE mit dem Schlüsselwort EXTERNAL in allen ESQL-Programmen, die die UDP verwenden, bzw. durch das Aufrufen der Methode getUserDefinedAttribute in allen JavaCompute-Knoten, die diese verwenden.

Weitere Informationen zur DECLARE-Anweisung finden Sie im Abschnitt DECLARE-Anweisung. Unter Über einen JavaCompute-Knoten auf benutzerdefinierte Nachrichtenflusseigenschaften zugreifen finden Sie Informationen zur Verwendung einer UDP im JavaCompute-Knoten.

Die Werte, die Sie einer UDP zuordnen, wenn Sie sie in einem Nachrichtenfluss definieren, setzen die entsprechenden Variablenwerte in Ihrem ESQL-Programm außer Kraft.

Der Wert einer UDP kann auch zum Implementierungszeitpunkt geändert werden. Verwenden Sie hierzu den Brokerarchiveditor zum Bearbeiten der BAR-Datei. Dieser Wert überschreibt den Wert, der bei der Definition des Nachrichtenflusses zugeordnet wurde.

Der Wert der UDP wird in der Nachrichtenflussebene festgelegt und ist für alle berechtigten Knoten im Nachrichtenfluss identisch. Ein berechtigter Knoten unterstützt UDPs und befindet sich im Gültigkeitsbereich der Deklaration, durch die die UDP in Ihrer Anwendung deklariert wird. Wenn Sie z. B. mit dem Nachrichtenflusseditor den Wert einer Benutzereigenschaft namens timezone (Zeitzone) ändern, die im Schema mySchema (MeinSchema) in einem Nachrichtenfluss namens myFlow (MeinFluss) deklariert ist, ist die UDP bei Laufzeit für alle Knoten in myFlow (MeinFluss) verfügbar, die UDPs unterstützen und in das Schema mySchema (MeinSchema) fallen.

Genauso stehen bei der Verwendung des Nachrichtenflusseditors zum Ändern des Werts einer benutzerdefinierten Eigenschaft in einem untergeordneten Nachrichtenfluss die neu bearbeiteten Eigenschaften allen Knoten im untergeordneten Nachrichtenfluss zur Verfügung, die UDPs unterstützen und sich im Gültigkeitsbereich der Deklaration befinden. Den Knoten im übergeordneten Nachrichtenfluss steht die Eigenschaft nicht zur Verfügung.

Eine UDP gilt global und ist nicht spezifisch für einen bestimmten untergeordneten Nachrichtenfluss. Wenn Sie einen untergeordneten Nachrichtenfluss in einem Nachrichtenfluss nochmals verwenden und diese untergeordneten Nachrichtenflüsse identische UDPs besitzen, können Sie für die UDPs keine unterschiedlichen Werte festlegen.

Benutzerdefinierte Eigenschaften während der Ausführung steuern

Benutzerdefinierte Eigenschaften können während der Ausführung abgefragt, erkannt und festgelegt werden, um das Verhalten eines Nachrichtenflusses dynamisch zu ändern. Mit der Message Broker-API (auch als CMP-API bezeichnet) oder mit dem WebSphere Message Broker Explorer können Sie diese Eigenschaften bearbeiten, die von einem Systemüberwachungstool zur Ausführung automatisierter Aktionen als Reaktion auf Situationen verwendet werden können, die in den überwachten Systemen festgestellt werden.

Beispiel: Ein Nachrichtenfluss enthält einen Route-Knoten, mit dem zwischen den Kundenklassen unterschieden wird, die in der Nachricht definiert sind. Der Route-Knoten hat die benutzerdefinierte Eigenschaft ProcessClasses (Prozessklassen), die mit dem Anfangswert Alle festgelegt ist. Wenn ProcessClasses auf Alle gesetzt ist, leitet der Knoten Nachrichten zur sofortigen Verarbeitung aus allen Kundenklassen an sein erstes Terminal.

Wenn bestimmte Bedingungen festgestellt werden (wenn das Überwachungssystem beispielsweise feststellt, dass das Service-Level-Agreement aufgrund der Anforderungslast das Ziel nicht erreicht), muss der Route-Knoten so festgelegt werden, dass nur Anforderungen von Kunden, die der "Gold"-Klasse angehören, zur sofortigen Verarbeitung weitergeleitet werden. Anforderungen von anderen Kunden werden hingegen an ein anderes Ausgabeterminal gesendet, von dem sie zur späteren Stapelverarbeitung in eine Warteschlange gestellt werden. Daher setzt die Überwachungsanwendung ProcessClasses auf Gold, damit der Route-Knoten die unwichtigeren Nachrichten an das zweite Terminal sendet.

Nutzen Sie eine geeignete Namenskonvention, damit deutlich erkennbar ist, was eine benutzerdefinierte Eigenschaft für Funktionen hat, und welche Werte sie annehmen kann. Die benutzerdefinierte Eigenschaft Eigenschaft01 mit dem Anfangswert WertA ist beispielsweise nicht so aufschlussreich wie die Eigenschaft WeiterleitungAnAoderB mit dem Anfangswert RouteA.

Weitere Informationen finden Sie unter Benutzerdefinierte Nachrichtenflusseigenschafen zur Ausführungszeit in einer Konfigurationsmanager-Proxy-Anwendung festlegen bzw. Benutzerdefinierte Eigenschaften mithilfe des WebSphere Message Broker Explorer dynamisch zur Ausführungszeit festlegen.

Vorrangstellung bei der Überschreibung von Werten für benutzerdefinierte Eigenschaften

Benutzerdefinierte Eigenschaften können folgendermaßen definiert werden:
  • Im ESQL-Knoten
  • Im Nachrichtenflusseditor
  • Durch Überschreiben einer Brokerarchivdatei
  • Über die CMP-API

Eine benutzerdefinierte Eigenschaft wird in ESQL, im Nachrichtenflusseditor oder durch Überschreiben einer Brokerarchivdatei vor der Implementierung der Brokerarchivdatei definiert. Das Überschreiben einer Brokerarchivdatei hat Vorrang vor Änderungen im Nachrichtenflusseditor, und die Änderungen im Nachrichtenflusseditor haben Vorrang vor den Änderungen im ESQL-Code.

Die Vorrangstellung der Werte für benutzerdefinierte Eigenschaften wird im Folgenden veranschaulicht:
  1. Die benutzerdefinierte Eigenschaft ProcessClasses wird in der Brokerarchivdatei eines Nachrichtenflusses auf Alle gesetzt. Nach der Implementierung der Brokerarchivdatei hat ProcessClasses den Wert Alle.
  2. Dieselbe benutzerdefinierte Eigenschaft (ProcessClasses) wird mit der CMP-API auf Gold gesetzt (durch Ausgabe des Aufrufs setUserDefinedProperty(“ProcessClasses”, “Gold”). Nach der erfolgreichen Ausführung dieser Methode hat die Eigenschaft ProcessClasses den Wert Gold.
  3. Der Broker wird heruntergefahren und neu gestartet. ProcessClasses hat nach wie vor den Wert Gold.
  4. Die ursprüngliche Brokerarchivdatei des Flusses wird erneut implementiert. Nach der Implementierung hat ProcessClasses den Wert Alle.
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:16:48


KonzeptthemaKonzeptthema | Version 8.0.0.1 | ac00643_