Struct FrontingConfig 

pub struct FrontingConfig { /* private fields */ }

Configuration for FrontPolicy::ConfiguredRetry. A domain is considered “failed” once it has failed failures_per_domain times; fronting is enabled once num_domains_failed distinct domains have failed.

Both thresholds are inclusive (>=), so 0 is a valid, well-defined value for either field rather than an error - it simply means the threshold is already satisfied:

• failures_per_domain: 0 - a domain counts as “failed” on its very first failure.
• num_domains_failed: 0 - fronting is enabled as soon as retry_enable is called with a domain, even before any domain has reached failures_per_domain. This makes failures_per_domain irrelevant, so setting num_domains_failed to 0 alongside a non-zero failures_per_domain is almost certainly a configuration mistake - use FrontPolicy::OnRetry instead if “enable on the first failure” is actually what’s wanted.
• FrontingConfig::default() (both 0) therefore enables fronting on the very first failure seen, same as num_domains_failed: 0 above.

Implementations

impl FrontingConfig

pub fn new(failures_per_domain: usize, num_domains_failed: usize) -> Self

Create a new configuration for FrontPolicy::ConfiguredRetry.

pub fn with_failures_per_domain(self, failures_per_domain: usize) -> Self

Set the number of failures allowed for a single domain before it is considered failed.

pub fn with_num_domains_failed(self, num_domains_failed: usize) -> Self

Set the number of distinct domains that must fail before fronting is enabled.

pub fn with_include_non_fronted_in_rotation(self, include: bool) -> Self

Once fronting is enabled, allow domains without a configured front to still be selected when rotating hosts (rather than only rotating between fronted domains).

pub fn with_disable_fronting_on_non_fronting_success( self, disable: bool, ) -> Self

Requires Self::with_include_non_fronted_in_rotation to also be set. When a request against a non-fronted domain succeeds while fronting is enabled, reset the accumulated failure counts and disable fronting again, letting the client rely less on fronting once it is no longer needed.

Trait Implementations

impl Clone for FrontingConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FrontingConfig

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

Formats the value using the given formatter.

impl Default for FrontingConfig

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for FrontingConfig

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FrontingConfig