Struct Builder

pub struct Builder<C, S> { /* private fields */ }

This struct allows one to configure the RPC interface prior to creating it. To get an instance of this struct, call Builder<C, S>::new with an Interface.

Implementations

impl Builder<(), ()>

pub fn new(interface: Interface) -> Self

Create a new builder from an Interface

impl<C> Builder<C, ()>

pub fn with_service<S: Service>( self, implementation: impl Into<S>, ) -> Builder<C, S>

Configure the RPC interface with a service that implements methods that can be called from the other side of the channel. To use this method, you need to specify the type S which is the service type generated by the attribute macro service. The implementation parameter is then an instance of something that implements the trait to which to applied the service macro. For example, if you have a trait Calculator to which you have applied service, you would use this method as follows:

struct CalculatorServiceImpl;
impl Calculator for CalculatorServiceImpl { /* add Calculator's methods */}
let server = Builder::new(some_interface)
    .with_service<CalculatorService<_>>(CalculatorServiceImpl)
    .build();

impl<S> Builder<(), S>

pub fn with_client<C: Client>(self) -> Builder<C, S>

Configure the RPC interface with a client that allows you to execute RPCs on the server. The builder will automatically instansiate the client for you, you just need to provide the type which is generated via the service attribute macro. For example, if you had a trait Calculator to which you applied the service attribute macro, the macro would have generated a CalculatorClient struct which you can use as the C in this function.

impl<C> Builder<C, ()>

where C: Client + From<Configuration<C::Request, C::Response>> + 'static, <C as Client>::Response: DeserializeOwned, <C as Client>::Request: Serialize,

pub fn build(self) -> C

Build function for client-only RPC interfaces.

impl<S> Builder<(), S>

where S: Service + 'static, <S as Service>::Request: DeserializeOwned, <S as Service>::Response: Serialize,

pub fn build(self) -> Server

Build function for server-only RPC interfaces.

impl<C, S> Builder<C, S>

where C: Client + From<Configuration<C::Request, C::Response>> + 'static, S: Service + 'static, <S as Service>::Request: DeserializeOwned, <S as Service>::Response: Serialize, <C as Client>::Request: Serialize, <C as Client>::Response: DeserializeOwned,

pub fn build(self) -> (C, Server)

Build function for client-server RPC interfaces.