com.launchdarkly.android

Class LDConfig.Builder

java.lang.Object

com.launchdarkly.android.LDConfig.Builder

Enclosing class:

LDConfig

public static class LDConfig.Builder
extends java.lang.Object

A builder that helps construct LDConfig objects. Builder calls can be chained, enabling the following pattern:

 LDConfig config = new LDConfig.Builder()
          .setMobileKey("mobile-key")
          .setEvaluationReasons(true)
          .build();
 

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
LDConfig.Builder	allAttributesPrivate() Specifies that user attributes (other than the key) should be hidden from LaunchDarkly.
LDConfig	build() Returns the configured LDConfig object.
LDConfig.Builder	setAdditionalHeaders(java.util.Map<java.lang.String,java.lang.String> additionalHeaders) Additional headers that should be added to all HTTP requests from SDK components to LaunchDarkly services
LDConfig.Builder	setBackgroundPollingIntervalMillis(int backgroundPollingIntervalMillis) Sets how often the client will poll for flag updates when your application is in the background.
LDConfig.Builder	setBaseUri(android.net.Uri baseUri) Deprecated. Please use setPollUri(Uri) instead.
LDConfig.Builder	setConnectionTimeoutMillis(int connectionTimeoutMillis) Sets the timeout when connecting to LaunchDarkly.
LDConfig.Builder	setDiagnosticOptOut(boolean diagnosticOptOut) Set to true to opt out of sending diagnostics data.
LDConfig.Builder	setDiagnosticRecordingIntervalMillis(int diagnosticRecordingIntervalMillis) Sets the interval at which periodic diagnostic data is sent.
LDConfig.Builder	setDisableBackgroundUpdating(boolean disableBackgroundUpdating) Sets whether feature flag updates should be disabled when your app is in the background.
LDConfig.Builder	setEvaluationReasons(boolean evaluationReasons) If enabled, LaunchDarkly will provide additional information about how flag values were calculated.
LDConfig.Builder	setEventsCapacity(int eventsCapacity) Set the capacity of the event buffer.
LDConfig.Builder	setEventsFlushIntervalMillis(int eventsFlushIntervalMillis) Sets the maximum amount of time to wait in between sending analytics events to LaunchDarkly.
LDConfig.Builder	setEventsUri(android.net.Uri eventsUri) Set the events URI for sending analytics to LaunchDarkly.
LDConfig.Builder	setInlineUsersInEvents(boolean inlineUsersInEvents) If enabled, events to the server will be created containing the entire User object.
LDConfig.Builder	setMaxCachedUsers(int maxCachedUsers) Sets the maximum number of users to cache the flag values for locally in the device's SharedPreferences.
LDConfig.Builder	setMobileKey(java.lang.String mobileKey) Sets the key for authenticating with LaunchDarkly.
LDConfig.Builder	setOffline(boolean offline) Disables all network calls from the LaunchDarkly client.
LDConfig.Builder	setPollingIntervalMillis(int pollingIntervalMillis) Sets the interval in between feature flag updates, when streaming mode is disabled.
LDConfig.Builder	setPollUri(android.net.Uri pollUri) Set the base URI for polling requests to LaunchDarkly.
LDConfig.Builder	setPrivateAttributeNames(java.util.Set<java.lang.String> privateAttributeNames) Marks a set of attributes private.
LDConfig.Builder	setSecondaryMobileKeys(java.util.Map<java.lang.String,java.lang.String> secondaryMobileKeys) Sets the secondary keys for authenticating to additional LaunchDarkly environments.
LDConfig.Builder	setStream(boolean enabled) Enables or disables real-time streaming flag updates.
LDConfig.Builder	setStreamUri(android.net.Uri streamUri) Set the stream URI for connecting to the flag update stream.
LDConfig.Builder	setUseReport(boolean useReport) Sets the flag for choosing the REPORT api call.
LDConfig.Builder	setWrapperName(java.lang.String wrapperName) For use by wrapper libraries to set an identifying name for the wrapper being used.
LDConfig.Builder	setWrapperVersion(java.lang.String wrapperVersion) For use by wrapper libraries to report the version of the library in use.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Method Detail

allAttributesPrivate

public LDConfig.Builder allAttributesPrivate()

Specifies that user attributes (other than the key) should be hidden from LaunchDarkly. If this is set, all user attribute values will be private, not just the attributes specified in setPrivateAttributeNames(Set).

Returns:

the builder

setPrivateAttributeNames

public LDConfig.Builder setPrivateAttributeNames(java.util.Set<java.lang.String> privateAttributeNames)

