¿Cómo proporcionar una descarga de archivo desde un bean de respaldo JSF?

91

¿Hay alguna forma de proporcionar una descarga de archivo desde un método de acción de bean de respaldo JSF? He probado muchas cosas. El problema principal es que no puedo entender cómo obtener OutputStreamla respuesta para escribir el contenido del archivo. Sé cómo hacerlo con a Servlet, pero esto no se puede invocar desde un formulario JSF y requiere una nueva solicitud.

¿Cómo puedo obtener OutputStreamla respuesta de la corriente FacesContext?

zmeda
fuente

Respuestas:

238

Introducción

Puede pasar todo ExternalContext. En JSF 1.x, puede obtener el HttpServletResponseobjeto sin formato ExternalContext#getResponse(). En JSF 2.x, puede usar un montón de nuevos métodos de delegado como ExternalContext#getResponseOutputStream()sin la necesidad de tomar el HttpServletResponsede debajo de las campanas JSF.

En la respuesta, debe configurar el Content-Typeencabezado para que el cliente sepa qué aplicación asociar con el archivo proporcionado. Y debe configurar el Content-Lengthencabezado para que el cliente pueda calcular el progreso de la descarga, de lo contrario será desconocido. Y debe establecer el Content-Dispositionencabezado en attachmentsi desea un cuadro de diálogo Guardar como ; de lo contrario, el cliente intentará mostrarlo en línea. Finalmente, simplemente escriba el contenido del archivo en el flujo de salida de respuesta.

La parte más importante es llamar FacesContext#responseComplete()para informar a JSF que no debe realizar la navegación y el renderizado después de haber escrito el archivo en la respuesta; de lo contrario, el final de la respuesta se contaminará con el contenido HTML de la página o en versiones JSF anteriores. , obtendrá un IllegalStateExceptionmensaje con un mensaje como getoutputstream() has already been called for this responsecuando la implementación JSF llama getWriter()a renderizar HTML.

¡Apague ajax / no use el comando remoto!

Solo necesita asegurarse de que el método de acción no sea llamado por una solicitud ajax, sino que sea llamado por una solicitud normal al disparar con <h:commandLink>y <h:commandButton>. Las solicitudes de Ajax y los comandos remotos son manejados por JavaScript que a su vez, debido a razones de seguridad, no tiene facilidades para forzar un diálogo Guardar como con el contenido de la respuesta ajax.

En caso de que esté utilizando, por ejemplo <p:commandXxx>, PrimeFaces , debe asegurarse de desactivar explícitamente ajax a través del ajax="false"atributo. En caso de que esté usando ICEfaces, entonces necesita anidar un <f:ajax disabled="true" />en el componente de comando.

Ejemplo genérico de JSF 2.x

public void download() throws IOException {
    FacesContext fc = FacesContext.getCurrentInstance();
    ExternalContext ec = fc.getExternalContext();

    ec.responseReset(); // Some JSF component library or some Filter might have set some headers in the buffer beforehand. We want to get rid of them, else it may collide.
    ec.setResponseContentType(contentType); // Check http://www.iana.org/assignments/media-types for all types. Use if necessary ExternalContext#getMimeType() for auto-detection based on filename.
    ec.setResponseContentLength(contentLength); // Set it with the file size. This header is optional. It will work if it's omitted, but the download progress will be unknown.
    ec.setResponseHeader("Content-Disposition", "attachment; filename=\"" + fileName + "\""); // The Save As popup magic is done here. You can give it any file name you want, this only won't work in MSIE, it will use current request URL as file name instead.

    OutputStream output = ec.getResponseOutputStream();
    // Now you can write the InputStream of the file to the above OutputStream the usual way.
    // ...

    fc.responseComplete(); // Important! Otherwise JSF will attempt to render the response which obviously will fail since it's already written with a file and closed.
}

Ejemplo genérico de JSF 1.x

