Zugriff auf Konfigurationsdaten zur Laufzeit

Verwendung

Das Adapter-Framework Configuration API ist ein Teil der Adapter-Framework Services.

Ein Service verwaltet Änderungen der Konfigurationsdaten im Integration Directory oder PCK. Er stellt Caching- und Verteilungsfunktionen für den Cluster bereit. Dieser Service wird CPA (Collaboration Profile Agreement) Service genannt. Das API selbst ist in den Services XPI Service: CPA Cache und XPI Service: AF Core implementiert, die zusammen mit dem Adapter-Framework deployed werden.

Interface-Überblick

Merkmal	Wert
Name	Adapter Framework Configuration Service (CPA Service)
Zweck	Liest die konfigurierten Daten und subskribiert sich auf Events, um geänderte Konfigurationsdaten zu erhalten.
Typ	Service in der Fassade `com.sap.aii.af.svc.facade`
Technischer Name	`com.sap.aii.af.service.cpa` und `com.sap.aii.af.service.administration.api.cpa`
Zertifizierung	Zwingend erforderlich
Syntax	JavaDoc package `com.sap.aii.af.service.cpa`

Funktionsumfang

Folgende Klassen und Interfaces stehen im Paket com.sap.aii.af.service.cpa zur Verfügung:

com.sap.aii.af.service.cpa

Name	Verwendung
`Party, PartyIdentifier`	Zugriff auf Partnerdaten
`Service, ServiceIdentifier, ServiceUser`	Zugriff auf Informationen zur Kommunikationskomponente
`Binding, BindingUser`	Zugriff auf Informationen zu Sender- oder Empfängervereinbarungen
`Channel`	Zugriff auf Kanaldaten
`ModuleConfig`	Zugriff auf die Modulkonfiguration eines Kanals
`CPAObject, CPAObjectType, AttributeExtendedCPAObject`	Generisches CPA-Objekt. Partner, Kommunikationskomponente, usw. sind von `CPAObject` abgeleitet, so dass `CPAObject-` Methoden auch dort aufgerufen werden können. Mit `CPAObjectType` wird die Kindklasse bestimmt. `AttributeExtendedCPAObject` liegt in der Vererbungshierarchie zwischen `CPAObject` und beispielsweise `Channel` als zusätzlicher Abstraktionsschicht.
`BinaryData, TableData, Direction`	Besondere Datentypen der `CPAObject` -Instanzen
`NormalizationManager`	Abbildung von externen Adressinformationen auf Adressinformationen im XI-Message-Header
`CPAException`	Ausnahme
`PartyCallBackController`	Zum Registrieren und Deregistrieren von Partner-Event-Handlern Ändert sich ein Partnerobjekt, beispielsweise die alternativen Identifikatoren im Integration Directory oder PCK, wird ein Änderungs-Event an alle registrierten Partner-Event-Handler geschickt. Die Methode `partyrefreshEvent()` wird immer aufgerufen, wenn ein Partnerobjekt im Cache aktualisiert wird. Eine Aktualisierung wird nicht immer durch Änderungen am Partnerobjekt herbeigeführt. Die Methode kann beispielsweise auch durch die Aktivierung des Objekts aufgerufen werden. Wenn Sie wissen müssen, wodurch die Methode `partyrefreshEvent()` aufgerufen wird, implementieren Sie ein Änderungs-Management in Ihrem Adapter.
`AbstractPartyCallBackHandler`	Erweitern Sie diese Klasse und fügen Sie Ihren eigenen Event-Handler hinzu. Überschreiben Sie hierzu die Methode `void partyrefreshEvent(Party party)`
`CPAObjectCallbackInterface`	Diese Klasse ist ein Verallgemeinerung von `AbstractPartyCallBackHandler` . Sie müssen sie nicht verwenden.

com.sap.aii.af.service.administration.api.cpa

Name	Bedeutung
`CPAInboundRuntimeLookupManager, CPALookupManager, CPAOutboundRu` `ntimeLookupManager`	Manager, die mit bestimmten Eingabeparametern und definierten Suchalgorithmen `CPAObject` -Instanzen suchen und zurückgeben. Sie können je nach Adaptervariante unterschiedliche Zugriffsstrategien verfolgen. Bestimmen Sie beispielsweise die Kommunikationsvereinbarung anhand der Adressedaten in der externen Message (B2B-Szenario) oder die Vereinbarung kann statisch zugewiesen werden wie beispielsweise beim File-Adapter. AdapterTypeMetaData/@senderAgreementUnique in den Adaptermetadaten
`CPAFactory`	Zugriff auf den LookupManager
`ChannelLifecycleCallback`	CPA-Event-Behandlung Sie kann implementiert werden, um bei Änderungen in der Konfiguration eine Benachrichtigung zu erzeugen
`CPAChannelStoppedException`	Ausnahme, für den Fall, dass versucht wird, auf Konfigurationsdaten eines gestoppten Kanals zuzugreifen.