我的第一个springboot starter(我的第一个果子是酸的这个故事告诉我们什么)

  本篇文章为你整理了我的第一个springboot starter(我的第一个果子是酸的这个故事告诉我们什么)的详细内容,包含有我的第一个上级 我的第一个果子是酸的这个故事告诉我们什么 我的第一个图书馆 我的第一个师傅主要内容 我的第一个springboot starter,希望能帮助你了解 我的第一个springboot starter。

    在springboot中有很多starter,很多是官方开发的,也有是个人或开源组织开发的。这些starter是用来做什么的呐?

  一、认识starter

    所谓的starter,在springboot中其实是一个依赖,是springboot官方为了方便开发者更好的管理依赖而开发的,像前边提到的mybatis的starter,

  

 dependency 

 

   groupId org.mybatis.spring.boot /groupId

   artifactId mybatis-spring-boot-starter /artifactId

   version 2.1.3 /version

   /dependency

 

    这是一个在springboot中使用mybatis的starter,看下其包含了哪些内容,下面是该starter中包含的依赖,

  更有意思的一点是mybatis-spring-boot-starter没有代码,

  也就是说mybatis-spring-boot-starter不具备实际功能,仅仅提供所需的依赖。那么是如何把mybatis相关的内容注入到springboot中的呐,是因为mybatis中有两位一个依赖”mybatis-spring-boot-autoconfigure“,该依赖中有有关自动配置的相关内容,先混个眼熟,

  其中,META-INF下的spring.factories和MybatisAutoConfiguration两个文件是重点,后面会重点分析springboot自动配置的原理。

  现在,现在对starter有了一个清析的认识,starter提供一个组件集成springboot的入口,包含了需要的依赖以及自动配置类。

  下面,看下springboot提供了哪些starter。

  二、starter汇总

  2.1、spring-boot-starter

  其依赖为,

  

 dependency 

 

   groupId org.springframework.boot /groupId

   artifactId spring-boot-starter /artifactId

   /dependency

 

  2.2、spring-boot-starter-web

  这个是开发springboot web项目时的starter,

  

 dependency 

 

   groupId org.springframework.boot /groupId

   artifactId spring-boot-starter-web /artifactId

   /dependency

 

  2.3、spring-boot-starter-jdbc

  和jdbc相关的,其依赖为

  

 dependency 

 

   groupId org.springframework.boot /groupId

   artifactId spring-boot-starter-jdbc /artifactId

   /dependency

 

  2.4、spring-boot-starter-activemq

  和activeMQ相关的

  

 dependency 

 

   groupId org.springframework.boot /groupId

   artifactId spring-boot-starter-activemq /artifactId

   /dependency

 

  2.5、spring-boot-starter-data-elasticsearch

  和ES相关的

  

 dependency 

 

   groupId org.springframework.boot /groupId

   artifactId spring-boot-starter-data-elasticsearch /artifactId

   /dependency

 

  2.6、spring-boot-starter-data-jpa

  和JPA相关的

  

 dependency 

 

   groupId org.springframework.boot /groupId

   artifactId spring-boot-starter-data-jpa /artifactId

   /dependency

 

  2.7、spring-boot-starter-data-mongodb

  和mongodb相关的

  

 dependency 

 

   groupId org.springframework.boot /groupId

   artifactId spring-boot-starter-data-mongodb /artifactId

   /dependency

 

  2.8、spring-boot-starter-quartz

  和定时任务相关的

  

 dependency 

 

   groupId org.springframework.boot /groupId

   artifactId spring-boot-starter-quartz /artifactId

   /dependency

 

  2.9、mybatis-spring-boot-starter

  和mybatis相关的

  

 dependency 

 

   groupId org.mybatis.spring.boot /groupId

   artifactId mybatis-spring-boot-starter /artifactId

   version 2.1.3 /version

   /dependency

 

  

    还有很多starter,这里暂且列举那么多,有个名称上的区别大家发现没,有的是”spring-boot-starter-XX“,有的是”XX-spring-boot-starter“,对于前者可以理解为是springboot官方提供的,对于后者可以理解为是第三方自己开发,我们如果自己开发一个其命名规范最好遵循后者。

  三、自定义starter

    前边说了很多有关官方的starter,现在自定义一个starter,有如下要求,该starter的名字暂定为:”customer-spring-boot-starter“,其包含一个依赖”customer-spring-boot-autoconfigurer“,在”customer-spring-boot-autoconfigurer“中会读取前缀为”my.customer“的配置文件,并且把MyCustomerService注入到springboot中,现在看要如何自定义一个starter。

  3.1、customer-spring-boot-starter

    从”mybatis-spring-boot-starter“知道,XX-spring-boot-starter是一个空项目,在该项目中会依赖XX-spring-boot-autoconfigurer,下面新建空项目”customer-spring-boot-starter“,

  对于src目录完全可以删除,这里暂时保留,重点看下pom.xml文件,我这里仅依赖了”customer-spring-boot-autoconfigurer“,

  

 ?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 http://maven.apache.org/xsd/maven-4.0.0.xsd"

   modelVersion 4.0.0 /modelVersion

   groupId org.example /groupId

   artifactId customer-spring-boot-starter /artifactId

   version 1.0-SNAPSHOT /version

   properties

   maven.compiler.source 8 /maven.compiler.source

   maven.compiler.target 8 /maven.compiler.target

   /properties

   dependencies

   !--自动配置模块--

   dependency

   groupId org.example /groupId

   artifactId customer-spring-boot-autoconfigurer /artifactId

   version 1.0-SNAPSHOT /version

   /dependency

   /dependencies

   /project

 

  ”customer-spring-boot-starter“就这样了,打包安装到本地仓库即可。

  3.2、customer-spring-boot-autoconfigurer

    相对于”customer-spring-boot-starter“来说,”custoerm-spring-boot-autoconfigurer“要复杂一些。建一个普通的maven项目即可,

  先看MyProperties文件吧,该文件负责读取配置文件(application.properties)文件中前缀为”my.customer“的配置,

  MyProperties.java

  

