一、快速使用

1、注册账号并实名验证

2、搜索找到对象存储OSS，开通OSS服务

3、查看官方文档

---

二、具体使用

1、 注册阿里云账号和实名认证

（1）网址：https://www.aliyun.com/

（2）可以使用支付宝注册，现在还提供了钉钉注册方式

（3）注册成功后需要实名认证才能开通“对象存储OSS”服务

2、开通“对象存储OSS”服务

直接搜索找到【对象存储OSS】，开通OSS服务

3、控制台的使用

（1）开通服务后，进入控制台

（2）手动创建bucket

 1）通过【创建Bucket】进行新建

bucket名称：自定义；

地域：系统会自动选择最优的，默认即可；

同城冗余存储：关闭，选择启动是要收费的；

读写权限：根据需要来选择；这里会为了后续讲解，会选择“公共读”

如果只是学习，基本上都默认即可

2）点击确定，这样我们就手动创建好了一个bucket

3）这时，我们可以试着上传文件了，阿里云是提供了两种访问方式，一种是后台管理系统，一种是API

 当然，在日常的开发中，是使用api的，因为你不可能叫用户打开阿里云去上传文件

 3）如果想删除bucket

（3）权限的设置

1）因为我们前面创建选择的读写权限是“公共读”，所以后续我们是需要设置AccessKey的

 2）进入AccessKey 管理

3）在使用AccessKey时，我们通常的做法是创建子用户key，不同的服务开通不同的子key，这样会更安全

4）开通子用户AccessKey

①做编程的要勾上Open API...

②验证

 ③创建子用户成功

注意：这时我们最后把key账号和密钥复制下来，找个地方存好备用，因为后面会直接给你隐藏掉了

 或者直接下载下来也可以

④最后为用户添加权限

如果没有添加权限，后面开发时，就会经常报错“没有权限”

 如果是平时的简单使用，到这里就可以了，如果需要做开发的，下面才是重要的。

4、查阅阿里云API（最核心）

做开发的怎么能离开开发文档呢

（1）进入oss学习路径 

（2）根据自己的开发语言选择SDK

因为我是写Java的，所以用Java SDK

（3）Java SDK概要

从Java SDK进来后，可以看到里面有着方方面面的介绍

5、一个简单的示例（Java创建bucket）

以下都可以通过查阅官方文档实现

（1）检查自己的jdk版本，要求是1.7及以上版本

（2）创建一个Maven项目

（2）安装sdk

这里是使用的是Maven项目，所以直接安装依赖即可

    <dependencies>
        <!--aliyunOSS-->
        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
            <version>3.10.2</version>
        </dependency>

        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>

 然后等待下载好依赖，即可做一些简单的操作

（3）Java创建bucket

①查阅官方文档-创建存储空间

 ②复制示例代码，然后根据之前保存的我们自己的AccessKey来修改即可，具体如下：

主要修改这几个即可
String endpoint
String accessKeyId 
String accessKeySecret 
String bucketName 

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.CreateBucketRequest;

public class Demo {

    public static void main(String[] args) throws Exception {
        // Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
        String accessKeyId = "yourAccessKeyId";
        String accessKeySecret = "yourAccessKeySecret";
        // 填写Bucket名称，例如examplebucket。
        String bucketName = "examplebucket";

        // 创建OSSClient实例。
        OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);

        try {
            // 创建CreateBucketRequest对象。
            CreateBucketRequest createBucketRequest = new CreateBucketRequest(bucketName);

            // 如果创建存储空间的同时需要指定存储类型和数据容灾类型, 请参考如下代码。
            // 此处以设置存储空间的存储类型为标准存储为例介绍。
            //createBucketRequest.setStorageClass(StorageClass.Standard);
            // 数据容灾类型默认为本地冗余存储，即DataRedundancyType.LRS。如果需要设置数据容灾类型为同城冗余存储，请设置为DataRedundancyType.ZRS。
            //createBucketRequest.setDataRedundancyType(DataRedundancyType.ZRS);
            // 设置存储空间的权限为公共读，默认为私有。
            //createBucketRequest.setCannedACL(CannedAccessControlList.PublicRead);

            // 创建存储空间。
            ossClient.createBucket(createBucketRequest);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

②判断bucket是否存在

如果有以下报错就是bucket已经存在了

<Error>
  <Code>BucketAlreadyExists</Code>
  <Message>The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again.</Message>
  <RequestId>623436******23630228039</RequestId>
  <HostId>xbao-1.oss-cn-beijing.aliyuncs.com</HostId>
  <BucketName>xbao-1</BucketName>
</Error>

③设置读写权限

默认创建出来的是“私有”项目，而我们想要的是“公共读”，所以就需要设置读写权限

（4）在实际开发中的文件上传（springcloud）

1）在中application.yml的配置

aliyun:
  oss:
    endpoint: 你的endponit
    keyid: 你的阿里云keyid
    keysecret: 你的阿里云keysecret
    bucketname: 你的阿里云bucket

2）定义工具类从配置文件中读取常量

@Data：lombok的注解
@Component： 加载到spring中
@ConfigurationProperties(prefix="aliyun.oss")：读取前缀是aliyun.oss的配置，根据名字endpoint、keyid等匹配赋值常量

@Data
@Component
@ConfigurationProperties(prefix="aliyun.oss")
public class OssProperties {
    private String endpoint;
    private String keyid;
    private String keysecret;
    private String bucketname;
}

3）文件上传的业务接口

public interface FileService {
    /**
     * 阿里云oss文件上传
     * @param inputStream 输入流
     * @param module 文件夹名称
     * @param originalFilename 原始文件名称
     * @return 文件在oss服务器上的url地址
     */
    String upload(InputStream inputStream, String module, String originalFilename);
}

@Service
public class FileServiceImpl implements FileService {


    @Autowired
    private OssProperties ossProperties;

    @Override
    public String upload(InputStream inputStream, String module, String originalFilename) {

        // 读取配置
        String endpoint = ossProperties.getEndpoint();
        String keyid = ossProperties.getKeyid();
        String keysecret = ossProperties.getKeysecret();
        String bucketname = ossProperties.getBucketname();

        //判断oss实例是否存在：如果不存在则创建，如果存在则获取
        OSS ossClient = new OSSClientBuilder().build(endpoint, keyid, keysecret);
        if (!ossClient.doesBucketExist(bucketname)) {
            //创建bucket
            ossClient.createBucket(bucketname);
            //设置oss实例的访问权限：公共读
            ossClient.setBucketAcl(bucketname, CannedAccessControlList.PublicRead);
        }

        //构建日期路径
        String folder = new DateTime().toString("yyyy/MM/dd");

        //文件名：uuid.扩展名
        String fileName = UUID.randomUUID().toString();
        String fileExtension = originalFilename.substring(originalFilename.lastIndexOf("."));
        String key = module + "/" + folder + "/" + fileName + fileExtension;

        //文件上传至阿里云
        ossClient.putObject(ossProperties.getBucketname(), key, inputStream);

        // 关闭OSSClient。
        ossClient.shutdown();

        //返回url地址
        return "https://" + bucketname + "." + endpoint + "/" + key;
    }
}

具体需要什么，查阅官方文档很快就能找到demo。