图片上传阿里云OSS及java应用上传下载图片实战

最新推荐文章于 2024-07-25 16:03:38 发布

liu1002880404

最新推荐文章于 2024-07-25 16:03:38 发布

阅读量1.8k

点赞数 1

分类专栏： springBoot

本文链接：https://blog.csdn.net/liuerchong/article/details/107965443

版权

springBoot 专栏收录该内容

49 篇文章 2 订阅

订阅专栏

1 、图片存储解决方案

项目中上传图片的需求有很多的，所以，我们需要

开发一个上传图片的服务，来提供服务。

开发一个图片上传服务，需要有存储的支持，那么我们的解决方案将以下几种：

1. 直接将图片保存到服务的硬盘

1. 优点：开发便捷，成本低

2. 缺点：扩容困难

2. 使用分布式文件系统进行存储

1. 优点：容易实现扩容

2. 缺点：开发复杂度稍大（尤其是开发复杂的功能）

3. 使用 nfs 做存储

1. 优点：开发较为便捷

2. 缺点：需要有一定的运维知识进行部署和维护

4. 使用第三方的存储服务

1. 优点：开发简单，拥有强大功能，免维护

2. 缺点：付费

本次讲解采用第一、四解决方案，第三方服务选用阿里云的 OSS 服务。

2 、阿里云 OSS 存储

2.1 、什么是 OSS 服务？

这是阿里云的官网：https://www.aliyun.com

（1.1）打开官网之后，就是这个样子的。

【2】什么是阿里云OSS ？

（2.1）首先我们点击该服务【对象存储OSS】

（2.2）下面红框是阿里云OSS的一个简介，简而言之，他就是一个文件存储的服务。

比如你的网站开发，假设需要用到图片上传，文件上传等功能。

以前我们的做法是，自己搭建一个图片服务器或者文件服务器，然后自己在写一套相关的实现方法。

但现在我们如果用了阿里云的OSS的话，这一块儿就可以省去我们买服务器的钱和写代码实现的时间。

【3】注册与登录

【4】开通OSS

（4.1）登录成功后，如果没有开通OSS的，则点击【立即开通】，然后他会提示相关方案。

开通的过程中他会让你选择个人版还是企业版，后面的API接口都一样，自己根据业务需要开通过即可。

（4.2）如果已经开通，则可以看到【管理控制台】，我们点击它。

【5】创建 Bucket

(5.1) 来到下面这个页面后，我们点击【创建Bucket】。

Bucket 的中文意思是桶，也就是官方说的存储空间。

你可以理解为你电脑中的C盘、D盘、E盘等。

（5.2）创建Bucket的时候，会让你填写相关信息，一般来说我们只填名称和选择区域，其他都默认就好。

Bucket名称是唯一的，这个唯一同其他所有用户，比如sunny这个桶已经有人用了，那么你就不能用这个了。至于是谁用的，你不知道，我也不知道。

区域就是你想把你东西存放到哪个地方，从功能来说，选哪个都一样。

选择完毕后，点击【确定】完成创建。

【6】记住桶名（bucketName）和外网地域节点（endPoint）

（6.1）完成创建后，就可以看到这个存储空间 sunnyzyq 了，右边是空间的相关介绍。记住这个桶名 (bucketName)，等会撸代码的时候需要。

（6.2）另外，还有记住你的这个Endpoint，等会撸代码的时候也需要。

【7】创建AccessKey，获取授权信息

阿里云的OSS只是一个服务，我们要使用服务，需要 AccessId 和 AccessKey 进行授权。不光是阿里接口，几乎所有API接口都有这一步。

（7.1）点击如图位置【Access Key】，开始获取授权信息。

（7.2）第一次创建，会弹出这个东西。一般来说，个人的数据没有那么必要折腾，选择【继续使用AccessKey】。而如果是公司用的话，基于安全原因，一般选择【开始使用字用户AccessKey】

