三、插件体外扩展机制(E-Spi)
插件体外扩展机制,简称:E-Spi。用于解决 fatjar 模式部署时的扩展需求。比如:
- 把一些“业务模块”做成插件包放到体外
- 把数据源配置文件放到体外,方便后续修改
其中, .properties 或 .yml 文件都会做为扩展配置加载,.jar 文件会做为插件包加载。
1、特点说明
- 所有插件包共享ClassLoader、AppContext、配置
- 可以打包成一个独立的插件包(放在体外加载),也可以与主程序一起打包。“分”或“合”自由!
- 更新体外插件包或配置文件后,需要重启主服务
- E-Spi 是由内核直接提供的支持,不需要其它依赖
- 一起打包的插件,区别不大。加载时机一样
2、操作说明
- 应用属性文件添加扩展目录配置
目录需要手动创建
#申明扩展目录为 demo_ext(没有时,不会异常)
solon.extend: "demo_ext"
也可以,目录自动创建。不同的场景可以不同选择
#申明扩展目录为 demo_ext(加!开头,表示自动创建)
solon.extend: "!demo_ext"
- 文件放置关系
将一个应用的数据源配置放在扩展目录,以便后续修改,部署效果:
demo.jar
demo_ext/_db.properties
再将一个用户频道或者领域模块做为插件包,部署效果:
demo.jar
demo_ext/_db.properties
demo_ext/demo_user.jar
demo_ext/demo_order.jar
3、插件包注意事项
- 要么把插件包打成 fatjar(使用 《maven-assembly-plugin 打胖包》 )
- 要么把插件包的依赖打进主应用里,特别的是公共的依赖(推荐)
最好,是把公共依赖放到主应用打包。在插件 pom.xml 里标为可选。