DECLARE-Anweisung

Die DECLARE-Anweisung definiert eine Variable, ihren Datentyp und - optional - ihren Anfangswert.

SYNTAX

Hinweise:

  1. Das Schlüsselwort SHARED ist in einer Funktion oder Prozedur nicht zulässig.
  2. Sie können SHARED nicht mit dem Datentyp REFERENCE TO angeben. (Verwenden Sie den Datentyp ROW, um eine Nachrichtenbaumstruktur in einer gemeinsamen Variablen zu speichern.)
  3. EXTERNE Variablen sind implizit konstant.
  4. Geben Sie bei der Programmierung einer EXTERNEN Variablen einen Anfangswert.
  5. Wenn Sie den Datentyp REFERENCE TO angeben, müssen Sie den Anfangswert (einer Variablen oder einer Baumstruktur) in UrsprünglicherWertAusdruck angeben.
  6. Wenn Sie die Klauseln NAMESPACE und NAME verwenden, sind die Werte implizit konstant und haben den Typ CHARACTER.

Variablentypen

Mit der DECLARE-Anweisung können Sie drei Variablentypen definieren:
Extern
Externe Variablen (definiert durch das Schlüsselwort EXTERNAL) werden auch benutzerdefinierte Eigenschaften genannt: (Details hierzu unter Benutzerdefinierte Eigenschaften in ESQL). Sie existieren über den gesamten Lebenszyklus eines Nachrichtenflusses und sind für alle Nachrichten, die den Fluss durchlaufen, sichtbar. Externe Variablen können nur auf Modul- und Schemaebene definiert werden. Sie können ihre Anfangswerte (optional festgelegt durch die DECLARE-Anweisung) während der Entwicklung mit dem Nachrichtenfluss-Editor oder bei der Implementierung mit dem BAR-Editor ändern. Ihre Werte können später nicht mit ESQL modifiziert werden.
Normal
"Normale" Variablen haben eine Lebensdauer von nur einer Nachricht, die einen Knoten durchläuft und sind nur für diese Nachricht sichtbar. Übergehen Sie bei der Definition einer "normalen" Variablen die Schlüsselwörter EXTERNAL und SHARED.
Gemeinsam
Gemeinsame Variablen können zur Implementierung eines Speichercaches in den Nachrichtenfluss verwendet werden (weitere Informationen unter Reaktionszeiten von Nachrichtenflüssen optimieren). Gemeinsame Variablen haben eine lange Lebensdauer und sind für mehrere Nachrichten sichtbar, die einen Nachrichtenfluss durchlaufen (weitere Informationen unter Langlebige Variablen). Sie bestehen für die Lebensdauer des Prozesses der Ausführungsgruppe, für die Lebensdauer des Flusses oder Knotens oder für die Lebensdauer der SQL des Knotens, die die Variable deklariert (immer die kürzestes Lebensdauer). Sie werden initialisiert, wenn die erste Nachricht nach jeder Broker-Initialisierung den Fluss oder Knoten durchläuft.

Lesen Sie auch die Hinweise zur Option ATOMIC der BEGIN ... END-Anweisung. Das Konstrukt BEGIN ATOMIC ist nützlich, wenn mehrere Änderungen an einer gemeinsamen Variablen vorgenommen werden, und der Zwischenstatus der Daten für andere Instanzen nicht sichtbar sein soll.

CONSTANT

Definieren Sie eine Konstant mit CONSTANT. Konstanten innerhalb von Schemata, Modulen, Routinen oder zusammengesetzten Anweisungen können (sowohl implizit als auch explizit) deklariert werden. Das Verhalten dieser Fälle wird in der folgenden Liste dargestellt:

Eine Konstante oder Variable, die innerhalb einer Routine deklariert wurde, überschreibt alle Parameter und alle in einem enthaltenen Modul oder Schema deklarierten Konstanten und Variablen mit demselben Namen.

Datentyp

Folgende Werte können Sie als Datentyp angeben:
  • BOOL
  • BOOLEAN
  • INT
  • INTEGER (Ganze Zahl)
  • FLOAT (Gleitkommazahl)
  • DEC
  • DECIMAL
  • DATE
  • TIME
  • TIMESTAMP
  • GMTTIME
  • GMTTIMESTAMP
  • INTERVAL. Dies gilt nicht für externe Variablen (Option EXTERNAL angegeben)
  • CHAR (Zeichen)
  • CHARACTER
  • BLOB
  • BIT
  • ROW. Dies gilt nicht für externe Variablen (Option EXTERNAL angegeben)
  • REF. Dies gilt nicht für externe oder gemeinsame Variablen (Option EXTERNAL oder SHARED angegeben)
  • REFERENCE TO. Dies gilt nicht für externe oder gemeinsame Variablen (Option EXTERNAL oder SHARED angegeben)

