Mit umfangreichen XML-Nachrichten arbeiten

Wenn ein Eingabebitstrom syntaktisch analysiert und eine logische Baumstruktur erstellt wird, ist die Darstellung einer XML-Nachricht in Form einer Baumstruktur in der Regel umfangreicher, in einigen Fällen sogar wesentlich umfangreicher, als der Ausgangsbitstrom.

Zu den Gründen für diese Erweiterung zählen folgende:

Die Bearbeitung einer umfangreichen Nachrichtenbaumstruktur kann viel Speicherplatz erfordern. Wenn Sie einen Nachrichtenfluss entwerfen, in dem umfangreiche Nachrichten mit sich wiederholenden Strukturen verarbeitet werden, können Sie ESQL-Anweisungen codieren und so den auf dem Broker erforderlichen Speicherplatz reduzieren. Diese Anweisungen unterstützen sowohl den wahlfreien als auch den sequenziellen Zugriff auf die Nachricht. Es wird jedoch vorausgesetzt, dass Sie nicht gleichzeitig auf die gesamte Nachricht zugreifen müssen.

Mit diesen ESQL-Anweisungen führt der Broker nur eine eingeschränkte Syntaxanalyse für die Nachricht durch, und es wird nur jeweils der Teil der Nachrichtenbaumstruktur gespeichert, der einen einzelnen Datensatz darstellt. Wenn bei der Verarbeitung die Informationen von Datensatz zu Datensatz beibehalten werden müssen (beispielsweise bei der Berechnung des Gesamtpreises auf Basis der sich wiederholenden Artikel in einer Bestellung), können Sie ESQL-Variablen deklarieren, initialisieren und beibehalten oder die Werte in einem anderen Teil der Nachrichtenbaumstruktur speichern, beispielsweise in 'LocalEnvironment'.

Mit diesem Verfahren benötigt der Broker nur Speicherplatz für die vollständigen Ein- und Ausgabebitströme und für einen Datensatz der Nachrichtenbaumstrukturen. Es ist auch dann weniger Speicher erforderlich, wenn eine Nachricht eine geringe Anzahl sich wiederholender Elemente enthält. Der Broker führt nur eine teilweise Syntaxanalyse durch und nutzt die Möglichkeit, bestimmte Bereiche der Nachrichtenbaumstruktur in und aus dem entsprechenden Bereich des Bitstroms syntaktisch zu analysieren.

Zur Anwendung dieser Verfahren in Ihrem Rechenknoten müssen Sie die folgenden allgemeinen Verfahren einsetzen:

Sie können diese Verfahren variieren und so an die Verarbeitung anpassen, die für Ihre Nachrichten erforderlich ist.

Der folgende ESQL-Code ist ein Beispiel einer Implementierung und stellt eine Modifikation des ESQL-Beispiels im Abschnitt Komplexe Nachricht umwandeln dar. In diesem Code wird mittels einer einzelnen SET-Anweisung mit verschachtelten SELECT-Funktionen eine Nachricht umgewandelt, die verschachtelte, sich wiederholende Strukturen enthält.

-- Copy the MQMD header
  SET OutputRoot.MQMD = InputRoot.MQMD;

-- Create a special folder in the output message to hold the input tree
-- Note : SourceMessageTree is the root element of an XML parser
  CREATE LASTCHILD OF OutputRoot.XMLNS.Data DOMAIN 'XMLNS' NAME 'SourceMessageTree';

-- Copy the input message to a special folder in the output message
-- Note : This is a root to root copy which will therefore not build trees
  SET OutputRoot.XMLNS.Data.SourceMessageTree = InputRoot.XMLNS;

-- Create a special folder in the output message to hold the output tree
  CREATE FIELD OutputRoot.XMLNS.Data.TargetMessageTree;

-- Prepare to loop through the purchased items
  DECLARE sourceCursor REFERENCE TO OutputRoot.XMLNS.Data.SourceMessageTree.Invoice;
  DECLARE targetCursor REFERENCE TO OutputRoot.XMLNS.Data.TargetMessageTree;
  DECLARE resultCursor REFERENCE TO OutputRoot.XMLNS.Data;
  DECLARE grandTotal   FLOAT     0.0e0;

