jax-rs规范的REST接口文件上传

使用jax-rs规范,需要引入spring-boot-starter-jersey包,用于支撑@Path,@GET等jax-rs注解,使用jax-rs规范上传文件,需要引入jersey-media-multipart包,用于支撑@FormDataParam,FormDataContentDisposition

<dependency>
    <groupId>org.glassfish.jersey.media</groupId>
    <artifactId>jersey-media-multipart</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jersey</artifactId>
</dependency>

然后需要将接收外部请求的Controller类注册到ResourceConfig, 将处理上传文件的MultipartFeature类注册到ResourceConfig

@Configuration
public class MyJaxrsConfig extends ResourceConfig {
    public MyJaxrsConfig() {
        super.register(UserService.class);
        register(MultiPartFeature.class);
    }
}

上传文件时需要注意的地方:

1.指定接口的消费数据类型为multipart/form-data

2.文件的接收分为2部分: 一部分是描述数据,一部分是输入流数据,

描述数据用FormDataContentDisposition对象接收,流数据用InputStream对象接收.通过类似于@PathParam绑定注解的@FormDataParam分别将文件数据的两部分数据绑定到对应的变量上.

@Path("/upload")
@POST
@Consumes(MediaType.MULTIPART_FORM_DATA_VALUE)
void upload(@FormDataParam("file") InputStream inputStream, @FormDataParam("file") FormDataContentDisposition file);