springboot实现自定义starter组件开发

引言

springboot 在java领域的应用可谓是独领风骚,细心的小伙伴都会发现springboot都是由一个个starter组件组成,无论是spring自带starter还是第三方集成starter都是如此,公司开发肯定会有一些是基础架构研发的,业务项目大多都需要依赖基础架构来进行业务开发,一般通用的工具、加解密、通信之类的都属于基础架构。如何通过自定义starter实现自己的组件开发。

springboot自动注入核心

spring-boot-autoconfiguration 包下面的spring.factories文件里面默认spring给配置了许多 EnableAutoConfiguration相关的配置注解类,这些都是springboot默认添加的配置类,如果我们要实现相应的starter也是如此即可。

自定义starter实现

idea创建empty project

分别新增pdf-spring-boot-starter和pdf-spring-boot-starter-autoconfigurue模块

注意:这里为啥默不是spring-boot-starter-xxx而是xxx-spring-boot-starter,是因为spring自建的starter是spring-boot-starter-xxx这样的,如果是第三方的建议xxx-spring-boot-starter,并不是什么强制规定,这是便于区分的写法而已。

pdf-spring-boot-starter-autoconfigurue新增配置

pom文件配置

xml 复制代码
<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>2.6.5</version>
</parent>

<dependencies>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
  </dependency>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-autoconfigure</artifactId>
  </dependency>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
  </dependency>
  <dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
    <version>2.0.29</version>
  </dependency>
</dependencies>

编写PdfProperties

java 复制代码
@ConfigurationProperties(prefix = "wh.pdf")
public class PdfProperties {
    private int maxSize;
    private String fileDir;
    private String imageType;

    public int getMaxSize() {
        return maxSize;
    }

    public void setMaxSize(int maxSize) {
        this.maxSize = maxSize;
    }

    public String getFileDir() {
        return fileDir;
    }

    public void setFileDir(String fileDir) {
        this.fileDir = fileDir;
    }

    public String getImageType() {
        return imageType;
    }

    public void setImageType(String imageType) {
        this.imageType = imageType;
    }
}

编写PdfHandlerService业务实现

java 复制代码
public class PdfHandlerService {
    private PdfProperties properties;
    public PdfProperties getProperties() {
        return properties;
    }
    public void setProperties(PdfProperties properties) {
        this.properties = properties;
    }
    /**
     * pdf转图片
     * @param path
     * @return
     * @throws IOException
     */
    public List<String> pdfToImage(String path) throws IOException {
        List<String> filePaths = new ArrayList<>();
        PDDocument pdDocument = PDDocument.load(new File(path));
        int pages = pdDocument.getNumberOfPages();
        PDFRenderer renderer = new PDFRenderer(pdDocument);
        for (int i = 0; i < pages; i++) {
            BufferedImage renderImage = renderer.renderImage(i);
            String filePath =  properties.getFileDir() + (i+1)+"."+properties.getImageType();
            ImageIO.write(renderImage, properties.getImageType(), new File(filePath));
            filePaths.add(filePath);
        }
        // 关闭文档
        pdDocument.close();
        return filePaths;
    }
}

编写PdfConfiguration配置类

less 复制代码
@Configuration
@ConditionalOnClass({PdfHandlerService.class})
@EnableConfigurationProperties(PdfProperties.class)
public class PdfConfiguration {
    // spring容器会接管PdfHandlerService,这样在引入自定义starter后直接使用@Autowired就可以直接使用
    @Bean
    public PdfHandlerService pdfHandlerService(PdfProperties pdfProperties){
        PdfHandlerService pdfHandlerService = new PdfHandlerService();
        pdfHandlerService.setProperties(pdfProperties);
        return pdfHandlerService;
    }
}

创建META-INF/spring.factories添加自动注入配置类

pdf-spring-boot-starter配置

pom.xml配置

xml 复制代码
<dependencies>
  <dependency>
    <groupId>org.wh</groupId>
    <artifactId>pdf-spring-boot-starter-autoconfigurer</artifactId>
    <version>1.1.0</version>
  </dependency>
</dependencies>

starer可以写相关组件的代码,我这里演示没有写

本地创建jar文件

实际生产开发自然是加入公司自己的仓库中去,以便项目引用

验证测试

本地项目引入

application.yml文件添加配置

编写单元测试

相关推荐
boonya3 小时前
Elasticsearch核心原理与面试总结
大数据·elasticsearch·面试
M1A15 小时前
小红书重磅升级!公众号文章一键导入,深度内容轻松入驻
后端
0wioiw06 小时前
Go基础(④指针)
开发语言·后端·golang
李姆斯8 小时前
复盘上瘾症:到底什么时候该“复盘”,什么时候不需要“复盘”
前端·后端·团队管理
javachen__8 小时前
Spring Boot配置error日志发送至企业微信
spring boot·后端·企业微信
seabirdssss8 小时前
使用Spring Boot DevTools快速重启功能
java·spring boot·后端
蒹葭玉树8 小时前
【C++上岸】C++常见面试题目--算法篇(第二十期)
c++·算法·面试
OC溥哥99910 小时前
Flask论坛与个人中心页面开发教程完整详细版
后端·python·flask·html
CoderYanger11 小时前
MySQL数据库——3.2.1 表的增删查改-查询部分(全列+指定列+去重)
java·开发语言·数据库·mysql·面试·职场和发展
雲墨款哥11 小时前
一个前端开发者的救赎之路-JS基础回顾(五)-数组
前端·javascript·面试