Marks a set of attributes private. Any users sent to LaunchDarkly with this configuration active will have attributes with these names removed. This can also be specified on a per-user basis with LDUser.Builder methods like LDUser.Builder.privateName(String).

Parameters:

privateAttributeNames - a set of names that will be removed from user data sent to LaunchDarkly

Returns:

the builder

setMobileKey

public LDConfig.Builder setMobileKey(java.lang.String mobileKey)

Sets the key for authenticating with LaunchDarkly. This is required unless you're using the client in offline mode.

Parameters:

mobileKey - Get this from the LaunchDarkly web app under Team Settings.

Returns:

the builder

setSecondaryMobileKeys

public LDConfig.Builder setSecondaryMobileKeys(java.util.Map<java.lang.String,java.lang.String> secondaryMobileKeys)

Sets the secondary keys for authenticating to additional LaunchDarkly environments.

Parameters:

secondaryMobileKeys - A map of identifying names to unique mobile keys to access secondary environments

Returns:

the builder

setUseReport

public LDConfig.Builder setUseReport(boolean useReport)

Sets the flag for choosing the REPORT api call. The default is GET. Do not use unless advised by LaunchDarkly.

Parameters:

useReport - true if HTTP requests should use the REPORT verb

Returns:

the builder

setBaseUri

@Deprecated
public LDConfig.Builder setBaseUri(android.net.Uri baseUri)

Deprecated. Please use setPollUri(Uri) instead.

Set the base URI for connecting to LaunchDarkly. You probably don't need to set this unless instructed by LaunchDarkly.

Parameters:

baseUri - the URI of the main LaunchDarkly service

Returns:

the builder

setPollUri

public LDConfig.Builder setPollUri(android.net.Uri pollUri)

Set the base URI for polling requests to LaunchDarkly. You probably don't need to set this unless instructed by LaunchDarkly.

Parameters:

pollUri - the URI of the main LaunchDarkly service

Returns:

the builder

setEventsUri

public LDConfig.Builder setEventsUri(android.net.Uri eventsUri)

Set the events URI for sending analytics to LaunchDarkly. You probably don't need to set this unless instructed by LaunchDarkly.

Parameters:

eventsUri - the URI of the LaunchDarkly analytics event service

Returns:

the builder

setStreamUri

public LDConfig.Builder setStreamUri(android.net.Uri streamUri)

Set the stream URI for connecting to the flag update stream. You probably don't need to set this unless instructed by LaunchDarkly.

Parameters:

streamUri - the URI of the LaunchDarkly streaming service

Returns:

the builder

setEventsCapacity

public LDConfig.Builder setEventsCapacity(int eventsCapacity)

Set the capacity of the event buffer. The client buffers up to this many events in memory before flushing. If the capacity is exceeded before the buffer is flushed, events will be discarded. Increasing the capacity means that events are less likely to be discarded, at the cost of consuming more memory.

The default value is .

Parameters:

eventsCapacity - the capacity of the event buffer

Returns:

the builder

See Also:

setEventsFlushIntervalMillis(int)

setEventsFlushIntervalMillis

public LDConfig.Builder setEventsFlushIntervalMillis(int eventsFlushIntervalMillis)

Sets the maximum amount of time to wait in between sending analytics events to LaunchDarkly.

The default value is .

Parameters:

eventsFlushIntervalMillis - the interval between event flushes, in milliseconds

Returns:

the builder

See Also:

setEventsCapacity(int)

setConnectionTimeoutMillis

public LDConfig.Builder setConnectionTimeoutMillis(int connectionTimeoutMillis)

Sets the timeout when connecting to LaunchDarkly.

The default value is .

Parameters:

connectionTimeoutMillis - the connection timeout, in milliseconds

Returns:

the builder

setStream

public LDConfig.Builder setStream(boolean enabled)

Enables or disables real-time streaming flag updates. By default, streaming is enabled. When disabled, an efficient caching polling mechanism is used.

Parameters:

enabled - true if streaming should be enabled

Returns:

the builder

setPollingIntervalMillis

public LDConfig.Builder setPollingIntervalMillis(int pollingIntervalMillis)

Sets the interval in between feature flag updates, when streaming mode is disabled. This is ignored unless setStream(boolean) is set to true. When set, it will also change the default value for setEventsFlushIntervalMillis(int) to the same value.

The default value is LDConfig.DEFAULT_POLLING_INTERVAL_MILLIS.

Parameters:

pollingIntervalMillis - the feature flag polling interval, in milliseconds

Returns:

the builder

setBackgroundPollingIntervalMillis

public LDConfig.Builder setBackgroundPollingIntervalMillis(int backgroundPollingIntervalMillis)

