ConnectToServerByProxy - Méthode

Cette méthode est utilisée pour initier l'établissement d’une connexion TCP au serveur HTTP via un serveur proxy. Pour la demande de connexion au serveur proxy, un bloc fonction implémentant l'interface IF_ProxyHandler doit être mis en œuvre dans votre application. Ce bloc fonction doit être affecté à l'entrée i_ifProxyHandler.

Dès qu'une interface valide a été affectée à l'entrée, les méthodes de l'interface sont appelées à partir du bloc fonction lors de l'établissement d'une connexion au serveur HTTP.

La séquence d'appel est la suivante :

1. Lorsque la méthode ConnectToServerByProxy est exécutée, la méthode d'interface ConnectToProxy est appelée.

   Si le chiffrement TLS est sélectionné pour la connexion au serveur HTTP, le type de socket StartTls est défini sur TRUE. La méthode est appelée de manière cyclique jusqu’à ce que la sortie q_xDone (connexion établie) ou q_xError (échec de connexion) ait la valeur TRUE.

2. Une fois la connexion au serveur proxy établie, la méthode d'interface ConnectToRemoteServer est appelée.

   Si le chiffrement TLS est sélectionné pour la connexion au serveur HTTP, l'option UpgradeToTls est réglée sur TRUE. La méthode est appelée de manière cyclique jusqu’à ce que la sortie q_xDone (connexion établie) ou q_xError (échec de connexion) ait la valeur TRUE.

3. Une fois la méthode ConnectToRemoteServer exécutée, l'instance de FB_HttpClient est connectée au serveur distant. Il est possible d'échanger des données avec le serveur à l'aide des méthodes correspondantes. L'interface IF_ProxyHandler n'est pas requise tant que la prochaine connexion TCP n'est pas établie à l'aide de la méthode ConnectToServerByProxy.

La valeur renvoyée par cette méthode indique uniquement si la connexion peut être lancée correctement. L'état de la connexion doit être vérifié à l’aide de la propriété State. Évaluez les messages de diagnostic de la méthode, si la valeur renvoyée est FALSE. Une erreur indiquée par ces messages n’exige aucune réinitialisation.

Si une erreur est détectée lors de l'établissement d'une connexion, la méthode d'interface Abort de IF_ProxyHandler est appelée une fois.

Pour plus d'informations sur l'implémentation des méthodes d'interface ou sur les implémentations déjà fournies, consultez le Guide de la bibliothèque ProxyCommunicationSupport.

Consultez Remarques sur les connexions sécurisées à l’aide de TLS de la méthode ConnectToServer.