溫馨提示×

您好，登錄后才能下訂單哦！

密碼登錄×
登錄注冊(cè)×
其他方式登錄
點(diǎn)擊 登錄注冊(cè) 即表示同意《億速云用戶服務(wù)條款》

SpringBoot2.1.x,實(shí)現(xiàn)創(chuàng)建自己的spring-boot-starter自動(dòng)配置模塊

發(fā)布時(shí)間：2020-11-03 16:05:31 來源：億速云 閱讀：201 作者：Leah 欄目：開發(fā)技術(shù)

SpringBoot2.1.x,實(shí)現(xiàn)創(chuàng)建自己的spring-boot-starter自動(dòng)配置模塊？相信很多沒有經(jīng)驗(yàn)的人對(duì)此束手無策，為此本文總結(jié)了問題出現(xiàn)的原因和解決方法，通過這篇文章希望你能解決這個(gè)問題。

一）spring-boot-starter命名規(guī)則

自動(dòng)配置模塊命名規(guī)則：xxx-spring-boot，如：aspectlog-spring-boot

啟動(dòng)器命名規(guī)則：xxx-spring-boot-starter，如：aspectlog-spring-boot-starter

如兩者只有一個(gè)模塊：建議以xxx-spring-boot-starter方式命名。

springboot建議以xxx前綴的方式對(duì)自己的自動(dòng)配置命名的。

二）spring-boot-starter條件注解

注解說明
@ConditionalOnClass指定加載的類
@ConditionalOnMissingClass指定不加載的類
@ConditionalOnBean指定需要加載的bean
@ConditionalOnMissingBean指定不需要加載的bean
@ConditionalOnProperty指定加載配置文件中的屬性，如yml或properties文件
@ConditionalOnResource檢查特定的資源是否存在，如：file:/home/user/test.dat
@ConditionalOnExpression使用SpEL表達(dá)式

該文章使用@ConditionalOnProperty注解實(shí)現(xiàn)。

三）創(chuàng)建自己的aspectlog-spring-boot-starter日志打印自動(dòng)配置模塊

第一步：創(chuàng)建一個(gè)aspectlog-spring-boot-starter名稱的maven項(xiàng)目

在pom.xml文件中引入springboot相應(yīng)jar

<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>com.oysept</groupId>
 <artifactId>aspectlog-spring-boot-starter</artifactId>
 <version>0.0.1-SNAPSHOT</version>
 
 <!-- springboot版本信息 -->
 <parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>2.1.4.RELEASE</version>
 </parent>
 
 <properties>
  <java.version>1.8</java.version>
 </properties>
 
 <dependencies>
  <dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-autoconfigure</artifactId>
  </dependency>
 
  <dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-aop</artifactId>
  </dependency>
 
  <!-- 自定義配置 -->
  <dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-configuration-processor</artifactId>
   <optional>true</optional>
  </dependency>
 </dependencies>
</project>

spring-boot-configuration-processor作用：會(huì)在源數(shù)據(jù)文件（META-INF/spring-autoconfigure-metadata.properties）中自動(dòng)掃描加載和自動(dòng)配置有關(guān)的條件。也就是說，當(dāng)編寫starter時(shí)，會(huì)讀取自動(dòng)配置的條件，寫入源數(shù)據(jù)文件中。

第二步：定義一個(gè)AspectLog注解類

該注解作用于方法上，并在運(yùn)行時(shí)啟用

package com.oysept.autoconfiguration.aspectlog;
 
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
 
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface AspectLog {
	
}

第三步：創(chuàng)建一個(gè)AspectLogProperties類，用于加載yml或properties中的屬性

package com.oysept.autoconfiguration.aspectlog; 
import org.springframework.boot.context.properties.ConfigurationProperties; 
@ConfigurationProperties("aspectlog")
public class AspectLogProperties {
 
 private boolean enable;
 
 public boolean isEnable() {
  return enable;
 }
 
 public void setEnable(boolean enable) {
  this.enable = enable;
 }
}

第四步：創(chuàng)建一個(gè)AspectLogAutoConfiguration打印日志自動(dòng)配置類

package com.oysept.autoconfiguration.aspectlog;
 
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.EnableAspectJAutoProxy;
import org.springframework.core.PriorityOrdered;
 
@Aspect
@EnableAspectJAutoProxy(exposeProxy = true, proxyTargetClass = true)
@Configuration
@ConditionalOnProperty(prefix="aspectlog", name = "enable", havingValue = "true", matchIfMissing = true)
public class AspectLogAutoConfiguration implements PriorityOrdered {
 
 protected Logger logger = LoggerFactory.getLogger(getClass());
 
 @Around("@annotation(com.oysept.autoconfiguration.aspectlog.AspectLog) ")
 public Object isOpen(ProceedingJoinPoint thisJoinPoint) throws Throwable {
  //執(zhí)行方法名稱 
  String taskName = thisJoinPoint.getSignature()
   .toString().substring(
    thisJoinPoint.getSignature()
     .toString().indexOf(" "), 
     thisJoinPoint.getSignature().toString().indexOf("("));
  taskName = taskName.trim();
  long time = System.currentTimeMillis();
  Object result = thisJoinPoint.proceed();
  logger.info("==>aspectlog method:{} run :{} ms", taskName, (System.currentTimeMillis() - time));
  return result;
 }
 
