在Struts2框架中实现文件上传到服务器是一个常见的需求,其核心在于利用Struts2提供的文件上传拦截器和配置文件来完成，下面将详细介绍Struts2上传文件的实现原理、步骤、配置及注意事项，并辅以表格说明关键配置项，最后附上相关FAQs。
Struts2的文件上传功能依赖于fileUpload拦截器，该拦截器默认存在于defaultStack中，负责处理HttpServletRequest中的multipart请求（即包含文件上传的表单），当表单的enctype属性设置为multipart/form-data时，浏览器会将文件内容以二进制形式随表单数据一同发送到服务器。fileUpload拦截器会解析请求，将文件内容封装为File对象，并存储在临时目录中，同时将文件名、文件类型等信息封装到Action的属性中，供开发者后续处理。
实现Struts2文件上传主要分为以下几个步骤：创建包含文件上传表单的JSP页面，表单需指定enctype="multipart/form-data"，并提供文件输入框；在Action类中定义接收文件的属性（类型为File）、文件名属性（类型为String）和文件类型属性（类型为String），并生成对应的getter和setter方法；在Struts2配置文件（struts.xml）中配置Action，可通过<interceptor-ref>指定fileUpload拦截器，并设置允许上传的文件类型、最大文件大小等参数；在Action中处理文件，例如将临时文件移动到指定目录，并返回操作结果。
以下是关键配置项的说明表格：
| 配置项 | 作用 | 示例 |
|---|---|---|
enctype="multipart/form-data" |
表单属性，声明表单包含文件上传 | <form enctype="multipart/form-data"> |
<fileUpload allowedTypes="..."> |
拦截器参数，限制允许上传的文件类型（MIME类型） | <interceptor-ref name="fileUpload"><param name="allowedTypes">image/jpeg,image/png</param></interceptor-ref> |
<fileUpload maximumSize="..."> |
拦截器参数，限制上传文件的最大字节数（单位：字节） | <param name="maximumSize">1048576</param>（限制为1MB） |
<fileUpload contentType="..."> |
拦截器参数，限制上传文件的Content-Type（较少使用，建议用allowedTypes） | <param name="contentType">text/plain</param> |
File saveDir |
Action属性，接收上传的文件（临时文件） | private File file; |
String fileFileName |
Action属性，接收上传文件的原始文件名（命名规则：文件属性名+FileName） | private String fileFileName; |
String fileContentType |
Action属性，接收上传文件的类型（命名规则：文件属性名+ContentType） | private String fileContentType; |
在Action中处理文件时,通常需要获取服务器上的目标存储路径，可以通过ServletContext的getRealPath()方法获取Web应用的物理路径，然后结合自定义目录构建完整路径，将文件保存到WebContent/uploads目录下，代码示例如下：
ServletContext servletContext = ServletActionContext.getServletContext();
String uploadPath = servletContext.getRealPath("/uploads");
File targetFile = new File(uploadPath, fileFileName);
FileUtils.copyFile(file, targetFile);
FileUtils是Apache Commons IO工具类中的方法，用于文件复制，需要注意的是，目标目录必须存在且有写入权限，否则会抛出异常，为了避免临时文件占用磁盘空间，应在文件处理完成后删除临时文件（可通过file.delete()实现）。
在配置struts.xml时，若未显式配置fileUpload拦截器，则默认会使用defaultStack中的拦截器，但若需要自定义拦截器栈，则需显式引入fileUpload拦截器，并设置相关参数。
<action name="upload" class="com.example.UploadAction">
<interceptor-ref name="fileUpload">
<param name="allowedTypes">image/jpeg,image/gif,image/png</param>
<param name="maximumSize">2097152</param> <!-- 2MB -->
</interceptor-ref>
<interceptor-ref name="defaultStack"/>
<result name="success">/success.jsp</result>
<result name="input">/upload.jsp</result>
</action>
上述配置中,allowedTypes限制了仅允许上传图片文件，maximumSize限制了文件大小不超过2MB，如果上传文件不符合要求，拦截器会返回input结果，此时可在JSP页面通过<s:fielderror>显示错误信息。
常见问题包括：文件上传大小限制失效，可能是因为未正确配置maximumSize参数，或服务器自身（如Tomcat）的maxPostSize限制（需在server.xml中修改Connector的maxPostSize属性）；文件上传后中文文件名乱码，可通过设置fileUpload拦截器的charset参数为UTF-8解决，或对文件名进行编码处理（如new String(fileFileName.getBytes("ISO-8859-1"), "UTF-8")）。
相关问答FAQs
-
问：Struts2上传大文件时出现错误，如何解决？
答：首先检查struts.xml中fileUpload拦截器的maximumSize参数是否设置合理（如10485760表示10MB）；确认服务器（如Tomcat）的maxPostSize限制，默认为2MB，需在server.xml的Connector节点中添加maxPostSize="-1"（表示无限制）或设置更大的值；确保临时目录有足够磁盘空间，并调整JVM堆内存大小，避免内存溢出。 -
问：上传文件后如何防止文件名重复导致的覆盖问题？
答：可在保存文件时对文件名进行重命名，例如使用UUID生成唯一文件名，或结合时间戳和随机数生成新文件名，示例代码：String originalName = fileFileName; String extension = originalName.substring(originalName.lastIndexOf(".")); String uniqueName = UUID.randomUUID().toString() + extension; File targetFile = new File(uploadPath, uniqueName); FileUtils.copyFile(file, targetFile);也可在数据库中记录文件原始名与存储名的映射关系,便于后续管理。
