Spring Boot项目实战之aliyunOss对象储存#文件上传接口实现（代码齐全）

项目环境：

  开发工具：IDEA（jdk1.8）

  模块类型：Mavan项目

  OSS版本：2.8.3

  开发者文档链接：https://help.aliyun.com/document_detail/32008.html

  接口测试工具：Swagger

功能代码：

（1）controller类

@RestController
@RequestMapping("/eduoss/oss")
@CrossOrigin
public class OssController {
    @Autowired
    private OssService ossService;

    /**
     * 功能描述
     * @MethodName: uploadFile
     * @MethodParam: [file]
     * @Return: com.guliedu.common.R
     * @Description:  上传文件提交到Oss
     * @Author: LinHong
     * @CreateDate: 2019/11/17 20:20
     */
    @PostMapping("fileupload")
    public R uploadFile(MultipartFile file){
        //1.获取上传过来的文件 MultipartFile
        //<input type="file" name="file">
        //返回上传之后头像在阿里云oss路径
        String url=ossService.uploadFileOss(file);
        return R.ok().data("url",url);

    }

}

（2）serviceImpl类

  注意：防止上传文件重名，使用UUID（随机唯一值32位）拼接文件名；为了分类、维护上传文件，时间日期拼接文件名（需要引入pom依赖），在Oss存储平台对应就是文件夹（例如：日期20191118对应2019、11、18三个文件夹）！

/**
 * @BelongProjecet: guli-framework-parent
 * @BelongPackage: com.guliedu.eduoss.service.impl
 * @ClassName: OssServiceImpl
 * @Description: 上传文件oss
 * @Copyright: 2019-xxx-Powered by 研发四部
 * @Author: LinHong
 * @CreateDate: 2019/11/17 19:56
 * @Version: V1.0
 */
@Service
public class OssServiceImpl implements OssService {
    @Override
    public String uploadFileOss(MultipartFile file) {
        //地域节点
        String endpoint = ConstantPropertiesUtil.END_POINT;
        // 阿里云主账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维，请登录 https://ram.console.aliyun.com 创建RAM账号
        String accessKeyId = ConstantPropertiesUtil.ACCESS_KEY_ID;
        String accessKeySecret = ConstantPropertiesUtil.ACCESS_KEY_SECRET;
        String bucketName = ConstantPropertiesUtil.BUCKET_NAME;

        try {
            // 创建OSSClient2.8.3实例
            OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);
            //上传文件流
            InputStream inputStream = file.getInputStream();
            String filename = file.getOriginalFilename();
            
            //添加一个UUID值
            String uuid = UUID.randomUUID().toString().replaceAll("-", "");
            //拼接到filename前面
            filename =uuid+filename;
            
            //2019/11/17/01.jpg
            //获取当前日期，转换/2019/11/17
            String timeUrl = new DateTime().toString("yyyy/MM/dd");
            
            filename =timeUrl+"/"+filename;
            //调用方法，上传文件
            ossClient.putObject(bucketName, filename, inputStream);
            // 关闭OSSClient
            ossClient.shutdown();
            //返回上传之后url地址--例如： https://guli-edu-191117.oss-cn-beijing.aliyuncs.com/7.jpg
            String url = "https://" + bucketName + "." + endpoint + "/" + filename;
            return url;
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }
}

（3）util类

/**
 * @BelongProjecet: guli-framework-parent
 * @BelongPackage: com.guliedu.eduoss.utils
 * @ClassName: ConstantPropertiesUtil
 * @Description: 读取application.properties文件的oss配置信息(工具类)
 * @Copyright: 2019-xxx-Powered by 研发四部
 * @Author: LinHong
 * @CreateDate: 2019/11/17 20:05
 * @Version: V1.0
 */
@Component
public class ConstantPropertiesUtil implements InitializingBean {

    @Value("${aliyun.oss.file.endpoint}")
    private String endpoint;
    @Value("${aliyun.oss.file.keyid}")
    private String keyid;
    @Value("${aliyun.oss.file.keysecret}")
    private String keysecret;
    @Value("${aliyun.oss.file.bucketname}")
    private String bucketname;

    //常量值
    public static String END_POINT;
    public static String ACCESS_KEY_ID;
    public static String ACCESS_KEY_SECRET;
    public static String BUCKET_NAME;

    @Override
    public void afterPropertiesSet() throws Exception {
        //赋值
        END_POINT=endpoint;
        ACCESS_KEY_ID=keyid;
        ACCESS_KEY_SECRET=keysecret;
        BUCKET_NAME=bucketname;
    }
}

（4）application.properties文件

#服务端口
server.port=8002
#服务名
spring.application.name=guli-aliyunoss-edu
#环境设置：dev、test、prod
spring.profiles.active=dev

#阿里云 OSS
#不同的服务器，地址不同
aliyun.oss.file.endpoint=oss-cn-beijing.aliyuncs.com
aliyun.oss.file.keyid=LTAI4FiPJy7MPdzLxxxxx
aliyun.oss.file.keysecret=Fj78yLoEjPczzmxxxxxx
#bucket可以在控制台创建，也可以使用java代码创建
aliyun.oss.file.bucketname=xxxx-edu-xxxxx

（5）pom依赖

引入oss、swagger、joda-time依赖。

    <dependencies>

        <!--aliyunOSS-->
        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
            <version>2.8.3</version>
        </dependency>
        <dependency>
            <groupId>com.guli</groupId>
            <artifactId>guli-common-edu</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
        
        <!--swagger-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
        </dependency>

        <!--日期时间工具-->
        <dependency>
            <groupId>joda-time</groupId>
            <artifactId>joda-time</artifactId>
            <version>2.10.1</version>
        </dependency>
    </dependencies>

（6）run启动类

/**
 * @BelongProjecet: guli-framework-parent
 * @BelongPackage: com.guliedu.eduoss
 * @ClassName: OssApplication
 * @Description: TODO
 * @Copyright: 2019-xxx-Powered by 研发四部
 * @Author: LinHong
 * @CreateDate: 2019/11/17 19:50
 * @Version: V1.0
 */
//(exclude = DataSourceAutoConfiguration.class)
@SpringBootApplication
public class OssApplication {
    public static void main(String[] args) {
        SpringApplication.run(OssApplication.class, args);
    }
}

控制台运行

（7）swagger测试

输入地址：<http://localhost:8002/swagger-ui.html#!/oss45controller/uploadFileUsingPOST>

浏览本地图片，选择图片，点击“Try it out！”按钮，测试成功！

查看aliyun-oss对象存储控制台，预先创建好bucket！

注意：上传图片方式很多，可以存储到服务器，如oss，也可以对图片进行base64编码进行数据库存储，常见案例就是富文本编辑器上传图片,但是上传图片大小有限制！

<p><img class="wscnph" src="data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyP.............1kXdn//Z" /></p>

♚学习、实战、总结、分享，让生活变得更美好！
☞林大侠博客：https://coding0110lin.blog.csdn.net/  欢迎转载，一起技术交流探讨！