Jersey框架：文件上传下载

企业应用中，文件管理是非常通用和重要的模块，功能包括文件上传、下载、文件管理（浏览、删除、权限等）等操作，本文针对Jersey框架实现文件的上传和下载。

Jersey文件特性

Jersey实现文件上传需要jersey-media-multipart库的支持，并且要在服务器启动类中注册MultiPartFeature。

特别注意：虽然jersey-media-multipart库依赖于mimepull，但在应用打包时并不会将mimepull打包到安装包中，需要显示引入。

<!--文件上传下载支持-->
<dependency><groupId>org.glassfish.jersey.media</groupId><artifactId>jersey-media-multipart</artifactId><version>${jersey2.version}</version>
</dependency>
<dependency><groupId>org.jvnet.mimepull</groupId><artifactId>mimepull</artifactId><version>1.9.5</version>
</dependency>

服务器启动类中，注册org.glassfish.jersey.media.multipart.MultiPartFeature类以开启文件特性。

//文件特性支持
sh.setInitParameter("jersey.config.server.provider.classnames","org.glassfish.jersey.media.multipart.MultiPartFeature");

文件上传

关键代码分析
(1)方法接收的参数类型是multipart/form-data，即包含文件的表单类型
@Consumes(MediaType.MULTIPART_FORM_DATA)
(2)接收客户端传输的输入流
@FormDataParam("file") InputStream inputStream
(3)接收客户端传输的输入流的元数据
@FormDataParam("file") FormDataContentDisposition disposition
完整代码

@Path("file")
public class FileRes {//文件存储路径private static final String FILE_PATH = "D:/file/upload/";//文件上传@Path("upload")@POST@Consumes(MediaType.MULTIPART_FORM_DATA)public Response upload(@FormDataParam("file") InputStream inputStream,@FormDataParam("file") FormDataContentDisposition disposition) {String fileName = UUID.randomUUID().toString();String originName;originName = disposition.getFileName();if (originName.contains("."))fileName = fileName +originName.substring(originName.lastIndexOf("."), originName.length());try {writeToFileServer(inputStream, fileName);return Response.ok(new FileMsg(fileName)).build();} catch (IOException e) {return Response.status(Response.Status.INTERNAL_SERVER_ERROR).entity(new SimpleMsg(e.getMessage())).build();}}//将输入流写出到本地文件private String writeToFileServer(InputStream inputStream, String fileName) throws IOException {OutputStream outputStream = null;File file = new File(FILE_PATH);if (!file.exists())file.mkdirs();String qualifiedUploadFilePath = FILE_PATH + fileName;try {outputStream = new FileOutputStream(new File(qualifiedUploadFilePath));int read = 0;byte[] bytes = new byte[1024];while ((read = inputStream.read(bytes)) != -1) {outputStream.write(bytes, 0, read);}outputStream.flush();} catch (IOException ioe) {ioe.printStackTrace();} finally {if (outputStream != null) outputStream.close();}return qualifiedUploadFilePath;}
}

文件下载

关键代码分析
(1)指定输出的媒体类型为OCTET_STREAM
@Produces(MediaType.APPLICATION_OCTET_STREAM)
(2)响应请求头
如果在浏览器中访问文件下载地址，如果设置的请求头为attachment; filename=，则浏览器会打开一个新窗格，并开启下载模式，如果是图片则会不友好，因为用户很多时候只是想查看图片，可以通过以下方式解决。
return Response.ok(file).header("Content-Type", "image/png").build();
完整代码

@Path("file")
public class FileRes {//文件存储路径private static final String FILE_PATH = "D:/file/upload/";@Path("download/{name}")@GET@Produces(MediaType.APPLICATION_OCTET_STREAM)public Response download(@PathParam("name") String name) {String fileName = FILE_PATH + name;File file = new File(fileName);if (!file.exists()) {return Response.status(Response.Status.NOT_FOUND).entity(new SimpleMsg("file not found")).build();}//为图片格式提供浏览模式//文件扩展名String ext = name.substring(name.lastIndexOf(".") + 1, name.length());if (StringUtils.equalsAnyIgnoreCase(ext, new String[]{"jpg", "jpeg", "png", "bmp", "gif"})) {return Response.ok(file).header("Content-Type", "image/png").build();}return Response.ok(file).header("Content-Disposition", "attachment; filename=" + fileName).build();}
}

测试

使用Postman提交文件上传请求，返回结果如图所示。

本地存储的文件如图所示。

完整代码参见：https://github.com/majxbear/jetty-rest