La funcionalidad de subida de archivos introducida en Servlet 3.0 simplifica considerablemente el manejo de contenido multipart, eliminando la necesidad de bibliotecas externas como Apache Commons FileUpload. Esta característica permite procesar formularios con archivos directamente desde un servlet anotado.

Requisitos del lado del cliente

Para que un formulario pueda enviar archivos al servidor, debe cumplir ciertas condiciones:

• El método HTTP debe ser POST.
• Debe incluir un campo de entrada de tipo archivo: <input type="file">.
• El atributo enctype del formulario debe establecerse en multipart/form-data.

Ejemplo de formulario HTML:

<form action="/app/upload" method="post" enctype="multipart/form-data">
   <label>Nombre de usuario:</label>
   <input type="text" name="user" /><br/>
   
   <label>Archivo:</label>
   <input type="file" name="archivo" /><br/>
   
   <button type="submit">Enviar</button>
</form>

Configuración del servlet

En el lado del srevidor, es necesario habilitar el soporte para partes multipart agregando la anotación @MultipartConfig a un servlet mapeado con @WebServlet.

@WebServlet("/upload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
   private static final long serialVersionUID = 1L;

   protected void doPost(HttpServletRequest request, HttpServletResponse response)
           throws ServletException, IOException {
       // Procesamiento del formulario
   }
}

Lectura de datos del formulario

Los distintos elementos del formulario se acceden de forma diferenciada:

• Campos de texto: Usar request.getParameter("nombre").
• Archivos: Obtener una instancia de Part mediante request.getPart("nombreCampo").

Ejemplo de procesamiento dentro del método doPost:

// Recuperar campo de texto
String username = request.getParameter("user");

// Recuperar parte del archivo
Part filePart = request.getPart("archivo");

// Nombre del campo en el formulario
String fieldName = filePart.getName();

// Tamaño del archivo en bytes
long fileSize = filePart.getSize();

// Flujo de entrada para leer el contenido
InputStream fileContent = filePart.getInputStream();

// Obtener nombre original del archivo
String header = filePart.getHeader("content-disposition");
String fileName = extractFileName(header);

Método auxiliar para extraer el nombre del archivo desde el encabezado:

private String extractFileName(String header) {
   int startIndex = header.indexOf("filename=\"");
   if (startIndex == -1) return null;
   startIndex += 10; // Longitud de "filename=\""
   int endIndex = header.indexOf("\"", startIndex);
   return header.substring(startIndex, endIndex);
}

Manejo de problemas comunes

Durante la implementación pueden surgir varios desafíos prácticos:

Colisiones de nombres de archivo

Si múltiples usuarios suben archivos con el mismo nombre (por ejemplo, foto.png), estos podrían sobrescribirse. Una solución efectiva es generar nombres únicos usando valores aleatorios o basados en marcas de tiempo.

String uniqueName = System.currentTimeMillis() + "_" + new Random().nextInt(1000) + "_" + fileName;

Seguridad y ubicación de almacenamiento

Almacenar archivos en directorios accesibles públicamente (como WebContent) puede exponer información sensible. Se recomienda usar ubicaciones seguras:

• WEB-INF/: No accesible desde el exterior.
• META-INF/: Similar protección.
• Sistema de archivos externo: Almacenar fuera del contenedor web mejora seguridad y escalabilidad.

Estas prácticas previenen accesos no autorizados y permiten un mejer control sobre los recursos cargados por los usuarios.