10分钟学会阿里OSS对象存储-编程知识

一. 前言

最近有很多小伙伴问，如果我们要进行大规模的文件存储该怎么做?

其实实现文件存储的技术有很多，如果我们在网上搜索一下，你会发现实现的技术简直是五花八门，比如有一种技术叫FastDFS就可以实现文件存储，但该方案需要自己搭建服务器，非常的麻烦。

实际上现在很多公司都在使用腾讯云或者阿里云技术，比如阿里云就提供了OSS对象存储技术，该技术安全可靠且用起来简单的要死，只需10分钟就可以上手搞定存储。什么？你不信？！那就跟着健哥一步步来，如果健哥带你10分钟搞定文件存储，你就给我点个赞呗！

二. 浅析OSS对象存储作用

在学习OSS具体实现之前，我们先来简单了解一下OSS是怎么个东东吧。

阿里云对象存储OSS，简单地说就是我们花钱在阿里购买一块存储空间，然后我们就可以将图片、音频、视频等各种文件资源存储在对象存储OSS服务器上。接着对象存储OSS服务器就可以供有权限的人员上传、下载、删除这些文件。

所以有了OSS，我们就省去了购买硬件存储服务器、搭建存储服务器、运营管理存储服务器等一系列的繁琐操作了。

有了这些基本的了解之后，我们就可以开始使用OSS了。当然，首先我们得购买OSS服务！

三. 对象存储OSS注册和配置

阿里云对象存储OSS官网地址 :

对象存储 OSS_云存储服务_企业数据管理_存储-阿里云

3.1 注册和登录

进入阿里云官网后，首先就是注册和登录，我们可以使用自己的支付宝账号登录，可以在阿里云手机客户端扫码登录，或者用账号密码登录，总之阿里云提供了多种登录形式。基本上阿里旗下的产品，用自己的支付宝账号都可以通用。

3.2 开通对象存储OSS服务

首先我们找到阿里云的对象存储OSS服务，点击进入。

点击开通按钮，开通对象存储OSS服务。

3.3 管理控制台

接着进入到控制台界面。

这里我们要先创建一个Bucket桶，点击Bucket列表菜单，点击创建Bucket按钮，然后按照下面的内容填写即可。大家要注意，Bucket桶的名称要唯一，不能重复。

3.4 使用控制台上传图片

创建完Bucket桶后，我们就可以使用控制台上传文件进行测试了，上传操作如下：

成功上传一张图片的结果如下：

四. 代码实现

当然，我们在开发的时候，肯定不会这样手动上传文件，主要是利用代码进行实现。

4.1 搭建项目环境

我们先创建一个项目，名称就叫做aliyunossDemo吧。这里我们当然是利用Maven创建项目，大家记得不要选择使用Maven自带的骨架哦。

接下来在pom.xml中导入依赖包。

<!-- 继承Spring boot工程 -->
<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.1.5.RELEASE</version>
</parent><properties><!-- 项目源码及编译输出的编码 --><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding><!-- 项目编译JDK版本 --><maven.compiler.source>1.8</maven.compiler.source><maven.compiler.target>1.8</maven.compiler.target><!-- 依赖包版本管理 --><spring.boot.version>2.1.5.RELEASE</spring.boot.version><aliyun-oss-version>3.10.2</aliyun-oss-version><httpcore-verison>4.4.3</httpcore-verison><httpclient-version>4.5.1</httpclient-version>
</properties><dependencies><!-- Spring boot starter --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><version>${spring.boot.version}</version></dependency><dependency><groupId>com.aliyun.oss</groupId><artifactId>aliyun-sdk-oss</artifactId><version>${aliyun-oss-version}</version></dependency><dependency><groupId>org.apache.httpcomponents</groupId><artifactId>httpcore</artifactId><version>${httpcore-verison}</version></dependency><dependency><groupId>org.apache.httpcomponents</groupId><artifactId>httpclient</artifactId><version>${httpclient-version}</version></dependency>
</dependencies>

