nacos client for rust

Go to file

caihongwen 52c1e6f33a chore: println for develop now		2022-09-07 21:22:07 +08:00
.github/workflows	CI actions/checkout@v2 -> actions/checkout@v3	2022-07-09 17:44:26 +08:00
proto	init cargo nacos rust-lib & proto build with `tonic-build`	2022-07-08 20:14:44 +08:00
src	chore: println for develop now	2022-09-07 21:22:07 +08:00
.gitignore	init cargo nacos rust-lib & proto build with `tonic-build`	2022-07-08 20:14:44 +08:00
Cargo.toml	chore: println for develop now	2022-09-07 21:22:07 +08:00
LICENSE	Initial commit	2022-07-08 19:13:30 +08:00
README.md	README.md rich 主要依赖包，简要描述 client & server 的交互	2022-07-09 17:44:35 +08:00
build.rs	fix: tonic_build.disable_package_emission() fix gRPC path	2022-09-06 00:17:42 +08:00

README.md

nacos-sdk-rust

Nacos client in Rust

开发说明

Build with cargo build

Note: The proto buf client generation is built into cargo build process so updating the proto files under proto/ is enough to update the proto buf client.

请 cargo fmt 格式化代码再提交

主要依赖包

在 nacos-sdk-rust 工程里，为主要功能的实现，将会引入以下依赖包。

serde-rs/serde 一个超高性能的通用序列化/反序列化框架，可以跟多种协议的库联合使用，实现统一编解码格式；serde-rs/json 快到上天的 JSON 库，也是 Rust 事实上的标准 JSON
hyperium/tonic 纯 Rust 实现的 gRPC 客户端和服务器端，支持 async/await 异步调用，文档和示例较为清晰
tokio-rs/prost tokio 出品的 Protocol Buffers 工具，简单易用，文档详细
tokio-rs/tokio 最火的异步网络库，除了复杂上手难度高一些外，没有其它大的问题。同时 tokio 团队提供了多个非常优秀的 Rust 库，整个生态欣欣向荣，用户认可度很高
tokio-rs/tracing 强大的日志框架，同时还支持 OpenTelemetry 格式，无缝打通未来的监控

Tip：Rust 入门推荐 Rust语言圣经(Rust Course)

简要描述 client & server 的交互

请关注 proto/nacos_grpc_service.proto 并知晓经过 tonic-build 构建出客户端侧的 stub，实现同步调用 service Request.request()，流式交互 service BiRequestStream.requestBiStream()。

tonic 创建与 Nacos-server 的 gRPC 双工长链接，serde/json 适配与 server 的交互序列化；

gRPC 交互的 Payload 和 Metadata 由 Protocol Buffers 序列化，具体的 Request/Response 实体 json 格式二进制数据维护于 Payload.body，类型名字符串维护于 Metadata.type (为 java 全类名)。

有了 gRPC 双工长链接，也有了数据序列化方式，那么就是对 Request/Response 的处理逻辑啦；而 client 会接受 server 的主动调用，故可以实现一个通用的 RequestHandler 接受 server 的请求，根据 Request 类型分发到具体的处理实现并返回对应的 Response。

而 client 请求 server 的部分，则 do it ...

以上交互务必参考 java nacos-client 和 nacos-server 的实现。

Config 配置交互

TODO List-Watch 机制

Naming 注册交互