Cómo configurar y solucionar problemas <p:fileUpload>
depende de la versión de PrimeFaces.
Todas las versiones de PrimeFaces
Los siguientes requisitos se aplican a todas las versiones de PrimeFaces:
El enctype
atributo de <h:form>
debe establecerse en multipart/form-data
. Cuando no está presente, la carga ajax puede funcionar, pero el comportamiento general del navegador no está especificado y depende de la composición del formulario y la marca / versión del navegador web. Solo especifíquelo siempre para estar seguro.
Cuando use mode="advanced"
(es decir, carga ajax, este es el valor predeterminado), asegúrese de tener un <h:head>
en la plantilla (maestra). Esto asegurará que los archivos JavaScript necesarios se incluyan correctamente. Esto no es necesario para mode="simple"
(carga que no sea ajax), pero esto rompería la apariencia y la funcionalidad de todos los demás componentes de PrimeFaces, por lo que no querrá perderse eso de todos modos.
Cuando se usa mode="simple"
(es decir, carga que no es ajax), entonces ajax debe estar deshabilitado en cualquier botón / enlace de comando PrimeFaces por ajax="false"
, y debe usar <p:fileUpload value>
con en <p:commandButton action>
lugar de <p:fileUpload fileUploadListener>
(para PrimeFaces <= 7.x) o <p:fileUpload listener>
(para PrimeFaces> = 8.x)
Entonces, si desea cargar (automáticamente) archivos con soporte ajax ( <h:head>
¡ tenga en cuenta !):
<h:form enctype="multipart/form-data">
<p:fileUpload fileUploadListener="#{bean.upload}" auto="true" /> // for PrimeFaces >= 8.x this should be listener instead of fileUploadListener
</h:form>
public void upload(FileUploadEvent event) {
UploadedFile uploadedFile = event.getFile();
String fileName = uploadedFile.getFileName();
String contentType = uploadedFile.getContentType();
byte[] contents = uploadedFile.getContents(); // Or getInputStream()
// ... Save it, now!
}
O si desea cargar un archivo que no sea ajax:
<h:form enctype="multipart/form-data">
<p:fileUpload mode="simple" value="#{bean.uploadedFile}" />
<p:commandButton value="Upload" action="#{bean.upload}" ajax="false" />
</h:form>
private UploadedFile uploadedFile; // +getter+setter
public void upload() {
String fileName = uploadedFile.getFileName();
String contentType = uploadedFile.getContentType();
byte[] contents = uploadedFile.getContents(); // Or getInputStream()
// ... Save it, now!
}
Ten en cuenta que los atributos relacionados con ajax-como auto
, allowTypes
, update
, onstart
, oncomplete
, etc, son ignorados en mode="simple"
. Por tanto, no es necesario especificarlos en tal caso.
También tenga en cuenta que debe leer el contenido del archivo inmediatamente dentro de los métodos mencionados anteriormente y no en un método bean diferente invocado por una solicitud HTTP posterior. Esto se debe a que el contenido del archivo cargado tiene un alcance de solicitud y, por lo tanto, no está disponible en una solicitud HTTP posterior / diferente. Cualquier intento de leerlo en una solicitud posterior probablemente terminará java.io.FileNotFoundException
en el archivo temporal.
PrimeFaces 8.x
La configuración es idéntica a la información de la versión 5.x a continuación, pero si no se llama a su oyente, compruebe si se llama al attriubute listener
y no (como en las versiones anteriores a 8.x)fileUploadListener
PrimeFaces 5.x
Esto no requiere ninguna configuración adicional si está utilizando JSF 2.2 y su faces-config.xml
versión también declarada conforme a JSF 2.2. No necesita el filtro de carga de archivos PrimeFaces en absoluto. En caso de que no le quede claro cómo instalar y configurar correctamente JSF según el servidor de destino utilizado, diríjase a ¿Cómo instalar y configurar correctamente las bibliotecas JSF a través de Maven? y la sección "Instalación de JSF" de nuestra página wiki de JSF .
Sin embargo, si aún no está usando JSF 2.2 y no puede actualizarlo (debería ser fácil cuando ya esté en un contenedor compatible con Servlet 3.0), entonces debe registrar manualmente el filtro de carga de archivos PrimeFaces a continuación en web.xml
(analizará el archivo multi solicitud de parte y complete el mapa de parámetros de solicitud regular para que FacesServlet
pueda continuar funcionando como de costumbre):
<filter>
<filter-name>primeFacesFileUploadFilter</filter-name>
<filter-class>org.primefaces.webapp.filter.FileUploadFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>primeFacesFileUploadFilter</filter-name>
<servlet-name>facesServlet</servlet-name>
</filter-mapping>
El <servlet-name>
valor de facesServlet
debe coincidir exactamente con el valor en la <servlet>
entrada de javax.faces.webapp.FacesServlet
la misma web.xml
. Entonces, si es por ejemplo Faces Servlet
, entonces necesita editarlo en consecuencia para que coincida.
PrimeFaces 4.x
La misma historia que PrimeFaces 5.x se aplica también a 4.x.
Solo existe un problema potencial para obtener el contenido del archivo cargado UploadedFile#getContents()
. Esto volverá null
cuando se use la API nativa en lugar de Apache Commons FileUpload. Necesitas usar UploadedFile#getInputStream()
en su lugar. Consulte también ¿Cómo insertar una imagen cargada desde p: fileUpload como BLOB en MySQL?
Otro problema potencial que se manifestará con la API nativa es cuando el componente de carga está presente en un formulario en el que se activa una solicitud ajax "regular" diferente que no procesa el componente de carga. Consulte también La carga de archivos no funciona con AJAX en PrimeFaces 4.0 / JSF 2.2.x - javax.servlet.ServletException: el tipo de contenido de la solicitud no es un multipart / form-data .
Ambos problemas también se pueden resolver cambiando a Apache Commons FileUpload. Consulte la sección PrimeFaces 3.x para obtener más detalles.
PrimeFaces 3.x
Esta versión no es compatible con la carga de archivos nativos JSF 2.2 / Servlet 3.0. Debe instalar manualmente Apache Commons FileUpload y registrar explícitamente el filtro de carga de archivos en web.xml
.
Necesita las siguientes bibliotecas:
Esos deben estar presentes en la ruta de clases en tiempo de ejecución de la aplicación web. Al usar Maven, asegúrese de que tengan al menos un ámbito de tiempo de ejecución (el ámbito de compilación predeterminado también es bueno). Cuando transporte manualmente los archivos JAR, asegúrese de que terminen en la /WEB-INF/lib
carpeta.
El detalle del registro del filtro de carga de archivos se puede encontrar en la sección PrimeFaces 5.x aquí arriba. En caso de que esté usando PrimeFaces 4+ y le gustaría usar explícitamente Apache Commons FileUpload en lugar de la carga de archivos nativos JSF 2.2 / Servlet 3.0, entonces necesita junto a las bibliotecas mencionadas y filtrar también el siguiente parámetro de contexto en web.xml
:
<context-param>
<param-name>primefaces.UPLOADER</param-name>
<param-value>commons</param-value><!-- Allowed values: auto, native and commons. -->
</context-param>
Solución de problemas
En caso de que aún no funcione, aquí hay otras posibles causas no relacionadas con la configuración de PrimeFaces:
Sólo si está utilizando el filtro de carga de archivos PrimeFaces: Hay otra Filter
en tu aplicación web que se ejecuta antes de que el filtro de carga de archivos PrimeFaces y ya ha consumido el cuerpo de la petición por ejemplo, llamadas getParameter()
, getParameterMap()
, getReader()
, etcétera. El cuerpo de una solicitud solo se puede analizar una vez. Cuando llama a uno de esos métodos antes de que el filtro de carga de archivos haga su trabajo, el filtro de carga de archivos obtendrá un cuerpo de solicitud vacío.
Para solucionar esto, debe colocar el <filter-mapping>
filtro de carga de archivos antes que el otro filtro web.xml
. Si la solicitud no es una multipart/form-data
solicitud, entonces el filtro de carga de archivos continuará como si nada. Si utiliza filtros que se agregan automáticamente porque usan anotaciones (por ejemplo, PrettyFaces), es posible que deba agregar un orden explícito a través de web.xml. Consulte Cómo definir el orden de ejecución del filtro de servlets mediante anotaciones en WAR
Solo si está utilizando el filtro de carga de archivos PrimeFaces: hay otra Filter
en su aplicación web que se ejecuta antes del filtro de carga de archivos PrimeFaces y ha realizado una RequestDispatcher#forward()
llamada. Por lo general, los filtros de reescritura de URL como PrettyFaces hacen esto. Esto activa el FORWARD
despachador, pero los filtros escuchan de forma predeterminada REQUEST
solo en el despachador.
Para solucionar esto, deberá colocar el filtro de carga de archivos PrimeFaces antes del filtro de reenvío, o reconfigurar el filtro de carga de archivos PrimeFaces para escuchar también en el FORWARD
despachador:
<filter-mapping>
<filter-name>primeFacesFileUploadFilter</filter-name>
<servlet-name>facesServlet</servlet-name>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
Hay un anidado <h:form>
. Esto es ilegal en HTML y el comportamiento del navegador no está especificado. La mayoría de las veces, el navegador no enviará los datos esperados al enviarlos. Asegúrese de no anidar <h:form>
. Esto es completamente independiente del formulario enctype
. Simplemente no anide formas en absoluto.
Si aún tiene problemas, depure el tráfico HTTP. Abra el conjunto de herramientas para desarrolladores del navegador web (presione F12 en Chrome / Firebug23 + / IE9 +) y verifique la sección Red / Red. Si la parte HTTP se ve bien, depure el código JSF. Ponga un punto de ruptura FileUploadRenderer#decode()
y avance desde allí.
Guardando archivo subido
Después de que finalmente lo hayas hecho funcionar, tu próxima pregunta probablemente será como "¿Cómo / dónde guardo el archivo cargado?". Bueno, continúe aquí: Cómo guardar el archivo cargado en JSF .
web.xml
según la Guía del usuario de PrimeFaces. ¿Lo leíste de todos modos? Sin embargo, eso no explicaría por quémode="simple"
funciona para usted.