Pour envoyer des fichiers (textes, binaires, images...) à un webservice REST, il est courant d'avoir un code du type :

Cette solution impose de charger en mémoire le contenu du fichier à envoyer au webservice. Elle convient donc parfaitement pour un seul fichier, n'excédant pas quelques mégas. Par contre lorsque le transfert est volumineux, ou s'il est fait depuis un appareil limité en mémoire, une autre solution est préconisée. Il s'agit de faire l'envoi en "multi-part", avec le principe de formulaire. En effet, de cette manière le transfert avec le serveur qui héberge le webservice sera automatiquement géré par bloc, sans chargement complet en mémoire :

Avec cette solution qui s'applique que l'application cliente qui consomme le webservice soit sous Windows, Android, iOS :

• plusieurs fichiers peuvent être envoyés dans une même requête, il suffit de répéter les appels de HTTPAjouteFichier.
• un suivi du transfert avec une jauge est permis avec la propriété AvancementTéléchargement du type httpRequête,
• un transfert asynchrone est autorisé à partir de la version 26, grâce à la syntaxe asynchrone de la fonction HTTPEnvoieFormulaire.

Au passage, pour le cas inverse du téléchargement d'un fichier par une requpête HTTP, il est également possible d'avoir un remplissage continu d'un fichier créé par l'application cliente. Le téléchargement doit pour cela être fait soit :

• avec la fonction HTTPDestination puis la fonction HTTPrequête,
• ou avec une requête GET exécutée par la fonction HTTPEnvoie/RESTEnvoie utilisant une variable httpRequete/restRequête et sa propriété ..Destination.

Ces deux solutions évitent de récupérer le contenu complet de la réponse HTTP pour la stocker localement par un fSauveBuffer. A noter qu'un exemple complet de téléchargement HTTP incluant une reprise sur panne est proposé dans la LST 108 WD Téléchargement Partiel.

Mise à jour 9/9/2021

Précision sur le "côté serveur" dans le cas d'un envoi :

• depuis le client en "typeMimeFormulaireMultiPartie" avec HTTPAjouteFichier,
• et avec une réception par un webservice REST en WLangage hébergé par le serveur d'application de WEBDEV :

Dans ce cas c'est le serveur d'application qui va gérer la réception. Le webservice ne va donc pas recevoir un buffer avec le fichier, mais un nom temporaire du fichier sur le disque du serveur. Si le webservice est en WLangage sur le serveur, la procédure de réception du fichier devra donc faire :

La variable sNomCompletTemporaire contiendra le chemin complet vers le fichier sauvé sur le serveur. Il pourra par exemple être copié vers l'emplacement voulu, ou stocker dans la base de données ...

A noter que le serveur web peut avoir des restrictions sur la taille des requêtes qu'il accepte d'échanger. Dans IIS, partie "Filtrage des demandes", "paramètres de filtrages des demandes", il peut être nécessaire d'ajuster la taille maximale des demandes (et donc des uploads).