Water（水孕育万物…）

Water 为项目开发、服务治理，提供一站式解决方案（可以理解为微服务架构支持套件）。基于 Solon 框架开发，并支持完整的 Solon Cloud 规范；已在生产环境跑了4年。

功能约等于：consul + rabbitmq + elk + prometheus + openFaas + quartz 等一些别的功能，并有机结合在一起。

本次更新

• 服务 watersev，子级服务增加各自的注册。从而形成子级服务的集群

  • 服务 watersev-pln，可自由集群，并让每个任务分布到集群中运行
  • 服务 watersev-mot，可自由集群，并让每个任务分布到集群中运行
  • 服务 watersev-msgexg，可自由集群，并分解borker到不同节点上
  • 服务 watersev-msgdis，可自由集群，并分解borker到不同节点上
  • 服务 watersev-sevchk，取消启动时需要 reset 的逻辑

• 服务 wateradmin

  • 增加服务规模、消息主题规模设置，从而自动调整控制台布局

• 服务 waterapi

  • 镜像端口改为：9371
  • 优化日志记录格式，强调输出输出概念和上下文随带

• 服务 waterraas

  • 端口改为：9375 （之前为：9376）

• 服务 waterpaas

  • 更名为：waterfaas

• 调整 PaaS 概念，将同时包含：FaaS + RaaS

  • FaaS 调整：

    • 数据表 paas_file 更名：luffy_file。强调FaaS自身的代号
    • 数据表 paas_etl 更名：luffy_etl
    • 管理后台 /paas/ 开头的路径，改为 /luffy/开头
    • 配置 paas_uri 更名为：faas_uri

• 安全名单，增加 token 的模式支持

快速入门

了解开发框架与镜像

| --- | --- |

| 开发框架 | |

| org.noear:water.client | 框架：Water 客户端 |

| org.noear:water-solon-plugin | 框架：Water 客户端 for solon（也可用于 Spring Boot 项目） |

| 镜像 | |

| noearorg/waterapi | 镜像：Water 主接口服务 |

| noearorg/watersev | 镜像：Water 后台服务（健康检测；数据监视；消息派发；定时任务等…） |

| noearorg/wateradmin | 镜像：Water 管理控制台（支持LDAP登录） |

| noearorg/waterfaas | 镜像：Water 即时接口服务，提供轻量级FaaS接口服务 |

| noearorg/waterraas | 镜像：Water 规则计算服务，提供轻量级规则计算服务 |

控制台演示站

地址： http://water.noear.org （账号：demo ；密码：demo ）

关键持久化说明：

• 日志持久化，支持：MySql、PostgreSQL、MongoDb、ElasticSearch、ClickHouse
• 消息持久化，支持：MySql、PostgreSQL、MongoDb

代码演示

(1) 配置

• pom.xml / mevan 配置

  org.noear water.client ${water.ver}

  org.noear water-solon-plugin ${solon.ver}

• application.yml / 配置说明

  solon.app:
  name: "wateradmin"
  group: "water"

  solon.cloud.water:
  server: "waterapi:9371" #WATER服务地址
  config:
  load: "test.properties" #默认加载的配置
  log:
  default: "water_log_admin" #默认日志记录器

(2) 代码

public class DemoApp {
    public void main(String[] args) {
        SolonApp app = Solon.start(DemoApp.class, args);

        //监控服务：之：添加接口性能记录（一般这个过滤器写成独立类）
        Logger log = LoggerFactory.getLogger(DemoApp.class);
        app.filter((ctx, chain) -> {
            //1.开始计时（用于计算响应时长）
            long start = System.currentTimeMillis();

            try {
                chain.doFilter(ctx);
            } catch (Throwable e) {
                //2.顺带记录个异常
                log.error("{}",e);
            } finally {
                //3.获得接口响应时长
                long milliseconds = System.currentTimeMillis() - start;
                CloudClient.metric().addMeter(Solon.cfg().appName(), "path", ctx.pathNew(), milliseconds);
            }
        });
    }
}

@Slf4j
@Controller
public class DemoController{
    @CloudConfig(name = "demoDb", autoRefreshed = true)  //配置服务的功能（注解模式）
    DbContext demoDb;

    @NamiClient            //RPC服务发现的功能（注解模式）
    RockService rockService;

    @Mapping("/")
    public void test(){
        //日志服务：写个日志
        log.info("你好，日志服务"); //(content)
        TagsMDC.tag0("demo");
        log.error("{}\r\n{}","test","你好，日志服务"); //(tag,summary,content)

        //配置服务：使用配置的数据库上下文进行查询
        Map map = demoDb.table("water_reg_service").limit(1).selectMap("*");

        //消息服务：发送消息
        CloudClient.event().publish(new Event("demo.test", "{\"order_id\":1}")); //（非注解模式）

        //Rpc发现服务：调用Rpc接口
        AppModel app = rockService.getAppById(12);
    }
}

//消息订阅：订阅消息并处理（根据：topic 进行订阅）
@Slf4j
@CloudEvent("demo.test")
public class Event_demo_test implements CloudEventHandler {
    @Override
    public boolean handler(Event event) throws Exception {
        //处理消息...
        log.info("我收到消息：" + event.content());
        return true;
    }
}

//配置订阅：关注配置的实时更新
@CloudConfig("demoDb")
public class TestConfigHandler implements CloudConfigHandler {
    @Override
    public void handler(Config config) {

    }
}

//分布式任务
@CloudJob(name = "demo_test", cron7x = "0 1 * * * ?")
public class Job_test implements CloudJobHandler {

    @Override
    public void handle(Context ctx) throws Throwable {
        //处理任务...
        log.info("我被调度了");
    }
}