SpringBoot2.x系列教程24--SpringBoot实现文件上传到OSS阿里云存储

本文涉及的产品
对象存储 OSS,20GB 3个月
对象存储 OSS,恶意文件检测 1000次 1年
对象存储 OSS,内容安全 1000次 1年
简介: 前言在上一章节中,壹哥 给大家讲解了如何在SpringBoot实现单个文件和多个文件上传,但是那种方式现在挺多项目中都不再采用了,而是会把文件上传到云存储服务器中,比如阿里云、腾讯云、华为云等。所以今天 壹哥 利用阿里云的OSS存储,讲解如何把本地文件存储到云存储服务器中,本文会教给你如何购买配置阿里云OSS,并且教你如何实现文件上传到云空间,干货满满哦。一. 阿里云OSS简介1. 存储服务简介我们进行项目开发,很多时候都需要进行文件、图片等的上传,对于很多项目来说,虽然有FastDFS等文件存储服务器技术,但其实我们完全没有必要搭建自己的图片等文件服务器。对一个小型非专业的应用来说,

前言

在上一章节中,壹哥 给大家讲解了如何在SpringBoot实现单个文件和多个文件上传,但是那种方式现在挺多项目中都不再采用了,而是会把文件上传到云存储服务器中,比如阿里云、腾讯云、华为云等。所以今天 壹哥 利用阿里云的OSS存储,讲解如何把本地文件存储到云存储服务器中,本文会教给你如何购买配置阿里云OSS,并且教你如何实现文件上传到云空间,干货满满哦。

一. 阿里云OSS简介

1. 存储服务简介

我们进行项目开发,很多时候都需要进行文件、图片等的上传,对于很多项目来说,虽然有FastDFS等文件存储服务器技术,但其实我们完全没有必要搭建自己的图片等文件服务器。对一个小型非专业的应用来说,搭建自己的专属文件存储服务器,完全就是浪费,而且也不一定有那样的实力。

但是我们项目中经常需要进行头像等其他文件的上传等操作,那么如何实现呢?

我推荐首选阿里云存储,便宜又靠谱。

阿里云提供了一个对象存储 OSS服务,可以实现海量、安全、低成本、高可靠的云存储服务,提供99.9999999999%的数据可靠性。并且使用RESTful API 可以在互联网任何位置存储和访问,容量和处理能力弹性扩展,多种存储类型供选择全面优化存储成本。

2. 购买阿里云OSS服务

首选搜索阿里云,选择第一个就是了。

然后选择云计算基础里的对象存储OSS产品。

可以看到,40G的一年存储服务才9块钱,很便宜了,对于学习来说足够了。

3. 阿里云OSS控制台简介

点击首页的控制台链接就可以进入后台。

4. 创建Bucket桶空间

在这里创建一个Bucket桶,作为存储文件的空间。

桶名不能重复。

可以在自己的桶空间中创建子目录,用来存储不同项目或模块下的文件。

5. 设置桶空间访问权限

接下来要设置该目录的访问权限,可以设置为公共读。

再设置一下该桶的授权策略。

二. SpringBoot中实现OSS云存储

1. 创建Web项目

我们按照之前的经验,创建一个Web程序,并将之改造成Spring Boot项目,具体过程略。

2. 添加依赖包

在项目中添加如下核心依赖包,比较重要的是web依赖和aliyun的依赖包。

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><!--简化bean代码--><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></dependency><!-- Thymeleaf--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-thymeleaf</artifactId></dependency><!-- 图片上传 SDK 阿里云oss --><dependency><groupId>com.aliyun.oss</groupId><artifactId>aliyun-sdk-oss</artifactId><version>2.8.3</version></dependency><dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.3.1</version></dependency>

3. 添加配置信息

我们可以在阿里云后台的如下位置,查看自己阿里云账号的AccessKey信息。

在这里复制自己的AccessKey ID与Secret信息,然后粘贴到自己的配置文件中。

请在application.properties或application.yml文件中添加如下格式的配置信息,重要的是把自己的AccessKey ID与Secret信息粘贴进来。

bucketName: "yiyige"accessKeyId: "自己阿里云的accessKey"accessKeySecret: "自己阿里云的accessKey"#OSS对应的区域endpoint: "http://oss-cn-hangzhou.aliyuncs.com"filehost: "images"

