自定義一個springboot starter_ZenDei技術網路在線

## 1.自定義starter的作用在我們的日常開發工作中，經常會有一些獨立於業務之外的配置模塊，比如阿裡雲oss存儲的時候，我們需要一個工具類進行文件上傳。我們經常將其放到一個特定的包下，然後如果另一個工程需要復用這塊功能的時候，需要將代碼硬拷貝到另一個工程，重新集成一遍，這樣會非常麻煩。如果我 ...

1.自定義starter的作用

在我們的日常開發工作中，經常會有一些獨立於業務之外的配置模塊，比如阿裡雲oss存儲的時候，我們需要一個工具類進行文件上傳。我們經常將其放到一個特定的包下，然後如果另一個工程需要復用這塊功能的時候，需要將代碼硬拷貝到另一個工程，重新集成一遍，這樣會非常麻煩。如果我們將這些可獨立於業務代碼之外的功配置模塊封裝成一個個starter，復用的時候只需要在 maven pom 中引用依賴即可，讓 SpringBoot 為我們完成自動裝配，提高開發效率。

2.自定義starter命名規範

SpringBoot提供的 starter 以 spring-boot-starter-xxx 的方式命名的。官方建議自定義的 starter 使用 xxx-spring-boot-starter 命名規則。以區分 SpringBoot 生態提供的 starter。如：mybatis-spring-boot-starter

3.自定義starter的步驟

現在就以自定義阿裡雲oss工具starter為例步驟如下：

新建兩個maven模塊

（1）aliyun-oss-spring-boot-autoconfigure：自動配置核心代碼

（2）aliyun-oss-spring-boot-starter：管理依賴

在aliyun-oss-spring-boot-autoconfigure的pom文件中引入以下依賴

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
            <version>3.15.1</version>
        </dependency>
        <dependency>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
            <version>2.3.1</version>
        </dependency>
        <dependency>
            <groupId>javax.activation</groupId>
            <artifactId>activation</artifactId>
            <version>1.1.1</version>
        </dependency>
        <!-- no more than 2.3.3-->
        <dependency>
            <groupId>org.glassfish.jaxb</groupId>
            <artifactId>jaxb-runtime</artifactId>
            <version>2.3.3</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
        </dependency>
</dependencies>

在aliyun-oss-spring-boot-autoconfigure的java裡面的對應的包里新建三個文件

AliOSSProperties.java

package com.minqiliang;


import org.springframework.boot.context.properties.ConfigurationProperties;

@ConfigurationProperties("aliyun.oss")
public class AliOSSProperties {
    private String endpoint;
    private String accessKeyId;
    private String accessKeySecret;
    private String bucketName;

    /**
     * 獲取
     * @return endpoint
     */
    public String getEndpoint() {
        return endpoint;
    }

    /**
     * 設置
     * @param endpoint
     */
    public void setEndpoint(String endpoint) {
        this.endpoint = endpoint;
    }

    /**
     * 獲取
     * @return accessKeyId
     */
    public String getAccessKeyId() {
        return accessKeyId;
    }

    /**
     * 設置
     * @param accessKeyId
     */
    public void setAccessKeyId(String accessKeyId) {
        this.accessKeyId = accessKeyId;
    }

    /**
     * 獲取
     * @return accessKeySecret
     */
    public String getAccessKeySecret() {
        return accessKeySecret;
    }

    /**
     * 設置
     * @param accessKeySecret
     */
    public void setAccessKeySecret(String accessKeySecret) {
        this.accessKeySecret = accessKeySecret;
    }

    /**
     * 獲取
     * @return bucketName
     */
    public String getBucketName() {
        return bucketName;
    }

    /**
     * 設置
     * @param bucketName
     */
    public void setBucketName(String bucketName) {
        this.bucketName = bucketName;
    }
}

AliOSSUtils.java

package com.minqiliang;

import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.io.InputStream;
import java.util.UUID;

/**
 * 阿裡雲 OSS 工具類
 */

public class AliOSSUtils {

    private AliOSSProperties aliOSSProperties;

    public AliOSSProperties getAliOSSProperties() {
        return aliOSSProperties;
    }

    public void setAliOSSProperties(AliOSSProperties aliOSSProperties) {
        this.aliOSSProperties = aliOSSProperties;
    }

