14 releases
0.2.2 | Nov 27, 2024 |
---|---|
0.2.1 | Nov 10, 2024 |
0.1.9 | Oct 21, 2024 |
0.1.8 | Sep 21, 2024 |
0.1.1 | Jul 30, 2024 |
#266 in Procedural macros
373 downloads per month
Used in quic-rpc-wrap
30KB
583 lines
quic-rpc库的高级封装
介绍
quic-rpc-wrap通过属性宏的方式简化quic-rpc的实现,消除了所有不必要的模板代码。 编写一次服务端的实现,自动生成客户端方法的存根,与本地函数调用几乎没有差异。
特点
- 支持一对一请求和响应;
- 支持客户端流模式;
- 支持服务端流模式;
- 支持客户端和服务端的双向流模式;
- 支持模块化,可用于生产环境;
- 高性能,支持quic协议(http3)、http2协议和内存传输,其中quic协议比http2性能提升了30%;
- 人体工程学的设计,代码整洁,使用简单。
运行示例
简单的内存传输示例
cargo run --package quic-rpc-example --bin flume --features server,client,flume
HTTP2协议传输示例
cargo run --package quic-rpc-example --bin hyper --features server,client,hyper
QUIC协议传输示例
cargo run --package quic-rpc-example --bin quinn --features server,client,quinn
如果启用server
特性,则会生成服务端模板代码;
如果启用client
特性,则会生成客户端模板代码。
运行测试
cargo test
关于证书
如果您的应用使用了QUIC协议传输,在调试过程中可能会比较困难,我们增加了一个可以生成自签名证书的cargo扩展,以便于您在开发环境中使用。 如果想要生成证书文件,首先需要安装cargo扩展程序:
cargo install quic-rpc-wrap
然后可以使用下面的命令来生成自签名证书文件:
cargo server-cert gen -n localhost -n your.domain -c /path/to/your_cert.crt -k /path/to/your/private_key.key
如果想要获取命令的帮助,可以运行:
cargo server-cert gen -h
Dependencies
~270–720KB
~17K SLoC