Benutzerdefinierte Eigenschaften

Eine benutzerdefinierte Eigenschaft (UDP) ist eine benutzerdefinierte Konstante, deren Anfangswert bei der Entwicklung vom Nachrichtenflusseditor geändert bzw. bei der Implementierung vom Brokerarchiveditor überschrieben werden kann. Sie können UDPs in Ihren ESQL- bzw. Java-Programmen verwenden. In ESQL können Sie eine UDP für Ihr Programm mit Hilfe der DECLARE-Anweisung definieren. Sie können der UDP einen Anfangswert in der DECLARE-Anweisung zuordnen, jedoch kann Ihr Code den Wert nicht zur Laufzeit modifizieren.

Wenn eine UDP in der DECLARE-Anweisung einen Anfangswert erhält, wird dieser als Standardwert verwendet. Jeder Wert, der bei der Entwicklung vom Nachrichtenfluss-Editor bzw. während der Implementierung vom BAR-Editor festgelegt wird (sogar Zeichenfolgen mit Null-Länge), überschreibt jedoch jeden in der DECLARE-Anweisung codierten Anfangswert.

Alle UDPs in einem Nachrichtenfluss müssen einen Wert haben, der entweder in der DECLARE-Anweisung oder durch den Nachrichtenfluss- bzw. BAR-Editor vergeben wurde. Anderenfalls tritt bei Implementierungszeit ein Fehler auf. Nachdem die UDP deklariert wurde, kann ihr Wert zwar bei Laufzeit von nachfolgenden ESQL-Anweisungen abgefragt, aber nicht geändert werden.

UDPs haben den Vorteil, dass Administratoren ihre Werte bei der Implementierungszeit ändern können. Wenn Sie z. B. mit den UDPs Konfigurationsdaten halten, können Sie bei der Implementierung einen Nachrichtenfluss für einen bestimmten Computer, eine Aufgabe oder Umgebung konfigurieren, ohne den Code auf Knotenebene ändern zu müssen. Konfigurationsdaten müssen z. B. nicht von Plug-Ins aus Datenquellen wie beispielsweise Datenbanken aufgerufen oder in Umgebungsbäume kopiert werden.

Unter Verwendung von UDPs lassen sich Konfigurationsdaten ohne großen Aufwand festlegen und wie normale Konstanten verwenden. Da keine externen Aufrufe von benutzerdefinierten Plug-Ins oder das Parsing von Umgebungsbäumen involviert sind, ist der ESQL-Code einfacher zu schreiben und zu pflegen und lässt sich besser ausführen. Zudem entfallen die Parsing-Kosten für das Herauslesen der Daten aus den Bäumen. Der Wert der benutzerdefinierten Eigenschaft wird bei Implementierung in der Variablen markiert. Dadurch kann sie schneller aufgerufen werden.

Mit der DECLARE-Anweisung fügen Sie Ihren Programmen eine UDP hinzu. UDPs können nur in Modulen oder Schemas deklariert werden.

Folgende Arten von Broker-Knoten können auf UDPs zugreifen:

Wenn Sie mit dem Nachrichtenfluss-Editor den Wert einer benutzerdefinierten Eigenschaft (UDP) ändern, wird ihr Wert auf Flussebene festgelegt und ist für alle auswählbaren, im Fluss enthaltenen Knoten identisch. (Ein "berechtigter Knoten" ist ein Knoten, der UDPs unterstützt und im Bereich der DECLARE-Anweisung liegt, die die UDP Ihrer Anwendung deklariert.) Wenn Sie z. B. mit dem Nachrichtenfluss-Editor den Wert einer Benutzereigenschaft namens "timezone" (Zeitzone) ändern, die im Schema "mySchema" (MeinSchema) in einem Nachrichten-Fluss namens "myFlow" (MeinFluss) deklariert ist, ist die UDP bei Laufzeit allen Knoten in myFlow (MeinFluss) verfügbar, die UDPs unterstützen und in das Schema mySchema (MeinSchema) fallen.

Wenn Sie mit dem Nachrichtenfluss-Editor den Wert einer benutzerdefinierten Eigenschaft (UDP) in einem untergeordneter Nachrichtenfluss ändern, wird steht neu bearbeitete Eigenschaft allen Knoten im untergeordneten Nachrichtenfluss zur Verfügung, die UDPs unterstützen und im Bereich der DECLARE-Anweisung liegen. (Knoten im übergeordneten Fluss steht sie nicht zur Verfügung.)
Anmerkung: Der Eigenschaften-Dialog zeigt nicht die UDP auf Knotenebene an (es sei denn, es handelt sich bei dem Knoten um einen untergeordneten Nachrichtenfluss, für den Sie eine UDP definiert haben). Wenn z. B. die Eigenschaft timezone (Zeitzone) dem Rechenknoten in myFlow (MeinFluss) zur Laufzeit zur Verfügung steht und Sie den Eigenschaften-Dialog des Rechenknotens öffnen können, wird die Eigenschaft timezone (Zeitzone) nicht angezeigt.

Informationen zum Definieren von benutzerdefinierten Eigenschaften für Ihre Programme finden Sie unter DECLARE-Anweisung.

Zugehörige Konzepte
Nachrichtenflüsse - Übersicht
ESQL-Variablen
Zugehörige Tasks
Nachrichtenflüsse entwickeln
UDPs zur Konfiguration eines Nachrichtenflusses zum Zeitpunkt der Implementierung verwenden
Zugehörige Verweise
ESQL-Variablen
DECLARE-Anweisung
Nachrichtenflusseditor
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
ak01015_