java优雅的图片展示和下载

在java web项目中，图片展示和下载的方式有很多，下面将化繁为简，使文件输出更优雅

下面的方法包括图片直接显示、图片或文件下载

开发环境：jdk1.7+,springboot 2+

先说明一下@ResponseBody注解，有些人可能对它有些误会，觉得它就是转json用的，实际上它是通过标记controller方法，使其返回的对象通过适当的转换器转换成指定格式，然后写入HTTP response body中(等同response.getOutputStream().write(xxx);)

第一种：最原始的方式，将数据流直接写入Response

代码量相对来说有点多，里面还用注释写了一些下载流的写法

    @RequestMapping(value = "/getImage1")
    public void getImage1(HttpServletResponse response) {
        InputStream is= null;
        try {
            File file = new File("C:/Users/Ken/Desktop/头像.jpg");
            is = new FileInputStream(file);
            byte[] bytes = new byte[is.available()];
            //设置类型
            //下载流，三种写法
            //response.setHeader("Content-Type","application/octet-stream");
            //response.setContentType("application/octet-stream");
            //response.setContentType(MediaType.APPLICATION_OCTET_STREAM_VALUE);
            //设置文件名，下载的时候会生成该名称，对图片字节流影响不大
            //response.setHeader("Content-Disposition","attachment;filename=图片.jpg");
            //图片字节流  image/jpeg
            response.setContentType(MediaType.IMAGE_JPEG_VALUE);

            //将文件输入流读取到字节数组
            is.read(bytes);

            //写入响应输出流
            response.getOutputStream().write(bytes);

            //不需要手动关闭，容器会在request处理结束后帮你回收相关资源。
            //response.getOutputStream().flush();
            //response.getOutputStream().close();
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            if (is != null) {
                try {
                    is.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
    }

简化一下上面的方式：

主要是利用了JDK1.7提供的ImageIO简化了文件流操作，简单了很多，但是跟spring没啥关系

    @RequestMapping(value = "/getImage2")
    public void getImage2(HttpServletResponse response) {
        try {
            File file = new File("C:/Users/Ken/Desktop/头像.jpg");
            ImageIO.write(ImageIO.read(file), "jpg", response.getOutputStream());
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

第二种：利用spring自带的转化器进行处理

返回类型为byte数组，使用@ResponseBody注解标记，spring会自动使用ByteArrayHttpMessageConverter作为消息转换器，返回数据到前台。

    @RequestMapping(value = "/getImage3", produces = MediaType.IMAGE_JPEG_VALUE)
    @ResponseBody
    public byte[] getImage3() {
        InputStream is = null;
        try {
            File file = new File("C:/Users/Ken/Desktop/头像.jpg");
            is = new FileInputStream(file);
            byte[] bytes = new byte[is.available()];
            // 将文件输入流读取到字节数组
            is.read(bytes);
            return bytes;
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            if (is != null) {
                try {
                    is.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
        return null;
    }

不过直接返回byte数组可能不太好看,可以改为返回BufferedImage。解析BufferedImage所需BufferedImageHttpMessageConverter转换器并没有在默认转换器列表中，所以需要手动创建bean，然后这个转换器会通过springboot的HttpMessageConvertersAutoConfiguration 自动加入到转换器列表中

public class SpringbootApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringbootApplication.class, args);
    }

    @Bean
    public BufferedImageHttpMessageConverter bufferedImageHttpMessageConverter() {
        return new BufferedImageHttpMessageConverter();
    }
}

    @RequestMapping(value = "/getImage4", produces = MediaType.IMAGE_JPEG_VALUE)
    @ResponseBody
    public BufferedImage getImage4() {
        try {
            File file = new File("C:/Users/Ken/Desktop/头像.jpg");
            return ImageIO.read(file);
        } catch (IOException e) {
            e.printStackTrace();
        }
        return null;
    }

注：使用response方式的可以，通过调整ContentType的类型，转换下载流和字节输出流（直接显示在前端），使用spring方式的，通过修改 @RequestMapping 注解的produces属性，在实现下载流和字节输出流切换

application/octet-stream 是下载流，spring中可以使用MediaType.APPLICATION_OCTET_STREAM_VALUE

image/jpeg是图片字节流 ，spring中还可以使用MediaType.IMAGE_JPEG_VALUE，还有image/png，image/gif等