Java组件commons fileupload实现文件上传功能

当我们需要在Java Web应用中实现文件上传功能时，可以使用Java组件commons fileupload来完成这个任务。下面是commons fileupload实现文件上传功能的完整攻略：

1. 引入commons fileupload组件

首先你需要在项目中引入commons fileupload组件的jar包，这个组件是Maven Group ID中的一部分。使用Maven管理依赖，可以在pom.xml文件中添加以下依赖：

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>

2. 在Web应用中导入commons fileupload

在Java Web应用中，我们需要将commons fileupload导入进来，这个可以使用以下代码完成：

import org.apache.commons.fileupload.servlet.ServletFileUpload;

ServletFileUpload.isMultipartContent(request)

3. 获取上传文件的参数

首先需要定义一个标签form来选择文件和提交表单数据。当用户提交表单数据时，可以使用以下代码将文件保存到服务器：

FileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload upload = new ServletFileUpload(factory);
List<FileItem> items = upload.parseRequest(request);

for (FileItem item : items) {
    if (item.isFormField()) {
        // 处理非文件表单项
    } else {
        // 处理文件表单项
    }
}

在上述代码中，我们使用FileItemFactory接口的实现类DiskFileItemFactory来创建FileItem，然后通过ServletFileUpload对象的parseRequest()方法来获取上传的文件列表。

4. 将上传的文件保存到服务器

下一步需要将上传的文件保存到服务器的指定路径中。可以使用以下代码完成这个任务：

FileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload upload = new ServletFileUpload(factory);
List<FileItem> items = upload.parseRequest(request);

for (FileItem item : items) {
    if (!item.isFormField()) {
        // 获取文件的完整路径名
        String fileName = item.getName();
        // 获取文件的大小
        long size = item.getSize();
        // 获取文件的类型
        String contentType = item.getContentType();
        // 保存文件到服务器
        String filePath = "/upload/" + fileName; // 保存到/upload文件夹下
        File file = new File(filePath);
        item.write(file);
    }
}

将上传的文件保存到服务器中可以使用File类和FileOutputStream类来完成。File类用于创建和操作文件或目录，FileOutputStream类可以将流中的内容写入到指定的文件中。

5. 处理上传文件的限制和异常

在文件上传功能中，为了保证应用程序的安全性和稳定性，需要进行一些限制和异常处理：

• 限制文件上传大小：可以在web.xml文件中配置大小限制。可以通过以下方式来获取大小限制：

long maxFileSize = Long.parseLong(
    getServletContext().getInitParameter("maxFileSize"));

• 限制上传文件类型：可以在web.xml文件中配置上传文件的类型。可以使用以下代码：

String allowedTypes = getServletContext().getInitParameter("allowedTypes");
String[] typesArray = allowedTypes.split(",");

• 处理上传文件异常：在上传文件时，可能会发生一些异常，例如文件格式不正确、文件大小超过限制等。我们需要捕获这些异常并进行处理：

try {
    item.write(file);
} catch (Exception e) {
    e.printStackTrace();
    response.getWriter().write(e.getMessage());
}

这样可以将发生的异常信息输出给客户端，以便于客户端更好地了解出现的问题。

示例1：上传文件和表单项到服务端

下面是一个示例代码，展示如何将表单项和上传的文件一起提交到后端服务器：

<form action="upload" method="post" enctype="multipart/form-data">
    <input type="text" name="username">
    <input type="file" name="file">
    <input type="submit">
</form>

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    ServletFileUpload fileUpload = new ServletFileUpload();
    try {
        // 解析请求
        FileItemIterator itemIterator = fileUpload.getItemIterator(request);
        while (itemIterator.hasNext()) {
            FileItemStream item = itemIterator.next();
            // 检查是否是表单项
            if (!item.isFormField()) {
                // 获取文件信息
                String fileName = item.getName();
                InputStream inputStream = item.openStream();
                // 进行文件操作
                // ...
            } else {
                // 获取表单项信息
                String fieldName = item.getFieldName();
                String value = Streams.asString(item.openStream());
                // 进行表单项操作
                // ...
            }
        }
    } catch (FileUploadException e) {
        e.printStackTrace();
        response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
    }
}

示例2：限制上传文件大小和类型

下面展示如何在web.xml配置文件中限制上传文件的大小和类型：

<context-param>
    <param-name>maxFileSize</param-name>
    <param-value>1000000</param-value>
</context-param>

<context-param>
    <param-name>allowedTypes</param-name>
    <param-value>image/jpeg,image/png</param-value>
</context-param>

在处理上传文件时，可以在代码中获取这些参数并进行相应的限制：

long maxFileSize = Long.parseLong(
    getServletContext().getInitParameter("maxFileSize"));
String allowedTypes = getServletContext().getInitParameter("allowedTypes");

ServletFileUpload fileUpload = new ServletFileUpload();
fileUpload.setFileSizeMax(maxFileSize);

FileItemIterator itemIterator = fileUpload.getItemIterator(request);
while (itemIterator.hasNext()) {
    FileItemStream item = itemIterator.next();
    if (!item.isFormField()) {
        // 检查文件类型
        String contentType = item.getContentType();
        if (!Arrays.asList(allowedTypes.split(",")).contains(contentType)) {
            response.sendError(HttpServletResponse.SC_BAD_REQUEST,
                String.format("Upload file type [%s] is not allowed!", contentType));
            return;
        }
        // 检查文件大小
        if (item.openStream().available() > maxFileSize) {
            response.sendError(HttpServletResponse.SC_BAD_REQUEST,
                String.format("Upload file size exceed %d bytes!", maxFileSize));
            return;
        }
        // 处理上传的文件
        // ...
    }
}

以上就是commons fileupload实现文件上传功能的完整攻略了，希望能够帮助到你。