Mediationshandler schreiben

Sie können einen Mediationshandler schreiben, ihm eine Mediationsfunktion hinzufügen und ihn für die Installation in einem Anwendungsserver vorbereiten.

Vorbereitende Schritte

Sie müssen Zugriff auf eine Java™-Programmierumgebung und ein Assembliertool wie IBM® Rational Application Developer haben.

Informationen zu diesem Vorgang

Ein Mediationshandler kann implementiert werden. Jeder Mediationshandler führt zur Laufzeit bestimmte Nachrichtenverarbeitungsoperationen aus, z. B. das Konvertieren eines Nachrichtenformats oder das Weiterleiten einer Nachricht an ein bestimmtes Ziel. Ein Mediationshandler ist ein Java-Programmframework, dem Sie den Code hinzufügen, der die Mediationsfunktion ausführt.

Sie können eine Mediationshandlerklasse in einem Java-Projekt oder einem EJB-Projekt definieren (was für das Implementierungsartefakt erforderlich ist). Die Programmierung- und Implementierungsartefakte können in gesonderten Projekten verwaltet werden. Die folgenden Schritte gelten für ein EJB-Projekt. Sie gleichen den Schritten für die Erstellung eines Java-Projekts aber sehr, weil Sie jeweils entweder einen Zielserver für ein Java-Projekt oder ein EJB-Projekt erstellen und das Server-Laufzeit-Plug-in den Klassenpfad ordnungsgemäß festlegt.

Vorgehensweise

  1. Erstellen Sie ein neues EJB-Projekt:
    1. Wechseln Sie in die Java EE-Perspektive, um mit Java EE-Projekten zu arbeiten. Klicken Sie auf Fenster > Perspektive öffnen > Andere > Java EE.
    2. Wählen Sie im Menü "Datei" die Optionen Neu > Projekt aus.
    3. Erweitern Sie den Java EE-Ordner und wählen Sie "Unternehmensanwendungsprojekt" aus. Klicken Sie auf Weiter.
    4. Optional: Wenn Sie anstelle eines EJB-Projekts ein Java-Projekt erstellt haben, klicken Sie mit der rechten Maustaste auf das Ordnersymbol für das Java-Projekt, damit das Kontextmenü angezeigt wird, und wählen Sie "Eigenschaften" aus. Wenn die Anzeige "Eigenschaften" erscheint, wählen Sie die Servereigenschaften aus, und ordnen Sie das Projekt, wie im folgenden Schritt gezeigt, einem geeigneten Server zu.
    5. Geben Sie Namen für das Projekt ein, und ordnen Sie das Projekt einem geeigneten Server für Ihr System zu. (Wenn Sie das Ziel für den Server zum ersten Mal auswählen, klicken Sie auf Neu....) Klicken Sie auf Weiter, um das Fenster EAR-Modulprojekte aufzurufen.
    6. Klicken Sie auf Neues Modul....
    7. Erstellen Sie ein neues Modulprojekt. Wählen Sie dazu das Kontrollkästchen für das EJB-Projekt aus, und geben Sie dann den Namen Ihres Mediationshandler ein.
    8. Klicken Sie auf Fertigstellen. Das Fenster EAR-Modulprojekte wird wieder angezeigt.
    9. Klicken Sie auf Fertigstellen, um das neue Projekt zu erstellen.
  2. Erstellen Sie eine Mediationshandlerklasse. Implementieren Sie dazu die Schnittstelle com.ibm.websphere.sib.mediation.handler.MediationHandler.
    1. Wählen Sie im Menü "Datei" die Optionen Neu > Java-Klasse aus.
    2. Geben Sie den Quellenordner für Ihr Mediations-EAR-Projekt ein.
    3. Geben Sie einen Namen für Ihren Mediationshandler ein.
    4. Wählen Sie die Superklasse java.lang.Object aus.
    5. Wählen Sie die Schnittstelle com.ibm.websphere.sib.mediation.handler.MediationHandler aus.
    6. Wählen Sie das Kontrollkästchen Übernommene abstrakte Methoden aus.
    7. Klicken Sie auf Fertigstellen, um die neue Mediationshandlerklasse zu erstellen.
  3. Fügen Sie mit IBM Rational Application Developer Funktionscode hinzu, der Nachrichten an den Mediationshandler umsetzt oder weiterleitet. Weitere Informationen finden Sie unter Dem Handler-Code Mediationsfunktionen hinzufügen. Beachten Sie, dass der Standardrückgabewert für die vom Toolkit erstellte Bearbeitungsmethode false ist, d. h. die Nachricht wird verworfen. Sie müssen den Rückgabewert in true ändern, wenn die Nachricht beibehalten werden soll.
  4. Generieren Sie eine EAR-Datei aus Ihrer Mediationshandlerklasse. Folgen Sie den Anweisungen in der Dokumentation von IBM Rational Application Developer.

Nächste Schritte

Jetzt können Sie die EAR-Datei mit Ihrem Mediationshandler im Anwendungsserver installieren.

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjy1700
Dateiname:tjy1700.html