文章目录
- 阿里云OSS对象存储的使用和实现万能文件上传
- 1、开通阿里云OSS对象存储服务(新用户可以免费试用三个月)
- 1.1、点击免费试用并选择自己想要使用的服务
- 1.2、咱们这里选择使用第一个存储服务,然后点击立即试用
- 2、创建存储空间,获取bucketName和endpoint
- 2.1、登录OSS[管理控制台](https://oss.console.aliyun.com/overview)。
- 2.2、Bucket命名规则
- 2.3、成功创建并进入Bucket
- 2.4、进入Bucket后查看概览,记录下图信息
- 3、在阿里云网站上的个人中心配置Accesskey,查询accessKeyId和accessKeySecret。
- 3.1、进入AccssKey管理页面应该会出现下图提示,accessKeySecret为空,不用点击下载,直接确定即可
- 3.2、点击创建AccessKey
- 3.3、通过安全验证后可以看到生成的==accessKeyId和accessKeySecret==,大家下载csv文件或者复制下来,因为点击确定后==不再显示==accessKeySecret!!!
- 4、OSS的使用
- 4.1、导入依赖
- 4.2、创建对应的工具类AliOssUtil类,此代码是固定代码,直接CV即可。
- 4.3、在该工具类中有四个属性,通过上面的步骤已经获得了我们上传图片到OSS所需要的四个参数:==bucketName、endpoint、accessKeyId、accessKeySecret==。这些属性需要我们手动在application.properties中配置。
- 4.5、配置相应model类
- 4.6、将工具类配置到ioc容器中,便于后续的使用。
- 4.7、测试:创建控制层(在本地项目基础上进行修改的大家可以去我的码云上查看项目完整结构)
- https://gitee.com/fpl1116/wms-project
阿里云OSS对象存储的使用和实现万能文件上传
oss是对象存储服务(Object Storage Service)的缩写,是一种分布式存储服务,用于存储和访问大规模数据。它提供了可靠、安全、低成本的数据存储解决方案,可以通过网络随时随地访问存储的数据。oss常用于存储图片、视频、文档等非结构化数据。
1、开通阿里云OSS对象存储服务(新用户可以免费试用三个月)
https://www.aliyun.com/product/oss?spm=5176.8465980.unusable.ddetail.7df51450v1aNb1
1.1、点击免费试用并选择自己想要使用的服务
1.2、咱们这里选择使用第一个存储服务,然后点击立即试用
2、创建存储空间,获取bucketName和endpoint
存储空间(Bucket)是用于存储对象(Object)的容器。在上传任意类型的Object前,您需要先创建Bucket。
2.1、登录OSS管理控制台。
在左侧导航栏,单击Bucket列表,然后单击创建Bucket。
在创建Bucket面板,按如下说明配置必要参数。其他参数均可保持默认配置,也可以在Bucket创建完成后单独配置。然后单击确定。
2.2、Bucket命名规则
同一阿里云账号在同一地域内创建的Bucket总数不能超过100个。Bucket创建后,其名称无法修改。Bucket命名规则如下:
Bucket名称在OSS范围内必须全局唯一。
只能包括小写字母、数字和短划线(-)。
必须以小写字母或者数字开头和结尾。
长度为3~63个字符。
命名示例
Bucket名称的正确示例如下:
examplebucket1
test-bucket-2021
aliyun-oss-bucket
Bucket名称的错误示例以及错误的原因如下:
Examplebucket1(包含了大写字母)
test_bucket_2021(包含了下划线)
aliyun-oss-bucket-(结尾包含了短划线)
2.3、成功创建并进入Bucket
2.4、进入Bucket后查看概览,记录下图信息
3、在阿里云网站上的个人中心配置Accesskey,查询accessKeyId和accessKeySecret。
3.1、进入AccssKey管理页面应该会出现下图提示,accessKeySecret为空,不用点击下载,直接确定即可
点击继续使用AccessKey
3.2、点击创建AccessKey
3.3、通过安全验证后可以看到生成的accessKeyId和accessKeySecret,大家下载csv文件或者复制下来,因为点击确定后不再显示accessKeySecret!!!
4、OSS的使用
4.1、导入依赖
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>3.10.2</version>
</dependency>
4.2、创建对应的工具类AliOssUtil类,此代码是固定代码,直接CV即可。
import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.extern.slf4j.Slf4j;
import java.io.ByteArrayInputStream;
@Data
@AllArgsConstructor
//固定代码,CV直接使用
public class AliOssUtil {
private String endpoint;
private String accessKeyId;
private String accessKeySecret;
private String bucketName;
/**
* 文件上传
*
* @param bytes :传入的文件要转为byte[]
* @param objectName :表示在oss中存储的文件名字。
* @return
*/
public String upload(byte[] bytes, String objectName) {
// 创建OSSClient实例。
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
try {
// 创建PutObject请求。
ossClient.putObject(bucketName, objectName, new ByteArrayInputStream(bytes));
} 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();
}
}
//文件访问路径规则 https://BucketName.Endpoint/ObjectName
StringBuilder stringBuilder = new StringBuilder("https://");
stringBuilder
.append(bucketName)
.append(".")
.append(endpoint)
.append("/")
.append(objectName);
return stringBuilder.toString();
}
}
4.3、在该工具类中有四个属性,通过上面的步骤已经获得了我们上传图片到OSS所需要的四个参数:bucketName、endpoint、accessKeyId、accessKeySecret。这些属性需要我们手动在application.properties中配置。
# 配置阿里云OSS(application.properties)
aliyun.oss.bucketName = fpl1116-project
aliyun.oss.endpoint = oss-cn-zhangjiakou.aliyuncs.com
aliyun.oss.accessKeyId =
aliyun.oss.accessKeySecret =
# yml版(application.yml)
#aliyun:
# oss:
# bucketName: fpl1116-project
# endpoint: oss-cn-zhangjiakou.aliyuncs.com
# accessKeyId:
# accessKeySecret:
4.5、配置相应model类
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
/**
* <p>Project: wms-project - OSSConfig</p>
* <p>Powered by fpl1116 On 2024-02-28 23:26:54</p>
* <p>描述:<p>
*
* @author penglei
* @version 1.0
* @since 1.8
*/
@Configuration
@ConfigurationProperties(prefix = "aliyun.oss")
@Data
public class AliOssProperties {
private String endpoint;
private String accessKeyId;
private String accessKeySecret;
private String bucketName;
}
4.6、将工具类配置到ioc容器中,便于后续的使用。
创建oss对应的配置类。
import com.fpl.model.AliOssProperties;
import com.fpl.utils.AliOssUtil;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class OssConfiguration {
@Bean
@ConditionalOnMissingBean
public AliOssUtil getAliOssUtil(AliOssProperties aliOssProperties) {
// log.info("创建OssUtil");
AliOssUtil aliOssUtil = new AliOssUtil(
aliOssProperties.getEndpoint(),
aliOssProperties.getAccessKeyId(),
aliOssProperties.getAccessKeySecret(),
aliOssProperties.getBucketName()
);
return aliOssUtil;
}
}
4.7、测试:创建控制层(在本地项目基础上进行修改的大家可以去我的码云上查看项目完整结构)
https://gitee.com/fpl1116/wms-project
@RestController
@RequestMapping("api/upload")
public class UploadController {
@Autowired
private AliOssUtil aliOssUtil;
@PostMapping("/oss1")
//万能上传
public String upload1(@RequestBody UploadInfo uploadInfo){
String name = uploadInfo.getName();
String base64 = uploadInfo.getBase64();
String[] base64Array = StrUtil.splitToArray(base64, "base64,");
byte[] bytes = Base64.decode(base64Array[1]);
name = PinyinUtil.getPinyin(name, "");
String newName = System.currentTimeMillis() +"_"+name;
FileUtil.writeBytes(bytes,newName);
return aliOssUtil.upload1(bytes, newName);
}
}