SpringBoot整合阿里云OSS对象存储图片

前因

温馨提醒:阅读本文需要5分钟

半藏商城刚开始的商品图片上传都是存储到服务器的一个路径中的，但是在开发过程中是windos系统，服务器是linux系统，在打包之前每次都需要更改路径并且数据库中还需要存储相对路径，读取还需要拼接比较麻烦，这次我重构了一些代码采用阿里云平台的OSS对象存储图片信息，数据库只需要存储全部路径就可以直接显示出图片来了，接下来分享一下我的整个OSS对象存储的代码实现流程。

开通OSS对象存储服务

首先需要在阿里云控制台开通阿里云OSS对象存储服务，可以购买半年套餐（不贵），然后需要创建BUCKET桶，我这里命名为hanzo-mall，后期上传图片需要用到，再继续创建文件夹images，以及给ACCESS_KEY的ARM访问权限进行授权OSS对象存储服务。最重要是接下来的这个步骤，需要将OSS对象存储的访问路径进行映射，在2019年之前不需要映射也可以直接访问的，现在直接访问会提示下载而不是显示出图片。这个需要有自己的备案域名才可以操作。最后还要提醒一下在oss中还要将桶设为了公共读，不然可能会上传或者读取失败。（这一小节，百度有详细的教程，不再详细讲解。）

Maven引包

首先进行在pom.xml中进行引包，还在为引哪个版本的包而困扰的同学推荐这个Maven在线查找依赖的网站，想用什么输入搜索，复制过来就可以了。

<!-- 阿里云oss对象存储-->
<dependency>
   <groupId>com.aliyun.oss</groupId>
   <artifactId>aliyun-sdk-oss</artifactId>
   <version>3.8.1</version>
</dependency>

配置OSS对象存储连接信息

public final static String END_POINT ="http://oss-cn-beijing.aliyuncs.com/"; //阿里云oss信息
public final static String ACCESS_KEY_ID  ="你的ACCESS_KEY_ID  ";//访问阿里云API的验证
public final static String ACCESS_KEY_SECRET ="你的ACCESS_KEY_SECRET ";//访问阿里云API的验证
public final static String BUCKET_NAME = "hanzo-mall"; //仓库信息
public final static String IMAGES_ADDRESS = "http://hanzoimage.babehome.com";//访问路径
public final static String FILEDIR = "images/";//object路径

存储图片到OSS中

接下来就需要开始调用OSS来进行存储和读取信息。

/**
 * @author 皓宇QAQ
 * @qq交流群 951485783
 * @email 2469653218@qq.com
 * @link https://github.com/Tianhaoy/hanzomall
 */
@Slf4j
@Controller
@RequestMapping("/admin")
public class UploadController {

    @PostMapping({"/upload/file"})
    @ResponseBody
    public Result upload(HttpServletRequest httpServletRequest, @RequestParam("file") MultipartFile file) throws URISyntaxException {
        try {
            String fileName = file.getOriginalFilename();
            String suffixName = fileName.substring(fileName.lastIndexOf("."));
            //生成文件名称通用方法
            SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMdd_HHmmss");
            Random r = new Random();
            StringBuilder tempName = new StringBuilder();
            tempName.append(sdf.format(new Date())).append(r.nextInt(100)).append(suffixName);
            String newFileName = tempName.toString();
            String addressData = this.ossClient(newFileName,file);
            Result resultSuccess = ResultGenerator.genSuccessResult();
            resultSuccess.setData(addressData);
            log.debug("图片访问Url："+resultSuccess.getData().toString());
            //双保险 将图片保存在oss的同时也在服务器中保存照片 但是数据库中的链接是oss的
            File fileDirectory = new File(Constants.FILE_UPLOAD_DIC);
            //创建文件
            File destFile = new File(Constants.FILE_UPLOAD_DIC + newFileName);
            if (!fileDirectory.exists()) {
                if (!fileDirectory.mkdir()) {
                    throw new IOException("文件夹创建失败,路径为：" + fileDirectory);
                }
            }
            file.transferTo(destFile);
            log.debug("在服务器路径 "+Constants.FILE_UPLOAD_DIC+"同步保存图片--");
            //服务器中保存照片结束
            return resultSuccess;
        } catch (Exception e) {
            e.printStackTrace();
            return ResultGenerator.genFailResult("文件上传失败");
        }
    }

    private String ossClient(String newFileName, MultipartFile file) {
        String addressData = "";
        // 创建OSSClient实例
        OSS client = new OSSClientBuilder().build(Constants.END_POINT,Constants.ACCESS_KEY_ID ,Constants.ACCESS_KEY_SECRET );
        try {
            PutObjectResult result =client.putObject(Constants.BUCKET_NAME,Constants.FILEDIR+newFileName, new ByteArrayInputStream(file.getBytes()));
            client.shutdown();
            if (null != result) {
                // 获取上传后的图片链接
                // 后端将地址拼接一下，oss那里设为了公共读，阿里云oss屁事太多了
                addressData= Constants.IMAGES_ADDRESS + "/" + Constants.FILEDIR+ newFileName;
            }
        } catch (IOException e) {
            e.printStackTrace();
            addressData = "";
        }
        return addressData;
    }
}

小结

到此为止，整个OSS对象存储图片信息的流程就介绍完毕了，知识只有分享出来才有价值。如果有问题的话，可以在关于我的页面，通过我的邮箱联系我进行探讨。半藏商城的所有代码都开源在GitHub上。