public void download() throws IOException {
    FacesContext fc = FacesContext.getCurrentInstance();
    HttpServletResponse response = (HttpServletResponse) fc.getExternalContext().getResponse();

    response.reset(); // Some JSF component library or some Filter might have set some headers in the buffer beforehand. We want to get rid of them, else it may collide.
    response.setContentType(contentType); // Check http://www.iana.org/assignments/media-types for all types. Use if necessary ServletContext#getMimeType() for auto-detection based on filename.
    response.setContentLength(contentLength); // Set it with the file size. This header is optional. It will work if it's omitted, but the download progress will be unknown.
    response.setHeader("Content-Disposition", "attachment; filename=\"" + fileName + "\""); // The Save As popup magic is done here. You can give it any file name you want, this only won't work in MSIE, it will use current request URL as file name instead.

    OutputStream output = response.getOutputStream();
    // Now you can write the InputStream of the file to the above OutputStream the usual way.
    // ...

    fc.responseComplete(); // Important! Otherwise JSF will attempt to render the response which obviously will fail since it's already written with a file and closed.
}

Ejemplo de archivo estático común

En caso de que necesite transmitir un archivo estático desde el sistema de archivos del disco local, sustituya el código como se muestra a continuación:

File file = new File("/path/to/file.ext");
String fileName = file.getName();
String contentType = ec.getMimeType(fileName); // JSF 1.x: ((ServletContext) ec.getContext()).getMimeType(fileName);
int contentLength = (int) file.length();

// ...

Files.copy(file.toPath(), output);

Ejemplo de archivo dinámico común

En caso de que necesite transmitir un archivo generado dinámicamente, como PDF o XLS, simplemente proporcione outputallí donde la API que se utiliza espera un OutputStream.

Por ejemplo, iText PDF:

String fileName = "dynamic.pdf";
String contentType = "application/pdf";

// ...

Document document = new Document();
PdfWriter writer = PdfWriter.getInstance(document, output);
document.open();
// Build PDF content here.
document.close();

Por ejemplo, Apache POI HSSF:

String fileName = "dynamic.xls";
String contentType = "application/vnd.ms-excel";

// ...

HSSFWorkbook workbook = new HSSFWorkbook();
// Build XLS content here.
workbook.write(output);
workbook.close();

Tenga en cuenta que no puede establecer la longitud del contenido aquí. Por lo tanto, debe eliminar la línea para establecer la longitud del contenido de la respuesta. Técnicamente, esto no es un problema, la única desventaja es que al usuario final se le presentará un progreso de descarga desconocido. En caso de que esto sea importante, entonces realmente necesita escribir en un archivo local (temporal) primero y luego proporcionarlo como se muestra en el capítulo anterior.

Método de utilidad

Si está utilizando la biblioteca de utilidades JSF OmniFaces , puede usar uno de los tres Faces#sendFile()métodos convenientes tomando a File, o an InputStream, o a byte[], y especificando si el archivo debe descargarse como un archivo adjunto ( true) o en línea ( false).

public void download() throws IOException {
    Faces.sendFile(file, true);
}

Sí, este código está completo tal cual. No es necesario que se invoque, responseComplete()etc. Este método también trata adecuadamente con encabezados específicos de IE y nombres de archivo UTF-8. Puede encontrar el código fuente aquí .

