SpringBoot 打成jar包供第三方引用自动装配方案实现

最新推荐文章于 2025-04-17 11:21:08 发布

原创最新推荐文章于 2025-04-17 11:21:08 发布

· 5k 阅读

28 ·

版权

文章标签：

#spring boot #自动装配 #spi #自定义注解

springboot 专栏收录该内容

5 篇文章

订阅专栏

本文详细介绍如何将SpringBoot项目打成jar包，供第三方作为组件引用，包括手动配置、注解引入、SPI机制等自动装配方案。通过具体示例，如使用Jedis连接Redis，演示不同配置方式下的组件注册过程。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

SpringBoot 打成jar包供第三方引用自动装配方案实现

每天多学一点点~
话不多说，这就开始吧…

1.前言

看了源码之后，总有种蠢蠢欲动的感觉，想着以后啥时候牛逼了，自己也可以用springboot写个第三方组件，让别人引入jar包就行。虽然知道目前水平有限，先试试普通的jar包如何与spring自动装配吧~
环境 jdk1.8 springboot 2.1.12.RELEASE

2.使用者手动配置 basePackages

这种个人觉比较low，不友好，使用者需要在类上加@ComponentScan，而对于开发者很简单，
不需要对项目进行任何其余配置。

@Configuration
@ComponentScan(basePackages = {"com.zjq.jartest.**"})
public class TestConfig{

}

配置方式: 在SpringBoot启动类或能被Spring发现的 Configuration 类上增加 @ComponentScan(basePackages = {“com.zjq.jartest.**”})

通过此方式配置后，Spring会在启动时扫描 com.zjq.jartest 这个包，我们的组件自然而然也会被注册为Spring Bean

3.使用者通过注解方式引入

这种方式比较像nacos的@EnableDiscoveryClient，Feign的@EnableFeignClients 之类。原谅我比较菜，用jedis举个例子。
项目结构
MyRedisTemplateAnno 主要配置类，相当于我们组件的入口
扫描到 com.zjq.jartest.service2 这个包下需要装配的类

@Configuration
@ComponentScan(value = "com.zjq.jartest.service2")
public class MyRedisTemplateAnno {

    private JedisPool jedisPool;

    @PostConstruct
    public void init() {
        GenericObjectPoolConfig poolConfig = new GenericObjectPoolConfig();
        poolConfig.setMaxTotal(500);
        jedisPool = new JedisPool(poolConfig, "127.0.0.1",
                6379, 5000, "123456", 1);
    }

    public void insert(String k, String v) {
        Jedis jedis = jedisPool.getResource();
        jedis.set(k, v);
        jedis.close();
    }

}

其中，第一行是声明为一个配置类
第二行为设置自动扫描包，让Spring能够发现我们封装的组件的其他 Spring Bean

到这儿还结束，我们的目的是使用者通过注解才能发现该配置类(类似于nacos和feign那样)，所以我们还需要建立一个注解类，此处取名为 EnableMyRedisCilent(是不是起名很规范~)

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE})
@Documented
@Import({MyRedisTemplateAnno.class})
public @interface EnableMyRedisCilent {

}

重点是**@Import** 这个注解，引入上面的配置类。

这样使用者在启动类上加入 @EnableMyRedisCilent 这个注解就可以了

@SpringBootApplication
@EnableMyRedisCilent
public class ExceltonijingliApplication {

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

或者在其他类上加上

@EnableMyRedisCilent
@Configuration
public class TestConfig {
}

4.利用SPI机制注入

java spi的具体约定为:当服务的提供者，提供了服务接口的一种实现之后，在jar包的META-INF/services/目录里同时创建一个以服务接口命名的文件。该文件里就是实现该服务接口的具体实现类。而当外部程序装配这个模块的时候，就能通过该jar包META-INF/services/里的配置文件找到具体的实现类名，并装载实例化，完成模块的注入。基于这样一个约定就能很好的找到服务接口的实现类，而不需要再代码里制定。jdk提供服务实现查找的一个工具类java.util.ServiceLoader
典型的应用就是dubbo。

在这里插入图片描述
此方法最关键的为 resources/META-INF/spring.factories 文件，当项目启动时，Spring会扫描所有jar包下面的 spring.factories 文件，进行相应的自动配置处理。

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.zjq.jartest.service.MyRedisTemplate

其中 org.springframework.boot.autoconfigure.EnableAutoConfiguration 代表自动配置的 key，即代表需要自动配置哪些类，\ 可以理解为一个换行符，则该行下面的每行当做一个参数

MyRedisTemplate 类，不用加注解

public class MyRedisTemplate {
    private JedisPool jedisPool;
    
    @PostConstruct
    public void init() {
        GenericObjectPoolConfig poolConfig = new GenericObjectPoolConfig();
        poolConfig.setMaxTotal(500);
        this.jedisPool = new JedisPool(poolConfig, "127.0.0.1",
                6379, 5000, "123456", 1);
    }

    public void insert(String k, String v) {
        Jedis jedis = jedisPool.getResource();
        jedis.set(k, v);
        jedis.close();
    }

5.打包测试

首先是我们的jartest的pom

这里需要注意的是我这里打包选举的是maven的方式，而非springboot的方式。
因为上文中提到需要用到注解方式注释,所以加上了spring的依赖。
如果光使用spi机制，不需要加入spring的依赖。

<?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>
    <groupId>com.zjq.jartest</groupId>
    <artifactId>jartest</artifactId>
    <version>1.0.0-Alpha</version>
    <name>jartest</name>
    <description>第三方中间件jar测试</description>
    
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.1.8.RELEASE</version>
            <!-- 如果该项目是准备作为一个第三方插件的话，这里对spring的依赖范围最好指定为provided-->
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>redis.clients</groupId>
            <artifactId>jedis</artifactId>
            <version>2.7.2</version>
        </dependency>
    </dependencies>

    <!--普通的jar 公共模块不要用上面的springboot构建 打成可执行的jar -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

使用者在工程中引入

        <!--jar test 内部测试版-->
        <dependency>
            <groupId>com.zjq.jartest</groupId>
            <artifactId>jartest</artifactId>
            <version>1.0.0-Alpha</version>
        </dependency>

springboot测试类

    /**
     *  用 spi 方式 注入
     */
    @Autowired
    private MyRedisTemplate myRedisTemplate;

    @Test
    public void test() {
        System.out.println("start test ");
        myRedisTemplate.insert("myRedisTemplate","12121");
    }

    /**
     *   用注解方式 注入  需要加上@@EnableMyRedisCilent 我们自定义的直接
     */
    @Autowired
    private MyRedisTemplateAnno myRedisTemplateAnno;

    @Test
    public void test2() {
        System.out.println("start  test2 ");
        myRedisTemplateAnno.insert("myRedisTemplateAnno","12121");
    }