 @Override
 public int getOrder() {
  //保證事務(wù)等切面先執(zhí)行
  return Integer.MAX_VALUE;
 }
}

注解說明：

@ConditionalOnProperty(prefix = "aspectLog", name = "enable",havingValue = "true", matchIfMissing = true)

當(dāng)yml或properties配置文件中有aspectLog.enable=true時(shí)開啟，如果配置文件沒有設(shè)置aspectLog.enable也開啟。

第五步：創(chuàng)建spring.factories文件，該文件是springboot規(guī)定的配置文件，把自動(dòng)配置類按規(guī)則配置

先在src/main/resources下創(chuàng)建一個(gè)META-INF文件夾，然后在文件夾下創(chuàng)建spring.factories

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\

com.oysept.autoconfiguration.aspectlog.AspectLogAutoConfiguration

META-INF/spring.factories是spring的工廠機(jī)制，在這個(gè)文件中定義的類，都會(huì)被自動(dòng)加載。多個(gè)配置使用逗號(hào)分割，換行用\

第六步：使用mvn install方式把該模塊自動(dòng)打包

SpringBoot2.1.x,實(shí)現(xiàn)創(chuàng)建自己的spring-boot-starter自動(dòng)配置模塊

四）測(cè)試aspectlog-spring-boot-starter打印日志配置

另外創(chuàng)建一個(gè)springboot_starter_test名稱的maven項(xiàng)目

在pom中引入aspectlog-spring-boot-starter的jar

<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>com.oysept</groupId>
 <artifactId>springboot_starter_test</artifactId>
 <version>0.0.1-SNAPSHOT</version>
 <packaging>jar</packaging>
 
 <parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>2.1.4.RELEASE</version>
  <relativePath/>
 </parent>
 
 <properties>
  <java.version>1.8</java.version>
 </properties>
 
 <dependencies>
  <dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  
  <!-- 引入自定義aspectlog-spring-boot-starter 打印日志jar -->
  <dependency>
   <groupId>com.oysept</groupId>
   <artifactId>aspectlog-spring-boot-starter</artifactId>
   <version>0.0.1-SNAPSHOT</version>
  </dependency>
 </dependencies>
 
 <!-- maven打包插件,在cmd命令窗口執(zhí)行,如: mvn install -U -->
 <build>
  <plugins>
   <plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
   </plugin>
  </plugins>
 </build>
</project>

創(chuàng)建一個(gè)application.yml，配置啟動(dòng)的端口，默認(rèn)是8080

server:

port: 8080

創(chuàng)建application啟動(dòng)類

package com.oysept;
 
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
 
@SpringBootApplication
public class TestSpringBootStarterApplication {
 
 public static void main(String[] args) {
  SpringApplication.run(TestSpringBootStarterApplication.class, args);
 }
}

創(chuàng)建測(cè)試AspectLog功能controller

package com.oysept.controller; 
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController; 
import com.oysept.autoconfiguration.aspectlog.AspectLog; 
@RestController
public class GetController {
 
 /**
  * 訪問地址: http://localhost:8080/test/starter/aspectlog&#63;param=TTTEEESSSTTT
  * @return
  */
 @AspectLog
 @RequestMapping(value="/test/starter/aspectlog", method = RequestMethod.GET)
 public String testStarterAspectLog(@RequestParam(value = "param") String param) {
  System.out.println("==>/test/starter/aspectlog, param: " + param);
 
  // 處理業(yè)務(wù)邏輯
  return "/test/starter/aspectlog SUCCESS!";
 }
}

在想要打印日志的方法上，使用@AspectLog注解

啟動(dòng)TestSpringBootStarterApplication中的main方法

在瀏覽器中輸入：http://localhost:8080/test/starter/aspectlog&#63;param=TTTEEESSSTTT

然后在控制臺(tái)查看效果：

SpringBoot2.1.x,實(shí)現(xiàn)創(chuàng)建自己的spring-boot-starter自動(dòng)配置模塊

看完上述內(nèi)容，你們掌握SpringBoot2.1.x,實(shí)現(xiàn)創(chuàng)建自己的spring-boot-starter自動(dòng)配置模塊的方法了嗎？如果還想學(xué)到更多技能或想了解更多相關(guān)內(nèi)容，歡迎關(guān)注億速云行業(yè)資訊頻道，感謝各位的閱讀！

向AI問一下細(xì)節(jié)

免責(zé)聲明：本站發(fā)布的內(nèi)容（圖片、視頻和文字）以原創(chuàng)、轉(zhuǎn)載和分享為主，文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng)，如果涉及侵權(quán)請(qǐng)聯(lián)系站長(zhǎng)郵箱：is@yisu.com進(jìn)行舉報(bào)，并提供相關(guān)證據(jù)，一經(jīng)查實(shí)，將立刻刪除涉嫌侵權(quán)內(nèi)容。

AI
助
手