4D v16.3

WEB ENVOYER DONNEES

Accueil

 
4D v16.3
WEB ENVOYER DONNEES

WEB ENVOYER DONNEES 


 

WEB ENVOYER DONNEES ( données {; *} ) 
Paramètre Type   Description
données  BLOB in Données HTTP à envoyer
Opérateur in Envoi morcelé (chunked)

La commande WEB ENVOYER DONNEES permet au serveur Web 4D d’envoyer des données HTTP “brutes”, pouvant être morcelées.

Le paramètre données contient les deux parties standard d’une réponse HTTP, c’est-à-dire l’en-tête et le corps (header et body). Les données sont envoyées sans formatage préalable par le serveur. Toutefois, 4D effectue un contrôle élémentaire sur l’en-tête et le corps de la réponse afin qu’elle soit valide :

  • Si l’en-tête est incomplet ou non conforme aux spécifications du protocole HTTP, 4D le modifie en conséquence.
  • Si la réponse HTTP est incomplète, 4D ajoute les informations manquantes. Si, par exemple, vous souhaitez effectuer une redirection, vous devez écrire :
HTTP/1.1 302 
Location : http://...

Si vous passez uniquement :

Location : http://...

4D complétera la réponse en ajoutant HTTP/1.1 302.

Le paramètre optionnel * permet de déclarer que la réponse sera envoyée sous forme “morcelée” (chunked). Le découpage des réponses peut être utile lorsque le serveur envoie une réponse sans connaître sa longueur totale (par exemple si la réponse n’a pas encore été générée). Tous les navigateurs compatibles HTTP/1.1 acceptent les réponses “morcelées”.
Si vous passez le paramètre *, le serveur Web inclura automatiquement le champ transfer-encoding: chunked dans l’en-tête de la réponse, si nécessaire (vous pouvez gérer manuellement l’en-tête de la réponse si vous le souhaitez). Le reste de la réponse sera également formaté en respectant la syntaxe de l’option chunked. Les réponses morcelées comportent un seul en-tête et un nombre indéfini de corps.
Toutes les instructions WEB ENVOYER DONNEES suivant l’exécution de WEB ENVOYER DONNEES(données;*) au sein de la même méthode seront considérées comme partie de la réponse (qu’elles contiennent ou non le paramètre *). Le serveur met un terme à l’envoi morcelé à la fin de l’exécution de la méthode.

Note : Si le client Web ne prend pas en charge le protocole HTTP/1.1, 4D convertira automatiquement la réponse au format compatible HTTP/1.0 (l’envoi ne sera pas morcelé). Dans ce cas toutefois, il est possible que le résultat ne corresponde pas à vos attentes. Il est donc recommandé de tester si le navigateur est compatible HTTP/1.1 et d’envoyer une réponse adaptée. Pour cela, vous pouvez utiliser une méthode de ce type :

 C_BOOLEEN($0)
 TABLEAU TEXTE(tabChamps;0)
 TABLEAU TEXTE(tabValeurs;0)
 WEB LIRE ENTETE HTTP(tabChamps;tabValeurs)
 $0:=Faux
 Si(Taille tableau(tabValeurs)>=3)
    Si(Position("HTTP/1.1";tabValeurs{3})>0)
       $0:=Vrai //Le navigateur est compatible HTTP/1.1, on retourne Vrai dans $0
    Fin de si
 Fin de si

Combinée à la commande WEB LIRE CORPS HTTP et aux autres commandes du thème “Serveur Web”, cette commande complète la gamme d’outils mis à la disposition des développeurs 4D pour traiter de manière entièrement personnalisée les connexions HTTP entrantes et sortantes. Ces différents outils sont présentés dans le schéma suivant :

Exemple  

Cet exemple illustre l’emploi de l’option chunked avec la commande WEB ENVOYER DONNEES. Les données (une suite de chiffres) sont envoyées en 100 morceaux générés à la volée dans une boucle. A noter que l’en-tête de la réponse n’est pas explicitement défini : la commande WEB ENVOYER DONNEES l’enverra automatiquement et y insérera le champ transfer-encoding: chunked car le paramètre * est utilisé.

 C_ENTIER LONG($cpt)
 C_BLOB($mon_blob)
 C_TEXTE($output)
 
 Boucle($cpt;1;100)
    $output:="["+Chaine($cpt)+"]"
    TEXTE VERS BLOB($output;$mon_blob;UTF8 texte sans longueur)
    WEB ENVOYER DONNEES($mon_blob;*)
 Fin de boucle



Voir aussi  

WEB LIRE CORPS HTTP
WEB LIRE ENTETE HTTP

 
PROPRIÉTÉS 

Produit : 4D
Thème : Serveur Web
Numéro : 815
Nom intl. : WEB SEND RAW DATA

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Créé : 4D 2004
Renommé : 4D v13

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)