Solon2 项目整合 Nacos 配置中心

网上关于 Nacos 的使用介绍已经很多了，尤其是与 SpringBoot 的整合使用。怎么安装也跳过了，主要就讲 Nacos 在 Solon 里的使用，这个网上几乎是没有的。

1、认识 Solon

Solon 一个高效的应用开发框架：更快、更小、更简单，也是个新起的 Java 生态。 启动快 5 ～ 10 倍；qps 高 2～ 3 倍；运行时内存节省 1/3 ~ 1/2；打包可以缩到 1/2 ~ 1/10；同时支持 jdk8, jdk11, jdk17, jdk19。

Solon 项目官网：https://solon.noear.org

2、认识 Solon Cloud Config

Solon Cloud 是一套分布式（或微服务）开发的接口与配置规范。其中 Solon Cloud Config 为云端配置服务，主要提供分布式配置服务的接口并与相关的中间件客户端进行适配：

• 通过 CloudConfigService 接口与中间件进行适配
• 使用 CloudClient.config () 获取适配实例，可支持手动操作
• 一般通过通过配置和 @CloudConfig 注解进行使用

其中 nacos-solon-cloud-plugin，是 nacos 关于 solon cloud config 的适配。也是本文的主角。

3、项目整合

3.1、在 Nacos 准备两个配置

安装好 Nacos 配置后，需要准备下配置数据。新建个 “test” 命名空间；然后，准备 DataId 为 “demoapp.yml” 配置（这个配置，用于导入到应用属性）：

demo.user.name: "1"

再准备 DataId 为 “demo-ds” 配置（这个配置，将直接使用）：

demo.ds:
  url: ""
  username: ""
  password: ""

3.2、创建项目，完成配置

借助 Solon Initializr（ https://solon.noear.org/start/ ） 生成一个 maven + java 的项目模块（这样方便些）。用开发工具打开项目（比如 IDEA）。在 pom.xml 里面添加依赖：

<dependencies>
    <dependency>
        <groupId>org.noear</groupId>
        <artifactId>nacos-solon-cloud-plugin</artifactId>
    </dependency>
</dependencies>

然后，在应用属性配置文件 “app.yml”，添加 nacos 的连接信息：

solon.app:
  name: "demoapp"
  group: "demo"
  namespace: "test"

solon.cloud.nacos:
  server: "localhost:8848"           #nacos 服务地址
  config:
    load: "demoapp.yml"                #加载配置到应用属性（多个以","隔开）

“...config.load” 会导入配置到应用属性。之后可用 “@Inject” 注入，也可用 “Solon.cfg().get (...)” 获取。

3.3、代码应用

在模板项目里，添加 "Config" 类：

@Configuration
public class Config {
    //注入用户名 //来自 config.load 导入到应用属性的
    @Inject("${demo.user.name}") 
    String userName;
    
    //注入并转为数据源 //直接来自 DataId = demo-ds
    @Bean
    public DataSource ds(@CloudConfig("demo-ds") HikariDataSource ds){
        return ds;
    }
}

直接获取 nacos 配置，可以通过 "@CloudConfig" 注解，或者 "CloudClient.config ().pull (group, name)" 手动获取。

4、多马甲项目的应用

很多情况下，公司会有相同的代码，但是不同的运营项目。这个场景下，自然是希望代码都不用改。

4.1、添加新的命名空间

在 Nacos 里，添加 “test2” 命名空间。然后把刚才的配置 DataId 复制一份。

4.2、修改项目应用配置

• 通过 app.yml 修改配置

solon.app:
  name: "demoapp"
  group: "demo"
  namespace: "test2"

solon.cloud.nacos:
  server: "localhost:8848"           #nacos 服务地址
  config:
    load: "demoapp.yml"                #加载配置到应用属性（多个以","隔开）

• 通过启动时指定（方式二）

java -Dsolon.app.namespace=test2 -jar demoapp.jar 

• 通过容器镜像的环境变量指定 （方式三）

services:
  demoapp:
    image: demo/demoapp:1.0.0
    container_name: demoapp
    environment:
      - solon.app.namespace=test2
      - TZ=Asia/Shanghai
    ports:
      - 8080:8080