package com.my.autoconfigurer;

 

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

   * 读取配置文件中的配置

   * 读取前缀为my.customer的配置

   * @date 2022/6/12 17:06

  @ConfigurationProperties(prefix = "my.customer")

  public class MyProperties {

   private String name;

   private String code;

   public String getName() {

   return name;

   public void setName(String name) {

   this.name = name;

   public String getCode() {

   return code;

   public void setCode(String code) {

   this.code = code;

  }

 

  该类中使用了@ConfigurationProperties注解用来读取配置文件,所以要引入spring-boot-autoconfigure的依赖,后边pom.xml会体现。下面看要注入的服务,

  MyCustomerService.java

  

package com.my.autoconfigurer;

 

   * 自定义的服务类

   * @date 2022/6/12 17:05

  public class MyCustomerService {

   //MyProperties的引用

   private MyProperties myProperties;

   public MyProperties getMyProperties() {

   return myProperties;

   public void setMyProperties(MyProperties myProperties) {

   this.myProperties = myProperties;

   //自定义方法

   public void myCustomerMethod(){

   System.out.println("name:"+myProperties.getName()+",code:"+myProperties.getCode());

  }

 

  这个类也很简单,有一个MyProperties的属性,另外有一个自定义方法myCustomerMethod方法。主角要登场了,自动配置类,

  MyCustomerAutoconfiguration.java

  

package com.my.autoconfigurer;

 

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

  import org.springframework.context.annotation.Bean;

  import org.springframework.context.annotation.Configuration;

   * 自定义的自动配置类

   * @date 2022/6/12 17:11

  @Configuration

  @EnableConfigurationProperties(MyProperties.class)

  public class MyCustomerAutoconfiguration {

   //向springboot的容器中注入名为"myCustomerService"的实例

   @Bean

   public MyCustomerService myCustomerService(MyProperties myProperties){

   MyCustomerService myCustomerService=new MyCustomerService();

   myCustomerService.setMyProperties(myProperties);

   return myCustomerService;

  }

 

  上面就是一个简单的自定义配置类。配置完这些完了吗,还没有,重量级选手登场,在src/resources下新建”META-INF“文件夹,且在下面新建文件”spring.factories“,

  该文件的内容为,

  

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.my.autoconfigurer.MyCustomerAutoconfiguration

 

  配置这样一个key-value即可,key只能为”org.springframework.boot.autoconfigure.EnableAutoConfiguration“,value就是自定义的配置类,如果有多个使用”,“分割即可。另外该文件的名称也只能是”spring.factories“

  上面的这些配置完成,最后看下pom.xml文件,

  

  

 ?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 http://maven.apache.org/xsd/maven-4.0.0.xsd"

   modelVersion 4.0.0 /modelVersion

   groupId org.example /groupId

   artifactId customer-spring-boot-autoconfigurer /artifactId

   version 1.0-SNAPSHOT /version

   properties

   maven.compiler.source 8 /maven.compiler.source

   maven.compiler.target 8 /maven.compiler.target

   /properties

   dependencies

   !--springboot的自动配置依赖--

   dependency

   groupId org.springframework.boot /groupId

   artifactId spring-boot-autoconfigure /artifactId

   version 2.3.3.RELEASE /version

   /dependency

   /dependencies

   /project

 

  至此,自定义自动配置完成,打包安装到本地仓库即可。

  3.3、使用customer-spring-boot-starter

    上面已经完成了第一个自定义的starter,到了真金验证的时候了,

  导入”customer-spring-boot-starter“依赖,

  写个测试类,测试下是否自动导入了”MyCustomerService“类,

  

  

package com.my.template.controller;

 

  import com.my.autoconfigurer.MyCustomerService;

  import org.springframework.beans.factory.annotation.Autowired;

  import org.springframework.stereotype.Controller;

  import org.springframework.web.bind.annotation.RequestMapping;

  import org.springframework.web.bind.annotation.ResponseBody;

   * 测试自动配置类

   * @date 2022/6/12 17:46

  @Controller

  public class MyController {

   //自动注入的类

   @Autowired

   private MyCustomerService myCustomerService;

   @RequestMapping("test")

   @ResponseBody

   public void test(){

   myCustomerService.myCustomerMethod();

  }

 

  另外在application.properites文件中配置自定义的配置文件,

  

#自定义配置

 

  my.customer.name=hello

  my.customer.code=autoconfiguration

 

  启动服务,看下打印结果,

  可以看到打印的和配置的是一样的,证明自定义的自动配置类成功,就是说自定义starter成功。

    本文从”mybatis-spring-boot-starter“开始,分析了一个starter的组成部分,然后总结了常用的starter,重点是实现了一个自定义的starter,并成功获取到自定义的配置。

    1、starter包含要注入的类的依赖及自定配置模块(XX-spring-boot-autoconfigure);

    2、自动配置模块(XX-spring-boot-autoconfigure)包含自动配置类及spring.factories文件;

  

    不知道小伙伴对springboot如何实现自动配置好奇吗,我们下期见。

  以上就是我的第一个springboot starter(我的第一个果子是酸的这个故事告诉我们什么)的详细内容,想要了解更多 我的第一个springboot starter的内容,请持续关注盛行IT软件开发工作室。

郑重声明:本文由网友发布,不代表盛行IT的观点,版权归原作者所有,仅为传播更多信息之目的,如有侵权请联系,我们将第一时间修改或删除,多谢。

留言与评论(共有 条评论)
   
验证码: