Jersey是一个开源的RESTful框架，实现了JAX - RS规范，支持文件的上传和下载。使用Jersey框架编写以multipart/form-data方式接收文件接口的教程如下： ### 1. 开启文件特性支持 在服务器启动类中，注册`org.glassfish.jersey.media.multipart.MultiPartFeature`类以开启文件特性。示例代码如下： ```java //文件特性支持 sh.setInitParameter("jersey.config.server.provider.classnames", "org.glassfish.jersey.media.multipart.MultiPartFeature"); ``` 此步骤可确保Jersey框架能够处理multipart/form-data类型的请求 [^4]。 ### 2. 使用`@FormDataParam`注解 通常在上传文件的时候，需要使用`@FormDataParam`注解。客户端以form（MIME为multipart/form-data）的方式提交表单，服务端使用`@FormDataParam`来解析form表单中的参数。例如，若前台的文件字段name属性值为`pic`，可以使用`org.springframework.web.multipart.MultipartFile`接收multipart/form-data类型的数据，示例如下： ```java import org.springframework.web.multipart.MultipartFile; // 接口方法示例 public Response uploadFile(@FormDataParam("pic") MultipartFile pic) { // 处理文件上传逻辑 return Response.ok().build(); } ``` 这里的`@FormDataParam("pic")`用于从请求中获取名为`pic`的文件数据 [^2][^3]。 ### 3. 多文件上传示例 如果需要处理多文件上传，可以使用`FormDataMultiPart`类。示例代码如下： ```java import javax.ws.rs.*; import javax.ws.rs.core.MediaType; import javax.ws.rs.core.Response; import org.glassfish.jersey.media.multipart.BodyPart; import org.glassfish.jersey.media.multipart.FormDataMultiPart; import javax.validation.constraints.NotNull; import java.util.List; @Path("/") public class FileUploadResource { @PUT @Path("/{id}") public Response update(@NotNull @PathParam("id") String id, @FormDataParam("requestBody") String requestBody, FormDataMultiPart formDataMultiPart) { List<BodyPart> bodyParts = formDataMultiPart.getBodyParts();//获取文件 bodyParts.forEach(r -> { String mediaType = r.getMediaType().getType() + "/" + r.getMediaType().getSubtype(); if (!mediaType.equals(MediaType.TEXT_PLAIN)) { String name = r.getContentDisposition().getParameters().get("name"); BodyPartEntity bodyPartEntity = (BodyPartEntity) r.getEntity(); String fileName = r.getContentDisposition().getFileName(); // 这里假设s3StorageService是一个保存文件到S3的服务 // String s3path = s3StorageService.saveFileToS3(bodyPartEntity.getInputStream(), fileName, TimeUtil.genTimemark()); // uploadFileMap.put(name, s3path); } }); return Response.ok().build(); } } ``` 在这个示例中，通过`FormDataMultiPart`获取请求中的所有文件部分，然后遍历处理每个文件 [^5]。