1个稳定版本

15.0.0 2020年11月9日

#1073 in HTTP服务器

MIT 许可证

190KB
5.5K SLoC

jsonrpc-http-server

Rust使用JSON-RPC 2.0的HTTP服务器。

文档

示例

Cargo.toml

[dependencies]
jsonrpc-http-server = "15.0"

main.rs

use jsonrpc_http_server::*;
use jsonrpc_http_server::jsonrpc_core::*;

fn main() {
	let mut io = IoHandler::default();
	io.add_method("say_hello", |_| {
		Ok(Value::String("hello".into()))
	});

	let server = ServerBuilder::new(io)
		.cors(DomainsValidation::AllowOnly(vec![AccessControlAllowOrigin::Null]))
		.start_http(&"127.0.0.1:3030".parse().unwrap())
		.expect("Unable to start RPC server");

	server.wait();
}

您现在可以在一个终端中运行以下命令来测试上述服务器:cargo run,并在另一个终端中向您的服务器发出以下POST请求

$ curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "say_hello", "id":123 }' 127.0.0.1:3030

服务器将响应以下内容

{"jsonrpc":"2.0","result":"hello","id":123}

如果您省略上述任何字段或调用不同的方法,您将收到一个有用的错误消息

$ curl -X POST -H "Content-Type: application/json" -d '{"method": "say_hello", "id":123 }' 127.0.0.1:3030
{"error":{"code":-32600,"message":"Unsupported JSON-RPC protocol version"},"id":123}
$ curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "say_bye", "id":123 }' 127.0.0.1:3030
{"jsonrpc":"2.0","error":{"code":-32601,"message":"Method not found"},"id":123}

依赖项

~15MB
~266K SLoC