Sets how often the client will poll for flag updates when your application is in the background.

The default value is LDConfig.DEFAULT_BACKGROUND_POLLING_INTERVAL_MILLIS.

Parameters:

backgroundPollingIntervalMillis - the feature flag polling interval when in the background, in milliseconds

Returns:

the builder

setDisableBackgroundUpdating

public LDConfig.Builder setDisableBackgroundUpdating(boolean disableBackgroundUpdating)

Sets whether feature flag updates should be disabled when your app is in the background.

The default value is false (flag updates will be done in the background).

Parameters:

disableBackgroundUpdating - true if the client should skip updating flags when in the background

Returns:

the builder

setOffline

public LDConfig.Builder setOffline(boolean offline)

Disables all network calls from the LaunchDarkly client.

This can also be specified after the client has been created, using LDClientInterface.setOffline().

The default value is true (the client will make network calls).

Parameters:

offline - true if the client should run in offline mode

Returns:

the builder

setInlineUsersInEvents

public LDConfig.Builder setInlineUsersInEvents(boolean inlineUsersInEvents)

If enabled, events to the server will be created containing the entire User object. If disabled, events to the server will be created without the entire User object, including only the user key instead; the rest of the user properties will still be included in Identify events.

Defaults to false in order to reduce network bandwidth.

Parameters:

inlineUsersInEvents - true if all user properties should be included in events

Returns:

the builder

setEvaluationReasons

public LDConfig.Builder setEvaluationReasons(boolean evaluationReasons)

If enabled, LaunchDarkly will provide additional information about how flag values were calculated. The additional information will then be available through the client's "detail" methods (LDClientInterface.boolVariationDetail(String, Boolean), etc.). Since this increases the size of network requests, the default is false (detail information will not be sent).

Parameters:

evaluationReasons - true if detail/reason information should be made available

Returns:

the builder

setDiagnosticOptOut

public LDConfig.Builder setDiagnosticOptOut(boolean diagnosticOptOut)

Set to true to opt out of sending diagnostics data. Unless the diagnosticOptOut field is set to true, the client will send some diagnostics data to the LaunchDarkly servers in order to assist in the development of future SDK improvements. These diagnostics consist of an initial payload containing some details of SDK in use, the SDK's configuration, and the platform the SDK is being run on; as well as payloads sent periodically with information on irregular occurrences such as dropped events.

Parameters:

diagnosticOptOut - true if you want to opt out of sending any diagnostics data.

Returns:

the builder

setDiagnosticRecordingIntervalMillis

public LDConfig.Builder setDiagnosticRecordingIntervalMillis(int diagnosticRecordingIntervalMillis)

Sets the interval at which periodic diagnostic data is sent. The default is every 15 minutes (900,000 milliseconds) and the minimum value is 300,000 (5 minutes).

Parameters:

diagnosticRecordingIntervalMillis - the diagnostics interval in milliseconds

Returns:

the builder

See Also:

for more information on the diagnostics data being sent.

setWrapperName

public LDConfig.Builder setWrapperName(java.lang.String wrapperName)

For use by wrapper libraries to set an identifying name for the wrapper being used. This will be sent in User-Agent headers during requests to the LaunchDarkly servers to allow recording metrics on the usage of these wrapper libraries.

Parameters:

wrapperName - An identifying name for the wrapper library

Returns:

the builder

setWrapperVersion

public LDConfig.Builder setWrapperVersion(java.lang.String wrapperVersion)

For use by wrapper libraries to report the version of the library in use. If the wrapper name has not been set with setWrapperName(String) this field will be ignored. Otherwise the version string will be included in the User-Agent headers along with the wrapperName during requests to the LaunchDarkly servers.

Parameters:

wrapperVersion - Version string for the wrapper library

Returns:

the builder

setMaxCachedUsers

public LDConfig.Builder setMaxCachedUsers(int maxCachedUsers)

Sets the maximum number of users to cache the flag values for locally in the device's SharedPreferences.

Note that the active user is not considered part of this limit, as it will always be served from the backing SharedPreferences.

Parameters:

maxCachedUsers - The maximum number of users to cache, negative values represent allowing an unlimited number of cached users.

Returns:

the builder

setAdditionalHeaders

public LDConfig.Builder setAdditionalHeaders(java.util.Map<java.lang.String,java.lang.String> additionalHeaders)

Additional headers that should be added to all HTTP requests from SDK components to LaunchDarkly services

Parameters:

additionalHeaders - A map of header keys to header values

Returns:

the builder

build

public LDConfig build()

Returns the configured LDConfig object.

Returns:

the configuration