java怎么上传文件到服务器，java如何把文件上传服务器

***：主要探讨Java上传文件到服务器的方法。在Java中，可利用多种技术实现文件上传服务器功能。例如借助Java的网络编程相关类库，通过建立连接、构建合适的请求等步骤传输文件。还可使用如Apache Commons FileUpload等开源框架，它们提供了方便的API来处理文件上传，简化了操作流程，包括解析请求、处理文件数据等，从而高效地将本地文件上传至服务器指定位置。

本文目录导读：

1. 概述
2. 基于Servlet的文件上传
3. 使用Spring框架进行文件上传
4. 使用Java NIO进行文件上传

《Java文件上传服务器全解析》

概述

在Java应用程序开发中，文件上传到服务器是一个常见的需求，这在许多场景下都有应用，例如用户头像上传、文档共享平台等，Java提供了多种方式来实现文件上传到服务器，本文将详细介绍这些方法及其相关技术要点。

基于Servlet的文件上传

（一）准备工作

1、导入相关库

- 在基于Servlet的文件上传中，通常需要导入commons - fileupload和commons - io库。commons - fileupload库提供了处理文件上传的功能，而commons - io库提供了一些输入输出相关的实用方法。

- 可以通过在项目的构建文件（如Maven的pom.xml或Gradle的build.gradle）中添加依赖来引入这些库，对于Maven项目，在pom.xml中添加如下依赖：

```xml

<dependency>

<groupId>commons - fileupload</groupId>

<artifactId>commons - fileupload</artifactId>

<version>1.4</version>

</dependency>

<dependency>

<groupId>commons - io</groupId>

<artifactId>commons - io</artifactId>

<version>2.6</version>

</dependency>

```

2、HTML表单设置

- 在前端，需要创建一个HTML表单来允许用户选择要上传的文件，表单的enctype属性必须设置为multipart/form - data，这是用于文件上传的特殊编码类型。

```html

<form action="UploadServlet" method="post" enctype="multipart/form - data">

<input type="file" name="fileToUpload">

<input type="submit" value="Upload File">

</form>

```

（二）编写Servlet处理文件上传

1、处理上传请求的Servlet代码

- 在Java中，创建一个Servlet类来处理文件上传请求，在doPost方法中，需要检查请求是否为多部分（multipart）请求。

```java

import javax.servlet.ServletException;

import javax.servlet.annotation.WebServlet;

import javax.servlet.http.HttpServlet;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

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 java.io.File;

import java.io.IOException;

import java.util.List;

@WebServlet("/UploadServlet")

public class UploadServlet extends HttpServlet {

@Override

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

if (ServletFileUpload.isMultipartContent(request)) {

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("C:/uploads/" + fileName);

item.write(uploadedFile);

}

}

response.getWriter().println("File uploaded successfully.");

} catch (FileUploadException | Exception e) {

e.printStackTrace();

response.getWriter().println("Error uploading file: " + e.getMessage());

}

} else {

response.getWriter().println("Not a multipart request.");

}

}

}

```

- 在上述代码中，首先创建了一个DiskFileItemFactory，它用于设置临时文件存储的位置等参数，然后创建了ServletFileUpload对象，并使用它来解析上传请求，如果请求是多部分请求，解析后的FileItem列表包含了表单中的所有字段和文件，对于每个FileItem，如果它不是普通的表单字段（即isFormField()返回false），则获取文件名，创建目标文件对象，然后将上传的文件内容写入目标文件。

2、文件存储路径和权限

- 在上述示例中，文件存储路径是硬编码的（C:/uploads/），在实际应用中，应该根据实际需求动态配置文件存储路径，需要确保服务器对该存储路径有写入权限，如果权限不足，可能会导致文件无法写入，从而导致上传失败。

使用Spring框架进行文件上传

（一）Spring Boot中的文件上传

1、配置文件上传属性

- 在Spring Boot项目中，可以在application.properties（或application.yml）中配置文件上传的相关属性，可以设置最大文件大小、临时文件存储位置等。

- 在application.properties中：

```properties

spring.servlet.multipart.max - file - size = 10MB

spring.servlet.multipart.max - request - size = 10MB

spring.servlet.multipart.location = /tmp/uploads

```

- 这里设置了单个文件的最大大小为10MB，整个请求的最大大小为10MB，临时文件存储在/tmp/uploads目录下。

2、编写文件上传控制器

- 创建一个Spring MVC控制器来处理文件上传请求。

```java

import org.springframework.web.bind.annotation.PostMapping;

import org.springframework.web.bind.annotation.RequestParam;

import org.springframework.web.bind.annotation.RestController;

import org.springframework.web.multipart.MultipartFile;

@RestController

public class FileUploadController {

@PostMapping("/upload")

public String uploadFile(@RequestParam("file") MultipartFile file) {

if (!file.isEmpty()) {

try {

file.transferTo(new File("C:/spring - uploads/" + file.getOriginalFilename()));

return "File uploaded successfully.";

} catch (Exception e) {

e.printStackTrace();

return "Error uploading file: " + e.getMessage();

}

} else {

return "Please select a file to upload.";

}

}

}

```

