PrimeFaces无法导入UploadedFiles类，求多文件上传解决方案

看起来你在实现多文件上传时遇到了依赖和类导入的问题，我来帮你一步步排查解决：

1. 确认正确的依赖配置 #

PrimeFaces的UploadedFiles类属于核心包，但文件上传功能依赖Apache Commons的两个基础库。如果你用Maven，确保pom.xml里包含以下完整依赖：

<!-- PrimeFaces核心依赖 -->
<dependency>
    <groupId>org.primefaces</groupId>
    <artifactId>primefaces</artifactId>
    <version>7.0</version>
</dependency>

<!-- 文件上传必需的Apache Commons依赖 -->
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>
<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.8.0</version>
</dependency>

如果是Gradle，对应配置：

compile 'org.primefaces:primefaces:7.0'
compile 'commons-fileupload:commons-fileupload:1.4'
compile 'commons-io:commons-io:2.8.0'

2. 检查导入语句是否正确 #

UploadedFiles类的正确包路径是org.primefaces.model，别搞错了包名，导入语句应该是：

import org.primefaces.model.UploadedFiles;
import org.primefaces.model.UploadedFile; // 遍历多文件时会用到单个文件类

3. 配置FileUpload过滤器 #

在web.xml里必须添加PrimeFaces的文件上传过滤器，否则上传功能无法正常触发：

<filter>
    <filter-name>PrimeFaces FileUpload Filter</filter-name>
    <filter-class>org.primefaces.webapp.filter.FileUploadFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>PrimeFaces FileUpload Filter</filter-name>
    <servlet-name>Faces Servlet</servlet-name>
</filter-mapping>

4. 多文件上传的示例实现 #

托管Bean代码 #

import javax.faces.bean.ManagedBean;
import javax.faces.bean.ViewScoped;
import org.primefaces.model.UploadedFile;
import org.primefaces.model.UploadedFiles;

@ManagedBean
@ViewScoped
public class MultiFileUploadBean {

    public void handleMultiUpload(UploadedFiles uploadedFiles) {
        // 遍历所有上传的文件
        for (UploadedFile file : uploadedFiles.getFiles()) {
            String fileName = file.getFileName();
            byte[] fileContent = file.getContents();
            
            // 这里写你的文件处理逻辑，比如保存到磁盘、数据库等
            System.out.println("成功上传文件：" + fileName);
        }
    }
}

XHTML页面代码 #

<h:form enctype="multipart/form-data">
    <p:fileUpload 
        mode="advanced" 
        multiple="true" 
        fileUploadListener="#{multiFileUploadBean.handleMultiUpload}"
        allowTypes="/(\.|\/)(gif|jpe?g|png|pdf|docx)$/" <!-- 可选：限制上传文件类型 -->
        label="选择文件"
        uploadLabel="开始上传"
        cancelLabel="取消" />
        
    <p:commandButton value="确认上传" update="growl" />
</h:form>

5. 排查可能的冲突问题 #

• 检查项目中是否存在多个版本的PrimeFaces Jar包，导致类加载冲突
• 确认Commons FileUpload/IO的版本和PrimeFaces 7.0兼容（上面给出的版本是经过验证的稳定组合）
• 如果是IDE缓存问题，尝试清理项目、重新导入依赖（比如Maven执行clean install）

如果按照这些步骤操作后还是找不到UploadedFiles类，可以手动打开PrimeFaces 7.0的Jar包，查看org/primefaces/model目录下是否存在该类，确认Jar包是否完整。

内容的提问来源于stack exchange，提问作者Sanyam Madaan