简介：本教程讲解了如何在Java Web开发中使用Struts1.x框架上传多个文件。介绍了在HTML表单中使用 <input type="file"> 元素配置多文件上传，以及如何在Struts1.x的配置文件中声明处理文件上传的Action。接着详细说明了在Action类中使用Apache Commons FileUpload库来解析请求中的多部分数据，并提供了一个具体的示例来演示整个上传过程，包括错误处理和成功反馈。
1. Struts1.x框架的MVC能力
Struts1.x框架概述
Struts1.x是Apache Software Foundation推出的基于MVC（Model-View-Controller）设计模式的Web应用框架。它的核心是将业务逻辑、用户界面和数据封装三者分离，简化了Java EE的开发流程，增强了代码的可维护性和可扩展性。
MVC设计模式的优势
在Struts1.x框架中，MVC模式将应用程序分为三个核心组件：模型（Model）、视图（View）和控制器（Controller）。模型代表应用程序的数据结构和业务逻辑；视图是用户看到并与之交互的界面；控制器负责接收用户的输入并调用模型和视图去完成用户的请求。
Struts1.x的MVC实现
Struts1.x通过ActionServlet作为控制器组件，将用户的请求转发到具体的Action类进行处理，Action类通常包含业务逻辑的实现。Struts提供了丰富的标签库来创建视图，而模型通常由JavaBean来表示，与Action类交互，处理数据和业务逻辑。
这一章内容为后续章节打下了基础，了解Struts1.x的MVC能力是掌握整个框架的关键。在后续章节中，我们将深入探讨如何在Struts1.x框架中实现具体的Web功能，例如表单的配置与多文件上传，以及如何使用Struts的配置文件声明Action等高级功能。
2. HTML表单配置与多文件选择
2.1 HTML表单的基本结构
2.1.1 表单元素的定义和属性
表单是Web应用中收集用户输入信息的重要界面组件。HTML表单的基本元素包括 <form> 标签及其子元素，如 <input> 、 <textarea> 、 <button> 等。 <form> 标签定义了表单的开始和结束位置，它包含有多个属性，如 action 属性指定表单提交的URL， method 属性指定提交数据所使用的HTTP方法（通常是GET或POST）。
<form action="/submit_form" method="POST">
<!-- 表单内容 -->
</form>
<input> 元素是表单中用于输入数据的元素， type 属性定义了输入类型，例如 text 、 password 、 radio 等。 name 属性是必须的，它标识了表单数据中的一个字段。 value 属性提供 input 元素的默认值。
2.1.2 多文件选择的input标签设置
HTML5 引入了 <input type="file"> 元素，允许用户上传文件到服务器。对于多文件上传， <input> 标签的 multiple 属性使得用户可以选择多个文件。
<form action="/submit_form" method="POST" enctype="multipart/form-data">
<input type="file" name="files[]" multiple>
<input type="submit" value="Upload">
</form>
在上述代码中， enctype 属性被设置为 multipart/form-data ，这是因为当表单包含文件上传时，必须使用此编码类型来确保文件数据能够正确传输。 name 属性设置为 files[] 以便在服务器端接收到的是一个数组形式的文件列表。
2.2 表单的提交方式和数据封装
2.2.1 提交方法的选择：POST与GET
选择使用POST还是GET方法取决于表单的目的和预期的数据量。通常，对于包含敏感信息（如密码）或数据量较大的表单，推荐使用POST方法。GET方法则适用于简单的数据获取场景，并且数据会显示在URL中。
<!-- 使用POST方法提交表单 -->
<form action="/submit_form" method="POST" enctype="multipart/form-data">
<!-- 表单内容 -->
</form>
<!-- 使用GET方法提交表单 -->
<form action="/submit_form" method="GET">
<!-- 表单内容 -->
</form>
2.2.2 数据封装与编码方式
数据封装是指数据在通过HTTP传输之前被组织成特定格式的过程。在HTML表单中，当表单提交时，浏览器会根据 enctype 属性的值来决定数据封装的方式。
对于 application/x-www-form-urlencoded （默认值），表单数据会被编码为一系列键值对。对于 multipart/form-data ，数据被封装成多个部分，每个部分对应一个表单控件。当涉及到文件上传时， multipart/form-data 是必须的，因为文件数据是以二进制形式存在，需要特殊处理。
<!-- 数据封装为application/x-www-form-urlencoded -->
<form action="/submit_form" method="POST">
<input type="text" name="username" value="example">
<!-- 其他表单控件 -->
</form>
<!-- 数据封装为multipart/form-data -->
<form action="/submit_form" method="POST" enctype="multipart/form-data">
<input type="file" name="resume">
<!-- 其他表单控件 -->
</form>
在这个例子中，第一个表单会以键值对的形式提交数据，而第二个表单由于包含文件，将使用 multipart/form-data 进行封装。
3. Struts1.x配置文件中的Action声明
3.1 Struts配置文件的结构和元素
3.1.1 struts-config.xml文件的重要性
Struts1.x框架通过 struts-config.xml 文件对整个应用的MVC组件进行配置和管理。这个配置文件是Struts应用的核心，它定义了Action映射、FormBeans、全局转发以及消息资源等配置信息。开发者通过在该文件中定义特定的XML标签和属性来控制应用行为，从而实现了从HTTP请求到业务逻辑处理的映射，以及从处理结果到响应输出的流程。
struts-config.xml 文件的配置不仅影响了应用的结构和可维护性，还决定了Struts应用如何响应客户端的请求，以及如何显示结果页面。例如，通过配置ActionForm，可以定义表单数据如何被封装和传输，而Action类则处理具体的业务逻辑。此外，配置文件还提供了一种机制来实现请求转发到相应的JSP页面或者Action类。
3.1.2 ActionMapping与ActionForm的配置
在 struts-config.xml 中， <action-mappings> 元素下定义了多个 <action> 元素，这些元素构成了Struts框架的核心组件。每一个 <action> 元素对应一个Action类，负责处理来自客户端的请求，并返回一个响应。每个 <action> 标签可以包含以下几个关键属性：
-
path：指定请求的URL模式与该Action关联。 -
type：指定处理请求的Action类的完全限定名。 -
name：指定与Action关联的FormBean的名称。 -
scope：指定FormBean的作用域。 -
validate：布尔值，指示是否验证FormBean。 -
input：指定当验证失败时应转发到的页面。
一个典型的Action映射配置示例如下所示：
<action-mappings>
<action path="/userUpload"
type="com.example.UploadAction"
name="userUploadForm"
scope="request"
validate="true"
input="/upload.jsp">
<forward name="success" path="/success.jsp"/>
<forward name="error" path="/error.jsp"/>
</action>
</action-mappings>
上面的配置指定了 /userUpload 路径的请求由 com.example.UploadAction 类来处理。当处理成功时，根据返回的逻辑视图名称，请求会被转发到 /success.jsp 页面；如果在处理过程中发生验证错误，则请求会被转发到 /error.jsp 页面。
3.2 多文件上传Action的配置细节
3.2.1 Action的名称和路径配置
为了支持多文件上传，Struts1.x框架要求开发者在 struts-config.xml 中为多文件上传功能配置专门的Action。多文件上传的Action配置中， path 属性用于定义请求的URL模式，而 type 属性指定该请求将由哪个Action类来处理。例如：
<action path="/uploadFiles"
type="com.example.UploadFileAction"
name="uploadForm"
scope="request"
validate="true">
<!-- 配置逻辑视图转发 -->
</action>
在上面的配置中， /uploadFiles 是URL模式，所有的上传请求都会被映射到 UploadFileAction 类。 uploadForm 是在 <form-bean> 中定义的表单bean名称，用于在Action与JSP表单之间传递数据。
3.2.2 表单和Action类的关联设置
在配置Action的时候，表单和Action类的关联设置是多文件上传不可或缺的一步。Struts框架通过 name 属性关联Action类和表单bean。表单bean是在 <form-beans> 部分定义的，它规定了表单数据的结构。下面是一个表单bean的示例：
<form-beans>
<form-bean name="uploadForm" type="com.example.UploadForm"/>
</form-beans>
在 struts-config.xml 文件中，这个表单bean uploadForm 被关联到Action配置，表明该表单将携带多文件上传的数据提交给 UploadFileAction 处理。 UploadForm 类需要继承自 ActionForm ，并在内部定义文件字段，以便Struts能够处理多部分数据。
例如，一个简单的表单bean类定义如下：
public class UploadForm extends ActionForm {
private File[] files; // 用于存储上传文件的文件数组
// getter和setter方法
public File[] getFiles() {
return files;
}
public void setFiles(File[] files) {
this.files = files;
}
}
多文件上传的Action配置细节不仅需要正确设置 struts-config.xml ，还需要有相应的Action类和FormBean类配合使用，以实现完整的多文件上传功能。在下一章节中，我们将详细探讨如何使用Apache Commons FileUpload解析多部分请求数据，并在Action类中实现文件的存储逻辑。
4. 使用Apache Commons FileUpload解析多部分请求数据
随着Web应用的日趋复杂，文件上传功能已成为许多Web应用不可或缺的一部分。在本章中，我们将深入探讨Apache Commons FileUpload库如何帮助开发者解析多部分请求数据，以实现文件上传功能。我们将详细讲解该库的工作原理、安装过程和如何在项目中应用。
4.1 Apache Commons FileUpload库简介
Apache Commons FileUpload是一个用于解析通过HTTP协议上传的文件的库，它简化了文件上传的处理过程。它支持处理来自HTML表单的文件上传，以及通过REST API接收的文件上传。
4.1.1 为什么选择Apache Commons FileUpload
在Java Web开发中，文件上传是一个常见的需求，而传统的Servlet API虽然提供了文件上传的基本支持，但其使用起来较为繁琐，并且需要处理多种边界情况，如多文件上传、上传失败处理等。Apache Commons FileUpload库的出现，大大降低了文件上传的复杂性，它通过提供一套简洁的API，使得开发者能够更加专注于业务逻辑的实现。
使用Apache Commons FileUpload的优势包括：
- 支持单文件和多文件上传。
- 可以灵活处理上传文件的大小限制。
- 提供了错误处理机制，便于上传过程中出现的问题的诊断和处理。
- 支持进度监听，可以在上传大文件时给予用户反馈。
- 能够轻松集成到Spring、Struts等主流框架中。
4.1.2 库的依赖和下载安装
要使用Apache Commons FileUpload库，首先需要将其添加到项目的依赖中。对于使用Maven的项目，可以在 pom.xml 文件中添加以下依赖：
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.4</version>
</dependency>
确保版本与项目需求相匹配。对于非Maven项目，需要手动下载jar包，并将其添加到项目的classpath中。
4.2 文件上传数据解析的实现步骤
接下来，我们将详细介绍如何使用Apache Commons FileUpload库来解析多部分请求数据。
4.2.1 创建DiskFileItemFactory实例
DiskFileItemFactory 是处理上传文件的工厂类，它负责为上传的文件创建临时存储区域。我们通常创建一个该类的实例，并设置一些属性，如缓存大小和临时目录：
DiskFileItemFactory factory = new DiskFileItemFactory();
// 设置缓冲区大小，超过则写入磁盘
factory.setSizeThreshold(1024 * 1024 * 3); // 3MB
// 设置临时存储目录
factory.setRepository(new File("path/to/tempdir"));
4.2.2 解析HttpServletRequest获取文件项
有了工厂实例后，我们需要解析 HttpServletRequest 来获取文件项。 ServletFileUpload 类正是为此而生：
ServletFileUpload upload = new ServletFileUpload(factory);
List<FileItem> multiparts = upload.parseRequest(request);
在这里， multiparts 是一个 FileItem 对象的列表，每个对象代表一个表单中的输入项。如果表单类型为“multipart/form-data”，则其中的每个 FileItem 对象表示一个文件或者表单字段。
4.2.3 文件保存逻辑的实现
现在，我们可以遍历 multiparts 列表，并对每个 FileItem 进行处理：
for (FileItem item : multiparts) {
if (item.isFormField()) {
// 处理表单字段
String fieldName = item.getFieldName();
String fieldValue = item.getString();
// 业务逻辑处理...
} else {
// 处理文件上传
String fileName = new File(item.getName()).getName();
File storeFile = new File("path/to/save", fileName);
item.write(storeFile);
// 业务逻辑处理...
}
}
在处理文件上传时，我们首先从 FileItem 获取文件的原始名称，并构造保存路径。然后调用 FileItem 的 write() 方法将文件写入到磁盘中。
本章节内容展示了如何通过Apache Commons FileUpload库解析多部分请求数据。在下一章节中，我们将介绍如何编写Action类以及实现文件存储逻辑。
5. Action类编写及文件存储逻辑实现
在Web应用开发中，处理上传的文件并将其存储到服务器是常见的需求。本章将重点介绍如何在Struts1.x框架下编写Action类以处理文件上传，并实现文件存储逻辑。
5.1 Action类的基本结构和生命周期
5.1.1 Action类的定义和继承关系
Action类是Struts1.x中用于处理用户请求的核心类。开发者需要继承自 org.apache.struts.action.Action 类，并实现 execute() 方法。
public class FileUploadAction extends Action {
@Override
public ActionForward execute(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response)
throws Exception {
// 处理上传的文件
// 返回逻辑视图
}
}
Action类的生命周期从创建到销毁，可以分为三个阶段：实例化、执行方法和销毁。
5.1.2 方法执行流程和返回值解析
在 execute() 方法执行过程中，开发者处理表单提交的数据，并返回一个 ActionForward 对象，该对象指示了请求下一步的去向。
ActionForward forward = new ActionForward();
forward.setPath("/success.jsp"); // 指定成功处理后跳转的页面
forward.setRedirect(false);
return forward;
5.2 文件存储逻辑的编码
5.2.1 文件信息的获取和验证
在处理文件上传请求时，首先需要从 request 对象中获取上传的文件信息。使用Apache Commons FileUpload库可以轻松地解析请求并获取文件信息。
5.2.2 文件的存储路径和命名策略
为了安全地存储文件，应避免直接将文件保存在Web应用目录下。一种常见的做法是将文件保存在单独的文件服务器或使用应用程序特定的文件系统路径。
String storePath = "/path/to/application/files";
File storeDir = new File(storePath);
if (!storeDir.exists()) {
storeDir.mkdirs(); // 确保存储目录存在
}
在命名文件时，为了避免文件名冲突，可以生成一个唯一的文件名。
String originalFileName = file.getOriginalFileName();
String uniqueFileName = UUID.randomUUID().toString() + "_" + originalFileName;
File destFile = new File(storeDir, uniqueFileName);
5.2.3 多文件存储的逻辑和异常处理
当处理多个文件上传时，需要遍历请求中的所有文件并应用上述逻辑。异常处理是必不可少的环节，确保在操作文件时能够处理可能发生的I/O错误。
try {
// 处理文件存储
for (FileItem item : items) {
if (item.isFormField()) {
continue; // 跳过非文件字段
}
String fileName = item.getName();
File uploadedFile = new File(storeDir, fileName);
item.write(uploadedFile); // 将文件写入磁盘
}
} catch (Exception e) {
// 处理异常情况，例如文件写入失败等
e.printStackTrace();
}
最终，开发者应确保所有文件都已正确存储，并且应用了适当的错误处理机制。在实现上传逻辑时，应考虑并发上传和安全性等因素，确保系统的健壮性和数据的安全。
简介：本教程讲解了如何在Java Web开发中使用Struts1.x框架上传多个文件。介绍了在HTML表单中使用 <input type="file"> 元素配置多文件上传，以及如何在Struts1.x的配置文件中声明处理文件上传的Action。接着详细说明了在Action类中使用Apache Commons FileUpload库来解析请求中的多部分数据，并提供了一个具体的示例来演示整个上传过程，包括错误处理和成功反馈。
扫一扫
3922
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
