Struct IoHandler

pub struct IoHandler<M: Metadata = ()>(/* private fields */);

Simplified IoHandler with no Metadata associated with each request.

Implementations

impl IoHandler

pub fn new() -> Self

Creates new IoHandler without any metadata.

Examples found in repository

examples/basic.rs (line 4)

fn main() {
	let mut io = IoHandler::new();

	io.add_sync_method("say_hello", |_: Params| Ok(Value::String("Hello World!".to_owned())));

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"hello","id":1}"#;

	assert_eq!(io.handle_request_sync(request), Some(response.to_owned()));
}

examples/async.rs (line 5)

fn main() {
	futures_executor::block_on(async {
		let mut io = IoHandler::new();

		io.add_method("say_hello", |_: Params| async {
			Ok(Value::String("Hello World!".to_owned()))
		});

		let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
		let response = r#"{"jsonrpc":"2.0","result":"hello","id":1}"#;

		assert_eq!(io.handle_request(request).await, Some(response.to_owned()));
	});
}

examples/params.rs (line 10)

fn main() {
	let mut io = IoHandler::new();

	io.add_method("say_hello", |params: Params| async move {
		let parsed: HelloParams = params.parse().unwrap();
		Ok(Value::String(format!("hello, {}", parsed.name)))
	});

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": { "name": "world" }, "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"hello, world","id":1}"#;

	assert_eq!(io.handle_request_sync(request), Some(response.to_owned()));
}

pub fn with_compatibility(compatibility: Compatibility) -> Self

Creates new IoHandler without any metadata compatible with specified protocol version.

impl<M: Metadata + Default> IoHandler<M>

pub fn handle_request( &self, request: &str, ) -> FutureResult<FutureResponse, FutureOutput>

Handle given string request asynchronously.

Examples found in repository

examples/async.rs (line 14)

fn main() {
	futures_executor::block_on(async {
		let mut io = IoHandler::new();

		io.add_method("say_hello", |_: Params| async {
			Ok(Value::String("Hello World!".to_owned()))
		});

		let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
		let response = r#"{"jsonrpc":"2.0","result":"hello","id":1}"#;

		assert_eq!(io.handle_request(request).await, Some(response.to_owned()));
	});
}

pub fn handle_rpc_request( &self, request: Request, ) -> FutureRpcResult<FutureResponse, FutureOutput>

Handle deserialized RPC request asynchronously.

pub fn handle_call( &self, call: Call, ) -> Either<FutureOutput, Either<FutureOutput, Ready<Option<Output>>>>

Handle single Call asynchronously.

pub fn handle_request_sync(&self, request: &str) -> Option<String>

Handle given request synchronously - will block until response is available. If you have any asynchronous methods in your RPC it is much wiser to use handle_request instead and deal with asynchronous requests in a non-blocking fashion.

Examples found in repository

examples/basic.rs (line 11)

fn main() {
	let mut io = IoHandler::new();

	io.add_sync_method("say_hello", |_: Params| Ok(Value::String("Hello World!".to_owned())));

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"hello","id":1}"#;

	assert_eq!(io.handle_request_sync(request), Some(response.to_owned()));
}

examples/params.rs (line 20)

fn main() {
	let mut io = IoHandler::new();

	io.add_method("say_hello", |params: Params| async move {
		let parsed: HelloParams = params.parse().unwrap();
		Ok(Value::String(format!("hello, {}", parsed.name)))
	});

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": { "name": "world" }, "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"hello, world","id":1}"#;

	assert_eq!(io.handle_request_sync(request), Some(response.to_owned()));
}

Methods from Deref<Target = MetaIoHandler<M>>

pub fn add_alias(&mut self, alias: &str, other: &str)

Adds an alias to a method.

pub fn add_sync_method<F>(&mut self, name: &str, method: F)

where F: RpcMethodSync,

Adds new supported synchronous method.

A backward-compatible wrapper.

Examples found in repository

examples/basic.rs (line 6)

fn main() {
	let mut io = IoHandler::new();

	io.add_sync_method("say_hello", |_: Params| Ok(Value::String("Hello World!".to_owned())));

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"hello","id":1}"#;

	assert_eq!(io.handle_request_sync(request), Some(response.to_owned()));
}

pub fn add_method<F>(&mut self, name: &str, method: F)

where F: RpcMethodSimple,

Adds new supported asynchronous method.

Examples found in repository

examples/async.rs (lines 7-9)

fn main() {
	futures_executor::block_on(async {
		let mut io = IoHandler::new();

		io.add_method("say_hello", |_: Params| async {
			Ok(Value::String("Hello World!".to_owned()))
		});

		let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
		let response = r#"{"jsonrpc":"2.0","result":"hello","id":1}"#;

		assert_eq!(io.handle_request(request).await, Some(response.to_owned()));
	});
}

examples/params.rs (lines 12-15)

