In einem .NETInput-Knoten verwendete Methoden

Welche Methoden in einem .NETInput-Knoten implementiert werden können, hängt davon ab, ob abfrage- oder ereignisgesteuerte Nachrichtenflüsse verwendet werden.

Die Anwendungsprogrammierschnittstelle (API) für den .NETInput-Knoten heißt Connector-API. Diese API befindet sich im Namensbereich IBM.Broker.Plugin.Connector.

Initialize
Die Methode Initialize wird aufgerufen, wenn ein Nachrichtenfluss, der den .NETInput-Knoten enthält, auf einem Integrationsserver (Ausführungsgruppe) implementiert wird. Wenn von der Methode Initialize eine Ausnahme ausgelöst wird, macht sie die Implementierung des Nachrichtenflusses rückgängig.

Start
Verwenden Sie die Methode Start zum Erstellen erforderlicher Verbindungen mit dem Endsystem, von dem der .NETInput-Knoten Daten abruft. Diese Methode wird nach der Methode Initialize aufgerufen, nachdem ein Nachrichtenfluss, der den .NETInput-Knoten enthält, erfolgreich implementiert wurde.

Wenn die Methode Start eine Ausnahme auslöst, hat das keinen Einfluss auf das Ergebnis der Implementierung des Nachrichtenflusses. Eine solche Ausnahme berichtet einen Fehler an das Systemprotokoll; nach einer kurzen Wartezeit wird die Methode Start dann erneut aufgerufen.

Ereignisconnector

Diagramm einer MSMQ-Anwendungseingabe in einen .NETInput-Knoten

Wenn Sie den ereignisgesteuerten Typ des .NETInput-Knotens verwenden, müssen Sie eine benutzerdefinierte Beauftragung bei der Anwendung registrieren, die die Quelle der Ereignisse ist, die den .NETInput-Knoten steuern. Falls Sie den ereignisgesteuerten Typ verwenden, aber keine Beauftragung in der Methode Start registrieren, hat der .NETInput-Knoten keine Möglichkeit, Daten an die Nachrichtenflussthreads weiterzugeben. Die Methode User Delegate ist für die Erstellung von NBEvent-Objekten und deren Übergabe an die Methode DeliverEvent, die mit der Klasse NBEventConnector bereitgestellt wird, verantwortlich. Die Methode DeliverEvent reiht Daten in eine speicherinterne Warteschlange ein, auf die die Nachrichtenflussthreads zugreifen, um die Daten im NBEvent-Objekt zu übergeben.

ReadData

Abfragegesteuerte Connector

Diagramm des .NETInput-Knotens in einer MSMQ-Beispielkonfiguration, in der ReadData() zurück an die MSMQ-Warteschlange gesendet wird.

Wenn Sie den abfragegesteuerten Typ des .NETInput-Knotens verwenden, müssen Sie die Methode ReadData aus der Basisklasse NBPollingConnector implementieren. Ihre ReadData-Methode wird vom internen Code des Brokers aufgerufen, d. h., der Entwickler eines .NETInput-Knotens muss die Methode lediglich implementieren und ist nicht dafür verantwortlich, Code für den eigentlichen Aufruf der Methode bereitzustellen. Deshalb ist der .NETInput-Knoten nicht für die Implementierung irgendeiner rekursiven Abfragelogik verantwortlich und es demzufolge auch nicht notwendig oder ratsam, eine Schleife oder eine Sleep-Methode als Teil der ReadData-Methode zu codieren.

Der Broker führt die Methode ReadData automatisch nach Abschluss der Nachrichtenflussimplementierung aus, sofern die Methode Start ohne eine Ausnahme zurückgekehrt ist.

Die Methode ReadData ist für die Entgegennahme von Daten von der Datenquelle, falls verfügbar, verantwortlich und gibt eine Instanz des NBPollingResult-Objekts zurück. Wenn Daten verfügbar sind, ist das zurückgegebene NBPollingResult-Objekt entweder ein integriertes NBByteArrayPollingResult-Objekt, das die Ausgabenachricht direkt aus dem Byte-Array erstellt, oder eine benutzerdefinierte Unterklasse, die es Ihnen ermöglicht, die Nachrichtenbaumstruktur manuell zu erstellen.

Das folgende Diagramm zeigt ein Beispiel für eine Abfrage mithilfe der Methode ReadData.

Diagramm eines Nachrichtenflussthreads für einen abfragegesteuerten Typ des .NETInput-Knotens mit Warteintervallen

Wenn keine Daten verfügbar sind, gibt der Knotenentwickler ein NBTimeoutPollingResult-Objekt zurück. Wenn die Methode ReadData die übergebene Zeitlimitdauer (T1) gewartet hat, verwenden Sie für NBTimeoutPollingResult den Konstruktor mit einem einzelnen Argument. Falls die Datenquelle kein zeitgesteuertes Warten zulässt, verwenden Sie den Konstruktor mit zwei Argumenten, um einen Zeitlimitwert an den Broker zurückzugeben. In diesem Fall wartet der Broker dieses Zeitlimitintervall (T2) lang, bevor er ReadData erneut aufruft. Dies ermöglicht es dem Entwickler des .NETInput-Knotens, die Dauer des Intervalls zwischen Abfragen (T2) zu steuern.

Es kann beispielsweise eine mit dem Stapelbetrieb vergleichbare Operation implementiert werden, die nur einmal pro Stunde oder einmal pro Tag die Ausführung der Methode ReadData anfordert.

Finish
Die Methode Finish wird aufgerufen, wenn der .NETInput-Knoten, der den Connector verwendet, das Empfangen von Daten stoppen soll. Wenn Sie einen Nachrichtenfluss entfernen, der einen .NETInput-Knoten enthält, der auf einem Integrationsserver implementiert ist, wird die Methode Finish vor der Methode Terminate aufgerufen. Falls die Methode Finish eine Ausnahme auslöst, wird der Fehler an das Systemprotokoll berichtet und der Connector in den Stoppstatus versetzt. Diese Methode eignet sich gut zum Schließen von Verbindungen oder Handles (oder ähnlichem).

Terminate
Die Methode Terminate wird aufgerufen, wenn ein Nachrichtenfluss, der den .NETInput-Knoten enthält, von einem Integrationsserver entfernt wird. Diese Methode bietet Ihnen die Möglichkeit, einen Code immer sauber zu beenden, falls Sie irgendwelche Aktionen ausführen möchten, bevor Sie einen implementierten Nachrichtenfluss, der einen .NETInput-Knoten enthält, entfernen.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-07-18 03:07:35


ReferenzthemaReferenzthema | IBM Integration Bus Version 9.0.0.0 | bc34237_