Springboot集成Springbrick實現(xiàn)動態(tài)插件的步驟詳解
spring-boot集成spring-brick實現(xiàn)動態(tài)插件
項目結(jié)構(gòu) & 需求實現(xiàn)
提示:本文的集成說明,是針對完成此設(shè)計、此需求進行的
項目結(jié)構(gòu)
demo
│
├─application # 主應(yīng)用
│
└─plugin-api
│
├─plugin-qwer # plugin-qwer-api的實現(xiàn)示例1(注:也可以是單獨的一個項目,繼承不繼承plugin-api均可)
│
├─plugin-qwer2 # plugin-qwer-api的實現(xiàn)示例2(注:也可以是單獨的一個項目,繼承不繼承plugin-api均可)
│
├─plugin-qwer-api # 插件qwer-api
│
├─plugin-xyz # plugin-xyz-api的實現(xiàn)示例(注:也可以是單獨的一個項目,繼承不繼承plugin-api均可)
│
└─plugin-xyz-api # 插件xyz-api
需求實現(xiàn)
主應(yīng)用(application)、各個插件的實現(xiàn)(plugin-qwer、plugin-qwer2、plugin-xyz)均可單獨啟動
主應(yīng)用(application)啟動后,可動態(tài)插拔各插件(plugin-qwer、plugin-qwer2、plugin-xyz)
在plugin-api中,定義各種接口、及相關(guān)的pojo,這些接口由具體的插件實現(xiàn)去完成,主應(yīng)用(application)面向plugin-api編程即可
spring-boot集成spring-brick
環(huán)境說明
- spring-boot:2.6.13
- spring-brick:3.1.1
1. 主程序集成spring-brick
第一步:引入相關(guān)依賴
<dependency>
<groupId>com.gitee.starblues</groupId>
<artifactId>spring-brick</artifactId>
<version>3.1.1</version>
</dependency>第二步:修改程序入口方法
import com.gitee.starblues.loader.launcher.SpringBootstrap;
import com.gitee.starblues.loader.launcher.SpringMainBootstrap;
import com.ideaaedi.commonspring.annotation.EnableParameterRecorder;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
/**
* main-application start class
*/
@SpringBootApplication
public class MainApplication implements SpringBootstrap {
public static void main(String[] args) {
// 這里使用 SpringMainBootstrap 引導(dǎo)啟動
SpringMainBootstrap.launch(MainApplication.class, args);
}
@Override
public void run(String[] args) throws Exception {
// 這里的寫法和SpringBoot 啟動保持一致
SpringApplication.run(MainApplication.class, args);
}
}第三步:編寫配置
plugin:
# 運行模式, 開發(fā)環(huán)境: dev; 生產(chǎn)環(huán)境: prod
runMode: prod
# 主程序包名, 包名建議設(shè)置到范圍最大級別,能包含主程序所有類的包名范圍
mainPackage: com.example.springbrick.application
# 插件的路徑, 可配置多個, 開發(fā)環(huán)境下配置為插件模塊上級目錄; 生產(chǎn)環(huán)境下配置到插件jar包存放目錄。
# 可使用~符號表示相對目錄,比如:~/plugins,開發(fā)環(huán)境相對于開發(fā)根目錄,生產(chǎn)環(huán)境下相對于主程序jar所在目錄
pluginPath:
- C:/Users/Administrator/Desktop/plugin第四步:設(shè)置maven插件
<!-- 本人引入此插件后,去除了spring-boot自身的打包插件 -->
<plugin>
<groupId>com.gitee.starblues</groupId>
<artifactId>spring-brick-maven-packager</artifactId>
<version>3.1.1</version>
<configuration>
<mode>main</mode>
<mainConfig>
<!-- 指定main -->
<mainClass>com.example.springbrick.application.MainApplication</mainClass>
<packageType>jar</packageType>
</mainConfig>
</configuration>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>2. 準備plugin-api
第一步:引入相關(guān)依賴
<dependency>
<groupId>com.gitee.starblues</groupId>
<artifactId>spring-brick</artifactId>
<version>3.1.1</version>
<!-- 這里指定為provided即可,主程序中已經(jīng)存在此artifact了 -->
<scope>provided</scope>
</dependency>第二步:引入相關(guān)依賴
注意:各plugin-api的包名,應(yīng)該處于主程序包名(本人這里為plugin.mainPackage=com.example.springbrick.application)的子集。如果不這樣設(shè)置的話,主程序和插件實現(xiàn)程序加載plugin-api中的類時,將被類加載器隔離
根據(jù)自己業(yè)務(wù)需要,定義業(yè)務(wù)接口及相關(guān)pojo即可,如:

