Struct fizyr_rpc::PeerHandle[−][src]

pub struct PeerHandle<Body> { /* fields omitted */ }
Expand description

Handle to a peer.

The handle can be used to receive incoming requests and stream messages, and to send requests and stream messages.

When the handle is dropped, the peer loop is stopped. Any open requests will also be terminated.

Implementations

impl<Body> PeerHandle<Body>[src]

pub fn split(self) -> (PeerReadHandle<Body>, PeerWriteHandle<Body>)[src]

Split the peer in a read handle and a write handle.

Splitting the peer allows you to move both handles into different tasks.

The original handle is consumed, but the peer loop will keep going until all read and write handles are dropped.

pub async fn next_message(&mut self) -> Result<Incoming<Body>, RecvMessageError>[src]

Get the next request or stream message from the remote peer.

Errors for invalid incoming messages are also reported by this function. For example: incoming update messages that are not associated with a received request will be reported as an error here.

pub async fn send_request(
    &mut self,
    service_id: i32,
    body: impl Into<Body>
) -> Result<SentRequest<Body>, SendRequestError>[src]

Send a new request to the remote peer.

pub async fn send_stream(
    &mut self,
    service_id: i32,
    body: impl Into<Body>
) -> Result<(), WriteMessageError>[src]

Send a stream message to the remote peer.

pub fn close(self)[src]

Close the connection with the remote peer.

pub fn close_handle(&self) -> PeerCloseHandle<Body>[src]

Make a close handle for the peer.

The close handle can be used to close the connection with the remote peer. It can be cloned and moved around independently.

Auto Trait Implementations

impl<Body> !RefUnwindSafe for PeerHandle<Body>

impl<Body> Send for PeerHandle<Body> where
    Body: Send, 

impl<Body> Sync for PeerHandle<Body> where
    Body: Send, 

impl<Body> Unpin for PeerHandle<Body>

impl<Body> !UnwindSafe for PeerHandle<Body>

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized, [src]

pub fn type_id(&self) -> TypeId[src]

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
    T: ?Sized, [src]

pub fn borrow(&self) -> &T[src]

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
    T: ?Sized, [src]

pub fn borrow_mut(&mut self) -> &mut T[src]

Mutably borrows from an owned value. Read more

impl<T> From<T> for T[src]

pub fn from(t: T) -> T[src]

Performs the conversion.

impl<T, U> Into<U> for T where
    U: From<T>, [src]

pub fn into(self) -> U[src]

Performs the conversion.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, [src]

type Error = Infallible

The type returned in the event of a conversion error.

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src]

Performs the conversion.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, [src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>[src]

Performs the conversion.