    /**
     * 實現上傳圖片到OSS
     */
    public String upload(MultipartFile file) throws IOException {
        String endpoint = aliOSSProperties.getEndpoint();
        String accessKeyId = aliOSSProperties.getAccessKeyId();
        String accessKeySecret = aliOSSProperties.getAccessKeySecret();
        String bucketName = aliOSSProperties.getBucketName();
        // 獲取上傳的文件的輸入流
        InputStream inputStream = file.getInputStream();

        // 避免文件覆蓋
        String originalFilename = file.getOriginalFilename();
        String fileName = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));

        //上傳文件到 OSS
        OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
        ossClient.putObject(bucketName, fileName, inputStream);

        //文件訪問路徑
        String url = endpoint.split("//")[0] + "//" + bucketName + "." + endpoint.split("//")[1] + "/" + fileName;
        // 關閉ossClient
        ossClient.shutdown();
        return url;// 把上傳到oss的路徑返回
    }

}

AliyunOssAutoConfigration.java

package com.minqiliang;

import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
@EnableConfigurationProperties(AliOSSProperties.class)
public class AliyunOssAutoConfigration {

    @Bean
    public AliOSSUtils aliOSSUtils(AliOSSProperties aliOSSProperties){
        AliOSSUtils aliossUtils = new AliOSSUtils();
        aliossUtils.setAliOSSProperties(aliOSSProperties);
        return  aliossUtils;
    }
}

aliyun-oss-spring-boot-autoconfigure的resources文件加下新建META_INF/spring文件夾，然後再在spring文件夾里新建org.springframework.boot.autoconfigure.AutoConfiguration.imports文件，文件內容為AliyunOssAutoConfigration類的全類名，如下
```
com.minqiliang.AliyunOssAutoConfigration
```

在aliyun-oss-spring-boot-starter的pom文件里引入aliyun-oss-spring-boot-autoconfigure依賴

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>com.minqiliang</groupId>
            <artifactId>aliyun-oss-spring-boot-autoconfigure</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
</dependencies>

目錄結構如下
執行clean和install，把自定義的starter安裝到本地倉庫
新建一個aliyun-starter-test模塊，進行測試，目錄結構如下：

UploadController.java

package com.example.controller;

import com.example.pojo.Result;
import com.minqiliang.AliOSSUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;

@RestController
public class UploadController {

    @Autowired
    private AliOSSUtils aliOSSUtils;

    @PostMapping("upload")
    public Result upload(MultipartFile image) throws IOException {
        String url = aliOSSUtils.upload(image);
        return Result.success(url);
    }
}

Result.java

package com.example.pojo;

public class Result {
    private Integer code;//響應碼，1 代表成功; 0 代表失敗
    private String msg;  //響應信息 描述字元串
    private Object data; //返回的數據

    public Result() {
    }

    public Result(Integer code, String msg, Object data) {
        this.code = code;
        this.msg = msg;
        this.data = data;
    }


    //增刪改 成功響應
    public static Result success(){
        return new Result(1,"success",null);
    }
    //查詢 成功響應
    public static Result success(Object data){
        return new Result(1,"success",data);
    }
    //失敗響應
    public static Result error(String msg){
        return new Result(0,msg,null);
    }

    /**
     * 獲取
     * @return code
     */
    public Integer getCode() {
        return code;
    }

    /**
     * 設置
     * @param code
     */
    public void setCode(Integer code) {
        this.code = code;
    }

    /**
     * 獲取
     * @return msg
     */
    public String getMsg() {
        return msg;
    }

    /**
     * 設置
     * @param msg
     */
    public void setMsg(String msg) {
        this.msg = msg;
    }

    /**
     * 獲取
     * @return data
     */
    public Object getData() {
        return data;
    }

    /**
     * 設置
     * @param data
     */
    public void setData(Object data) {
        this.data = data;
    }

    public String toString() {
        return "Result{code = " + code + ", msg = " + msg + ", data = " + data + "}";
    }
}

pom文件引入aliyun-oss-spring-boot-starter依賴

<dependencies>
        <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>
        <dependency>
            <groupId>com.minqiliang</groupId>
            <artifactId>aliyun-oss-spring-boot-starter</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
</dependencies>

application.yml里配置自己的阿裡雲oss信息，如下

aliyun:
  oss:
    endpoint: 填寫自己的
    accessKeyId: 填寫自己的
    accessKeySecret: 填寫自己的
    bucketName: 填寫自己的

啟動測試項目，使用postman上傳一個文件，結果如下，說明starter配置成功

{
    "code": 1,
    "msg": "success",
    "data": "https://tlias-manage.oss-cn-hangzhou.aliyuncs.com/8713ed3d-751c-4d54-8a64-239b1ccb0da4.jpg"
}