1. 背景简介及目的
这是一个java读取图片流并进行格式转换,图片高质量压缩,ZIP格式转Base64的极简教程。功能需求是在对接农行支付接口时产生的,满足农行二级商户管理接口中上传商户影印件的功能。写这篇博客的目的是分享给大家我在工作中遇到的实际需求,解决问题的思路,以及一些技术探讨。对接银行的接口开发,他们就直接给文档,是不安排技术支持和联调的,先看一眼文档,目前我要解决的是二级商户证件照资料上传
通过查看报文用例,确认SubMerCertFile字段就是文件流对应的字段。字段类型要求是String,凭借经验,也能知道这个是Base64编码格式,银行的接口文档看着第一眼就觉得奇怪,要求的字段基本都是大写开头的,在现代开发框架中,实体类大写开头的话,可能会产生一些Bug,如spring通过@RequestParam、@PathVariable注入时,会导致找不到属性。
2.相关概念介绍:
Base64 是一种用于将二进制数据编码为 ASCII 字符串的编码方式。它广泛应用于需要以文本格式传输或存储二进制数据的场景,如电子邮件、数据传输、图像嵌入等。
2.1主要特点:
编码原理:
- Base64 使用 64 个字符(A-Z、a-z、0-9、+、/)来表示数据。每 3 个字节的二进制数据会被编码为 4 个 ASCII 字符。
- 为了保证输出总是可以被整齐地分割,Base64 会在数据末尾添加一个或两个等号(
=
)作为填充。
可读性:
- Base64 编码的输出是可打印的 ASCII 字符,适合在文本环境中传输,避免了二进制数据可能带来的问题。
应用场景:
- 常用于将图像、音频等文件嵌入 HTML、CSS 文件中,避免额外的 HTTP 请求。
- 在电子邮件中,Base64 常用于编码附件,使其可以安全传输。
编码和解码:
- 编码时,将每 3 个字节转为 4 个字符;解码时则反向操作,将 4 个字符还原为 3 个字节。
3.准备工作
3.1 引入依赖
<!-- 高质量压缩图设置图片尺寸,转换图片格式-->
<thumbnailator.version>0.4.20</thumbnailator.version>
<dependency>
<groupId>net.coobird</groupId>
<artifactId>thumbnailator</artifactId>
<version>${thumbnailator.version}</version>
</dependency>
4.整体思路
在我们框架中,已经存在公共的图片上传接口,主要是接收一个file流,指定一个分类(枚举值)用来将图片存到不同的存储桶(bucket),最后返回一个绝对路径URL地址,前端将这个地址作为我接口需要的path字段,最终存储到我的数据库的是一个相对路径字符串,之所以存相对路径,是因为存储服务器可能会存在迁移的情况,例如我们项目就是从阿里云迁移到移动云。以下是公共上传接口:
/**
* 上传图片
*
* @param multipartFiles
* @return
*/
@ApiOperation(value = "上传图片")
@ApiImplicitParam(name="ify",value = "图片分类:1-商品,2-身份证,3-营业执照,4-app轮播图, 5-发票,6-银行回执单,7-资讯,8-门头照,9-店内照,10-保险单,11-银行卡正面,12-银行卡反面,13-商品主图,14-商品详情图",required = true,dataType = "integer")
@PostMapping("/api/uploadImages")
public Result<List<UploadVO>> uploadImages(@RequestParam("file") MultipartFile[] multipartFiles,@RequestParam Integer ify) throws IOException