Soap.SOAPHTTPClient.THTTPRIO

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Soap.Rio.TRIOSystem.Classes.TComponentSystem.Classes.TPersistentSystem.TObjectTHTTPRIO

Delphi

THTTPRIO = class(TRIO)

C++

class PASCALIMPLEMENTATION THTTPRIO : public Soap::Rio::TRIO

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
class public
Soap.SOAPHTTPClient.pas
Soap.SOAPHTTPClient.hpp
Soap.SOAPHTTPClient Soap.SOAPHTTPClient


Beschreibung

THTTPRIO ruft mit HTTP-Botschaften externe Interface-Objekte unter Verwendung von SOAP auf.

Mit THTTPRIO können Sie statisch gelinkte Aufrufe für aufrufbare Interfaces einer externen Web-Service-Anwendung erzeugen. Wenn eine Anwendung THTTPRIO in ein registriertes aufrufbares Interface umwandelt, wird im Speicher eine Methodentabelle dynamisch erzeugt und so eine Implementierung für das aufrufbare Interface bereitgestellt. THTTPRIO codiert die in dieser Tabelle enthaltenen Methoden beim Aufruf als SOAP-Anforderung und sendet sie als HTTP-Anforderungsbotschaft an die Web-Service-Anwendung. Die zurückgegebene HTTP-Antwortbotschaft wird von THTTPRIO entpackt, um den Rückgabewert und eventuell vorhandene Ausgabeparameter zu ermitteln. Wenn die Anforderung auf dem Server zu einer Exception geführt hat, löst auch THTTPRIO eine Exception aus.

Mit den als published deklarierten Eigenschaften von THTTPRIO können Sie festlegen, wie die Verbindung zur Web-Service-Anwendung hergestellt wird. Die Position des Servers kann auf zwei Arten angegeben werden:

  • Geben Sie mit der Eigenschaft URL den URL an, auf dem sich die Serveranwendung befindet.
  • Weisen Sie die Eigenschaft WSDLLocation zu, wenn Sie die Verbindungsinformationen zur Laufzeit dynamisch aus einem WSDL-Dokument lesen möchten. Wählen Sie anschließend im Objektinspektor die Werte der Eigenschaften Service und Port aus, um die Bindung vollständig zu definieren.

Falls die Verwendung eines Proxy-Servers erforderlich ist oder der Server eine Authentifizierung erfordert, geben Sie die benötigten Informationen mit den Eigenschaften des THTTPReqResp-Objekts an, das in der Eigenschaft HTTPWebNode festgelegt ist.

Bevor THTTPRIO eine Methodentabelle für ein aufrufbares Interface erzeugen kann, muss das Interface in der Aufrufregistrierung registriert werden. Sie registrieren ein aufrufbares Interface, indem Sie mit der globalen Funktion InvRegistry auf die Registrierung zugreifen und dann deren Methode RegisterInterface aufrufen.

Wenn ein THTTPRIO-Objekt als untergeordnetes Element eines Formulars oder Datenmoduls erzeugt wird, muss es vor der Freigabe des Formulars oder Datenmoduls freigegeben werden. Wird es mit dem Parameter nil (Delphi) oder NULL (C++) erstellt, wird es automatisch freigegeben, wenn der Referenzzähler Null erreicht.

Siehe auch