阿里云对象存储OSS使用

一、申请对象存储OSS

为了解决海量数据存储与弹性扩容，项目中我们采用云存储的解决方案- 阿里云OSS。
1、开通“对象存储OSS”服务
（1）申请阿里云账号
（2）实名认证
（3）开通“对象存储OSS”服务
（4）进入管理控制台
2、创建Bucket
选择：标准存储或低频访问存储(根据实际需要)、公共读、其余功能一律不开通(开通要收费)


3、生成自己专属的访问权限的Access key,点击进入创建即可；后面当需要上传文件到OSS需要bucket名称、keyId和keySecret

二、Java后端集成OSS(SpringBoot工程)

1、引入依赖
在工程依赖中添加下面两个核心依赖

	<dependencies>
        <!-- 阿里云oss依赖 -->
        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
            <version>3.1.0</version>
        </dependency>

        <!-- 日期工具栏依赖 -->
        <dependency>
            <groupId>joda-time</groupId>
            <artifactId>joda-time</artifactId>
            <version>2.10.1</version>
        </dependency>
    </dependencies>

2、配置application.properties

#服务端口
server.port=8002
#服务名
spring.application.name=service-oss

#环境设置：dev、test、prod
spring.profiles.active=dev

#阿里云 OSS
#不同的服务器，地址不同
aliyun.oss.file.endpoint=你的OSS地域(例：oss-cn-shanghai.aliyuncs.com）
aliyun.oss.file.keyid=你的keyId
aliyun.oss.file.keysecret=你的KeySecret
#bucket可以在控制台创建，也可以使用java代码创建
aliyun.oss.file.bucketname=你的bucket名

3、SpringBoot启动类
本次是用不到数据库配置所以将DataSourceAutoConfiguration移除，否则可能会报错

@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
@ComponentScan(basePackages = {"com.atguigu"})
public class OssApplication {

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

4、从配置文件读取常量

/**
 * 常量类，读取配置文件application.properties中的配置
 *
 * @author chengw
 * @since 2020-12-7
 */
@Component
public class ConstantPropertiesUtil implements InitializingBean {

    //当项目一启动，属性读取配置文件获得值后会执行重写的InitializingBean接口的方法
    //读取配置文件中的内容
    @Value("${aliyun.oss.file.endpoint}")
    private String endpoint;

    @Value("${aliyun.oss.file.keyid}")
    private String keyId;

    @Value("${aliyun.oss.file.keysecret}")
    private String keySecret;

    @Value("${aliyun.oss.file.bucketname}")
    private String bucketName;

    //类ConstantPropertiesUtil的属性均为私有，所以再类中定义一些常量供  类之外使用
    public static String END_POINT;
    public static String ACCESS_KEY_ID;
    public static String ACCESS_KEY_SECRET;
    public static String BUCKET_NAME;

    @Override
    public void afterPropertiesSet() throws Exception {
        END_POINT = endpoint;
        ACCESS_KEY_ID = keyId;
        ACCESS_KEY_SECRET =keySecret;
        BUCKET_NAME = bucketName;
    }
}

5、实现文件上传的Service实现类

@Service
public class OssServiceImpl implements OssService {

    @Override
    public String uploadFileAvatar(MultipartFile file) {
        String endPoint = ConstantPropertiesUtil.END_POINT;
        // 云账号AccessKey有所有API访问权限
        String accessKeyId = ConstantPropertiesUtil.ACCESS_KEY_ID;
        String accessKeySecret = ConstantPropertiesUtil.ACCESS_KEY_SECRET;
        String bucketName = ConstantPropertiesUtil.BUCKET_NAME;

        String uploadUrl = null;

        try {
            // 创建OSSClient实例
            OSS ossClient = new OSSClientBuilder().build(endPoint, accessKeyId, accessKeySecret);
            if (!ossClient.doesBucketExist(bucketName)) {   判断oss实例是否存在：如果不存在则创建
                //创建bucket
                ossClient.createBucket(bucketName);
                //设置oss实例的访问权限：公共读
                ossClient.setBucketAcl(bucketName, CannedAccessControlList.PublicRead);
            }

            // 获取上传文件输入流
            InputStream inputStream = file.getInputStream();

            //构建日期层级文件夹:2020/12/07
            String filePath = new DateTime().toString("yyyy/MM/dd");

            //文件名:uuid.扩展名
            String original = file.getOriginalFilename();
            String fileName = UUID.randomUUID().toString();
            String fileType = original.substring(original.lastIndexOf("."));
            String newName = fileName + fileType;
            //上传文件在OSS中存储位置:2020/12/07/uuid随机数.扩展名
            String fileUrl = filePath + "/" + newName;

            //调用OSS方法实现上传
            ossClient.putObject(bucketName, fileUrl, inputStream);

            // 关闭OSSClient
            ossClient.shutdown();

            //获取url地址:https://chengw-guli.oss-cn-shanghai.aliyuncs.com/wangzai.jpg
            uploadUrl = "https://" + bucketName + "." + endPoint + "/" + fileUrl;
        } catch (IOException e) {
            e.printStackTrace();
        }
        return uploadUrl;
    }
}

5、实现文件上传的Controller实现类

@RestController
@RequestMapping("/eduoss/fileupload")
@CrossOrigin
public class OssController {

    @Autowired
    private OssService ossService;

    //上传头像
    @PostMapping
    public Result uploadOssFile(MultipartFile file){    //获取上传文件: MultipartFile
        //返回上传到oss上的存储路径
        String url = ossService.uploadFileAvatar(file);
        return Result.ok().data("url",url);
    }
}