3. 實現(xiàn)plugin-api
提示:各plugin-api的實現(xiàn)程序,繼承不繼承父類plugin-api都可以
第一步:引入相關(guān)依賴
- 架構(gòu)級依賴
<!-- 引入要實現(xiàn)的plugin-api -->
<dependency>
<groupId>com.example</groupId>
<artifactId>plugin-xyz-api</artifactId>
<version>1.0.0</version>
</dependency>
<!-- 引入spring-brick-bootstrap以完成插件的引導(dǎo) -->
<dependency>
<groupId>com.gitee.starblues</groupId>
<artifactId>spring-brick-bootstrap</artifactId>
<version>3.1.1</version>
</dependency>
<!-- 和主程序引入同樣的spring-brick,不過這里需要設(shè)置為provided -->
<dependency>
<groupId>com.gitee.starblues</groupId>
<artifactId>spring-brick</artifactId>
<version>3.1.1</version>
<scope>provided</scope>
</dependency>- 業(yè)務(wù)級依賴
<!-- spring-boot-starter依賴 -->
<!--建議將spring-boot-starter依賴放到第一個位置, 以防止出現(xiàn)依賴沖突導(dǎo)致無法啟動插件-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
<version>2.6.13</version>
</dependency>
<!-- spring-boot-starter-web依賴. 當(dāng)插件需要獨立啟動時,需要引入此插件。但是當(dāng)要打包成插件前,需要去除此依賴(因為主程序中已經(jīng)存在此依賴了) -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>2.6.13</version>
<scope>test</scope>
</dependency>第二步:修改程序入口方法
import com.gitee.starblues.bootstrap.SpringPluginBootstrap;
import org.springframework.boot.autoconfigure.SpringBootApplication;
/**
* plugin start class
*/
@SpringBootApplication
public class PluginXyzApplication extends SpringPluginBootstrap {
public static void main(String[] args) {
new PluginXyzApplication().run(args);
}
}第三步:設(shè)置maven插件
<!-- 本人引入此插件后,去除了spring-boot自身的打包插件 -->
<plugin>
<groupId>com.gitee.starblues</groupId>
<artifactId>spring-brick-maven-packager</artifactId>
<version>3.1.1</version>
<configuration>
<!--當(dāng)前打包模式為: 開發(fā)模式-->
<mode>prod</mode>
<!--插件信息定義-->
<pluginInfo>
<!--插件id-->
<id>plugin-xyz</id>
<!--插件入口類, 定義說明見: 定義插件入口類-->
<bootstrapClass>com.example.springbrick.plugin.xyz.PluginXyzApplication</bootstrapClass>
<!--插件版本號-->
<version>1.0.0</version>
</pluginInfo>
</configuration>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>4. 測試驗證
提示:本人這里進行簡單驗證說明,更多驗證可以去文末下載源碼,自己跑起來后完成驗證
- 第一步:打包所有插件實現(xiàn),然后放到主程序配置文件中(
plugin.pluginPath)指定的插件位置

