Struct rmp_rpc::Endpoint [−][src]
pub struct Endpoint<S: ServiceWithClient, T: AsyncRead + AsyncWrite> { /* fields omitted */ }
A Future
for running both a client and a server at the same time.
The client part will be provided to the
ServiceWithClient::handle_request
and
ServiceWithClient::handle_notification
methods,
so that the server can send back requests and notifications as part of its handling duties. You
may also access the client with the client()
method if you want to send
additional requests.
The returned future needs to be spawned onto a task in order to actually run the server (and the client). It will run until the stream is closed; if the stream encounters an error, the future will propagate it and terminate.
extern crate futures; extern crate rmp_rpc; extern crate tokio; use futures::{Future, Stream}; use rmp_rpc::ServiceWithClient; use std::net::SocketAddr; use tokio::net::TcpListener; struct MyService; impl ServiceWithClient for MyService { // ... } fn main() { let addr: SocketAddr = "127.0.0.1:54321".parse().unwrap(); // Here's the simplest version: we listen for incoming TCP connections and run an // endpoint on each one. let server = TcpListener::bind(&addr).unwrap() .incoming() // Each time the listener finds a new connection, start up an endpoint to handle // it. .map_err(|e| println!("error on TcpListener: {}", e)) .for_each(move |stream| { Endpoint::new(stream, MyService).map_err(|e| println!("error on endpoint {}", e)) }); // Uncomment this to run the server on the tokio event loop. This is blocking. // Press ^C to stop // tokio::run(server); // Here's an alternative, where we take a handle to the client and spawn the endpoint // on its own task. let addr: SocketAddr = "127.0.0.1:65432".parse().unwrap(); let server = TcpListener::bind(&addr) .unwrap() .incoming() .map_err(|e| println!("error on TcpListener: {}", e)) .for_each(move |stream| { let end = Endpoint::new(stream, MyService); let client = end.client(); // Spawn the endpoint. It will do its own thing, while we can use the client // to send requests. tokio::spawn(end.map_err(|_| ())); // Send a request with method name "hello" and argument "world!". client .request("hello", &["world!".into()]) .map(|response| println!("{:?}", response)) .map_err(|e| println!("got an error: {:?}", e)) // We're returning the future that came from `client.request`. This means that // `server` (and therefore our entire program) will terminate once the // response is received and the messages are printed. If you wanted to keep // the endpoint running even after the response is received, you could // (instead of spawning `end` on its own task) `join` the two futures (i.e. // `end` and the one returned by `client.request`). }); // Uncomment this to run the server on the tokio event loop. This is blocking. // Press ^C to stop // tokio::run(server); }
Methods
impl<S: ServiceWithClient, T: AsyncRead + AsyncWrite> Endpoint<S, T>
[src]
impl<S: ServiceWithClient, T: AsyncRead + AsyncWrite> Endpoint<S, T>
pub fn new(stream: T, service: S) -> Self
[src]
pub fn new(stream: T, service: S) -> Self
Creates a new Endpoint
on stream
, using service
to handle requests and notifications.
pub fn client(&self) -> Client
[src]
pub fn client(&self) -> Client
Returns a handle to the client half of this Endpoint
, which can be used for sending
requests and notifications.
Trait Implementations
impl<S: ServiceWithClient, T: AsyncRead + AsyncWrite> Future for Endpoint<S, T>
[src]
impl<S: ServiceWithClient, T: AsyncRead + AsyncWrite> Future for Endpoint<S, T>
type Item = ()
The type of value that this future will resolved with if it is successful. Read more
type Error = Error
The type of error that this future will resolve with if it fails in a normal fashion. Read more
fn poll(&mut self) -> Poll<Self::Item, Self::Error>
[src]
fn poll(&mut self) -> Poll<Self::Item, Self::Error>
Query this future to see if its value has become available, registering interest if it is not. Read more
fn wait(self) -> Result<Self::Item, Self::Error>
[src]
fn wait(self) -> Result<Self::Item, Self::Error>
Block the current thread until this future is resolved. Read more
fn map<F, U>(self, f: F) -> Map<Self, F> where
F: FnOnce(Self::Item) -> U,
[src]
fn map<F, U>(self, f: F) -> Map<Self, F> where
F: FnOnce(Self::Item) -> U,
Map this future's result to a different type, returning a new future of the resulting type. Read more
fn map_err<F, E>(self, f: F) -> MapErr<Self, F> where
F: FnOnce(Self::Error) -> E,
[src]
fn map_err<F, E>(self, f: F) -> MapErr<Self, F> where
F: FnOnce(Self::Error) -> E,
Map this future's error to a different error, returning a new future. Read more
fn from_err<E>(self) -> FromErr<Self, E> where
E: From<Self::Error>,
[src]
fn from_err<E>(self) -> FromErr<Self, E> where
E: From<Self::Error>,
Map this future's error to any error implementing From
for this future's Error
, returning a new future. Read more
fn then<F, B>(self, f: F) -> Then<Self, B, F> where
B: IntoFuture,
F: FnOnce(Result<Self::Item, Self::Error>) -> B,
[src]
fn then<F, B>(self, f: F) -> Then<Self, B, F> where
B: IntoFuture,
F: FnOnce(Result<Self::Item, Self::Error>) -> B,
Chain on a computation for when a future finished, passing the result of the future to the provided closure f
. Read more
fn and_then<F, B>(self, f: F) -> AndThen<Self, B, F> where
B: IntoFuture<Error = Self::Error>,
F: FnOnce(Self::Item) -> B,
[src]
fn and_then<F, B>(self, f: F) -> AndThen<Self, B, F> where
B: IntoFuture<Error = Self::Error>,
F: FnOnce(Self::Item) -> B,
Execute another future after this one has resolved successfully. Read more
fn or_else<F, B>(self, f: F) -> OrElse<Self, B, F> where
B: IntoFuture<Item = Self::Item>,
F: FnOnce(Self::Error) -> B,
[src]
fn or_else<F, B>(self, f: F) -> OrElse<Self, B, F> where
B: IntoFuture<Item = Self::Item>,
F: FnOnce(Self::Error) -> B,
Execute another future if this one resolves with an error. Read more
fn select<B>(self, other: B) -> Select<Self, <B as IntoFuture>::Future> where
B: IntoFuture<Item = Self::Item, Error = Self::Error>,
[src]
fn select<B>(self, other: B) -> Select<Self, <B as IntoFuture>::Future> where
B: IntoFuture<Item = Self::Item, Error = Self::Error>,
Waits for either one of two futures to complete. Read more
fn select2<B>(self, other: B) -> Select2<Self, <B as IntoFuture>::Future> where
B: IntoFuture,
[src]
fn select2<B>(self, other: B) -> Select2<Self, <B as IntoFuture>::Future> where
B: IntoFuture,
Waits for either one of two differently-typed futures to complete. Read more
fn join<B>(self, other: B) -> Join<Self, <B as IntoFuture>::Future> where
B: IntoFuture<Error = Self::Error>,
[src]
fn join<B>(self, other: B) -> Join<Self, <B as IntoFuture>::Future> where
B: IntoFuture<Error = Self::Error>,
Joins the result of two futures, waiting for them both to complete. Read more
fn join3<B, C>(
self,
b: B,
c: C
) -> Join3<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future> where
B: IntoFuture<Error = Self::Error>,
C: IntoFuture<Error = Self::Error>,
[src]
fn join3<B, C>(
self,
b: B,
c: C
) -> Join3<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future> where
B: IntoFuture<Error = Self::Error>,
C: IntoFuture<Error = Self::Error>,
Same as join
, but with more futures.
fn join4<B, C, D>(
self,
b: B,
c: C,
d: D
) -> Join4<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future, <D as IntoFuture>::Future> where
B: IntoFuture<Error = Self::Error>,
C: IntoFuture<Error = Self::Error>,
D: IntoFuture<Error = Self::Error>,
[src]
fn join4<B, C, D>(
self,
b: B,
c: C,
d: D
) -> Join4<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future, <D as IntoFuture>::Future> where
B: IntoFuture<Error = Self::Error>,
C: IntoFuture<Error = Self::Error>,
D: IntoFuture<Error = Self::Error>,
Same as join
, but with more futures.
fn join5<B, C, D, E>(
self,
b: B,
c: C,
d: D,
e: E
) -> Join5<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future, <D as IntoFuture>::Future, <E as IntoFuture>::Future> where
B: IntoFuture<Error = Self::Error>,
C: IntoFuture<Error = Self::Error>,
D: IntoFuture<Error = Self::Error>,
E: IntoFuture<Error = Self::Error>,
[src]
fn join5<B, C, D, E>(
self,
b: B,
c: C,
d: D,
e: E
) -> Join5<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future, <D as IntoFuture>::Future, <E as IntoFuture>::Future> where
B: IntoFuture<Error = Self::Error>,
C: IntoFuture<Error = Self::Error>,
D: IntoFuture<Error = Self::Error>,
E: IntoFuture<Error = Self::Error>,
Same as join
, but with more futures.
fn into_stream(self) -> IntoStream<Self>
[src]
fn into_stream(self) -> IntoStream<Self>
Convert this future into a single element stream. Read more
fn flatten(self) -> Flatten<Self> where
Self::Item: IntoFuture,
<Self::Item as IntoFuture>::Error: From<Self::Error>,
[src]
fn flatten(self) -> Flatten<Self> where
Self::Item: IntoFuture,
<Self::Item as IntoFuture>::Error: From<Self::Error>,
Flatten the execution of this future when the successful result of this future is itself another future. Read more
fn flatten_stream(self) -> FlattenStream<Self> where
Self::Item: Stream,
<Self::Item as Stream>::Error == Self::Error,
[src]
fn flatten_stream(self) -> FlattenStream<Self> where
Self::Item: Stream,
<Self::Item as Stream>::Error == Self::Error,
Flatten the execution of this future when the successful result of this future is a stream. Read more
fn fuse(self) -> Fuse<Self>
[src]
fn fuse(self) -> Fuse<Self>
Fuse a future such that poll
will never again be called once it has completed. Read more
fn inspect<F>(self, f: F) -> Inspect<Self, F> where
F: FnOnce(&Self::Item),
[src]
fn inspect<F>(self, f: F) -> Inspect<Self, F> where
F: FnOnce(&Self::Item),
Do something with the item of a future, passing it on. Read more
fn catch_unwind(self) -> CatchUnwind<Self> where
Self: UnwindSafe,
[src]
fn catch_unwind(self) -> CatchUnwind<Self> where
Self: UnwindSafe,
Catches unwinding panics while polling the future. Read more
Create a cloneable handle to this future where all handles will resolve to the same result. Read more