（7.3）选择完毕后，点击【创建AccessKey】。

（7.4）然后他会向你发验证码，确认是否是本人操作，输入验证码后，就会得到相关的的 AccessKeyId 和 AccessKeySecret 了。

【9】阿里云OSS实战

OSS具体开发文档链接地址为：https://help.aliyun.com/product/31815.html

例如：我们往上面上传一张图片。

文件上传代码

以下代码用于上传本地文件：

// Endpoint以杭州为例，其它Region请按实际情况填写。
String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// 阿里云主账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维，请登录 https://ram.console.aliyun.com 创建RAM账号。
String accessKeyId = "<yourAccessKeyId>";
String accessKeySecret = "<yourAccessKeySecret>";

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

// 创建PutObjectRequest对象。
PutObjectRequest putObjectRequest = new PutObjectRequest("<yourBucketName>", "<yourObjectName>", new File("<yourLocalFile>"));

// 如果需要上传时设置存储类型与访问权限，请参考以下示例代码。
// ObjectMetadata metadata = new ObjectMetadata();
// metadata.setHeader(OSSHeaders.OSS_STORAGE_CLASS, StorageClass.Standard.toString());
// metadata.setObjectAcl(CannedAccessControlList.Private);
// putObjectRequest.setMetadata(metadata);

// 上传文件。
ossClient.putObject(putObjectRequest);

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

可以看到上传文件需要三个常量，我们在配置文件中配置

需要一个client对象，通过配置文件配置

下面开始撸代码

新建一个服务

导入依赖

<groupId> com.aliyun.oss </groupId>

<artifactId> aliyun-sdk-oss </artifactId>

</dependency>

<groupId> org.projectlombok </groupId>

<artifactId> lombok </artifactId>

</dependency>

</dependency>

编写 aliyun.properties 配置文件

aliyun.endpoint = oss-cn-qingdao.aliyuncs.com

aliyun.accessKeyId = <yourAccessKeyId>

aliyun.accessKeySecret = <your accessKeySecret >

aliyun.bucketName = your bucketName

aliyun.urlPrefix = http : //xxx.oss-cn-qingdao.aliyuncs.com/

accessKeyId 以及 accessKeySecret 获取参考官方文档 :

https://help.aliyun.com/knowledge_detail/48699.html

@Configuration

//读取配置文件

@PropertySource ( value = { "classpath:aliyun.properties" })

//前缀

@ConfigurationProperties ( prefix = "aliyun" )

@Data