- 第二步:啟動主程序
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.6.13)
2023-06-07 15:27:55.223 INFO 20520 --- [ Thread-0] c.g.s.l.launcher.SpringMainBootstrap : Starting SpringMainBootstrap using Java 17.0.3.1 on WIN-E500OMQS07D with PID 20520 (D:\maven\repository\com\gitee\starblues\spring-brick-loader\3.1.1\spring-brick-loader-3.1.1.jar started by Administrator in D:\working\demo)
2023-06-07 15:27:55.224 INFO 20520 --- [ Thread-0] c.g.s.l.launcher.SpringMainBootstrap : No active profile set, falling back to 1 default profile: "default"
2023-06-07 15:27:55.430 INFO 20520 --- [ Thread-0] c.i.c.aop.ParameterRecorderRegistrar : registry spring-bean parameterRecorder with ConstructorArg includePrefixes -> [], excludePrefixes -> [], parameterHandleMode -> USE_JSON, pretty -> true, ignoreParamTypes -> []
2023-06-07 15:27:55.902 INFO 20520 --- [ Thread-0] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http)
2023-06-07 15:27:55.909 INFO 20520 --- [ Thread-0] o.apache.catalina.core.StandardService : Starting service [Tomcat]
2023-06-07 15:27:55.909 INFO 20520 --- [ Thread-0] org.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/9.0.68]
2023-06-07 15:27:55.990 INFO 20520 --- [ Thread-0] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext
2023-06-07 15:27:55.990 INFO 20520 --- [ Thread-0] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 737 ms
2023-06-07 15:27:56.246 INFO 20520 --- [ Thread-0] c.i.commonspring.aop.ParameterRecorder : Set LocalVariableTableParameterNameDiscoverer as parameterNameDiscoverer.
2023-06-07 15:27:56.358 INFO 20520 --- [ Thread-0] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path ''
2023-06-07 15:27:56.364 INFO 20520 --- [ Thread-0] c.g.s.l.launcher.SpringMainBootstrap : Started SpringMainBootstrap in 1.377 seconds (JVM running for 1.736)
2023-06-07 15:27:56.367 INFO 20520 --- [ Thread-0] c.g.s.i.operator.DefaultPluginOperator : 插件加載環(huán)境: prod
2023-06-07 15:27:56.367 INFO 20520 --- [ Thread-0] c.g.s.i.operator.DefaultPluginOperator : 插件加載模式: isolation
2023-06-07 15:27:56.367 INFO 20520 --- [ Thread-0] c.g.s.i.operator.DefaultPluginOperator : 開始加載插件, 插件根路徑為:
C:/Users/Administrator/Desktop/plugin
2023-06-07 15:27:56.367 INFO 20520 --- [ Thread-0] c.g.s.s.web.PluginStaticResourceConfig : 插件靜態(tài)資源訪問前綴配置為: /static-plugin/{pluginId}
2023-06-07 15:27:56.382 INFO 20520 --- [ Thread-0] c.g.starblues.core.DefaultPluginManager : 插件[plugin-qwer@1.0.0]加載成功
2023-06-07 15:27:56.383 INFO 20520 --- [ Thread-0] c.g.starblues.core.DefaultPluginManager : 插件[plugin-qwer2@1.0.0]加載成功
2023-06-07 15:27:56.384 INFO 20520 --- [ Thread-0] c.g.starblues.core.DefaultPluginManager : 插件[plugin-xyz@1.0.0]加載成功
2023-06-07 15:27:57.446 INFO 20520 --- [ Thread-0] c.g.s.b.ConfigurePluginEnvironment : Plugin[plugin-qwer@1.0.0] No active profile set, falling back to default profiles : default
2023-06-07 15:27:57.785 INFO 20520 --- [ Thread-0] c.g.starblues.core.DefaultPluginManager : 插件[plugin-qwer@1.0.0]啟動成功
2023-06-07 15:27:58.690 INFO 20520 --- [ Thread-0] c.g.s.b.ConfigurePluginEnvironment : Plugin[plugin-qwer2@1.0.0] No active profile set, falling back to default profiles : default
2023-06-07 15:27:59.033 INFO 20520 --- [ Thread-0] c.g.starblues.core.DefaultPluginManager : 插件[plugin-qwer2@1.0.0]啟動成功
2023-06-07 15:27:59.938 INFO 20520 --- [ Thread-0] c.g.s.b.ConfigurePluginEnvironment : Plugin[plugin-xyz@1.0.0] No active profile set, falling back to default profiles : default
2023-06-07 15:28:00.233 INFO 20520 --- [ Thread-0] c.g.starblues.core.DefaultPluginManager : 插件[plugin-xyz@1.0.0]啟動成功
2023-06-07 15:28:00.234 INFO 20520 --- [ Thread-0] c.g.s.i.operator.DefaultPluginOperator : 插件初始化完成訪問測試類,觀察控制臺輸出
測試類長這樣,訪問
localhost:8080/demo/hello-world接口即可
import com.example.springbrick.application.helper.DynamicClass;
import com.example.springbrick.application.plugin.api.qwer.QwerService;
import com.example.springbrick.application.plugin.api.xyz.XyzService;
import com.example.springbrick.application.plugin.api.xyz.entity.IdInfo;
import com.example.springbrick.application.plugin.api.xyz.entity.User;
import com.gitee.starblues.integration.user.PluginUser;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
import java.time.LocalDateTime;
import java.util.Map;
/**
* 動態(tài)插件支持
*/
@RestController
@RequestMapping("/demo")
public class DemoController {
@Resource
private PluginUser pluginUser;
@GetMapping("hello-world")
public void helloWorld() {
User user = new User();
user.setName("張三");
user.setBirthday(LocalDateTime.now());
IdInfo idInfo = new IdInfo();
idInfo.setIdNumber("12345");
idInfo.setExt("non");
user.setIdInfo(idInfo);
/* ------------------------------ 示例1 ------------------------------ */
QwerService qwerService = pluginUser.getBeanByInterface("plugin-qwer", QwerService.class).get(0);
System.err.println(qwerService.helloWorld());
System.err.println(qwerService.helloWorld123("sdfsd"));
XyzService xyzService = pluginUser.getBeanByInterface("plugin-xyz", XyzService.class).get(0);
xyzService.helloWorld();
System.err.println(xyzService.userInfo(user));
System.err.println();
System.err.println();
/* ------------------------------ 示例2 ------------------------------ */
Map<String, Object> pluginBean = pluginUser.getBean(QwerService.BEAN_NAME, false).getPluginBean();
pluginBean.forEach((pluginId, springBean) -> {
System.err.println(pluginId + " " + DynamicClass.exec(springBean, QwerService::helloWorld));
System.err.println(pluginId + " " + DynamicClass.exec(springBean, QwerService.EMPTY_INSTANCE::helloWorld123, "123"));
});
pluginBean = pluginUser.getBean(XyzService.BEAN_NAME, false).getPluginBean();
pluginBean.forEach((pluginId, springBean) -> {
DynamicClass.exec(springBean, XyzService::helloWorld);
System.err.println(pluginId + " " + DynamicClass.exec(springBean, XyzService.EMPTY_INSTANCE::userInfo, user));
});
}
}- 控制臺輸出

