Erstellen Sie einen neuen WS-Notification-Service und die zugehörigen Objekte, die die Infrastruktur der WS-Notification-Konfiguration bilden. Verwenden Sie diesen Servicetyp, wenn Sie einen JAX-WS-basierten WS-Notification-Service mit Web-Service-Servicequalitäten über
Richtliniensätze zusammenstellen oder JAX-WS-Handler auf Ihren WS-Notification-Service anwenden möchten. Dies ist der empfohlene Servicetyp für neue Implementierungen. Diese WS-Notification-Option ist in WebSphere Application Server ab Version 7.0 verfügbar.
Vorbereitende Schritte
Legen Sie die Methode fest, die Sie für die Konfiguration dieser Ressourcen verwenden möchten. Sie können einen neuen
WS-Notification-Service der Version 7.0, wie in dieser Task beschrieben, über die Administrationskonsole erstellen, oder Sie können den
Befehl "createWSNService" verwenden.
In der Beschreibung dieser Task wird davon ausgegangen, dass Sie bereits einen Service Integration Bus
(SIB) mit mindestens einem Busmember konfiguriert haben.
Normalerweise konfigurieren Sie einen WS-Notification-Service für einen Service Integration Bus, aber Sie können auch mehrere konfigurieren. Weitere Informationen
finden Sie im Artikel Gründe für das Erstellen mehrerer WS-Notification-Services in einem Bus.
Das Definieren
eines WS-Notification-Service der Version 7.0 ist nicht identisch mit der Bereitstellung eines NotificationBroker-Port
(WSDL), zu dem Web-Service-Anwendungen eine Verbindung herstellen können. Hierfür müssen Sie, wie in dieser Task beschrieben, mindestens einen
WS-Notification-Servicepunkt der Version 7.0 erstellen.
Informationen zu diesem Vorgang
Ein WS-Notification-Service ermöglicht, einige oder alle Messaging-Engines, die in einem Service Integration Bus definiert sind, für WS-Notification-Anwendungen bereitzustellen.
Für die Unterstützung von
Java™ API for XML-based Web Services (JAX-WS) und die Zusammensetzung mit WS-ReliableMessaging erstellen Sie
Ihre WS-Notification-Services als JAX-WS-Anwendungen.
Verwenden Sie anschließend diese Task, um einen WS-Notification-Service der Version 7.0,
einen oder mehrere Servicepunkte und (optional) einen permanenten Topic-Namespace zu erstellen.
Sie können auch JAX-WS-Handler-Listen auf WS-Notification-Servicepunkte (für die Bearbeitung
eingehender Aufrufe) und WS-Notification-Services (für die Bearbeitung abgehender Aufrufe) anwenden.
Wenn Sie einen WS-Notification-Service der Version 7.0 erstellen, erstellt und implementiert der Assistent
eine JAX-WS-basierte Provideranwendung.
Diese Anwendung stellt die WS-Notification-Web-Service-Schnittstellen für jede der drei Rollen des WS-Notification-Service bereit:
- NotificationBroker
- SubscriptionManager
- PublisherRegistrationManager
Vorgehensweise
- Starten Sie die Administrationskonsole.
- Navigieren Sie zu oder . Das Formular
WS-Notification-Services [Sammlung] wird angezeigt.
- Klicken Sie im Inhaltsteilfenster auf Neu. Der Assistent "Neuer WS-Notification-Service" erscheint. Weitere Informationen zu den Eigenschaften, die Sie mit dem Assistenten festlegen, finden Sie im Artikel
WS-Notification-Services [Einstellungen].
- Schritt 1: Namen und Beschreibung für Service Integration Bus sowie Einstellungen für dynamischen Topicbereich konfigurieren.
- Geben Sie den ausgewählten
Namen und optional eine Beschreibung ein.
Der Name ist ein Teil des Endpunkts, an dem der Service bereitgestellt wird (d. h. des URL, der verwendet wird, um auf die WS-Notification-Servicepunkte zuzugreifen, die unter dem Service definiert sind). Für WS-Notification-Services der Version 6.1 ist der Servicename in einem Bus eindeutig. Für WS-Notification-Services der Version 7.0 ist der Servicename in der Zelle eindeutig. Dies entspricht dem Verwaltungsmodell, das für Richtliniensätze verwendet wird, und unterstützt deshalb die Kombination von WS-Notification-Services der Version 7.0 mit WS-ReliableMessaging.
- Wählen Sie die Option Dynamische Topic-Namespaces aktivieren? aus oder ab.
Gibt an, ob dieser Service zulässt, dass zur Laufzeit dynamische Topic-Namespaces erstellt werden. Weitere
Informationen finden Sie unter
Dynamischer
Topic-Namespace.
Verwenden Sie diese Option, um die Topic-Namespaces genau zu steuern, die verwendet werden, wenn eine Verbindung zu einem bestimmten WS-Notification-Service hergestellt wird (z. B. für Sicherheits- oder Prüfanforderungen). Wenn Sie diese Option abwählen, können alle Anwendungen, die eine Verbindung zum WS-Notification-Service herstellen und Topics aus einem dynamischen Topic-Namespace anfordern, keine Nachrichten mehr veröffentlichen und empfangen.
Alle in einem dynamischen Topic-Namespace veröffentlichten Nachrichten werden mit der Standardzuverlässigkeit für Nachrichten zuverlässig, persistent eingefügt. Wenn dieser Wert nicht angemessen ist, erstellen Sie einen permanenten Topic-Namespace und konfigurieren Sie manuell das Attribut mit dem richtigen Wert.
Anmerkung: Die in einem bestimmten WS-Notification-Service verwendeten dynamischen Topic-Namespaces werden durch einen SIB-Topicbereich gestützt, der automatisch beim Erstellen des Topic-Namespace erstellt wird.
Für die in diesem Topicbereich verwendeten Topics wird eine interne Syntax der WS-Notification-Serviceimplementierung verwendet.
- Wählen Sie die Option Registrierung erforderlich aus oder ab.
- Wählen Sie einen Service Integration Bus in der Dropdown-Liste aus.
- Klicken Sie auf Weiter.
- Schritt 2: WS-Notification-Servicetyp auswählen.
Wählen Sie Version 7.0 als Typ für den zu erstellenden Service aus.
- Schritt 3: Handler und Web-Service-Richtlinieneinstellungen konfigurieren.
Diese Einstellungen werden auf die Ereignisbenachrichtigungen
angewendet, die mit WS-Notification-Clientanwendungen ausgetauscht werden.
- Optional: Wählen Sie eine JAX-WS-Handler-Liste aus.
Eine Handlerliste definiert die Handler, die angewendet werden, wenn abgehende Web-Service-Aufrufe ausgeführt werden, z. B., um die abgehenden Ereignisbenachrichtigungen (als Reaktion auf eine Subskriptionsoperation) zu überwachen oder bedarfsbasierte Publisher zu steuern (subscribe, pause und resume). Weitere Informationen zu Handlerlisten finden Sie im Artikel JAX-WS-Handler konfigurieren.
- Wählen Sie die Option WSDL abfragen aus oder ab.
Gibt an, ob der WS-Notification-Service der Version 7.0 die WSDL anderer WS-Notification-Web-Services abfragt, wenn er mit diesen interagiert. Diese Option ist standardmäßig aktiviert. Wenn Sie diese Option abwählen, können Sie damit die Leistung verbessern, weil die kostenintensiven WSDL-Abfragen unterbleiben. Wenn die WSDL-Abfrage nicht aktiviert wird, sind jedoch die folgenden Punkte zu beachten:- WS-Notification versucht, die Bindungsinformationen (die normalerweise über die WSDL bestimmt werden) mit anderen Mitteln festzustellen.
WS-Notification verwendet die SOAP-Version, die dem WS-Notification-Servicepunkt zugeordnet ist, an dem Subskriptionen (von anderen Web-Services) vorgenommen
oder an dem verwaltete Subskriptionen (von einem Administrator) erstellt wurden.
- Es gibt verschiedene Situationen, in denen WS-Notification die Bindungsinformationen nicht bestimmen kann.
Dies ist beispielsweise der Fall, wenn Subskriptionen bereinigt werden,
bei denen der zugeordnete Servicepunkt gelöscht wurde und die Konfigurationsdaten nicht mehr verfügbar sind.
Unter solchen Umständen legt WS-Notification die für die Bereinigung der Subskriptionen zu verwendenden Bindungsinformationen nach eigenem Ermessen fest.
- Es gibt ein Szenario, in dem ungültige Bindungsinformationen verwendet werden.
Dies ist der Fall, wenn ein Subskribent die Subskription mit einer bestimmten SOAP-Bindung für einen
NotificationConsumer vornimmt, der eine andere SOAP-Bindung erwartet.
- Geben Sie den Namen eines dynamischen Topicbereichs an.
Der Name des Bustopicbereichs für die Ad-hoc-Topic-Namespaces und die dynamischen Topic-Namespaces, sofern diese zulässig sind. Der Standardname
WSN_dynamic_Name_des_Service wird angeboten.
- Klicken Sie auf Weiter.
- Schritt 4: WS-Notification-Servicepunkte erstellen.
Das Vorhandensein eines WS-Notification-Servicepunkts in einem Busmember impliziert, dass ein WS-Notification-Web-Service über dieses Busmember bereitgestellt wird, und bewirkt, dass
Web-Service-Endpunkte für den NotificationBroker, SubscriptionManager oder PublisherRegistrationManager für diesen WS-Notification-Service in dem Busmember bereitgestellt werden,
dem der Servicepunkt zugeordnet ist. WS-Notification-Anwendungen verwenden diese Endpunkte, um mit dem WS-Notification-Service zu interagieren. Weitere
Informationen finden Sie im Artikel
WS-Notification-Servicepunkt.
- Wählen Sie Ja aus,
um einen neuen WS-Notification-Servicepunkt zu erstellen, und klicken Sie anschließend auf Weiter.
Ein WS-Notification-Service muss mindestens einen Servicepunkt haben.
- Geben Sie einen Namen und (optional) eine Beschreibung für
den WS-Notification-Servicepunkt ein, und wählen Sie in der Dropdown-Liste das Busmember aus,
in dem der Servicepunkt konfiguriert werden soll. Klicken Sie anschließend auf
Weiter.
Der Name des Servicepunkts bildet einen Teil des URL, mit dem auf den Servicepunkt zugegriffen wird. In einem Einzelserversystem erscheint in der Liste nur ein einziges Busmember.
- Wählen Sie die Transporteinstellungen für den neuen Servicepunkt aus.
- Über einen HTTP-Proxy zugänglicher Servicepunkt
- Wenn über einen Proxy auf den Servicepunkt zugegriffen wird, wählen Sie das Kontrollkästchen aus, und geben Sie das Stammverzeichnis des extern sichtbaren Endpunkt-Adress-URL für Web-Services ein, die über diesen Endpunkt aufgerufen werden.
- Der URL für den Proxy wird verwendet, um die WSDL-Endpunktadressfelder auszufüllen, wenn WSDL-Dateien in einer Datei mit der Erweiterung .zip veröffentlicht werden.
- SOAP-Version
- Wählen Sie die SOAP-Version aus, die vom Servicepunkt unterstützt wird. Dies betrifft die WSDL-Definition, die vom Web-Service bereitgestellt wird.
- Optional: Wählen Sie die Einstellungen für die JAX-WS-Handlerliste für den neuen Servicepunkt aus.
- JAX-WS-Handlerliste für NotificationBroker
-
- JAX-WS-Handlerliste für SubscriptionManager
-
- JAX-WS-Handlerliste für PublisherRegistrationManager
-
- Klicken Sie auf Weiter. Der neue
Servicepunkt wird der Liste der Servicepunkte für diesen WS-Notification-Service hinzugefügt.
- Optional: Zum Erstellen eines weiteren Servicepunkts wiederholen Sie die zuvor beschriebenen
Teilschritte.
- Wenn Sie mit dem Erstellen der Servicepunkte für diesen WS-Notification-Service
fertig sind, wählen Sie Nein für die Option zum Erstellen eines weiteren
Servicepunkts aus. Klicken Sie anschließend auf Weiter.
- Optional: Schritt 5: Permanente Topic-Namespaces erstellen.
Weitere Informationen finden Sie im Artikel
Permanenter Topic-Namespace. Wenn Sie einen neuen permanenten WS-Notification-Topic-Namespace erstellen, geben Sie den Namespace an und ordnen ihn einem der SIB-Topicbereiche zu, die in dem Bus konfiguriert sind, in dem der übergeordnete WS-Notification-Service definiert ist. Ein permanenter Topic-Namespace kann nach der Erstellung nicht mehr geändert werden. Es können lediglich Topic-Namespace-Dokumente hinzugefügt oder entfernt werden.
- Wählen Sie
Ja aus, um einen neuen permanenten
Topic-Namespace zu erstellen, und klicken Sie anschließend auf Weiter.
- Geben Sie einen Namen für den permanenten Topic-Namespace ein.
Dies ist der URI, mit dem
WS-Notification-Anwendungen auf Topics in diesem Namespace verweisen.
- Ordnen
Sie diesen neuen permanenten Topic-Namespace dem SIB-Topicbereich zu, den Sie zum Veröffentlichen und Empfangen von Nachrichten verwenden möchten.
Führen Sie über die Dropdown-Liste mit den SIB-Topicbereichen eine der folgenden Aktionen aus:
- Wählen Sie den Namen eines vorhandenen Bustopicbereichs aus.
- Wählen Sie die Option
zum Erstellen eines neuen Topicbereichs aus und geben Sie anschließend
einen Namen für den neuen Topicbereich ein.
- Wählen Sie in der Dropdown-Liste die SIB-Zuverlässigkeit
(Servicequalität, QoS) aus, die den Nachrichten zugeordnet wird, die mit diesem Topic-Namespace veröffentlicht werden.
Sie können zwischen fünf Werten wählen. Jeder Wert stellt eine
der Nachrichtenzuverlässigkeitsstufen
des Service Integration Bus dar. Der Standardwert
ist zuverlässig, persistent. Dieser Wert wird standardmäßig für
persistente JMS-Nachrichten verwendet.
- Klicken Sie auf Weiter.
Der
neue permanente Topic-Namespace wird einer Liste permanenter Topic-Namespaces für diesen
WS-Notification-Service der Version 7.0 hinzugefügt. Anschließend werden Sie gefragt, ob Sie einen weiteren
permanenten Topic-Namespace erstellen möchten (die Standardantwort ist Ja).
- Optional: Zum Erstellen eines weiteren permanenten Topic-Namespace wiederholen Sie die zuvor beschriebenen
Teilschritte.
- Wenn Sie mit dem Erstellen der permanenten Topic-Namespaces für diesen WS-Notification-Service der Version 7.0
fertig sind, wählen Sie Nein für die Option zum Erstellen eines weiteren
permanenten Topic-Namespace aus. Klicken Sie anschließend auf Weiter.
- Schritt 6: Zusammenfassung.
Prüfen Sie, ob die Zusammenfassung der Aktionen, die vom Assistenten ausgeführt wurden, Ihren Erwartungen entspricht, und klicken Sie anschließend auf Fertig stellen.
Bei fehlerfreiem Abschluss der Verarbeitung
wird die Liste der WS-Notification-Services der Version 7.0 mit dem neuen WS-Notification-Service der Version 7.0 aktualisiert. Andernfalls
wird eine Fehlernachricht angezeigt.
- Speichern Sie Ihre Änderungen in der Masterkonfiguration.
- Optional: Starten Sie den Server erneut, wenn eine der folgenden Bedingungen zutrifft:
- Im Rahmen dieser Task wurde ein neuer Bus oder ein neues Busmember erstellt.
- Das erneute Laden der Konfiguration ist für den Bus nicht aktiviert.
Nächste Schritte
Informationen zum Ausführen erweiterter Konfigurationstasks für diesen WS-Notification-Service
(z. B. Hinzufügen weiterer Servicepunkte und Anwenden von Topic-Namespace-Dokumenten auf permanente
Topic-Namespaces) finden Sie im Artikel WS-Notification-Service der Version 7.0 ändern.
Informationen
zum Ausführen erweiterter Konfigurationstasks für den WS-Notification-Servicepunkt, (z. B. Hinzufügen verwalteter Subskribenten,
Veröffentlichen von WSDL-Dateien
in einer Datei mit der Erweiterung ".zip" und Konfiguration der Unternehmensanwendung, der diesem Servicepunkt zugeordnet ist)
finden Sie im Artikel WS-Notification-Servicepunkt der Version 7.0 ändern.
Zum Konfigurieren
dieses WS-Notification-Service oder -Servicepunkts mit Web-Service-Servicequalitäten, wie z. B. Zuverlässigkeit
oder Sicherheit, finden Sie im Artikel WS-Notification-Service der Version 7.0 mit Web-Service-Servicequalität konfigurieren.