Anschluss an den Adapter-Monitor 

Verwendung

Die Schnittstellen des Adapter-Monitors werden vom Adapter-Framework verwendet, um Systemverwaltern den Zustand des Adapters, seiner Kanäle und seiner Unterkomponenten anzuzeigen.

Interface-Überblick

Merkmal	Wert
Name	Adapter-Framework Adapter-Monitor
Zweck	Abfrage des Adapterstatus zur Anzeige im Adapter-Monitor
Typ	J2EE-Service
Technischer Name	com.sap.aii.af.monitor.api
Zertifizierung	Optional
Syntax	Siehe unter Pfad: JavaDoc (.\index.html) package com.sap.aii.af.monitor.api

Uml_monitor.wmf enthält das Klassendiagram in UML-Darstellung. Öffnen Sie hierzu Word und importieren Sie uml_monitor.wmf als Grafik.

 

Integration

Sie können den Adapter-Monitor unter //localhost:50000/AdapterFramework/monitor/monitor.jsp aufrufen. Die JavaServer Pages-Anwendung ruft die hier spezifizierte Schnittstelle auf, um die Adapterstatusdaten anzuzeigen.

Funktionsumfang

·        Damit Ihr Adapter im Adapter-Monitor angezeigt wird, müssen Sie ihn am Adapter-Framework registrieren. Die Registrierung muss mit dem gleichen Adapternamen und Namensraum vorgenommen werden, mit dem die Adaptermetadaten angelegt sind, beziehungsweise mit dem Namen, der bei der CPA Callback-Registrierung verwendet wird.

Im Beispieladapter sind dies JCA als Adaptername und http://sap.com/xi/XI/sample als Namensraum.

Wird ein Adapter gestoppt, dann sollte er sich wieder deregistrieren. Sie können die Deregistrierung mit der MonitorManager-Klasse in com.sap.aii.af.monitor.api vornehmen. Dies wird im Beispieladapter dargestellt.

Öffnen Sie hierzu SPIManagedConnectionFactory.java und suchen Sie nach der Zeichenkette CS_ADMONR und CS_ADMOND.

Beim Registrieren wird eine Klasse angegeben, die das AdapterMonitor-Interface implementiert. Im Beispieladapter ist dies SPIManagedConnectionFactory.java, es kann aber auch eine beliebige andere Klasse sein, welche auf den Status des Adapters, seiner Unterkomponenten und seiner Kanäle Zugriff hat.

·        Das AdapterMonitor-Interface spezifiziert die Methode getStatus(), die vom Adapter-Monitor aufgerufen wird, wenn der entsprechende Adaptereintrag, wie er im CPA bekannt ist, ausgewählt wird. getStatus() liefert in einem Objekt der AdapterStatus-Klasse ein Array mit AdapterStatusData-Zeilen zurück, das den Status des Adapters, seiner Unterkomponenten und seiner Kanäle auflistet.

Öffnen Sie hierzu SPIManagedConnectionFactory.java und suchen Sie nach der Zeichenkette CS_ADMON.

Im Beispieladapter werden pro Kommunikationskanal eine Statuszeile und eine allgemeine Statuszeile pro Adapter zurückgegeben. Es sind weitere Angaben je nach Architektur des Adapters möglich.

Melden Sie, wenn möglich, den aktuellen Status des Adapters zurück. Manche Adaptertypen haben ein bestimmtes Objekt für einen Kommunikationskanal nicht implementiert, weil sie z.B. auf einen Port hören und dort mittels Adressdaten dynamisch die Sendervereinbarung bestimmen. In solchen Fällen verwaltet der Adapter möglicherweise keinen Status des Kommunikationskanals und kann auch keinen Statuseintrag zurückliefern. Der Adapter sollte dann jedoch einen Subkomponentenstatus zurückliefern, der in diesem Beispiel den Zustand des Ports anzeigt.