Lycka Bonita

Requisitos 

Es normal que en algunas aplicaciones web se permita subir/eliminar archivos al servidor. Por ejemplo, subir la foto del empleado en un portal corporativo a un directorio de fotos, o a un directorio personal del usuario que sube la foto.

En la práctica es necesario tener ciertas restricciones, como un tamaño máximo de archivo. 

Partiremos de una aplicación implementada con Struts, aunque sería muy similar en servlets y portlets.

Herramientas

Para gestionar ficheros transmitidos en la request ya existen herramientas suficientemente estables, como las utilidades del proyecto Commons FileUpload de http://www.apache.org. Podremos obtener las fuentes, los archivos binarios y documentación como la guía del usuario. En este ejemplo utilizaremos la librería commons-fileupload-1.2.jar obtenida de este proyecto.

Además, este proyecto necesita también el proyecto Commons IO, por lo cual utilizaremos también commons-io-1.3.1.jar.

Implementación en el cliente

En la parte del cliente, nuestro formulario deberá de ser capaz de transmitir en la request el contenido del archivo que queremos subir al servidor, y por tanto debe de codificar sus datos en la request de una forma diferente a la habitual, como "multipart".

Además, para subir un fichero debemos utilizar un campo del tipo "file", que permitirá al usuario explorar para seleccionar el fichero que quiere subir. 

<html:form action="/adjuntarFichero"  method="POST" enctype='multipart/form-data' >
    <html:file property='ficheroSubir' />
</html:form>

Implementación en el servidor

Si vamos a utilizar Struts, además de sus librerías debemos añadir al classpath de nuestra aplicación (típicamente /WebContent/WEB-INF/lib) las dos librerías que vamos a utilizar: commons-upload.jar y commons-io.jar. 

Debemos declarar en nuestro formulario una variable del tipo FormFile con el nombre de la propiedad del tipo file que hemos declarado en el fichero jsp.

private FormFile ficheroSubir;

De esta forma, en nuestro Action podremos acceder tanto al nombre del fichero, como a su tipo, tamaño y datos.

        FormFile formFile = formulario.getTheFile();
        String contentType = formFile.getContentType();
        String fileName    = formFile.getFileName();
        int fileSize       = formFile.getFileSize();
        byte[] fileData    = formFile.getFileData();

A tener en cuenta: 

• Struts nos permite realizar subidas de ficheros al servidor fácilmente como hemos visto, pero también podemos utilizar las clases de la librería commons-upload. 

• SizeThreshold, nos indica el tamaño a partir del cual los ficheros son almacenados en un directorio local del disco duro del servidor, en lugar de manejarlo en la memoria RAM. Este fichero no es eliminado automáticamente a posteriori por la librería Commons FileUpload.

Technorati Tags: struts, upload, subir ficheros