在Java Web开发中，文件上传是一项常见的功能，用于允许用户上传本地文件到服务器。本教程将专注于使用Java、JSP（JavaServer Pages）和Servlet来实现文件上传，并结合Apache Commons IO和Commons FileUpload库来简化这个过程。这两个库提供了方便的API，使文件上传更加简单、高效。
我们需要理解文件上传的基本原理。在HTTP协议中，表单数据（包括文件）通常以多部分/形式数据（Multipart/form-data）格式发送。Servlet API本身并不直接支持这种格式的解析，因此我们需要借助外部库，如Apache Commons FileUpload，它能够解析这种复杂的请求数据。
Apache Commons IO是另一个实用库，提供了许多与输入/输出操作相关的工具类，例如文件读写、流处理等，对于文件上传也有一定的辅助作用。
要使用这些库，首先需要在项目中引入它们。`commons-io-2.0.1.jar`和`commons-fileupload-1.2.2.jar`是必需的依赖项。根据提供的描述，可以从指定的下载地址获取这些jar包，并将其添加到项目的类路径中。
接下来，我们创建一个Servlet来处理文件上传。以下是一个基本的`UploadServlet`示例：
```java
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.IOException;
import java.util.List;
public class UploadServlet extends HttpServlet {
@Override
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
if (!ServletFileUpload.isMultipartContent(request)) {
return;
}
DiskFileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload upload = new ServletFileUpload(factory);
try {
List<FileItem> items = upload.parseRequest(request);
for (FileItem item : items) {
if (!item.isFormField()) {
String fileName = item.getName();
File uploadedFile = new File("uploads/" + fileName);
item.write(uploadedFile);
// 在这里可以处理上传后的逻辑，如保存文件信息到数据库等
}
}
} catch (FileUploadException e) {
throw new ServletException("Failed to parse upload request", e);
}
}
}
```
这段代码中，我们首先检查请求是否为多部分/表单类型，然后使用`ServletFileUpload`解析请求并获取文件项。每个`FileItem`代表一个表单字段，如果是文件字段，我们可以调用`write()`方法将其保存到服务器的特定位置。
为了在JSP页面上实现文件选择和提交，我们可以创建一个简单的表单：
```jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<body>
<form action="UploadServlet" method="post" enctype="multipart/form-data">
<input type="file" name="fileToUpload" id="fileToUpload">
<input type="submit" value="Upload File" name="submit">
</form>
</body>
</html>
```
这里的`enctype="multipart/form-data"`属性告诉浏览器以多部分/表单数据格式发送表单数据，`action`属性指定了Servlet的URL。
在实际应用中，还需要考虑错误处理、文件大小限制、文件类型检查等安全问题。例如，可以设置`DiskFileItemFactory`的最大存储限制，或者使用`FileUpload`的`setFileSizeMax()`方法限制上传文件大小。
别忘了在Web应用的部署描述符`web.xml`中注册Servlet：
```xml
<servlet>
<servlet-name>UploadServlet</servlet-name>
<servlet-class>com.example.UploadServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>UploadServlet</servlet-name>
<url-pattern>/upload</url-pattern>
</servlet-mapping>
```
这样，当用户访问`/upload` URL并提交带有文件的表单时，`UploadServlet`会接收请求并处理文件上传。
通过以上步骤，我们就实现了基于Java、JSP和Servlet的文件上传功能，利用了Apache Commons IO和Commons FileUpload库简化了实现过程。在实际项目中，还可以根据需求进一步扩展，比如提供上传进度条、多文件上传等功能。
文件上传.rar （2个子文件） 
Upload.java 4KB
使用到的jar包.txt 140B
