Water（水孕育万物...）

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

功能相当于：consul + rabbitmq + elk + prometheus + openFaas + quartz + 等等，并有机结合在一起。 或者约等于：nacos + rocketmq + PlumeLog + prometheus + magic-api + xxl-job + 等。

对 k8s 友好，支持 ip 漂移、支持 k8s service 映射（通过上游配置，可直接将服务发现为 k8s service 地址）。

本次更新

• solon 升级为: 2.2.16
• snack3 升级为：3.2.66
• wood 升级为：1.1.1
• water.client 增加版本号做为头信息上传
• waterapi 增加版本号做为头信息输出
• 修复国际化导出json时，有[]的会错乱
• 配置管理/应用属性 增加 label ，做为内部显示分组
• 应用监视 调整时间间隔

快速入门

了解开发框架与镜像

控制台功能

控制台演示站

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

关键持久化说明：

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

项目地址

• https://gitee.com/noear/water
• https://github.com/noear/water

代码演示

(1) 配置

• pom.xml / mevan 配置

<!-- 客户端版本 -->
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>water.client</artifactId>
    <version>2.10.4</version>
</dependency>

<!-- solon cloud 集成版本 （也可用于 Spring Boot 项目） -->
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>water-solon-cloud-plugin</artifactId>
    <version>2.2.16</version>
</dependency>

• app.yml / 配置说明

solon.app:
  name: "demo-api"
  group: "demo"

solon.cloud.water:
  server: "waterapi:9371"    #WATER服务地址
  config:
    load: "demo.yml"         #默认加载的配置

(2) 代码

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

//监控服务：之：添加接口性能记录
@Component(index = -999)
public class AppFilter implements Filter {
    static Logger log = LoggerFactory.getLogger(DemoApp.class);
    @Override
    public void doFilter(Context ctx, FilterChain chain) throws Throwable {
        //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);
        }
    }
}

@Configuration
public class DemoConfig {

    @Bean
    public DataSource db1(@CloudConfig("demoDb") HikariDataSource ds) {
        //配置一个数据源
        return ds;
    }
    
    @Bean
    public I18nBundleFactory i18nBundleFactory(){
        //将国际化服务，切换为云端接口
        return new CloudI18nBundleFactory();
    }
}

@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 handle(Event event) throws Exception {
        //处理消息...
        log.info("我收到消息：" + event.content());
        return true;
    }
}


//配置订阅：关注配置的实时更新
@CloudConfig("demoDb")
public class TestConfigHandler implements CloudConfigHandler {
    @Override
    public void handle(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("我被调度了");
    }
}