-- Create a block so that it's easy to abandon processing
  ProcessInvoice: BEGIN
  -- If there are no Invoices in the input message, there is nothing to do
    IF NOT LASTMOVE(sourceCursor) THEN
      LEAVE ProcessInvoice;
    END IF;

  -- Loop through the invoices in the source tree
  InvoiceLoop : LOOP
    -- Inspect the current invoice and create a matching Statement
    SET targetCursor.Statement = THE (SELECT 'Monthly' AS (XML.Attribute)Type,
                                             'Full'                                       AS (0x03000000)Style[1],
                                             I.Customer.FirstName                         AS Customer.Name,
                                             I.Customer.LastName AS Customer.Surname,                                                                    I.Customer.Title AS Customer.Title,
                                             (SELECT
                                               FIELDVALUE(II.Title)              AS Title,
                                               CAST(II.UnitPrice AS FLOAT) * 1.6 AS Cost,
                                               II.Quantity                       AS Qty
                                             FROM I.Purchases.Item[] AS II
                                             WHERE II.UnitPrice > 0.0 ) AS Purchases.Article[],
                                             (SELECT
                                               SUM( CAST(II.UnitPrice AS FLOAT) *
                                                    CAST(II.Quantity  AS FLOAT) *
                                                    1.6                          )
                                             FROM I.Purchases.Item[] AS II        )        AS Amount,
                                             'Dollars'                                      AS Amount.(XML.Attribute)Currency
                                           FROM sourceCursor AS I
                                           WHERE I.Customer.LastName <> 'White');

                                       -- Turn the current Statement into a bit stream
                                       DECLARE StatementBitStream BLOB
                                         CAST(ASBITSTREAM(targetCursor.Statement OPTIONS FolderBitStream) AS BLOB);

                                       -- If the SELECT produced a result
                                       -- (that is, it was not filtered out by the WHERE clause),
                                       -- process the Statement
                                       IF StatementBitStream IS NOT NULL THEN
                                         -- create a field to hold the bit stream in the result tree
                                         CREATE LASTCHILD OF resultCursor
                                           Type  XML.BitStream
                                           NAME  'StatementBitStream'
                                           VALUE StatementBitStream;
                                         
                                         -- Add the current Statement's Amount to the grand total
                                         -- Note that the cast is necessary because of the behavior
                                         -- of the XML syntax element
                                         SET grandTotal = grandTotal + CAST(targetCursor.Statement.Amount AS FLOAT);
                                       END IF;

                                       -- Delete the real Statement tree leaving only the bit stream version
                                       DELETE FIELD targetCursor.Statement;

                                       -- Step onto the next Invoice,
                                       -- removing the previous invoice and any
                                       -- text elements that might have been
                                       -- interspersed with the Invoices

                                       REPEAT
                                         MOVE sourceCursor NEXTSIBLING;
                                         DELETE PREVIOUSSIBLING OF sourceCursor;
                                       UNTIL (FIELDNAME(sourceCursor) = 'Invoice') OR (LASTMOVE(sourceCursor) = FALSE)
                                       END REPEAT;

                                       -- If there are no more invoices to process, abandon the loop                                                 IF NOT LASTMOVE(sourceCursor) THEN
                                         LEAVE InvoiceLoop;
                                       END IF;

                                     END LOOP InvoiceLoop;
                                   END ProcessInvoice;

                                   -- Remove the temporary source and target folders
                                   DELETE FIELD OutputRoot.XMLNS.Data.SourceMessageTree;
                                   DELETE FIELD OutputRoot.XMLNS.Data.TargetMessageTree;

                                   -- Finally add the grand total
                                   SET resultCursor.GrandTotal = grandTotal; 
Dieser ESQL-Code erstellt die folgende Ausgabenachricht:
<Data>
 <Statement Type="Monthly" Style="Full">
  <Customer>
   <Name>Andrew</Name>
   <Surname>Smith</Surname>
   <Title>Mr</Title>
  </Customer>
  <Purchases>
   <Article>
    <Title>The XML Companion </Title>
    <Cost>4.472E+1</Cost>
    <Qty>2</Qty>
   </Article> 
   <Article>
    <Title>A Complete Guide to DB2 Universal Database</Title>
    <Cost>6.872E+1</Cost>
    <Qty>1</Qty>
   </Article> 
   <Article>
    <Title>JAVA 2 Developers Handbook</Title>
    <Cost>9.5984E+1</Cost>
    <Qty>1</Qty>
   </Article>
  </Purchases>
  <Amount Currency="Dollars">2.54144E+2</Amount>
  </Statement>
  <GrandTotal>2.54144E+2</GrandTotal>
 </Data>  
Zugehörige Konzepte
Nachrichtenflüsse - Übersicht
Übersicht zu ESQL
Zugehörige Tasks
Nachrichtenfluss entwerfen
Nachrichtenflussinhalte definieren
ESQL-Dateien verwalten
Komplexe Nachricht umwandeln
Zugehörige Verweise
Compute-Knoten
DELETE-Anweisung
ASBITSTREAM-Funktion
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac67176_