Formations — 1 037 leçons en français

Accueil › Fullstack Angular + Spring Boot › Envoyer et télécharger des fichiers

Envoyer et télécharger des fichiers

Listes, pagination et fichiersintermediaire

Envoi, côté Angular : un FormData, et surtout aucun Content-Type manuel.

envoyer(fichier: File, commandeId: number) {
  const corps = new FormData();
  corps.append('fichier', fichier, fichier.name);
  corps.append('commandeId', String(commandeId));

  return this.http.post<DocumentDto>('/api/documents', corps, {
    reportProgress: true,
    observe: 'events',
  });
}

Côté Spring, le fichier arrive en MultipartFile :

@PostMapping("/api/documents")
public DocumentDto envoyer(
        @RequestPart("fichier") MultipartFile fichier,
        @RequestPart("commandeId") String commandeId) {
    return service.enregistrer(fichier, Long.parseLong(commandeId));
}
spring:
  servlet:
    multipart:
      max-file-size: 10MB
      max-request-size: 12MB   # un peu plus : les autres parties comptent aussi

Téléchargement : un lien HTML ne porte pas le jeton d'authentification. Il faut passer par HttpClient et un blob.

telecharger(id: number) {
  return this.http.get(`/api/documents/${id}/contenu`, { responseType: 'blob' });
}

Les termes à connaître

multipart/form-data

Type de contenu utilisé pour envoyer des fichiers en HTTP. Le corps est découpé en parties, chacune avec son nom et son type. Côté Angular, on construit un FormData ; côté Spring, on reçoit un MultipartFile.

MultipartFile

Interface Spring représentant un fichier reçu : getOriginalFilename(), getContentType(), getSize(), getInputStream(). Le nom d'origine vient du client : il n'est jamais fiable et doit être nettoyé avant tout usage.

FormData

Objet du navigateur qui construit un corps multipart. On n'ajoute pas d'en-tête Content-Type à la main : le navigateur le pose avec la frontière (boundary) qu'il a générée, et un en-tête manuel casse la requête.

reportProgress

Option de requête Angular qui, combinée à observe: 'events', fait émettre des événements d'avancement (HttpUploadProgressEvent) pendant l'envoi. C'est ce qui permet d'afficher une barre de progression réelle.

Content-Disposition

En-tête de réponse qui indique au navigateur comment traiter le contenu : inline pour l'afficher, attachment; filename="facture.pdf" pour proposer un enregistrement sous ce nom.

Traversée de répertoire (path traversal)

Attaque où un nom de fichier contient ../ pour écrire hors du dossier prévu (../../etc/passwd). La parade est de ne jamais utiliser le nom fourni par le client comme chemin : on génère un nom propre et on conserve le nom d'origine en base, comme simple libellé.

URL pré-signée

URL temporaire délivrée par un service de stockage (S3 et équivalents) qui autorise un envoi ou un téléchargement direct par le navigateur. Le fichier ne transite pas par votre back : c'est l'approche à privilégier pour des fichiers volumineux.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.