Téléchargement de fichiers Servlet 3 - @MultipartConfig, Part

Introduction

Le transfert de fichiers est une fonctionnalité fréquente dans les applications web. Servlet 3.0 introduit les annotations @MultipartConfig et Part pour simplifier ce processus. Ces annotations offrent aux développeurs une méthode aisée pour gérer les téléchargements de fichiers côté serveur.

L'annotation @MultipartConfig

L'annotation @MultipartConfig signale qu'une servlet est capable de traiter les requêtes multipart incluant des fichiers joints. Elle permet de définir divers attributs pour paramétrer le comportement du téléchargement:

• location : Le répertoire temporaire utilisé pour stocker les fichiers durant le téléchargement.
• fileSizeThreshold : La limite de taille (en octets) à partir de laquelle les fichiers sont sauvegardés sur le disque.
• maxFileSize : La taille maximale autorisée (en octets) pour un fichier téléchargé.
• maxRequestSize : La taille maximale autorisée (en octets) pour la requête entière.

L'annotation Part

L'annotation Part permet d'injecter des informations relatives à un fichier joint téléchargé au sein d'une méthode de servlet. Elle expose les propriétés suivantes:

• contentType : Le type de contenu du fichier joint.
• headers : Les en-têtes HTTP associés au fichier joint.
• inputStream : Le flux d'entrée permettant de lire le contenu du fichier joint.
• name : Le nom du champ de formulaire correspondant au fichier joint.
• size : La taille (en octets) du fichier joint.

Déroulement du traitement des téléchargements

Pour gérer efficacement les téléchargements de fichiers dans une servlet, voici les étapes à suivre:

1. Ajouter l'annotation @MultipartConfig à la définition de la classe de la servlet.
2. Utiliser l'annotation Part pour injecter les fichiers joints dans les méthodes de la servlet.
3. Récupérer les informations relatives au fichier joint grâce aux propriétés de l'objet Part.
4. Effectuer la sauvegarde des fichiers téléchargés sur le serveur.

Exemple de Servlet de Téléchargement de Fichiers

Voici un exemple concret d'une servlet utilisant les annotations @MultipartConfig et Part pour gérer le téléchargement de fichiers :

@WebServlet("/UploadServlet")
@MultipartConfig(
 location = "/tmp",
 fileSizeThreshold = 1024 * 1024,
 maxFileSize = 1024 * 1024 * 10,
 maxRequestSize = 1024 * 1024 * 50
)
public class UploadServlet extends HttpServlet {

 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
 Part filePart = request.getPart("file");
 String fileName = getFileName(filePart);
 if (filePart != null && fileName != null) {
 filePart.write(fileName);
 }
 }

 private String getFileName(Part part) {
 for (String contentDisposition : part.getHeader("Content-Disposition").split(";")) {
 if (contentDisposition.trim().startsWith("filename")) {
 return contentDisposition.substring(contentDisposition.indexOf('=') + 1).trim().replace("\"", "");
 }
 }
 return null;
 }
}

Conclusion

Les annotations @MultipartConfig et Part introduites par Servlet 3 simplifient considérablement la gestion des téléchargements de fichiers dans les applications web. Elles permettent aux développeurs de configurer aisément les paramètres de téléchargement, d'injecter les fichiers joints dans les méthodes de servlet et de les sauvegarder efficacement sur le serveur.

En exploitant ces annotations, les développeurs peuvent créer des applications web robustes et performantes, capables de gérer les téléchargements de fichiers de manière optimale.

Questions Fréquentes