BalusC
fuente
1
¡Tan fácil! Me he estado preguntando cómo hacer que la descarga esté disponible para PrimeFaces de acuerdo con su escaparate, porque requiere InputStreaminfraestructura p:fileDownloady no he logrado convertir OutputStreama InputStream. Ahora está claro que incluso un oyente de acciones puede cambiar el tipo de contenido de la respuesta y, de todos modos, la respuesta se respetará como una descarga de archivo en el lado del usuario-agente. ¡Gracias!
Lyubomyr Shaydariv
1
¿Hay alguna manera de hacer esto usando HTTP GET en lugar de HTTP POST (h: commandButton y h: commandLink)?
Alfredo Osorio
@Alfredo: sí, usando el preRenderViewoyente en una vista sin marcas. Una pregunta similar para descargar (bueno, servir) JSON se responde aquí: stackoverflow.com/questions/8358006/…
BalusC
El enlace w3schools.com/media/media_mimeref.asp está roto. Quizás este sea adecuado: iana.org/assignments/media-types
Zakhar
2
@BalusC cubre todos los temas de jsf, ¡gracias por hacerme la vida más fácil, señor!
Buttinger Xaver
5
public void download() throws IOException
{

    File file = new File("file.txt");

    FacesContext facesContext = FacesContext.getCurrentInstance();

    HttpServletResponse response = 
            (HttpServletResponse) facesContext.getExternalContext().getResponse();

    response.reset();
    response.setHeader("Content-Type", "application/octet-stream");
    response.setHeader("Content-Disposition", "attachment;filename=file.txt");

    OutputStream responseOutputStream = response.getOutputStream();

    InputStream fileInputStream = new FileInputStream(file);

    byte[] bytesBuffer = new byte[2048];
    int bytesRead;
    while ((bytesRead = fileInputStream.read(bytesBuffer)) > 0) 
    {
        responseOutputStream.write(bytesBuffer, 0, bytesRead);
    }

    responseOutputStream.flush();

    fileInputStream.close();
    responseOutputStream.close();

    facesContext.responseComplete();

}
John Mendes
fuente
3

Esto es lo que funcionó para mí:

public void downloadFile(String filename) throws IOException {
    final FacesContext fc = FacesContext.getCurrentInstance();
    final ExternalContext externalContext = fc.getExternalContext();

    final File file = new File(filename);

    externalContext.responseReset();
    externalContext.setResponseContentType(ContentType.APPLICATION_OCTET_STREAM.getMimeType());
    externalContext.setResponseContentLength(Long.valueOf(file.lastModified()).intValue());
    externalContext.setResponseHeader("Content-Disposition", "attachment;filename=" + file.getName());

    final HttpServletResponse response = (HttpServletResponse) externalContext.getResponse();

    FileInputStream input = new FileInputStream(file);
    byte[] buffer = new byte[1024];
    final ServletOutputStream out = response.getOutputStream();

    while ((input.read(buffer)) != -1) {
        out.write(buffer);
    }

    out.flush();
    fc.responseComplete();
}
Koray Tugay
fuente
1
Después de 2 días de trabajo, esto resolvió mi problema con algunos pequeños cambios :) muchas gracias.
ÖMER TAŞCI
@ ÖMERTAŞCI: Qué cambia,
Kukeltje
-3

aquí está el fragmento de código completo http://bharatonjava.wordpress.com/2013/02/01/downloading-file-in-jsf-2/

 @ManagedBean(name = "formBean")
 @SessionScoped
 public class FormBean implements Serializable
 {
   private static final long serialVersionUID = 1L;

   /**
    * Download file.
    */
   public void downloadFile() throws IOException
   {
      File file = new File("C:\\docs\\instructions.txt");
      InputStream fis = new FileInputStream(file);
      byte[] buf = new byte[1024];
      int offset = 0;
      int numRead = 0;
      while ((offset < buf.length) && ((numRead = fis.read(buf, offset, buf.length -offset)) >= 0)) 
      {
        offset += numRead;
      }
      fis.close();
      HttpServletResponse response =
         (HttpServletResponse) FacesContext.getCurrentInstance()
        .getExternalContext().getResponse();

     response.setContentType("application/octet-stream");
     response.setHeader("Content-Disposition", "attachment;filename=instructions.txt");
     response.getOutputStream().write(buf);
     response.getOutputStream().flush();
     response.getOutputStream().close();
     FacesContext.getCurrentInstance().responseComplete();
   }
 }

Puede cambiar la lógica de lectura del archivo en caso de que desee que el archivo se genere en tiempo de ejecución.

Bharat Sharma
fuente
¡Esto solo le dará parte del archivo de entrada, si es mayor que 1024 bytes!
hinneLinks