Water(水孕育萬物...)
Water 為專案開發、服務治理,提供一站式解決方案(可以理解為微服務架構支援套件)。基於 Solon 框架開發,並支援完整的 Solon Cloud 規範;已在生產環境奔跑了4年。
功能約等於:consul + rabbitmq + elk + prometheus + openFaas + quartz 等一些別的功能,並有機結合在一起。
本次更新
- 許可權系統由舊的bcf框架切換為grit框架
- /run/、/msg/ 開頭的觸發規則統一為:/_run/ 開頭
- 助理工具 wateraide 更名為:xwater
- 增加 通過令牌安全模式,獲取服務執行時狀態
- 取消 getDistributionListByMsg 介面快取,避免造成訊息重派
- 修復 行為記錄時,沒有記錄行為者的ip問題(涉及water.client更新)
- 取消 映象統一埠8080,改為各自不衝突埠
- 升級 solon, snack3, weed3
- 升級 redisx,支援 user 配置(無用的user要去掉了)
- 日誌服務的 es 方案,由別名方案改為 data steam 模式
快速入門
瞭解開發框架與映象
| --- | --- |
| 開發框架 | |
| 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 配置
<!-- 客戶端版本 -->
<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: "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("我被排程了");
}
}