Struts2是一个流行的Java web框架，它提供了丰富的功能来构建MVC（模型-视图-控制器）架构的应用程序。在Struts2中，文件上传是一个常见的需求，允许用户通过网页上传文件到服务器。本篇文章将详细讲解如何使用Struts2实现上传单个文件的功能。
我们需要创建一个用于上传文件的JSP页面。`upload.jsp` 是用户交互的界面，用户在这里选择要上传的文件。JSP页面的关键部分是`<form>`标签，它必须设置`enctype="multipart/form-data"`以支持文件上传，同时`method`属性应为`POST`。在这个例子中，我们有一个`<input type="file" name="upload">`元素让用户选择文件，然后点击`<input type="submit" value="上传文件">`按钮提交表单。
```jsp
<form action="uploadImage.action" enctype="multipart/form-data" method="post">
please select the file:<input type="file" name="upload">
<input type="submit" value="上传文件">
</form>
```
接下来，我们需要创建一个Struts2的动作类（Action），这个类负责处理用户提交的请求。这里我们创建了一个名为`FileUploadAction`的类，它继承自`ActionSupport`，这是Struts2提供的基础动作类。在`FileUploadAction`中，我们需要定义三个属性：`upload`、`uploadFileName`和`uploadContentType`，分别对应上传文件的实例、文件名和内容类型。这些属性会由Struts2的上传组件自动填充。
```java
public class FileUploadAction extends ActionSupport {
private File upload;
private String uploadFileName;
private String uploadContentType;
// getters and setters...
public String execute(){
// 文件保存逻辑...
}
}
```
在`execute()`方法中，我们处理文件上传的实际逻辑。获取文件的保存路径，通常我们将其保存到服务器的一个特定目录下。这里使用`ServletActionContext.getServletContext().getRealPath()`方法来获取相对于web应用根目录的绝对路径。然后，创建`FileInputStream`和`FileOutputStream`，分别用于读取上传文件和写入到服务器的文件。`IOUtils.copy()`方法用于将输入流的内容复制到输出流，完成文件的保存。
```java
String savePath = ServletActionContext.getServletContext().getRealPath("/upload/" + this.uploadFileName);
try{
FileInputStream fis = new FileInputStream(upload);
FileOutputStream fos = new FileOutputStream(savePath);
IOUtils.copy(fis, fos);
fos.flush();
fos.close();
fis.close();
}catch(Exception e){
// 错误处理...
}
```
别忘了处理可能的异常，并确保在操作完成后关闭流。这只是一个基本的文件上传示例，实际应用中可能还需要考虑更多的细节，比如文件大小限制、文件类型检查、错误处理等。
总结来说，Struts2通过提供内置的文件上传支持，使得开发者能够轻松地实现文件上传功能。在JSP页面中创建表单，定义上传字段，并在对应的Action类中处理文件上传逻辑，即可完成文件上传的过程。这种机制在开发Java web应用程序时非常有用，特别是在需要用户交互并处理上传文件的场景中。
