图片存储方案-MinIo

背景

文件存储是各个系统中必不可少的一部分，比如在电商系统中的商品图片存储，基本需求是大容量存储、快速访问、缩略图自动生成，现在有很多云服务如阿里的oss可以满足，在这里我们分享基于minio自建图片存储方案

minIO简介：

Minio 是个基于 Golang 编写的开源对象存储套件，虽然轻量，却拥有着不错的性能。

 

部署：

创建文件

mkdir -p /opt/data/minIO/datadocker 

启动命令

docker run -d -p 9000:9000 
  --name minio 
  -v /opt/data/minIO/data:/data 
  -e "MINIO_ACCESS_KEY=root" 
  -e "MINIO_SECRET_KEY=root1234" 
  minio/minio server /data

用户名：MINIO_ACCESS_KEY （用户名最低3位） 
密码： MINIO_SECRET_KEY （密码最低8位）

详细见 ： min.io官网

代码展示：

javashop商城为了更好的对接更多的平台，所以文件上传功能实现了插件化，降低代码耦合，也方便二次开发，

文件上传接口类：

/**
 * 存储方案参数接口
 */
public interface Uploader {

    /**
     * 配置各个存储方案的参数
     * @return 参数列表
     */
    List<ConfigItem> definitionConfigItem();

    /**
     * 上传文件
     * @param input  上传对象
     * @param scene  业务场景
     * @param config 配置信息
     * @return
     */
    FileVO upload(FileDTO input, String scene, Map config);

    /**
     * 删除文件
     * @param filePath 文件地址
     * @param config   配置信息
     */
    void deleteFile(String filePath, Map config);

    /**
     * 获取插件ID
     * @return 插件beanId
     */
    String getPluginId();

    /**
     * 生成缩略图路径
     * @param url    原图片全路径
     * @param width  需要生成图片尺寸的宽
     * @param height 需要生成图片尺寸的高
     * @return 生成的缩略图路径
     */
    String getThumbnailUrl(String url, Integer width, Integer height);

    /**
     * 存储方案是否开启
     * @return 0 不开启  1 开启
     */
    Integer getIsOpen();

    /**
     * 获取插件名称
     * @return 插件名称
     */
    String getPluginName();
}

minIO的插件类

javashop商城 实现 minIO的插件类：

@Component
public class MinIOPlugin implements Uploader {
    /**
     * 获取配置参数
     */
    @Override
    public List<ConfigItem> definitionConfigItem() {
        List<ConfigItem> list = new ArrayList();

        ConfigItem endpoint = new ConfigItem();
        endpoint.setType("text");
        endpoint.setName("endpoint");
        endpoint.setText("minIO服务地址");

        ConfigItem accessKey = new ConfigItem();
        accessKey.setType("text");
        accessKey.setName("accessKey");
        accessKey.setText("用户名");

        ConfigItem SecretKey = new ConfigItem();
        SecretKey.setType("text");
        SecretKey.setName("secretKey");
        SecretKey.setText("密钥");

        list.add(serviceUrl);
        list.add(accessKey);
        list.add(SecretKey);

        return list;
    }

    /**
     * 获取连接
     */
    public MinioClient getClient(Map config, String scene) throws InvalidPortException, InvalidEndpointException, IOException, InvalidKeyException, NoSuchAlgorithmException, InsufficientDataException, InternalException, NoResponseException, InvalidBucketNameException, XmlPullParserException, ErrorResponseException, RegionConflictException, InvalidObjectPrefixException {
        String accessKeyId = StringUtil.toString(config.get("accessKey"));
        String accessKeySecret = StringUtil.toString(config.get("secretKey"));
        String endpoint = StringUtil.toString(config.get("endpoint"));
        //进行连接
        MinioClient minioClient = new MinioClient(endpoint, accessKeyId, accessKeySecret);
        //如果桶为空
        if (!minioClient.bucketExists(scene)) {
            //创建桶
            minioClient.makeBucket(scene);
            //创建桶的文件为全部可读
            minioClient.setBucketPolicy(scene, "*", PolicyType.READ_ONLY);
        }
        return minioClient;
    }