fn main() {
	let mut io = IoHandler::new();

	io.add_method("say_hello", |params: Params| async move {
		let parsed: HelloParams = params.parse().unwrap();
		Ok(Value::String(format!("hello, {}", parsed.name)))
	});

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": { "name": "world" }, "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"hello, world","id":1}"#;

	assert_eq!(io.handle_request_sync(request), Some(response.to_owned()));
}

pub fn add_notification<F>(&mut self, name: &str, notification: F)

where F: RpcNotificationSimple,

Adds new supported notification

pub fn add_method_with_meta<F>(&mut self, name: &str, method: F)

where F: RpcMethod<T>,

Adds new supported asynchronous method with metadata support.

Examples found in repository

examples/meta.rs (lines 10-12)

pub fn main() {
	let mut io = MetaIoHandler::default();

	io.add_method_with_meta("say_hello", |_params: Params, meta: Meta| async move {
		Ok(Value::String(format!("Hello World: {}", meta.0)))
	});

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"Hello World: 5","id":1}"#;

	let headers = 5;
	assert_eq!(
		io.handle_request_sync(request, Meta(headers)),
		Some(response.to_owned())
	);
}

examples/middlewares.rs (lines 36-38)

pub fn main() {
	let mut io = MetaIoHandler::with_middleware(MyMiddleware::default());

	io.add_method_with_meta("say_hello", |_params: Params, meta: Meta| async move {
		Ok(Value::String(format!("Hello World: {}", meta.0)))
	});

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"Hello World: 5","id":1}"#;

	let headers = 5;
	assert_eq!(
		io.handle_request_sync(request, Meta(headers)),
		Some(response.to_owned())
	);
}

pub fn add_notification_with_meta<F>(&mut self, name: &str, notification: F)

where F: RpcNotification<T>,

Adds new supported notification with metadata support.

pub fn extend_with<F>(&mut self, methods: F)

where F: IntoIterator<Item = (String, RemoteProcedure<T>)>,

Extend this MetaIoHandler with methods defined elsewhere.

pub fn handle_request_sync(&self, request: &str, meta: T) -> Option<String>

Handle given request synchronously - will block until response is available. If you have any asynchronous methods in your RPC it is much wiser to use handle_request instead and deal with asynchronous requests in a non-blocking fashion.

Examples found in repository

examples/meta.rs (line 19)

pub fn main() {
	let mut io = MetaIoHandler::default();

	io.add_method_with_meta("say_hello", |_params: Params, meta: Meta| async move {
		Ok(Value::String(format!("Hello World: {}", meta.0)))
	});

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"Hello World: 5","id":1}"#;

	let headers = 5;
	assert_eq!(
		io.handle_request_sync(request, Meta(headers)),
		Some(response.to_owned())
	);
}

examples/middlewares.rs (line 45)

pub fn main() {
	let mut io = MetaIoHandler::with_middleware(MyMiddleware::default());

	io.add_method_with_meta("say_hello", |_params: Params, meta: Meta| async move {
		Ok(Value::String(format!("Hello World: {}", meta.0)))
	});

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"Hello World: 5","id":1}"#;

	let headers = 5;
	assert_eq!(
		io.handle_request_sync(request, Meta(headers)),
		Some(response.to_owned())
	);
}

pub fn handle_request( &self, request: &str, meta: T, ) -> FutureResult<S::Future, S::CallFuture>

Handle given request asynchronously.

pub fn handle_rpc_request( &self, request: Request, meta: T, ) -> FutureRpcResult<S::Future, S::CallFuture>

Handle deserialized RPC request.

pub fn handle_call( &self, call: Call, meta: T, ) -> Either<S::CallFuture, Either<FutureOutput, Ready<Option<Output>>>>

Handle single call asynchronously.

pub fn iter(&self) -> impl Iterator<Item = (&String, &RemoteProcedure<T>)>

Returns an iterator visiting all methods in arbitrary order.

Trait Implementations

impl<M: Clone + Metadata> Clone for IoHandler<M>

fn clone(&self) -> IoHandler<M>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<M: Debug + Metadata> Debug for IoHandler<M>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<M: Default + Metadata> Default for IoHandler<M>

fn default() -> IoHandler<M>

Returns the “default value” for a type.

impl<M: Metadata> Deref for IoHandler<M>

type Target = MetaIoHandler<M>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<M: Metadata> DerefMut for IoHandler<M>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl From<IoHandler> for MetaIoHandler<()>

fn from(io: IoHandler) -> Self

Converts to this type from the input type.

impl<T: Metadata> IntoIterator for IoHandler<T>

type Item = <MetaIoHandler<T> as IntoIterator>::Item

The type of the elements being iterated over.

type IntoIter = <MetaIoHandler<T> as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<M: Metadata> IoHandlerExtension<M> for IoHandler<M>

fn augment<S: Middleware<M>>(self, handler: &mut MetaIoHandler<M, S>)

Extend given handler with additional methods.