ConnectToServerByProxy - Methode

Diese Methode wird verwendet, um den Aufbau einer TCP-Verbindung zum HTTP-Server über einen Proxy-Server zu initialisieren. Für die Verbindungsanfrage an den Proxy-Server muss ein Funktionsbaustein, der die Schnittstelle IF_ProxyHandler implementiert, in der Anwendung implementiert sein. Dieser Funktionsbaustein muss dem Eingang i_ifProxyHandler zugewiesen werden.

Sobald dem Eingang eine gültige Schnittstelle zugewiesen wurde, werden die Schnittstellenmethoden vom Funktionsbaustein aufgerufen, während eine Verbindung zum HTTP-Server hergestellt wird.

Die Aufrufsequenz lautet wie folgt:

1. Wenn die Methode ConnectToServerByProxy ausgeführt wird, wird die Schnittstellenmethode ConnectToProxy aufgerufen.

   Wenn für die Verbindung zum HTTP-Server die TLS-Verschlüsselung ausgewählt ist, wird der Sockettyp StartTls auf TRUE gesetzt. Die Methode wird zyklisch aufgerufen, bis einer der Ausgänge q_xDone (Verbindung hergestellt) oder q_xError (Verbindung nicht erfolgreich) TRUE angibt.

2. Nachdem die Verbindung zum Proxy-Server hergestellt wurde, wird die Schnittstellenmethode ConnectToRemoteServer aufgerufen.

   Wenn für die Verbindung zum HTTP-Server die TLS-Verschlüsselung ausgewählt ist, wird die Option UpgradeToTls auf TRUE gesetzt. Die Methode wird zyklisch aufgerufen, bis einer der Ausgänge q_xDone (Verbindung hergestellt) oder q_xError (Verbindung nicht erfolgreich) TRUE angibt.

3. Nachdem die Methode ConnectToRemoteServer erfolgreich abgeschlossen wurde, wird die Verbindung der Instanz des FB_HttpClient zum dezentralen Server hergestellt. Der Datenaustausch mit dem Server unter Verwendung der entsprechenden Methoden ist möglich. Die Schnittstelle IF_ProxyHandler ist bis zur nächsten Initialisierung der TCP-Verbindung mit der Methode ConnectToServerByProxy nicht erforderlich.

Der Rückgabewert der Methode gibt nur an, ob die Verbindung erfolgreich initialisiert werden konnte. Der Status der Verbindung muss über die Eigenschaft State geprüft werden. Werten Sie die Diagnoseausgänge der Methode aus, wenn der Rückgabewert FALSE sein sollte. Ein von diesen Ausgängen signalisierter Fehler braucht nicht zurückgesetzt zu werden.

Wenn beim Herstellen einer Verbindung ein Fehler erkannt wird, wird die Schnittstellenmethode Abort des IF_ProxyHandler einmal aufgerufen.

Weitere Informationen zur Implementierung der Schnittstellenmethoden oder zu bereits bereitgestellten Implementierungen finden Sie im ProxyCommunicationSupport-Bibliothekshandbuch.

Siehe Hinweise zu gesicherten Verbindungen mit TLS der ConnectToServer-Methode.