注意，如果你的JDK是1.9或者以上版本，需要加入jaxb相关依赖，其他JDK版本不需要！

<dependency><groupId>javax.xml.bind</groupId><artifactId>jaxb-api</artifactId><version>2.3.1</version>
</dependency><dependency><groupId>javax.activation</groupId><artifactId>activation</artifactId><version>1.1.1</version>
</dependency><!-- no more than 2.3.3-->
<dependency><groupId>org.glassfish.jaxb</groupId><artifactId>jaxb-runtime</artifactId><version>2.3.3</version>
</dependency>

然后我们在resources目录下创建一个application.yml配置文件。

spring:servlet:multipart:max-file-size: 10MBmax-request-size: 10MBapplication:name: aliyun-oss-demo
server:port: 9001
aliyun:oss:#服务器地址, 我选择的是华北2-北京地址如下endpoint: http://oss-cn-beijing.aliyuncs.com#子账户名称，在自己控制台账户的Access中查看accessKeyId: 填写自己的accessKey#子账户密码accessKeySecret: 填写自己的accessSecret#自己创建的桶的名字bucketName: qianfeng-file

 接着我们创建一个启动类AliyunOssApplication。

package com.qianfeng;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;/*** 微服务启动类* @Author 千锋健哥*/
@SpringBootApplication
public class AliyunOssApplication {public static void main(String[] args) {SpringApplication.run(AliyunOssApplication.class, args);}
}

4.2 封装工具类

创建com.qianfeng.util包，放入文件操作工具类AliyunOSSUtil。

