Soap.InvokeRegistry.TSOAPHeader
Delphi
TSOAPHeader = class(TRemotable)
C++
class PASCALIMPLEMENTATION TSOAPHeader : public TRemotable
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| class | public | Soap.InvokeRegistry.pas Soap.InvokeRegistry.hpp |
Soap.InvokeRegistry | Soap.InvokeRegistry |
Beschreibung
TSOAPHeader wird für einen Header im SOAP-Envelope verwendet, der eine codierte Nachricht in einer Web-Service-Anwendung enthält.
TSOAPHeader ist die Basisklasse für Komponenten, die SOAP-Headern entsprechen. Für jede Art von Header ist eine entsprechende, von TSOAPHeader abgeleitete Klasse in der Registrierung für Remotable-Typen eingetragen. Sie können einen TSOAPHeader-Nachkommen wie jeden anderen Remotable-Typ registrieren, indem Sie den Namen des Headers als Typnamen verwenden. Beim Importieren eines WSDL-Dokuments wird der Quelltext zum Definieren und Registrieren der Header-Komponente automatisch generiert.
Sie können von TSOAPHeader abgeleitete Klassen auch in die Aufrufregistrierung eintragen. Mit der Methode RegisterHeaderClass der Registrierung können Sie eine Zuordnung zwischen der Header-Klasse und den aufrufbaren Interfaces vornehmen. Das Eintragen des Headers in die Aufrufregistrierung dient zwei Zwecken:
Wenn ein Server WSDL-Informationen zum Web-Service weitergibt, werden die Informationen über den Header-Typ in das generierte WSDL-Dokument aufgenommen.
Auf Servern und Clients ordnet die Aufrufregistrierung die Header-Klasse einem Header-Namen und einem Namespace zu, in dem dieser Name definiert ist. Dies ist wichtig, wenn sich der Namespace des Header-Typs vom Namespace für das aufrufbare Interface unterscheidet, die den Header verwendet.
Ein SOAP-Header ist ein spezieller Remotable-Typ, der für einen Knoten im Header-Abschnitt eines SOAP-Envelopes verwendet wird. Wie bei den anderen Remotable-Typen entsprechen die published-Eigenschaften einer von TSOAPHeader abgeleiteten Komponente den untergeordneten Knoten und Attributen des zugehörigen Header-Knotens. In TSOAPHeader werden zwei Eigenschaften für die gemeinsamen Attribute aller SOAP-Header eingeführt: MustUnderstand und Actor. In der Regel werden SOAP-Header für die Informationen eines gesamten aufrufbaren Interface (Port-Typ) und nicht nur für die Methode in einer bestimmten Nachricht verwendet.
Wenn eine Anwendung eine SOAP-Nachricht erhält (wenn ein Server eine Anforderung zur Ausführung einer Methode in eines aufrufbaren Interface oder ein Client nach dem Senden einer solchen Anforderung eine Antwort erhält), werden die enthaltenen Header automatisch in den TSOAPHeader-Nachkommen konvertiert, der in der Registrierung für Remotable-Typen eingetragen ist. Auf die TSOAPHeader-Nachkommen kann über das Interface ISOAPHeaders zugegriffen werden. Dieses kann von der Implementierungsklasse des aufrufbaren Interface oder von dem aufrufbaren Interface eines externen Objekts abgerufen werden.
Wenn eine Anwendung eine SOAP-Nachricht sendet (wenn ein Client eine Anforderung oder ein Server eine Antwort sendet), geben Sie die gewünschten Header an, indem Sie die entsprechenden TSOAPHeader-Nachkommen erstellen und die Methode Send eines ISOAPHeaders-Interface aufrufen.