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 地址)
本次更新
优化框架任务 speed_sync_date,speed_sync_hour,speed_sync 执行性能(提高几倍)
优化框架任务 log_stat_sync 执行性能(提高几倍)
函数计算增加事务控制快捷接口, XUtil.tran((=>{ ... }
solon 升级为: 2.1.3
snack3 升级为:3.2.53
grit 升级为:1.5.0
rock 升级为:2.6.0
luffy 升级为:1.5.1
快速入门
了解开发框架与镜像
组件 | 说明 |
---|---|
开发框架 | |
org.noear:water.client | 框架:Water 客户端 |
org.noear:water-solon-plugin | 框架:Water 客户端 for solon(也可用于 Spring Boot 项目) |
镜像 | |
noearorg/waterapi:2.10.0 | 镜像:Water 主接口服务 |
noearorg/watersev:2.10.0 | 镜像:Water 后台服务(健康检测;数据监视;消息派发;定时任务等...) |
noearorg/wateradmin:2.10.0 | 镜像:Water 管理控制台(支持LDAP登录) |
noearorg/waterfaas:2.10.0 | 镜像:Water 即时接口服务,提供轻量级FaaS接口服务 |
noearorg/xwater:2.10.0 | 构建:Water 助理工具 |
控制台功能
控制台演示站
地址: (账号: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.0</version>
</dependency>
<!-- solon cloud 集成版本 (也可用于 Spring Boot 项目) -->
<dependency>
<groupId>org.noear</groupId>
<artifactId>water-solon-cloud-plugin</artifactId>
<version>2.1.3</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("我被调度了";
}
}