    @Override
    public FileVO upload(FileDTO input, String scene, Map config) {
        // 获取文件后缀
        String ext = input.getExt();
        //生成随机图片名
        String picName = UUID.randomUUID().toString().toUpperCase().replace("-", "") + "." + ext;

        MinioClient minioClient = null;
        try {
            //获取连接
            minioClient = this.getClient(config, scene);
            //文件上传
            minioClient.putObject(scene, picName, input.getStream(), input.getStream().available(), "image/" + ext);

        } catch (Exception e) {
            throw new ServiceException(SystemErrorCode.E802.code(), "上传图片失败");
        }
        String serviceUrl = StringUtil.toString(config.get("serviceUrl"));
        FileVO file = new FileVO();
        file.setName(picName);
        file.setExt(ext);
        file.setUrl(serviceUrl + "/" + scene + "/" + picName);
        return file;
    }

    @Override
    public void deleteFile(String filePath, Map config) {
        MinioClient minioClient = null;
        String[] split = filePath.split("/");
        String bucketName = "";
        String objectName = "";
        for (int i = 0; i < split.length; i++) {
            if (i == 3) {
                bucketName = split[i];
            }
        }
        if (bucketName.length() > 3) {
            objectName = filePath.substring(filePath.indexOf(bucketName) + bucketName.length() + 1);
        } else {
            throw new ServiceException(SystemErrorCode.E803.code(), "删除失败，无法解析路径");
        }
        try {
            minioClient = this.getClient(config, bucketName);
            minioClient.removeObject(bucketName, objectName);
        } catch (Exception e) {
            throw new ServiceException(SystemErrorCode.E903.code(),"删除图片失败");
        }

    }

    @Override
    public String getPluginId() {
        return "minIOPlugin";
    }

    @Override
    public String getThumbnailUrl(String url, Integer width, Integer height) {
        // 缩略图全路径
        String thumbnailPah = url + "_" + width + "x" + height;
        // 返回缩略图全路径
        return thumbnailPah;
    }

    @Override
    public Integer getIsOpen() {
        return 0;
    }

    @Override
    public String getPluginName() {
        return "MinIO存储";
    }
}

文件上传入口方法：

 /**
     * 文件上传<br>
     * 接受POST请求<br>
     * 同时支持多择文件上传和截图上传
     * @param upfile 文件流
     * @return
     * @throws JSONException
     * @throws IOException
     */
    @PostMapping(value = "/")
    @ApiOperation(value = "ueditor文件/图片上传")
    public Map upload( MultipartFile upfile) throws JSONException, IOException {
        Map result = new HashMap(16);
        if (upfile != null && upfile.getOriginalFilename() != null) {
            //文件类型
            String contentType= upfile.getContentType();
            //获取文件名称后缀
            String ext = contentType.substring(contentType.lastIndexOf("/") + 1, contentType.length());

            if(!FileUtil.isAllowUpImg(ext)){
                result.put("state","不允许上传的文件格式，请上传gif,jpg,png,jpeg,mp4格式文件。");
                return  result;
            }
            FileDTO input  = new FileDTO();
            input.setName(upfile.getOriginalFilename());
            input.setStream(upfile.getInputStream());
            input.setExt(ext);
            FileVO file  = this.fileManager.upload(input, "ueditor");
            String url  = file.getUrl();
            String title = file.getName();
            String original = file.getName();
            result.put("state","SUCCESS");
            result.put("url", url);
            result.put("title", title);
            result.put("name", title);
            result.put("original", original);
            result.put("type","."+file.getExt());
            return  result;
        }else{
            result.put("state","没有读取要上传的文件");
            return  result;
        }
    }
}