Struct qiniu_credential::ChainCredentialsProviderBuilder

pub struct ChainCredentialsProviderBuilder { /* private fields */ }

串联认证信息构建器

接受多个认证信息获取接口的实例并将他们串联成串联认证信息

Implementations

impl ChainCredentialsProviderBuilder

pub fn new(credential: impl CredentialProvider + 'static) -> Self

构建新的串联认证信息构建器

Examples found in repository

src/lib.rs (line 945)

    pub fn builder(credential: impl CredentialProvider + 'static) -> ChainCredentialsProviderBuilder {
        ChainCredentialsProviderBuilder::new(credential)
    }
}

impl CredentialProvider for ChainCredentialsProvider {
    fn get(&self, opts: GetOptions) -> IoResult<GotCredential> {
        let mut last_err = None;
        if let Some(credential) = self.credentials.iter().find_map(|c| match c.get(opts) {
            Ok(cred) => Some(cred),
            Err(err) => {
                last_err = Some(err);
                None
            }
        }) {
            Ok(credential)
        } else {
            Err(last_err.expect("No credential in ChainCredentialsProvider, which is unexpected"))
        }
    }

    #[cfg(feature = "async")]
    #[cfg_attr(feature = "docs", doc(cfg(feature = "async")))]
    fn async_get(&self, opts: GetOptions) -> AsyncIoResult<'_, GotCredential> {
        Box::pin(async move {
            let mut last_err = None;
            for provider in self.credentials.iter() {
                match provider.async_get(opts).await {
                    Ok(cred) => {
                        return Ok(cred);
                    }
                    Err(err) => {
                        last_err = Some(err);
                    }
                }
            }
            Err(last_err.expect("No credential in ChainCredentialsProvider, which is unexpected"))
        })
    }
}

impl Default for ChainCredentialsProvider {
    #[inline]
    fn default() -> Self {
        ChainCredentialsProviderBuilder::new(Box::new(GlobalCredentialProvider))
            .append_credential(Box::new(EnvCredentialProvider))
            .build()
    }

pub fn append_credential(
    &mut self,
    credential: impl CredentialProvider + 'static
) -> &mut Self

将认证信息获取接口的实例推送到认证串末端

Examples found in repository

src/lib.rs (line 989)

    fn default() -> Self {
        ChainCredentialsProviderBuilder::new(Box::new(GlobalCredentialProvider))
            .append_credential(Box::new(EnvCredentialProvider))
            .build()
    }
}

impl FromIterator<Box<dyn CredentialProvider>> for ChainCredentialsProvider {
    #[inline]
    fn from_iter<T: IntoIterator<Item = Box<dyn CredentialProvider>>>(iter: T) -> Self {
        ChainCredentialsProviderBuilder::from_iter(iter).build()
    }
}

impl<'a> IntoIterator for &'a ChainCredentialsProvider {
    type Item = &'a Box<dyn CredentialProvider + 'static>;
    type IntoIter = std::slice::Iter<'a, Box<dyn CredentialProvider + 'static>>;

    #[inline]
    fn into_iter(self) -> Self::IntoIter {
        self.credentials.iter()
    }
}

/// 串联认证信息构建器
///
/// 接受多个认证信息获取接口的实例并将他们串联成串联认证信息
#[derive(Debug, Clone, Default)]
pub struct ChainCredentialsProviderBuilder {
    credentials: VecDeque<Box<dyn CredentialProvider + 'static>>,
}

impl ChainCredentialsProviderBuilder {
    /// 构建新的串联认证信息构建器
    #[inline]
    pub fn new(credential: impl CredentialProvider + 'static) -> Self {
        let mut builder = Self::default();
        builder.append_credential(credential);
        builder
    }

pub fn prepend_credential(
    &mut self,
    credential: impl CredentialProvider + 'static
) -> &mut Self

将认证信息获取接口的实例推送到认证串顶端

pub fn build(&mut self) -> ChainCredentialsProvider

串联认证信息

Examples found in repository

src/lib.rs (line 990)

    fn default() -> Self {
        ChainCredentialsProviderBuilder::new(Box::new(GlobalCredentialProvider))
            .append_credential(Box::new(EnvCredentialProvider))
            .build()
    }
}

impl FromIterator<Box<dyn CredentialProvider>> for ChainCredentialsProvider {
    #[inline]
    fn from_iter<T: IntoIterator<Item = Box<dyn CredentialProvider>>>(iter: T) -> Self {
        ChainCredentialsProviderBuilder::from_iter(iter).build()
    }

Trait Implementations

impl Clone for ChainCredentialsProviderBuilder

fn clone(&self) -> ChainCredentialsProviderBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ChainCredentialsProviderBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ChainCredentialsProviderBuilder

fn default() -> ChainCredentialsProviderBuilder

Returns the “default value” for a type.

impl Extend<Box<dyn CredentialProvider + 'static, Global>> for ChainCredentialsProviderBuilder

fn extend<T: IntoIterator<Item = Box<dyn CredentialProvider>>>(
    &mut self,
    iter: T
)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl FromIterator<Box<dyn CredentialProvider + 'static, Global>> for ChainCredentialsProviderBuilder

fn from_iter<T: IntoIterator<Item = Box<dyn CredentialProvider>>>(
    iter: T
) -> Self

Creates a value from an iterator.