4. 创建配置信息类

为了方便调用,我们封装一个配置信息类,后面就可以直接通过Get/Set方法来调用这些配置信息了。

packagecom.yyg.boot.config;
importlombok.Data;
importlombok.Getter;
importlombok.Setter;
importorg.springframework.beans.factory.annotation.Value;
importorg.springframework.context.annotation.Configuration;
importorg.springframework.stereotype.Component;
/*** 把配置文件中的配置信息读取到该类中.*/@Data@ConfigurationpublicclassOssConfiguration {
@Value("${endpoint}")
privateStringendPoint;
@Value("${accessKeyId}")
privateStringaccessKeyId;
@Value("${accessKeySecret}")
privateStringaccessKeySecret;
@Value("${filehost}")
privateStringfileHost;
@Value("${bucketName}")
privateStringbucketName;
}

5. 封装阿里云文件上传工具类

然后我这里封装了一个文件上传工具类,用于实现文件上传功能。

packagecom.yyg.boot.util;
importcom.aliyun.oss.OSSClient;
importcom.aliyun.oss.model.CannedAccessControlList;
importcom.aliyun.oss.model.CreateBucketRequest;
importcom.aliyun.oss.model.PutObjectRequest;
importcom.aliyun.oss.model.PutObjectResult;
importcom.yyg.boot.config.OssConfiguration;
importorg.springframework.beans.factory.annotation.Autowired;
importorg.springframework.stereotype.Component;
importjava.io.File;
importjava.text.SimpleDateFormat;
importjava.util.Date;
importjava.util.UUID;
/*** 封装文件上传方法*/@ComponentpublicclassAliyunOssUtil {
@AutowiredprivateOssConfigurationconfig;
publicStringupload(Filefile) {
if (file==null) {
returnnull;
        }
StringendPoint=config.getEndPoint();
StringkeyId=config.getAccessKeyId();
StringkeySecret=config.getAccessKeySecret();
StringbucketName=config.getBucketName();
StringfileHost=config.getFileHost();
//定义子文件的格式SimpleDateFormatformat=newSimpleDateFormat("yyyy-MM-dd");
StringdateStr=format.format(newDate());
//阿里云文件上传客户端OSSClientclient=newOSSClient(endPoint, keyId, keySecret);
try {
//判断桶是否存在if (!client.doesBucketExist(bucketName)) {
//创建桶client.createBucket(bucketName);
CreateBucketRequestcreateBucketRequest=newCreateBucketRequest(bucketName);
//设置访问权限为公共读createBucketRequest.setCannedACL(CannedAccessControlList.PublicRead);
//发起创建桶的请求client.createBucket(createBucketRequest);
            }
//当桶存在时,进行文件上传//设置文件路径和名称StringfileUrl=fileHost+"/"+ (dateStr+"/"+UUID.randomUUID().toString().replace("-", "") +"-"+file.getName());
PutObjectResultresult=client.putObject(newPutObjectRequest(bucketName, fileUrl, file));
client.setBucketAcl(bucketName, CannedAccessControlList.PublicRead);
//文件上传成功后,返回当前文件的路径if (result!=null) {
returnfileUrl;
            }
        } catch (Exceptione) {
e.printStackTrace();
        } finally {
if (client!=null) {
client.shutdown();
            }
        }
returnnull;
    }
}

6. 编写Controller接口

接着再创建一个Controller文件上传接口,上传我们的文件到阿里云中。

packagecom.yyg.boot.web;
importcom.yyg.boot.util.AliyunOssUtil;
importlombok.extern.slf4j.Slf4j;
importorg.springframework.beans.factory.annotation.Autowired;
importorg.springframework.stereotype.Controller;
importorg.springframework.web.bind.annotation.GetMapping;
importorg.springframework.web.bind.annotation.PostMapping;
importorg.springframework.web.bind.annotation.RequestParam;
importorg.springframework.web.multipart.MultipartFile;
importjava.io.File;
importjava.io.FileOutputStream;
@ControllerpublicclassOssController {
@AutowiredprivateAliyunOssUtilossUtil;
@GetMapping("/")
publicStringshowUploadFile() {
return"upLoad";
    }
@PostMapping("/uploadFile")
publicStringupload(@RequestParam("file") MultipartFilefile) {
try {
if (file!=null) {
StringfileName=file.getOriginalFilename();
if (!"".equals(fileName.trim())) {
FilenewFile=newFile(fileName);
FileOutputStreamos=newFileOutputStream(newFile);
os.write(file.getBytes());
os.close();
//把file里的内容复制到奥newFile中file.transferTo(newFile);
Stringupload=ossUtil.upload(newFile);
//图片回显地址://http://yiyige.oss-cn-hangzhou.aliyuncs.com/images/2019-10-21/6c964702b67d4eeb920e7f1f4358189b-dishu.jpgSystem.out.println("path="+upload);
                }
            }
        } catch (Exceptione) {
e.printStackTrace();
        }
return"success";
    }
}