package com.qianfeng.util;import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClient;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.model.*;import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.InputStream;
import java.util.Date;/*** 阿里云OSS上传,下载, 删除文件工具类* @Author 千锋健哥*/
public class AliyunOSSUtil {/*** byte数组格式上传文件* @param endpoint          OSS对外服务的访问域名* @param accessKeyId       accessKey账号* @param accessKeySecret   accessKey密码* @param bucketName        桶名字* @param objectName        完整文件名, 例如abc/efg/123.jpg* @param content           文件内容, byte数组格式* @Author 千锋健哥*/public static void uploadByByteArrayFile(String endpoint,String accessKeyId,String accessKeySecret,String bucketName,String objectName,byte[] content) throws Exception {// 创建OSSClient实例。OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);//创建上传请求对象PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectName, new ByteArrayInputStream(content));// 上传PutObjectResult putObjectResult = ossClient.putObject(putObjectRequest);// 关闭OSSClient。ossClient.shutdown();}/*** 输入流格式上传文件* @param endpoint          OSS对外服务的访问域名* @param accessKeyId       accessKey账号* @param accessKeySecret   accessKey密码* @param bucketName        桶名字* @param objectName        完整文件名, 例如abc/efg/123.jpg* @param content           文件内容, 输入流格式* @Author 千锋健哥*/public static void uploadByInputStreamFile(String endpoint,String accessKeyId,String accessKeySecret,String bucketName,String objectName,InputStream content) {// 创建OSSClient实例。OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);// 上传ossClient.putObject(bucketName, objectName, content);// 关闭OSSClientossClient.shutdown();}/*** byte数组格式上传文件并返回上传后的URL地址* @param endpoint          OSS对外服务的访问域名* @param accessKeyId       accessKey账号* @param accessKeySecret   accessKey密码* @param bucketName        桶名字* @param objectName        完整文件名, 例如abc/efg/123.jpg* @param content           文件内容, byte数组格式* @Author 千锋健哥*/public static String uploadImage(String endpoint,String accessKeyId,String accessKeySecret,String bucketName,String objectName,byte[] content)  throws Exception {// 创建OSSClient实例。OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);// 创建上传文件的元信息，可以通过文件元信息设置HTTP header(设置了才能通过返回的链接直接访问)。ObjectMetadata objectMetadata = new ObjectMetadata();objectMetadata.setContentType("image/jpg");// 文件上传ossClient.putObject(bucketName, objectName, new ByteArrayInputStream(content), objectMetadata);// 设置URL过期时间为1小时。Date expiration = new Date(System.currentTimeMillis() + 3600 * 1000);//返回url地址String url = ossClient.generatePresignedUrl(bucketName, objectName, expiration).toString();//关闭OSSClient。ossClient.shutdown();return url;}/*** 下载文件到本地* @param endpoint          OSS对外服务的访问域名* @param accessKeyId       accessKey账号* @param accessKeySecret   accessKey密码* @param bucketName        桶名字* @param objectName        完整文件名, 例如abc/efg/123.jpg* @param localFile         下载到本地文件目录* @Author 千锋健哥*/public static void downFile(String endpoint,String accessKeyId,String accessKeySecret,String bucketName,String objectName,String localFile) throws Exception {// 创建OSSClient实例。OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);// 下载OSS文件到本地文件。如果指定的本地文件存在会覆盖，不存在则新建。ossClient.getObject(new GetObjectRequest(bucketName, objectName), new File(localFile));// 关闭OSSClient。ossClient.shutdown();}/*** 删除文件* @param endpoint          OSS对外服务的访问域名* @param accessKeyId       accessKey账号* @param accessKeySecret   accessKey密码* @param bucketName        桶名字* @param objectName        完整文件名, 例如abc/efg/123.jpg* @Author 千锋健哥*/public static void deleteFile(String endpoint,String accessKeyId,String accessKeySecret,String bucketName,String objectName) {// 创建OSSClient实例。OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);// 删除文件。如需删除文件夹，请将ObjectName设置为对应的文件夹名称。如果文件夹非空，则需要将文件夹下的所有object删除后才能删除该文件夹。ossClient.deleteObject(bucketName, objectName);// 关闭OSSClient。ossClient.shutdown();}
}

4.3 上传文件案例

我们在Controller中实现文件上传。

package com.qianfeng.controller;import com.qianfeng.util.AliyunOSSUtil;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;/*** 文件管理接口* 提供文件各种形式上传, 下载, 删除等操作* @Author 千锋健哥*/
@RestController
@RequestMapping("/file")
public class FileManagerController {//OSS服务器访问域名@Value("${aliyun.oss.endpoint}")private String endpoint;//子账户名@Value("${aliyun.oss.accessKeyId}")private String accessKeyId;//子账户密码@Value("${aliyun.oss.accessKeySecret}")private String accessKeySecret;//桶名字@Value("${aliyun.oss.bucketName}")private String bucketName;/*** byte数组形式上传* @param file* @Author 千锋健哥*/@PostMapping("/upload1")public void upload(@RequestParam("file") MultipartFile file) throws Exception {AliyunOSSUtil.uploadByByteArrayFile(endpoint, accessKeyId, accessKeySecret, bucketName, file.getOriginalFilename(), file.getBytes());}/*** 输入流形式上传* @param file* @Author 千锋健哥*/@PostMapping("/upload2")public void upload2(@RequestParam("file") MultipartFile file) throws Exception {AliyunOSSUtil.uploadByInputStreamFile(endpoint, accessKeyId, accessKeySecret, bucketName, file.getOriginalFilename(), file.getInputStream());}
}

4.4 上传图片并返回访问路径案例

在这个案例中给大家展示了如何获取返回的访问路径。

/*** 上传图片并返回上传后的URL地址* @param file* @Author 千锋健哥*/
@PostMapping("/upload3")
public String upload3(@RequestParam("file") MultipartFile file) throws Exception {String url = AliyunOSSUtil.uploadImage(endpoint, accessKeyId, accessKeySecret, bucketName, file.getOriginalFilename(), file.getBytes());System.out.println("===千锋健哥===" + url);return url;
}

4.5 删除文件案例

这是删除上传后的文件案例。

/*** 删除文件* @param objName 需要删除的对象名称* @Author 千锋健哥*/
@DeleteMapping("/delete")
public void deleteFile(String objName) {AliyunOSSUtil.deleteFile(endpoint, accessKeyId, accessKeySecret, bucketName, objName);
}