Trait Chooser

pub trait Chooser:
    DynClone
    + Debug
    + Sync
    + Send {
    // Required methods
    fn choose(
        &self,
        ips: &[IpAddrWithPort],
        opts: ChooseOptions<'_>,
    ) -> ChosenResults;
    fn feedback(&self, feedback: ChooserFeedback<'_>);

    // Provided methods
    fn async_choose<'a>(
        &'a self,
        ips: &'a [IpAddrWithPort],
        opts: ChooseOptions<'a>,
    ) -> Pin<Box<dyn Future<Output = ChosenResults> + Send + 'a>> { ... }
    fn async_feedback<'a>(
        &'a self,
        feedback: ChooserFeedback<'a>,
    ) -> Pin<Box<dyn Future<Output = ()> + Send + 'a>> { ... }
}

选择 IP 地址接口

还提供了对选择结果的反馈接口，用以修正自身选择逻辑，优化选择结果

同时提供阻塞接口和异步接口，异步接口则需要启用 async 功能

Required Methods

fn choose( &self, ips: &[IpAddrWithPort], opts: ChooseOptions<'_>, ) -> ChosenResults

选择 IP 地址列表

fn feedback(&self, feedback: ChooserFeedback<'_>)

反馈选择的 IP 地址列表的结果

Provided Methods

fn async_choose<'a>( &'a self, ips: &'a [IpAddrWithPort], opts: ChooseOptions<'a>, ) -> Pin<Box<dyn Future<Output = ChosenResults> + Send + 'a>>

异步选择 IP 地址列表

该方法的异步版本为 Self::async_choose。

fn async_feedback<'a>( &'a self, feedback: ChooserFeedback<'a>, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'a>>

异步反馈选择的 IP 地址列表的结果

Trait Implementations

impl<'clone> Clone for Box<dyn Chooser + 'clone>

fn clone(&self) -> Box<dyn Chooser + 'clone>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'clone> Clone for Box<dyn Chooser + Send + 'clone>

fn clone(&self) -> Box<dyn Chooser + Send + 'clone>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'clone> Clone for Box<dyn Chooser + Sync + Send + 'clone>

fn clone(&self) -> Box<dyn Chooser + Sync + Send + 'clone>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'clone> Clone for Box<dyn Chooser + Sync + 'clone>

fn clone(&self) -> Box<dyn Chooser + Sync + 'clone>

Returns a copy of the value.

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

Performs copy-assignment from source.

Implementations on Foreign Types

impl<'b, T> Chooser for &'b T

where T: 'b + Chooser + ?Sized, &'b T: DynClone + Debug + Sync + Send,

fn choose( &self, ips: &[IpAddrWithPort], opts: ChooseOptions<'_>, ) -> ChosenResults

fn feedback(&self, feedback: ChooserFeedback<'_>)

fn async_choose<'a>( &'a self, ips: &'a [IpAddrWithPort], opts: ChooseOptions<'a>, ) -> Pin<Box<dyn Future<Output = ChosenResults> + Send + 'a>>

fn async_feedback<'a>( &'a self, feedback: ChooserFeedback<'a>, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'a>>

impl<'b, T> Chooser for &'b mut T

where T: 'b + Chooser + ?Sized, &'b mut T: DynClone + Debug + Sync + Send,

fn choose( &self, ips: &[IpAddrWithPort], opts: ChooseOptions<'_>, ) -> ChosenResults

fn feedback(&self, feedback: ChooserFeedback<'_>)

fn async_choose<'a>( &'a self, ips: &'a [IpAddrWithPort], opts: ChooseOptions<'a>, ) -> Pin<Box<dyn Future<Output = ChosenResults> + Send + 'a>>

fn async_feedback<'a>( &'a self, feedback: ChooserFeedback<'a>, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'a>>

impl<T> Chooser for Box<T>

where T: Chooser + ?Sized, Box<T>: DynClone + Debug + Sync + Send,

fn choose( &self, ips: &[IpAddrWithPort], opts: ChooseOptions<'_>, ) -> ChosenResults

fn feedback(&self, feedback: ChooserFeedback<'_>)

fn async_choose<'a>( &'a self, ips: &'a [IpAddrWithPort], opts: ChooseOptions<'a>, ) -> Pin<Box<dyn Future<Output = ChosenResults> + Send + 'a>>

fn async_feedback<'a>( &'a self, feedback: ChooserFeedback<'a>, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'a>>

impl<T> Chooser for Rc<T>

where T: Chooser + ?Sized, Rc<T>: DynClone + Debug + Sync + Send,

fn choose( &self, ips: &[IpAddrWithPort], opts: ChooseOptions<'_>, ) -> ChosenResults

fn feedback(&self, feedback: ChooserFeedback<'_>)

fn async_choose<'a>( &'a self, ips: &'a [IpAddrWithPort], opts: ChooseOptions<'a>, ) -> Pin<Box<dyn Future<Output = ChosenResults> + Send + 'a>>

fn async_feedback<'a>( &'a self, feedback: ChooserFeedback<'a>, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'a>>

impl<T> Chooser for Arc<T>

where T: Chooser + ?Sized, Arc<T>: DynClone + Debug + Sync + Send,

fn choose( &self, ips: &[IpAddrWithPort], opts: ChooseOptions<'_>, ) -> ChosenResults

fn feedback(&self, feedback: ChooserFeedback<'_>)

fn async_choose<'a>( &'a self, ips: &'a [IpAddrWithPort], opts: ChooseOptions<'a>, ) -> Pin<Box<dyn Future<Output = ChosenResults> + Send + 'a>>

fn async_feedback<'a>( &'a self, feedback: ChooserFeedback<'a>, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'a>>

Implementors

impl Chooser for DirectChooser

impl Chooser for IpChooser

impl Chooser for SubnetChooser

impl<C> Chooser for NeverEmptyHandedChooser<C>

where C: Chooser + Clone,

impl<C> Chooser for ShuffledChooser<C>

where C: Chooser + Clone,