7. 编写文件上传页面

编写一个文件上传页面,请参考之前的章节实现。

<!DOCTYPE html><htmlxmlns="http://www.w3.org/1999/xhtml"xmlns:th="http://www.thymeleaf.org"><head><metacharset="UTF-8"/><title>【基于OSS的上传文件页面】</title><linkrel="stylesheet"th:href="@{/css/bootstrap.min.css}"media="all"/><styletype="text/css">        *{
margin:0;
padding:0;
        }
#group{
position: absolute;
left:580px;
        }
#submit{
position: absolute;
top:140px;
left:580px;
        }
</style></head><body><divalign="center"><h2style="color:orangered;">基于OSS的上传文件页面</h2></div><br/><formaction="/uploadFile"enctype="multipart/form-data"method="post"><divclass="form-group"id="group"><labelfor="exampleInputFile">File input</label><inputtype="file"id="exampleInputFile"name="file"/></div><buttontype="submit"class="btn btn-default"id="submit">上传</button></form></body></html>

8. 文件上传成功界面

为了看得文件上传的结果,我这里编写了一个文件上传成功后要跳转到的界面。

<!DOCTYPE html><htmlxmlns="http://www.w3.org/1999/xhtml"xmlns:th="http://www.thymeleaf.org"><head><metacharset="UTF-8"/><title>【文件上传成功页面】</title></head><body><divalign="center"><h5>上传成功</h5></div></body></html>

9. 编写入口类

最后我们编写一个项目的入口类,启动项目。

packagecom.yyg.boot;
importorg.springframework.boot.SpringApplication;
importorg.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplicationpublicclassOssApplication {
publicstaticvoidmain(String[] args) {
SpringApplication.run(OssApplication.class, args);
    }
}

10. 进行测试

把项目启动起来进行测试,这里我们首先进入到文件上传界面,选择一个文件进行上传,正常情况下会发现文件上传成功的提示。

打开控制台,可以看到阿里云OSS服务器端返回的图片存储路径。

然后我们可以在阿里云服务器上,看到会自动以当天的日期创建的一个文件夹,这里存放的就是刚才上传的文件。

在这个文件夹里我们可以看到刚才上传的图片文件。

结语

至此,壹哥 就把阿里云OSS的使用给大家介绍完了,以后你可以把你的私密文件上传到自己的云服务器哦,这样就不用担心会被人盗走了,当然请一定要记得权限配置好,😋。

今天的内容你学会了吗?评论区告诉我吧!

今日小作业:

在自己的学生信息管理系统中,把自己的靓照上传存储的阿里云OSS里。