public class AliyunConfig {

private String endpoint ;

private String accessKeyId ;

private String accessKeySecret ;

private String bucketName ;

private String urlPrefix ;

@Bean

public OSS oSSClient () {

return new OSSClient ( endpoint , accessKeyId , accessKeySecret );

}

编写 PicUploadResult

该类用于返回给前端的数据结构定义。

@Data

public class PicUploadResult {

具体的上传逻辑实现，在该类中调用了 OSS 客户端的 API 。

// 文件唯一标识

private String uid ;

// 文件名

private String name ;

// 状态有： uploading done error removed

private String status ;

// 服务端响应内容，如： '{"status": "success"}'

private String response ;

}

@Configuration
@PropertySource("classpath:aliyun.properties")
@ConfigurationProperties(prefix = "aliyun")
@Data
public class AliyunConfig {

private String endpoint;
private String accessKeyId;
private String accessKeySecret;
private String bucketName;
private String urlPrefix;

@Bean
public OSSClient oSSClient() {
return new OSSClient(endpoint, accessKeyId, accessKeySecret);
}

}

编写 PicUploadService

具体的上传逻辑实现，在该类中调用了 OSS 客户端的API

@Service

public class PicUploadService {

// 允许上传的格式

private static final String [] IMAGE_TYPE = new String []{ ".bmp" , ".jpg" ,

".jpeg" , ".gif" , ".png" };

@Autowired

private OSS ossClient ;

@Autowired

private AliyunConfig aliyunConfig ;

public PicUploadResult upload ( MultipartFile uploadFile ) {

// 校验图片格式

boolean isLegal = false ;

for ( String type : IMAGE_TYPE ) {

if ( StringUtils . endsWithIgnoreCase ( uploadFile . getOriginalFilename (),

type )) {

isLegal = true ;

break ;

}

// 封装 Result 对象，并且将文件的 byte 数组放置到 result 对象中

PicUploadResult fileUploadResult = new PicUploadResult ();

if ( ! isLegal ){

fileUploadResult . setStatus ( "error" );

return fileUploadResult ;

}

// 文件新路径

String fileName = uploadFile . getOriginalFilename ();

String filePath = getFilePath ( fileName );

// 上传到阿里云

try {

ossClient . putObject ( aliyunConfig . getBucketName (), filePath , new

ByteArrayInputStream ( uploadFile . getBytes ()));

} catch ( Exception e ) {

e . printStackTrace ();

// 上传失败

fileUploadResult . setStatus ( "error" );

return fileUploadResult ;

}

fileUploadResult . setStatus ( "done" );

fileUploadResult . setName ( this . aliyunConfig . getUrlPrefix () + filePath );

fileUploadResult . setUid ( String . valueOf ( System . currentTimeMillis ()));

return fileUploadResult ;

}

private String getFilePath ( String sourceFileName ) {

DateTime dateTime = new DateTime ();

return "images/" + dateTime . toString ( "yyyy" )

+ "/" + dateTime . toString ( "MM" ) + "/"

+ dateTime . toString ( "dd" ) + "/" + System . currentTimeMillis () +

RandomUtils . nextInt ( 100 , 9999 ) + "." +

StringUtils . substringAfterLast ( sourceFileName , "." );

}

@Service
public class PicUploadService {

// 允许上传的格式
private static final String[] IMAGE_TYPE = new String[]{".bmp", ".jpg",
".jpeg", ".gif", ".png"};

@Autowired
private OSSClient ossClient;

@Autowired
private AliyunConfig aliyunConfig;

public PicUploadResult upload(MultipartFile uploadFile) {

PicUploadResult fileUploadResult = new PicUploadResult();

//图片做校验，对后缀名
boolean isLegal = false;

for (String type : IMAGE_TYPE) {
if (StringUtils.endsWithIgnoreCase(uploadFile.getOriginalFilename(),
type)) {
isLegal = true;
break;
}
}

if (!isLegal) {
fileUploadResult.setStatus("error");
return fileUploadResult;
}

// 文件新路径
String fileName = uploadFile.getOriginalFilename();
String filePath = getFilePath(fileName);

// 上传到阿里云
try {
// 目录结构：images/2018/12/29/xxxx.jpg
ossClient.putObject(aliyunConfig.getBucketName(), filePath, new
ByteArrayInputStream(uploadFile.getBytes()));
} catch (Exception e) {
e.printStackTrace();
//上传失败
fileUploadResult.setStatus("error");
return fileUploadResult;
}

// 上传成功
fileUploadResult.setStatus("done");
fileUploadResult.setName(this.aliyunConfig.getUrlPrefix() + filePath);
fileUploadResult.setUid(String.valueOf(System.currentTimeMillis()));

return fileUploadResult;
}

private String getFilePath(String sourceFileName) {
DateTime dateTime = new DateTime();
return "images/" + dateTime.toString("yyyy")
+ "/" + dateTime.toString("MM") + "/"
+ dateTime.toString("dd") + "/" + System.currentTimeMillis() +
RandomUtils.nextInt(100, 9999) + "." +
StringUtils.substringAfterLast(sourceFileName, ".");
}

}

编写 PicUploadController

@RequestMapping("pic/upload")
@Controller
public class PicUploadController {

@Autowired
private PicUploadService picUploadService;

// @Autowired
// private PicUploadFileSystemService picUploadService;

@PostMapping
@ResponseBody
public PicUploadResult upload(@RequestParam("file") MultipartFile multipartFile) {
return this.picUploadService.upload(multipartFile);
}
}

postman进行测试

添加水印

OSS 提供了在线添加水印功能，下面我们来体验下该功能：

本地文件系统存储

3.1 、编写 PicUploadFileSystemService

@Service
public class PicUploadFileSystemService {

// 允许上传的格式
private static final String[] IMAGE_TYPE = new String[]{".bmp", ".jpg",
".jpeg", ".gif", ".png"};

public PicUploadResult upload(MultipartFile uploadFile) {
// 校验图片格式
boolean isLegal = false;
for (String type : IMAGE_TYPE) {
if (StringUtils.endsWithIgnoreCase(uploadFile.getOriginalFilename(),
type)) {
isLegal = true;
break;
}
}

PicUploadResult fileUploadResult = new PicUploadResult();
if (!isLegal) {
fileUploadResult.setStatus("error");
return fileUploadResult;
}

String fileName = uploadFile.getOriginalFilename();
String filePath = getFilePath(fileName);
// 生成图片的绝对引用地址
String picUrl = StringUtils.replace(StringUtils.substringAfter(filePath,
"F:\\code\\itcast-haoke\\haoke-upload"),
"\\", "/");
fileUploadResult.setName("http://image.haoke.com" + picUrl);
File newFile = new File(filePath);
// 写文件到磁盘
try {
uploadFile.transferTo(newFile);
} catch (IOException e) {
e.printStackTrace();
//上传失败
fileUploadResult.setStatus("error");
return fileUploadResult;
}
fileUploadResult.setStatus("done");
fileUploadResult.setUid(String.valueOf(System.currentTimeMillis()));
return fileUploadResult;
}

private String getFilePath(String sourceFileName) {
String baseFolder = "F:\\code\\itcast-haoke\\haoke-upload" + File.separator
+ "images";
Date nowDate = new Date();
// yyyy/MM/dd
String fileFolder = baseFolder + File.separator + new
DateTime(nowDate).toString("yyyy")
+ File.separator + new DateTime(nowDate).toString("MM") +
File.separator
+ new DateTime(nowDate).toString("dd");
File file = new File(fileFolder);
if (!file.isDirectory()) {
// 如果目录不存在，则创建目录
file.mkdirs();
}
// 生成新的文件名
String fileName = new DateTime(nowDate).toString("yyyyMMddhhmmssSSSS")
+ RandomUtils.nextInt(100, 9999) + "." +
StringUtils.substringAfterLast(sourceFileName, ".");
return fileFolder + File.separator + fileName;
}
}
修改Controller中的引用

@Autowired

private PicUploadFileSystemService picUploadService ;

/**

* @param uploadFile

* @return

* @throws Exception

@PostMapping

@ResponseBody

public PicUploadResult upload ( @RequestParam ( "file" ) MultipartFile uploadFile )

throws Exception {

return this . picUploadService . upload ( uploadFile );

}

liu1002880404

关注

1
点赞
踩
8

收藏

觉得还不错? 一键收藏
0
评论
图片上传阿里云OSS及java应用上传下载图片实战

1、图片存储解决方案项目中上传图片的需求有很多的，所以，我们需要开发一个上传图片的服务，来提供服务。开发一个图片上传服务，需要有存储的支持，那么我们的解决方案将以下几种： 1. 直接将图片保存到服务的硬盘 1. 优点：开发便捷，成本低 2. 缺点：扩容困难 2. 使用分布式文件系统进行存储 1. 优点：容易实现扩容 2. 缺点：开发复杂度稍大（尤其是开发复杂的功能） 3. 使用nfs做存储 1. 优点：开发较为便捷 ...
复制链接

扫一扫