EXTERNAL

Mit EXTERNAL zeigen Sie eine benutzerdefinierte Eigenschaft (UDP) an. Eine UDP ist eine benutzerdefinierte Konstante, deren Anfangswert (optional von der DECLARE-Anweisung festgelegt) bei der Entwicklung vom Nachrichtenflusseditor geändert (siehe Nachrichtenflusseditor) bzw. bei der Implementierung vom Brokerarchiveditor überschrieben (siehe Brokerarchiveditor) werden kann. Ihr Wert kann nicht von ESQL geändert werden.

Eine Übersicht über benutzerdefinierte Eigenschafen finden Sie unter Benutzerdefinierte Eigenschaften in ESQL.

Wenn eine UDP in der DECLARE-Anweisung einen Anfangswert erhält, wird dieser als Standardwert verwendet. Jeder Wert, der bei der Entwicklung im Nachrichtenfluss-Editor bzw. während der Implementierung im 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 während der Ausführung von nachfolgenden ESQL-Anweisungen abgefragt, aber nicht geändert werden.

Der Vorteil von UDPs liegt darin, dass ihre Werte während der Implementierung geändert werden 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.

UDPs können nur in Modulen oder Schemas deklariert werden. Das bedeutet, dass Sie die DECLARE-Anweisung mit dem EXTERNAL-Suchbegriff ausschließlich auf der MODULE- oder SCHEMA-Ebene verwenden können. Wenn Sie eine DECLARE-Anweisung mit dem Schlüsselwort EXTERNAL in einer PROZEDUR oder FUNKTION verwenden, wird die Ausnahme BIP2402E erzeugt, wenn Sie den Nachrichtenfluss implementieren.

Folgende Arten von Broker-Knoten können auf UDPs zugreifen:
  • Compute-Knoten
  • Datenbank-Knoten
  • Filter-Knoten
  • Aus diesen Knotentypen abgeleitete Knoten

Legen Sie den Datentyp einer UDP mit Bedacht fest, da mit dem Typ CAST der Wert des angeforderten Datentyps geändert wird.

Beispiel 1

DECLARE mycolour EXTERNAL CHARACTER ‘blue'; 

Beispiel 2

DECLARE TODAYSCOLOR EXTERNAL CHARACTER;
SET COLOR = TODAYSCOLOR;
wobei es sich bei TODAYSCOLOR um eine benutzerdefinierte Eigenschaft vom Typ CHARACTER und mit einem vom Nachrichtenfluss-Editor festgelegten WERT ist.

NAME

Mit NAME definieren Sie einen Aliasnamen (d. h. einen alternativen Namen), unter dem eine Variable bekannt sein kann.

Beispiel 1

-- Die nachfolgende Anweisung gibt Schema1 den Aliasnamen 'Joe'.
DECLARE Schema1 NAME 'Joe';  
-- Die nachfolgende Anweisung erstellt ein Feld 'Joe'.
SET OutputRoot.XMLNS.Data.Schema1 = 42; 
 
-- Die nachfolgende Anweisung fügt einen Wert in eine Tabelle namens Table1 
-- im Schema 'Joe' ein.
INSERT INTO Database.Schema1.Table1 (Answer) VALUES 42; 

Beispiel 2

DECLARE Schema1 EXTERNAL NAME;

CREATE FIRSTCHILD OF OutputRoot.XMLNS.TestCase.Schema1 Domain('XMLNS') 
                     NAME 'Node1' VALUE '1';

-- Wenn Schema1 den Wert 'red' erhalten hat, lautete das Ergebnis:
<xml version="1.0"?>
<TestCase>
  <red>
    <Node1>1</Node1>
  </red>

NAMESPACE

Mit NAMESPACE definieren Sie einen Aliasnamen (d. h. einen alternativen Namen), unter dem ein Namespace bekannt sein kann.

Beispiel

Dies ist ein Beispiel für eine Namespacedeklaration, ihre Verwendung als BereichsId in einem Pfad und als Zeichenkonstante in einem Namespaceausdruck:

       DECLARE prefixOne NAMESPACE 'http://www.example.com/PO1';

       -- Auf der rechten Seite der Zuweisung wird eine Namespacekonstante
       -- als solche verwendet, während auf der linken Seite eine 
       -- als normale Konstante verwendet wird (d. h. in einem Ausdruck).

       SET OutputRoot.XMLNS.{prefixOne}:{'PurchaseOrder'} = 
                      InputRoot.XMLNS.prefixOne:PurchaseOrder;

SHARED