相关实践学习
借助OSS搭建在线教育视频课程分享网站
本教程介绍如何基于云服务器ECS和对象存储OSS,搭建一个在线教育视频课程分享网站。
相关文章
|
1月前
|
Cloud Native Java C++
Springboot3新特性:开发第一个 GraalVM 本机应用程序(完整教程)
文章介绍如何在Spring Boot 3中利用GraalVM将Java应用程序编译成独立的本机二进制文件,从而提高启动速度、减少内存占用,并实现不依赖JVM运行。
199 1
Springboot3新特性:开发第一个 GraalVM 本机应用程序(完整教程)
|
1月前
|
前端开发 Java 数据安全/隐私保护
用户登录前后端开发(一个简单完整的小项目)——SpringBoot与session验证(带前后端源码)全方位全流程超详细教程
文章通过一个简单的SpringBoot项目,详细介绍了前后端如何实现用户登录功能,包括前端登录页面的创建、后端登录逻辑的处理、使用session验证用户身份以及获取已登录用户信息的方法。
180 2
用户登录前后端开发(一个简单完整的小项目)——SpringBoot与session验证(带前后端源码)全方位全流程超详细教程
|
1月前
|
Java API Apache
Springboot+shiro,完整教程,带你学会shiro
这篇文章提供了一个完整的Apache Shiro与Spring Boot结合使用的教程,包括Shiro的配置、使用以及在非Web和Web环境中进行身份验证和授权的示例。
66 2
Springboot+shiro,完整教程,带你学会shiro
|
1月前
|
前端开发 Java Apache
Springboot整合shiro,带你学会shiro,入门级别教程,由浅入深,完整代码案例,各位项目想加这个模块的人也可以看这个,又或者不会mybatis-plus的也可以看这个
本文详细讲解了如何整合Apache Shiro与Spring Boot项目,包括数据库准备、项目配置、实体类、Mapper、Service、Controller的创建和配置,以及Shiro的配置和使用。
303 1
Springboot整合shiro,带你学会shiro,入门级别教程,由浅入深,完整代码案例,各位项目想加这个模块的人也可以看这个,又或者不会mybatis-plus的也可以看这个
|
1月前
|
缓存 NoSQL Java
springboot的缓存和redis缓存,入门级别教程
本文介绍了Spring Boot中的缓存机制,包括使用默认的JVM缓存和集成Redis缓存,以及如何配置和使用缓存来提高应用程序性能。
96 1
springboot的缓存和redis缓存,入门级别教程
|
1月前
|
数据采集 监控 Java
SpringBoot日志全方位超详细手把手教程,零基础可学习 日志如何配置及SLF4J的使用......
本文是关于SpringBoot日志的详细教程,涵盖日志的定义、用途、SLF4J框架的使用、日志级别、持久化、文件分割及格式配置等内容。
136 0
SpringBoot日志全方位超详细手把手教程,零基础可学习 日志如何配置及SLF4J的使用......
|
1月前
|
存储 JSON 算法
JWT令牌基础教程 全方位带你剖析JWT令牌,在Springboot中使用JWT技术体系,完成拦截器的实现 Interceptor (后附源码)
文章介绍了JWT令牌的基础教程,包括其应用场景、组成部分、生成和校验方法,并在Springboot中使用JWT技术体系完成拦截器的实现。
72 0
JWT令牌基础教程 全方位带你剖析JWT令牌,在Springboot中使用JWT技术体系,完成拦截器的实现 Interceptor (后附源码)
|
1月前
|
JavaScript 安全 Java
如何使用 Spring Boot 和 Ant Design Pro Vue 实现动态路由和菜单功能,快速搭建前后端分离的应用框架
本文介绍了如何使用 Spring Boot 和 Ant Design Pro Vue 实现动态路由和菜单功能,快速搭建前后端分离的应用框架。首先,确保开发环境已安装必要的工具,然后创建并配置 Spring Boot 项目,包括添加依赖和配置 Spring Security。接着,创建后端 API 和前端项目,配置动态路由和菜单。最后,运行项目并分享实践心得,包括版本兼容性、安全性、性能调优等方面。
148 1
|
21天前
|
JavaScript 安全 Java
如何使用 Spring Boot 和 Ant Design Pro Vue 构建一个具有动态路由和菜单功能的前后端分离应用。
本文介绍了如何使用 Spring Boot 和 Ant Design Pro Vue 构建一个具有动态路由和菜单功能的前后端分离应用。首先,创建并配置 Spring Boot 项目,实现后端 API;然后,使用 Ant Design Pro Vue 创建前端项目,配置动态路由和菜单。通过具体案例,展示了如何快速搭建高效、易维护的项目框架。
96 62
|
19天前
|
JavaScript 安全 Java
如何使用 Spring Boot 和 Ant Design Pro Vue 构建一个前后端分离的应用框架,实现动态路由和菜单功能
本文介绍了如何使用 Spring Boot 和 Ant Design Pro Vue 构建一个前后端分离的应用框架,实现动态路由和菜单功能。首先,确保开发环境已安装必要的工具,然后创建并配置 Spring Boot 项目,包括添加依赖和配置 Spring Security。接着,创建后端 API 和前端项目,配置动态路由和菜单。最后,运行项目并分享实践心得,帮助开发者提高开发效率和应用的可维护性。
36 2