Water 2.6.1 發佈，一站式服務治理平台

• 2022 年 4 月 19 日
• 筆記
• JAVA, solon, water, 一站式, 微服務, 服務治理

Water（水孕育萬物…）

Water 為項目開發、服務治理，提供一站式解決方案（可以理解為微服務架構支持套件）。基於 Solon 框架開發，並支持完整的 Solon Cloud 規範；已在生產環境奔跑了4年。

功能相當於：consul + rabbitmq + elk + prometheus + openFaas + quartz + 等等，並有機結合在一起。 或者約等於：nacos + rocketmq + PlumeLog + prometheus + magic-api + xxl-job + 等。

對 k8s 友好，支持 ip 漂移、支持 k8s service 映射。

本次更新

• 添加密鑰配置模塊
• 添加國際化配置模塊
• 添加客戶端多地址集群支持
• 優化日誌數據監控的線圖顯示
• 修復保存主題後界面錯亂的問題
• ConfigHandler::handler 更名為 handle
• DiscoverHandler::handler 更名為 handle
• MessageHandler::handler 更名為 handle
• WaterClient.job 更名為 Job
• solon 升級為：1.7.2（項目地址：//gitee.com/noear/solon）
• grit 升級為：1.1.1（項目地址：//gitee.com/noear/grit）
• weed3 升級為：3.4.22
• redisx 升級為：1.4.1（項目地址：//gitee.com/noear/redisx）
• snack3 升級為：3.2.20（項目地址：//gitee.com/noear/snack3）

快速入門

了解開發框架與鏡像

控制台演示站

地址： //water.noear.org （賬號：demo ；密碼：demo ）

關鍵持久化說明：

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

項目地址

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

代碼演示

(1) 配置

• pom.xml / mevan 配置

<!-- 客戶端版本 -->
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>water.client</artifactId>
    <version>${water.ver}</version>
</dependency>

<!-- solon cloud 集成版本 （也可用於 Spring Boot 項目） -->
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>water-solon-plugin</artifactId>
    <version>${solon.ver}</version>
</dependency>

• application.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);

        //監控服務：之：添加接口性能記錄（一般這個過濾器寫成獨立類）
        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);
            }
        });
    }
}

@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("我被調度了");
    }
}