快速开始

使用 Rust 快速开发 Dubbo 服务。

请在此查看完整 示例。

1 前置条件

2 使用 IDL 定义 Dubbo 服务

Greeter 服务定义如下，包含一个 Unary(request-response) 模型的 Dubbo 服务。

  1. // ./proto/greeter.proto
  2. syntax = "proto3";
  4. option java_multiple_files = true;
  6. package org.apache.dubbo.sample.tri;
  9. // The request message containing the user's name.
  10. message GreeterRequest {
  11.   string name = 1;
  12. }
  14. // The response message containing the greetings
  15. message GreeterReply {
  16.   string message = 1;
  17. }
  19. service Greeter{
  20.   // unary
  21.   rpc greet(GreeterRequest) returns (GreeterReply);
  22. }

3 添加 Dubbo-rust 及相关依赖到项目

  1. # ./Cargo.toml
  2. [package]
  3. name = "example-greeter"
  4. version = "0.1.0"
  5. edition = "2021"
  7. [[bin]]
  8. name = "greeter-server"
  9. path = "src/greeter/server.rs"
  11. [[bin]]
  12. name = "greeter-client"
  13. path = "src/greeter/client.rs"
  15. [dependencies]
  16. http = "0.2"
  17. http-body = "0.4.4"
  18. futures-util = {version = "0.3", default-features = false}
  19. tokio = { version = "1.0", features = [ "rt-multi-thread", "time", "fs", "macros", "net", "signal"] }
  20. prost-derive = {version = "0.10", optional = true}
  21. prost = "0.10.4"
  22. async-trait = "0.1.56"
  23. tokio-stream = "0.1"
  25. dubbo = "0.1.0"
  26. dubbo-config = "0.1.0"
  28. [build-dependencies]
  29. dubbo-build = "0.1.0"

4 配置 dubbo-build 编译 IDL

在项目根目录创建 (not /src)，创建 build.rs 文件并添加以下内容：

  1. // ./build.rs
  2. fn main() {
  3.     dubbo_build::prost::configure()
  4.         .compile(&["proto/greeter.proto"], &["proto/"])
  5.         .unwrap();
  6. }

这样配置之后，编译项目就可以生成 Dubbo Stub 相关代码，路径一般在./target/debug/build/example-greeter-<id>/out/org.apache.dubbo.sample.tri.rs。

5 编写 Dubbo 业务代码

5.1 编写 Dubbo Server

  1. // ./src/greeter/server.rs
  2. use ...
  4. #[tokio::main]
  5. async fn main() {
  6.     register_server(GreeterServerImpl {
  7.         name: "greeter".to_string(),
  8.     });
  10.     // Dubbo::new().start().await;
  11.     Dubbo::new()
  12.         .with_config({
  13.             let r = RootConfig::new();
  14.             match r.load() {
  15.                 Ok(config) => config,
  16.                 Err(_err) => panic!("err: {:?}", _err), // response was droped
  17.             }
  18.         })
  19.         .start()
  20.         .await;
  21. }
  23. #[allow(dead_code)]
  24. #[derive(Default, Clone)]
  25. struct GreeterServerImpl {
  26.     name: String,
  27. }
  29. // #[async_trait]
  30. #[async_trait]
  31. impl Greeter for GreeterServerImpl {
  32.     async fn greet(
  33.         &self,
  34.         request: Request<GreeterRequest>,
  35.     ) -> Result<Response<GreeterReply>, dubbo::status::Status> {
  36.         println!("GreeterServer::greet {:?}", request.metadata);
  38.         Ok(Response::new(GreeterReply {
  39.             message: "hello, dubbo-rust".to_string(),
  40.         }))
  41.     }
  42. }

5.2 配置dubbo.yaml

dubbo.yaml指示server端的配置，包括暴露的服务列表、协议配置、监听配置等。

  1. # ./dubbo.yaml
  2. name: dubbo
  3. service:
  4.   org.apache.dubbo.sample.tri.Greeter:
  5.     version: 1.0.0
  6.     group: test
  7.     protocol: triple
  8.     registry: ''
  9.     serializer: json
  10.     protocol_configs:
  11.       triple:
  12.         ip: 0.0.0.0
  13.         port: '8888'
  14.         name: triple
  15. protocols:
  16.   triple:
  17.     ip: 0.0.0.0
  18.     port: '8888'
  19.     name: triple

5.3 编写 Dubbo Client

  1. // ./src/greeter/client.rs
  2. use ...
  4. #[tokio::main]
  5. async fn main() {
  6.     let mut cli = GreeterClient::new().with_uri("http://127.0.0.1:8888".to_string());
  8.     println!("# unary call");
  9.     let resp = cli
  10.         .greet(Request::new(GreeterRequest {
  11.             name: "message from client".to_string(),
  12.         }))
  13.         .await;
  14.     let resp = match resp {
  15.         Ok(resp) => resp,
  16.         Err(err) => return println!("{:?}", err),
  17.     };
  18.     let (_parts, body) = resp.into_parts();
  19.     println!("Response: {:?}", body);
  20. }

6 运行并总结

  1. 编译

执行cargo build来编译server和client。

  1. 运行server

执行./target/debug/greeter-server来运行server，如上文dubbo.yaml所配置，server会监听8888端口，并以triple协议提供RPC服务：

  1. $ ./target/debug/greeter-server
  2. 2022-09-28T23:33:28.104577Z  INFO dubbo::framework: url: Some(Url { uri: "triple://0.0.0.0:8888/org.apache.dubbo.sample.tri.Greeter", protocol: "triple", location: "0.0.0.0:8888", ip: "0.0.0.0", port: "8888", service_key: ["org.apache.dubbo.sample.tri.Greeter"], params: {} })
  1. 运行client，验证调用是否成功

执行./target/debug/greeter-client来运行client，调用triple://127.0.0.1:8888/org.apache.dubbo.sample.tri.Greeter下的各种方法：

  1. $ ./target/debug/greeter-client
  2. Response: GreeterReply { message: "hello, dubbo-rust" }

7 更多示例

Streaming 通信模式

使用 Dubbo Rust 实现 Streaming 通信模型。

与 Dubbo Java 互通

实现与其他 Dubbo 多语言服务的互通

最后修改 September 13, 2024: Refactor website structure (#2860) (1a4b998f54b)