HTTP GET OPTION
HTTP GET OPTION ( option ; valeur )
| Paramètre | Type | Description | |
|---|---|---|---|
| option | Integer | → | Code de l’option à lire |
| valeur | Integer | ← | Valeur courante de l’option |
Compatibilité
Cette commande est maintenue pour des raisons de compatibilité uniquement. Il est maintenant recommandé d'utiliser la classe 4D.HTTPRequest.
Description
La commande HTTP GET OPTION retourne la valeur courante des options HTTP (options utilisées par le client pour la prochaine requête déclenchée par la commande HTTP Get ou HTTP Request). La valeur courante d'une option peut être la valeur par défaut ou avoir été modifiée à l'aide de la commande HTTP SET OPTION.
Note : Les options sont locales au process courant. Dans le cadre d’un composant, elles sont locales au composant en cours d’exécution.
Passez dans le paramètre option le numéro de l’option dont vous souhaitez lire la valeur. Vous pouvez utiliser une des constantes prédéfinies suivantes, placées dans le thème Client HTTP :
| Constante | Type | Valeur | Comment |
|---|---|---|---|
| HTTP client log | Entier long | 7 | valeur= une des constantes suivantes : HTTP désactiver log: Le journal des requêtes du client HTTP est désactivé (défaut) HTTP activer log avec tous body: Le journal des requêtes du client HTTP est activé avec tous les body de la réponse et de la requête. HTTP activer log avec body request: Le journal des requêtes du client HTTP est activé avec uniquement le body de la requête HTTP activer log avec body response: Le journal des requêtes du client HTTP est activé avec uniquement le body de la réponse HTTP activer log sans body: Le journal des requêtes du client HTTP est activé sans body (la taille du body est fournie dans ce cas) Permet d'obtenir ou de définir l'état du fichier journal des requêtes du client HTTP. Lorsqu'il est activé, ce fichier, nommé "4DHTTPClientLog_nn.txt", est stocké dans le dossier "Logs" de l'application (nn est le numéro du fichier). Il est utile pour déboguer les problèmes liés aux requêtes du client HTTP. Il enregistre chaque requête et chaque réponse en mode brut. Les requêtes entières, y compris les en-têtes, sont enregistrées ; en option, les parties du body peuvent également être enregistrées. Pour plus d'informations, veuillez vous reporter à la section Description des logs. |
| HTTP compression | Entier long | 6 | valeur = 0 (ne pas compresser) ou 1 (compresser). Par défaut : 0 Cette option permet d’activer ou d’activer le mécanisme de compression des requêtes entre le client et le serveur, destiné à accélérer les échanges. Lorsque ce mécanisme est activé, le client HTTP utilise la compression deflate ou GZIP en fonction de la réponse du serveur. |
| HTTP display auth dial | Entier long | 4 | valeur = 0 (ne pas afficher le dialogue) ou 1 (afficher le dialogue). Par défaut : 0 Cette option gère l’affichage de boîte de dialogue d’authentification lors de l’exécution de la commande HTTP Get ou HTTP Request. Par défaut, cette commande ne provoque jamais l'affichage de la boîte de dialogue, vous devez en principe utiliser la commande HTTP AUTHENTICATE. Toutefois, si vous souhaitez qu’une boîte de dialogue d’authentification apparaisse pour que l’utilisateur saisisse ses identifiants, passez 1 dans valeur. La boîte de dialogue n’apparaît que si la requête requiert une authentification. |
| HTTP follow redirect | Entier long | 2 | valeur = 0 (ne pas accepter les redirections) ou 1 (accepter les redirections). Valeur par défaut = 1 |
| HTTP max redirect | Entier long | 3 | valeur = nombre maximum de redirections acceptées Valeur par défaut = 2 |
| HTTP reset auth settings | Entier long | 5 | valeur = 0 (ne pas effacer les informations) ou 1 (les effacer). Par défaut : 0 Cette option permet d’indiquer à 4D de réinitialiser les informations d'authentification de l’utilisateur (nom d'utilisateur, mot de passe, méthode) après chaque exécution d’une commande HTTP Get ou HTTP Request dans un même process. Par défaut, ces informations sont conservées et réutilisées à chaque requête. Passez 1 dans valeur pour les effacer après chaque appel. A noter que quel que soit le paramétrage, les informations sont effacées lorsque le process est détruit. |
| HTTP timeout | Entier long | 1 | valeur = timeout de la requête cliente, exprimé en secondes. Le timeout est le délai d’attente du client HTTP en cas de non-réponse du serveur. A l’issue de ce délai, le client referme la session, la requête est perdue. Par défaut, ce délai est de 120 secondes. Il peut être modifié en raison de caractéristiques particulières (état du réseau, spécificités de la requête, etc.). |
Passez dans le paramètre valeur une variable qui recevra la valeur courante de l'option.