Struct PollingDataSourceBuilder

pub struct PollingDataSourceBuilder<C> { /* private fields */ }

Contains methods for configuring the polling data source.

Polling is not the default behavior; by default, the SDK uses a streaming connection to receive feature flag data from LaunchDarkly. In polling mode, the SDK instead makes a new HTTP request to LaunchDarkly at regular intervals. HTTP caching allows it to avoid redundantly downloading data if there have been no changes, but polling is still less efficient than streaming and should only be used on the advice of LaunchDarkly support.

To use polling mode, create a builder PollingDataSourceBuilder::new, change its properties with the methods of this class, and pass it to the crate::ConfigBuilder::data_source.

Examples

Adjust the initial reconnect delay.

    ConfigBuilder::new("sdk-key").data_source(PollingDataSourceBuilder::<HttpsConnector<HttpConnector>>::new()
        .poll_interval(Duration::from_secs(60)));

Implementations

impl<C> PollingDataSourceBuilder<C>

Contains methods for configuring the polling data source.

Polling is not the default behavior; by default, the SDK uses a streaming connection to receive feature flag data from LaunchDarkly. In polling mode, the SDK instead makes a new HTTP request to LaunchDarkly at regular intervals. HTTP caching allows it to avoid redundantly downloading data if there have been no changes, but polling is still less efficient than streaming and should only be used on the advice of LaunchDarkly support.

To use polling mode, create a builder with PollingDataSourceBuilder::new, set its properties with the methods of this class, and pass it to crate::ConfigBuilder::data_source.

Examples

Adjust the poll interval.

    ConfigBuilder::new("sdk-key").data_source(PollingDataSourceBuilder::<HttpsConnector<HttpConnector>>::new()
        .poll_interval(Duration::from_secs(60)));

pub fn new() -> Self

Create a new instance of the PollingDataSourceBuilder with default values.

pub fn poll_interval(&mut self, poll_interval: Duration) -> &mut Self

Sets the poll interval for the polling connection.

The default and minimum value is 30 seconds. Values less than this will be set to the default.

pub fn https_connector(&mut self, connector: C) -> &mut Self

Sets the connector for the polling client to use. This allows for re-use of a connector between multiple client instances. This is especially useful for the sdk-test-harness where many client instances are created throughout the test and reading the native certificates is a substantial portion of the runtime.

Trait Implementations

impl<C: Clone> Clone for PollingDataSourceBuilder<C>

fn clone(&self) -> PollingDataSourceBuilder<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C> Default for PollingDataSourceBuilder<C>

fn default() -> Self

Returns the “default value” for a type.