- 在这个控制器中，@PostMapping注解表示处理POST请求的方法。@RequestParam("file")注解用于绑定名为file的上传文件，如果文件不为空，则将文件传输到指定的目标位置（这里是C:/spring - uploads/）。

（二）Spring Security与文件上传

1、处理安全相关问题

- 如果在使用Spring Security的项目中进行文件上传，可能需要考虑安全相关的问题，防止恶意文件上传（如可执行脚本文件）。

- 可以通过在文件上传前对文件类型进行检查来实现一定程度的安全防护，只允许特定类型的文件（如图片文件jpg、png等）上传。

```java

private boolean isAllowedFileType(MultipartFile file) {

String contentType = file.getContentType();

return contentType!= null && (contentType.equals("image/jpeg") || contentType.equals("image/png"));

}

```

- 然后在文件上传控制器的方法中，在处理文件上传之前先调用这个方法进行文件类型检查。

```java

@PostMapping("/upload - secure")

public String uploadSecureFile(@RequestParam("file") MultipartFile file) {

if (isAllowedFileType(file)) {

// 继续文件上传处理逻辑

} else {

return "Invalid file type. Only JPEG and PNG are allowed.";

}

}

```

使用Java NIO进行文件上传

（一）基本原理

1、通道（Channel）和缓冲区（Buffer）的使用

- Java NIO（New Input/Output）提供了一种高效的文件上传方式，它基于通道和缓冲区的概念，通道是一种双向的数据传输机制，可以用于读取和写入数据，缓冲区则是用于临时存储数据的容器。

- 在文件上传场景中，可以创建一个文件通道用于读取本地文件，再创建一个网络通道（如SocketChannel）用于将数据发送到服务器。

（二）示例代码

1、客户端代码（上传文件的客户端）

```java

import java.io.File;

import java.io.FileInputStream;

import java.io.IOException;

import java.net.InetSocketAddress;

import java.nio.ByteBuffer;

import java.nio.channels.FileChannel;

import java.nio.channels.SocketChannel;

public class FileUploadClient {

public static void uploadFile(String filePath, String serverAddress, int port) throws IOException {

File file = new File(filePath);

FileInputStream fis = new FileInputStream(file);

FileChannel fileChannel = fis.getChannel();

SocketChannel socketChannel = SocketChannel.open();

socketChannel.connect(new InetSocketAddress(serverAddress, port));

ByteBuffer buffer = ByteBuffer.allocate(1024);

while (fileChannel.read(buffer) > 0) {

buffer.flip();

socketChannel.write(buffer);

buffer.clear();

}

fileChannel.close();

fis.close();

socketChannel.close();

}

public static void main(String[] args) throws IOException {

String filePath = "C:/test.txt";

String serverAddress = "127.0.0.1";

int port = 8080;

uploadFile(filePath, serverAddress, port);

}

}

```

- 在上述客户端代码中，首先打开要上传的本地文件，获取其文件通道，然后创建一个SocketChannel并连接到服务器，通过一个ByteBuffer缓冲区，从文件通道读取数据，然后将数据写入SocketChannel，直到文件读取完毕，最后关闭相关的通道和流。

2、服务器端代码（接收文件的服务器）

```java

import java.io.FileOutputStream;

import java.io.IOException;

import java.net.InetSocketAddress;

import java.nio.ByteBuffer;

import java.nio.channels.FileChannel;

import java.nio.channels.ServerSocketChannel;

import java.nio.channels.SocketChannel;

public class FileUploadServer {

public static void receiveFile(String savePath, int port) throws IOException {

ServerSocketChannel serverSocketChannel = ServerSocketChannel.open();

serverSocketChannel.bind(new InetSocketAddress(port));

SocketChannel socketChannel = serverSocketChannel.accept();

FileOutputStream fos = new FileOutputStream(savePath);

FileChannel fileChannel = fos.getChannel();

ByteBuffer buffer = ByteBuffer.allocate(1024);

while (socketChannel.read(buffer) > 0) {

buffer.flip();

fileChannel.write(buffer);

buffer.clear();

}

fileChannel.close();

fos.close();

socketChannel.close();

serverSocketChannel.close();

}

public static void main(String[] args) throws IOException {

String savePath = "C:/uploads/received.txt";

int port = 8080;

receiveFile(savePath, port);

}

}

```

- 在服务器端代码中，首先创建一个ServerSocketChannel并绑定到指定端口，当有客户端连接时，接受连接并创建SocketChannel，然后创建一个文件输出流及其对应的文件通道，通过缓冲区从SocketChannel读取数据并写入文件通道，从而将接收到的文件保存到指定位置。

Java提供了多种方式来实现文件上传到服务器，每种方式都有其特点和适用场景，基于Servlet的文件上传是一种较为传统的方式，适合在纯Servlet环境下使用，Spring框架提供了更方便的文件上传支持，尤其是在Spring Boot项目中，可以通过简单的配置和控制器编写来实现文件上传，而Java NIO则提供了一种高效的、基于通道和缓冲区的文件上传方式，适用于对性能有较高要求的场景，在实际应用中，还需要考虑文件上传的安全性、文件大小限制、存储路径管理等多方面的问题，以确保文件上传功能的稳定和安全。