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 unMultipartFile.- 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êteContent-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 :
inlinepour 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.
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.