springboot整合阿里云oss实现文件上传

通过阿里云oss进行文件上传，首先需要开通相关的服务，这边就不在具体说明，不懂的可以百度看一下。

阿里云oss有几个关键的参数，这也是后续通过java进行上传所需要的参数，分别是endpoint(域结点)、AccessKey ID(秘钥id)、AccessKey secret(秘钥)、bucket name(bucket域名)。

 通过这几个关键字段才能过连接上阿里云的oss，可以通过配置文件来进行连接，具体配置如下：

pom:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>demooss</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demooss</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
            <version>3.1.0</version>
        </dependency>
        <!--日期时间工具-->
        <dependency>
            <groupId>joda-time</groupId>
            <artifactId>joda-time</artifactId>
            <version>2.10.1</version>
        </dependency>

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.7.0</version>
        </dependency>

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.7.0</version>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.24</version>
            <scope>compile</scope>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

# 服务端口
server.port=8888

# 环境设置：dev、test、prod
spring.profiles.active=dev

#阿里云oss
#不同的服务器，地址不同
aliyun.oss.file.endpoint=oss-cn-shanghai.aliyuncs.com
aliyun.oss.file.keyid=LTAI5tMYCr1pxcx4vz2o7riE
aliyun.oss.file.keysecret=vtAZaFH4CqJcqFj5oyyuRobivPNK8p

#bucket可以在控制台创建，也可以在java代码创建
aliyun.oss.file.bucketname=aaa-1010

然后创建相应的包service, controller, utils等。

utils工具类代码：

@Component
public class Utils implements InitializingBean {

    //读取配置文件内容  value注解读取属性值
    @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;
    }
}

 通过value注解获取配置中的结果，注意value引用的包是spring里面的org.springframework.beans.factory.annotation.Value，不能引错。再设置几个公共静态常量，将value注解得到的配置结果给到这几个静态常量，后续就可以通过方法直接调用。

swagger配置：参考上篇文章（注意相关的注解）

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket webApiConfig(){
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("webApi")
                .apiInfo(webApiInfo())
                .select()
                .paths(Predicates.not(PathSelectors.regex("/admin/.*")))
                .paths(Predicates.not(PathSelectors.regex("/error.*")))
                .build();

    }
    private ApiInfo webApiInfo(){
         return new ApiInfoBuilder()
         .title("API文档")
         .description("接口定义")
         .version("1.0")
         .contact(new Contact("mzz", "http://www.baidu.com",
                "1345656307@qq.com"))
         .build();
         }
}

service接口以及实现类

public interface OssService {
    String uploadFile(MultipartFile file);
}

@Service
public class OssServiceImpl implements OssService {

    @Override
    public String uploadFile(MultipartFile file) {

        String endpoint = Utils.END_POINT;
        String accessKeyId = Utils.ACCESS_KEY_ID;
        String accessKeySecret = Utils.ACCESS_KEY_SECRET;
        String bucketName = Utils.BUCKET_NAME;

        try {
            // 创建OSSClient实例。
            OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
            InputStream inputStream =file.getInputStream();
            //获取文件名称
            String fileName = file.getOriginalFilename();

            //1 在文件名称里面添加随机唯一值
            String uuid = UUID.randomUUID().toString().replaceAll("-","");
            fileName=uuid+fileName;

            //2 文件按照日期分类
            String datePath = new DateTime().toString("yyyy/MM/dd");

            //拼接
            fileName = datePath+"/"+fileName;

            //oss方法实现上传
            //第一个参数 bucket名称
            //第二个参数 上传到oss文件路径和名称 fileName
            //第三个参数 上传文件输入流
            ossClient.putObject(bucketName, fileName, inputStream);
            ossClient.shutdown();

            //把上传之后文件路径返回
            //需要把上传到阿里云oss路径手动拼接出来
            String url = "https://"+bucketName+"."+endpoint+"/"+fileName;

            return url;

        } catch (Exception e){
            e.printStackTrace();
            return null;

        }
    }
}

这边需要注意一下，因为不同的用户可能上传相同的文件，所以需要通过uuid生成一个随机唯一值，不加的话可能会导致第二次上传相同的文件覆盖掉前一次的文件。并且将文件按照日期分类，可以通过拼接完成。

controller代码：

@RestController
@RequestMapping("/fileoss")
public class OssController {

    @Resource
    private OssService ossService;

    @PostMapping
    public R uploadOssFile(MultipartFile file){
        //获取上传文件 MultipartFile
        String url = ossService.uploadFile(file);  //返回上传到oss的路径
        return R.ok().data("url",url);
    }

}

启动类：

@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
@ComponentScan(basePackages = {"com.example"})
public class DemoossApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoossApplication.class, args);
    }

}

启动类需要注意，不涉及数据库的话有可能会报错

1.@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)括号里面的exclude = DataSourceAutoConfiguration.class需要加上，因为我这边没有用的数据库的东西，如果不加会报错。

2.注解用@SpringBootApplication，在application.properties中加上数据库的配置信息。

一般我们通过第一种方式实现。

最后进行swagger测试

 

这是看一下阿里云oss里面就有记录了