Skip to main content

Client

Struct Client 

Source
pub struct Client<T, C>
where T: Initiator<Connection = C>, C: Connection,
{ /* private fields */ }
Expand description

The central client responsible for managing the connection to the server.

This client handles TCP stream creation and delegates UDP session management to a dedicated UdpDispatcher. It ensures the connection stays alive through a retry mechanism.

Implementations§

Source§

impl<T, C> Client<T, C>
where T: Initiator<Connection = C>, C: Connection,

Source

pub async fn new( transport: T, secret: Secret, options: Option<Bytes>, ) -> Result<Self>

Creates a new Client and establishes a connection to the server.

This involves performing a handshake and spawning a background task to handle incoming UDP datagrams.

Source

pub async fn open_bidirectional( &self, dest_addr: Address, ) -> Result<BufferedStream<C::Stream>>

Opens a new bidirectional stream for TCP-like communication.

This method negotiates a new stream with the server, which will then connect to the specified destination address. It waits for the server’s connection response before returning, ensuring proper TCP state handling.

The returned stream is wrapped in a BufferedStream to ensure that any data remaining in the protocol framing buffer is read first, preventing data loss when transitioning from message-based to raw stream communication.

Source

pub async fn rebind(&self) -> Result<()>

Rebind the transport to a new socket to ensure a clean state for reconnection.

Trait Implementations§

Source§

impl<T, C> Drop for Client<T, C>
where T: Initiator<Connection = C>, C: Connection,

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more

Auto Trait Implementations§

§

impl<T, C> Freeze for Client<T, C>

§

impl<T, C> !RefUnwindSafe for Client<T, C>

§

impl<T, C> Send for Client<T, C>

§

impl<T, C> Sync for Client<T, C>

§

impl<T, C> Unpin for Client<T, C>

§

impl<T, C> UnsafeUnpin for Client<T, C>

§

impl<T, C> !UnwindSafe for Client<T, C>

Blanket Implementations§

Source§

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

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

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

The type returned in the event of a conversion error.
Source§

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

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more