以上就是Springboot集成Springbrick實現(xiàn)動態(tài)插件的步驟詳解的詳細內(nèi)容,更多關(guān)于Springboot集成Springbrick 動態(tài)插件的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
SpringCloud maven-assembly-plugin 多級目錄打包的實現(xiàn)
本文主要介紹了SpringCloud maven-assembly-plugin 多級目錄打包的實現(xiàn),文中通過示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下2021-10-10
Java 確保某個Bean類被最后執(zhí)行的幾種實現(xiàn)方式
這篇文章主要介紹了Java 確保某個BeanDefinitionRegistryPostProcessor Bean被最后執(zhí)行的幾種實現(xiàn)方式,幫助大家更好的理解和學(xué)習(xí)使用Java,感興趣的朋友可以了解下2021-03-03
Java實現(xiàn)Excel導(dǎo)入導(dǎo)出數(shù)據(jù)庫的方法示例
這篇文章主要介紹了Java實現(xiàn)Excel導(dǎo)入導(dǎo)出數(shù)據(jù)庫的方法,結(jié)合實例形式分析了java針對Excel的讀寫及數(shù)據(jù)庫操作相關(guān)實現(xiàn)技巧,需要的朋友可以參考下2017-08-08
javaweb Servlet開發(fā)總結(jié)(一)
Servlet是sun公司提供的一門用于開發(fā)動態(tài)web資源的技術(shù)。這篇文章主要介紹了javaweb Servlet開發(fā)的第一篇,感興趣的小伙伴們可以參考一下2016-05-05