Mit SHARED definieren Sie eine gemeinsame Variable. Gemeinsame Variablen gehören dem Nachrichtenfluss (wenn sie in einem Schema deklariert sind) oder Knoten (wenn sie in einem Modul deklariert sind), werden aber von den Instanzen des Flusses (Threads) gemeinsam verwendet. Kein Variablentyp ist außerhalb der Nachrichtenflussebene sichtbar; so können beispielsweise Variablen nicht von Ausführungsgruppen gemeinsam verwendet werden.

Gemeinsame Variablen können zur Implementierung eines Speichercaches in den Nachrichtenfluss verwendet werden (sieheReaktionszeiten von Nachrichtenflüssen optimieren). Gemeinsame Variablen haben eine lange Lebensdauer und sind für mehrere Nachrichten sichtbar, die einen Nachrichtenfluss durchlaufen (siehe Langlebige Variablen). Sie bestehen für die Lebensdauer des Prozesses der Ausführungsgruppe, für die Lebensdauer des Flusses oder Knotens oder für die Lebensdauer der SQL des Knotens, die die Variable deklariert (immer die kürzestes Lebensdauer). Sie werden initialisiert, wenn die erste Nachricht nach jeder Broker-Initialisierung den Fluss oder Knoten durchläuft.

Sie können keine gemeinsame Variabel innerhalb einer Funktion oder Prozedur definieren.

Die Vorteile gemeinsamer Variablen im Vergleich zu Datenbanken sind:
  • Der Schreibzugriff ist wesentlich schneller.
  • Der Lesezugriff auf kleine Datenstrukturen ist schneller.
  • Der Zugriff ist direkt, d. h. Sie benötigen keine Sonderfunktion (SELECT) für den Datenabruf oder Sonderanweisungen (INSERT, UPDATE oder DELETE), um Daten zu ändern. Stattdessen können Sie in Ausdrücken direkt auf die Daten verweisen.
Die Vorteile von Datenbanken im Vergleich zu gemeinsamen Variablen sind:
  • Die Daten sind persistent.
  • Die Daten werden transaktionsorientiert geändert.

Diese Lese-Schreib-Variablen sind ideal geeignet für Benutzer, die die Persistenz und Transaktionsorientiertheit von Datenbanken gerne gegen eine bessere Leistung eintauschen, da sie eine längere Lebensdauer als nur eine Nachricht und eine bessere Performance als eine Datenbank aufweisen.

Da Variablen, die von mehreren Nachrichtenflüssen gemeinsam verwendet werden, von mehreren Instanzen und Nachrichtenflüssen aktualisiert werden können, müssen Sie sicherstellen, dass die Nachrichtenflüsse bzw. Instanzen keine Änderungen an gemeinsamen Variablen vornehmen, die unerwartete Ergebnisse in anderen Nachrichtenflüssen und Instanzen zur Folge haben könnten (z. B. wenn die Variable als Zähler verwendet wird). Sie können verhindern, dass andere Instanzen die temporären Stufen der Daten sehen können, indem Sie eine BEGIN ATOMIC-Anweisung verwenden (Details hierzu erhalten Sie unter BEGIN ... END-Anweisung).

Gemeinsam in Zeilen verwendete Variablen ermöglichen einem Benutzerprogramm, eine effiziente Lese/Schreibkopie der Nachricht eines Empfangsknotens zu erstellen. Dies ist generell hilfreich und vereinfacht im Speziellen die Bearbeitung großer Nachrichten.

Es besteht die Einschränkung, dass untergeordnete Baumstrukturen nicht direkt aus einer gemeinsamen Zeilenvariablen in eine andere gemeinsamen Zeilenvariable kopiert werden können. Untergeordnete Baumstrukturen lassen sich indirekt unter Verwendung einer Zeilenvariablen kopieren, die nicht gemeinsam genutzt wird. Skalare Werte, die aus einer gemeinsam genutzten Zeilenvariablen extrahiert wurden (mit Hilfe der FIELDVALUE-Funktion), können Sie in eine andere gemeinsam genutzte Zeilenvariable kopieren.

Beispiel

Der folgende Mustercode zeigt die Vorgehensweise zur Verwendung sowohl gemeinsamer als auch externer Variablen: Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.
Zugehörige Konzepte
Übersicht zu ESQL
Benutzerdefinierte Eigenschaften in ESQL
Langlebige Variablen
Zugehörige Tasks
ESQL erstellen
Dynamische Feldverweise erstellen
Nachrichtenfluss zur Implementierungszeit unter Verwendung von benutzerdefinierten Eigenschaften konfigurieren
Reaktionszeiten von Nachrichtenflüssen optimieren
Zugehörige Verweise
Syntaxdiagramme: Verfügbare Typen
ESQL-Anweisungen
ESQL-Datentypen in Nachrichtenflüssen
Nachrichtenflusseditor
FIELDVALUE-Funktion
Brokerarchiveditor
BEGIN ... END-Anweisung
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ak04980_