README.md · leethomas/hades

![](https://p6-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/d640749c820d41c1b9d9846663fa56aa~tplv-k3u1fbpfcp-watermark.image?)

### hades 介绍

项目背景：业务开发逻辑变更频繁，一点小的修改都要发布系统，灵活度不够。对于一些**非核心流程又频繁改动**的部分是否可以用动态脚本替代？

核心功能：**Java应用无须发布上下线，即可动态变更业务逻辑**

### hades 技术原理

核心技术：Groovy+分布式配置中心(`apollo`/`nacos`)

![](https://p1-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/9dfc77529693487fad9dba07c6d09480~tplv-k3u1fbpfcp-watermark.image?)

技术原理：将`Groovy`脚本写在配置中心里，借助分布式配置中心监听配置功能，客户端能实时发现`Groovy`脚本变更。`hades`规则引擎将`Groovy`脚本解析后，放入`Spring IOC`容器中供客户端使用。

### hades 使用手册

1、引入maven依赖：
```xml

<dependency>
    <groupId>io.github.ZhongFuCheng3y</groupId>
    <artifactId>hades-apollo-starter</artifactId>
    <version>1.0.2</version>
</dependency>

<dependency>
    <groupId>io.github.ZhongFuCheng3y</groupId>
    <artifactId>hades-nacos-starter</artifactId>
    <version>1.0.2</version>
</dependency>

```

2、在接入`hades`规则引擎的项目配置文件中（如：`application.properties`）填写主配置的文件名

`nacos`分布式配置中心示例：

```properties

nacos.config.server-addr=austin.nacos:8848
nacos.config.username=nacos
nacos.config.password=nacos
nacos.config.namespace=9537c674-f3a6-4203-b286-ef0c36bfacb2
nacos.config.enabled=true

# heades param you should write
hades.main.config.enabled=true
hades.main.config.file-name=hades
hades.main.config.group-name=hades
```

`apollo`分布式配置中心示例：

```properties

app.id=austin
apollo.bootstrap.enabled=true
apollo.meta=austin-apollo

# heades param you should write
hades.main.config.enabled=true
hades.main.config.file-name=hades
```

3、在对应的分布式配置中心创建`hades`主配置，配置内容如下：

（注：`hades`所有的配置内容**在分布式配置中心**默认均为`txt`格式）

```json
{
    "instanceNames": [
        "TencentSmsService"
    ],
    "updateTime": "2023年3月20日10:26:0131"
}
```
说明：`hades`主要是监听以上配置的变更，当新增或修改了`Groovy`脚本时，需要**手动**更新该配置。

4、新建`Groovy`脚本，`apollo`需要跟**主配置**在同`appId`下，`nacos`在同`namespace`下。

**注：`Groovy`脚本跟`Java`代码99%相同（特别要注意`lambda`语法和`lombok`的问题，建议不写`lambda`）**

5、客户端使用`HadesClient`获取对象或执行方法

```java

private void test() {
    // 获取脚本对象，用接口接收
    SendSmsService sendSmsService = hadesClient.getInterfaceByName("TencentSmsService");
    sendSmsService.send();

// 获取GroovyObject对象
    GroovyObject groovyObject = hadesClient.getGroovyObjectByName("TencentSmsService");
    groovyObject.invokeMethod("send", null);
    log.info("groovy object:{}", groovyObject);

// 直接执行脚本对应的方法，得到返回值
    Object execute = hadesClient.execute("TencentSmsService", "send", null);
    System.out.println("result" + execute);
}

```

### hades 示例

`hades-apollo-example`和`hades-nacos-example`可用于调试

leethomas/hades

简介

发行版

贡献者

近期动态

leethomas/hades .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

leethomas/hades