OSS下载中文名编码错误
最近工作中有个需求，是将客户支付的银行回执单上按照客户姓名上传到oss，然后将oss地址反显到pc后台，供客户自己查看下载。
开始的时候感觉很简单，设计思路是根据客户支付单单号，查询数据库中是否存在该支付单的回执单，若存在直接返回，若不返回则通过拉卡拉API申请回执单，然后将结果保存到数据库（因不是频繁操作需求所以没有做缓存处理）。
private static LklSOAClient soaClient;
/**
* 初始化请求
*/
private static void iniLklSOAClient() {
try {
soaClient = new LklSOAClient();
//应用号，钱账通提供的应用ID
soaClient.setAppId(LaKaLaConstant.appId);
//版本号，当前版本为 3.0
soaClient.setVersion(LaKaLaConstant.version);
//商户DSA私钥，钱账通提供的DSA私钥
log.info("privateKeyPwd={}", LaKaLaConstant.privateKeyPwd);
soaClient.setPrivateKey(LklDSAUtil.loadPrivateKey(LaKaLaConstant.private KeyUrl, LaKaLaConstant.privateKeyPwd));
//钱账通DSA公钥，钱账通提供的DSA公钥
soaClient.setPublicKey(LklDSAUtil.loadPublicKey(LaKaLaConstant.publicKey Url));
//钱账通接口地址
soaClient.setServerUrl(LaKaLaConstant.soaServerUrl);
} catch (Exception e) {
log.error(e.toString(), e);
}
}
/**
* 根据订单号查询电子回单文件列表
* @param orderNo
* @return
*/
public static JSONObject receiptQuery(String orderNo){
JSONObject jsonParam = new JSONObject();
jsonParam.put("order_no", orderNo);//订单单号必填
JSONObject response = null;
String service = "order.receipt.query";
try {
log.info("拉卡拉回单查询接口请求参数：{}", JSONUtil.format(jsonParam));
response = soaClient.request(service, jsonParam);
log.info("拉卡拉回单查询接口返回：{}", JSONUtil.format(response));
} catch (Exception e) {
log.error(e.toString(), e);
return null;
} finally {
//此处保存请求日志信息
}
//此处返回请求结果
return Objects.requireNonNull(response).getJSONObject("response");
}
以上是关于获取电子回单的请求，截止到这里还没有问题
下面我们进行oss文件上传
/**
* 上传到oss
* @param path
* @param fileName
* @return
*/
public String fileUploadByFileNo(String path,String fileName){
log.info("文件在服务器地址:{}",path);
File file = new File(path);
if (cn.hutool.core.io.FileUtil.isEmpty(file)) {
log.error("文件不存在,filePath = {}", path);
throw new RuntimeException();
}
log.info("文件长度:{}",file.length());
// 上传到oss
FileInputStream fileInputStream = null;
String ossPath ;
try {
fileInputStream = new FileInputStream(file);
//上传oss工具类方法
ossPath = OSSUtil.uploadFile2OSS(fileInputStream, fileName);
if (StringUtils.isEmpty(ossPath)) {
log.error("oss文件上传失败,fileName={}",fileName);
throw new RuntimeException();
}
} catch (Exception e) {
log.error("oss文件流异常:",e);
throw new RuntimeException();
} finally {
IoUtil.close(fileInputStream);
}
return ossPath;
}
/**
* 上传到OSS服务器 如果同名文件会覆盖服务器上的
*
* @param inStream 文件流
* @param fileName 文件名称 包括后缀名
* @return 出错返回"" ,唯一MD5数字签名
*/
public static String uploadFile2OSS(InputStream inStream, String fileName){
OSSClient ossClient = OSSUtil.getOSSClient();
String ret = "";
try {
//创建上传Object的Metadata
ObjectMetadata objectMetadata = new ObjectMetadata();
objectMetadata.setContentLength(inStream.available());
objectMetadata.setCacheControl("no-cache");
objectMetadata.setHeader("Pragma","no-cache");
//通过文件名判断并获取文件的contentType
objectMetadata.setContentType(getContentType(fileNam e.substring (fileName.lastIndexOf("."))));
objectMetadata.setContentDisposition("inline;filename=" + fileName);
//上传文件
PutObjectResult putResult = ossClient.putObject(bucketName, filedir + fileName, inStream, objectMetadata);
//文件在oss地址
ret = getUrl(fileName),StandardCharsets.UTF_8.toString();
} catch (IOException e) {
logger.error(e.getMessage(), e);
} finally {
try {
if (inStream != null) {
inStream.close();
}
} catch (IOException e) {
e.printStackTrace();
}
}
return ret;
}
/**
* 获取文件URL
*
* @Title getUrl
* @param @param
* key
* @param @return
* @return URL
*/
public static String getUrl(String key) throws UnsupportedEncodingException {
if (key.indexOf("http") == -1) {
OSSClient server = new OSSClient(endpoint, accessKeyId, accessKeySecret);// 连接oss云存储服务器
// 设置URL过期时间为10年 3600l* 1000*24*365*10
Date expirations = new Date(new Date().getTime() + 1000 * 60 * 5);// url超时时间
// 生成URL
URL url = server.generatePresignedUrl(bucketName,filedir + key, expirations);
String strUrl = String.valueOf(url);
// 关闭client
server.shutdown();
return splitUrl(strUrl);
} else {
return splitUrl(key);
}
}
/**
* 切割url
*
* @param url
* @return
*/
public static String splitUrl(String url) {
if (url.indexOf("?Expires") != -1) {
return url.split("Expires")[0].substring(0,url.split("Expires")[0].length() -1 );
}
return url;
}
根据fileName获取URL时就会发现获取到地址不是这种
https://img-video.oss-cn-beijing.aliyuncs.com/测试中.pdf
而是一下这种
https://img-video.oss-cn-beijing.aliyuncs.com/%E5%BC%A0%E5%AE%81.pdf
开始的时候以为是自己没有指定上传文件编码导致的，但是在oss后台查看发现已经是中文名称路径了，所以就在上传时指定了编码格式为UTF-8
objectMetadata.setContentEncoding(StandardCharsets.UTF_8.toString());
后来发现并没有用，就去翻了一下oss源码，发现他们在上传时就已经指定了编码为UTF-8
源码路径com.aliyun.oss.internal.OSSOperation#createDefaultContext(com.aliyun.oss.HttpMethod, java.lang.String, java.lang.String)
那就只能是下载url时有问题了，继续查看源码发现文件下载时，又用UTF-8进行了编码
源码地址：
com.aliyun.oss.OSSClient#generatePresignedUrl(com.aliyun.oss.model.GeneratePresignedUrlRequest)
方法中在做http请求时
HttpUtil.paramToQueryString(params, "utf-8");
继续查看HttpUtil.paramToQueryString会发现他对url做了处理，如下
public static String urlEncode(String value, String encoding) {
if (value == null) {
return "";
} else {
try {
String encoded = URLEncoder.encode(value, encoding);
return encoded.replace("+", "%20").replace("*", "%2A").replace("~", "%7E").replace("/", "%2F");
} catch (UnsupportedEncodingException var3) {
throw new IllegalArgumentException(OSSUtils.OSS_RESOURCE_MANAGER.getString("FailedToEncodeUri"), var3);
}
}
}
截止这里就会明白了，因为在获取文件url时进行了URLEncoder.encode(value, encoding)所以获取的结果地址不是中文名称。
所以我们只需要在获取文件url地址后进行再进行编译即可，如下
ret = URLDecoder.decode(getUrl(fileName),StandardCharsets.UTF_8.toString());
会发现结果ret结果变成了我们想要的中文名称，如下
https://img-video.oss-cn-beijing.aliyuncs.com/测试中.pdf