com.launchdarkly.client.integrations

Class StreamingDataSourceBuilder

java.lang.Object

com.launchdarkly.client.integrations.StreamingDataSourceBuilder

All Implemented Interfaces:

UpdateProcessorFactory

public abstract class StreamingDataSourceBuilder
extends java.lang.Object
implements UpdateProcessorFactory

Contains methods for configuring the streaming data source.

By default, the SDK uses a streaming connection to receive feature flag data from LaunchDarkly. If you want to customize the behavior of the connection, create a builder with Components.streamingDataSource(), change its properties with the methods of this class, and pass it to LDConfig.Builder.dataSource(UpdateProcessorFactory):

     LDConfig config = new LDConfig.Builder()
         .dataSource(Components.streamingDataSource().initialReconnectDelayMillis(500))
         .build();
 

These properties will override any equivalent deprecated properties that were set with LDConfig.Builder, such as LDConfig.Builder.reconnectTimeMs(long).

Note that this class is abstract; the actual implementation is created by calling Components.streamingDataSource().

Since:

4.12.0

Field Summary

Fields

Modifier and Type	Field and Description
protected java.net.URI	baseURI
static long	DEFAULT_INITIAL_RECONNECT_DELAY_MILLIS The default value for initialReconnectDelayMillis(long).
protected long	initialReconnectDelayMillis
protected java.net.URI	pollingBaseURI

Constructor Summary

Constructors

Constructor and Description
StreamingDataSourceBuilder()

Method Summary

Modifier and Type	Method and Description
StreamingDataSourceBuilder	baseURI(java.net.URI baseURI) Sets a custom base URI for the streaming service.
StreamingDataSourceBuilder	initialReconnectDelayMillis(long initialReconnectDelayMillis) Sets the initial reconnect delay for the streaming connection.
StreamingDataSourceBuilder	pollingBaseURI(java.net.URI pollingBaseURI) Sets a custom base URI for special polling requests.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.launchdarkly.client.UpdateProcessorFactory

createUpdateProcessor

Field Detail

DEFAULT_INITIAL_RECONNECT_DELAY_MILLIS

public static final long DEFAULT_INITIAL_RECONNECT_DELAY_MILLIS

The default value for initialReconnectDelayMillis(long).

See Also:

Constant Field Values

baseURI

protected java.net.URI baseURI

pollingBaseURI

protected java.net.URI pollingBaseURI

initialReconnectDelayMillis

protected long initialReconnectDelayMillis

Constructor Detail

StreamingDataSourceBuilder

public StreamingDataSourceBuilder()

Method Detail

baseURI

public StreamingDataSourceBuilder baseURI(java.net.URI baseURI)

Sets a custom base URI for the streaming service.

You will only need to change this value in the following cases:

• You are using the Relay Proxy. Set baseUri to the base URI of the Relay Proxy instance.
• You are connecting to a test server or a nonstandard endpoint for the LaunchDarkly service.

Parameters:

baseURI - the base URI of the streaming service; null to use the default

Returns:

the builder

initialReconnectDelayMillis

public StreamingDataSourceBuilder initialReconnectDelayMillis(long initialReconnectDelayMillis)

Sets the initial reconnect delay for the streaming connection.

The streaming service uses a backoff algorithm (with jitter) every time the connection needs to be reestablished. The delay for the first reconnection will start near this value, and then increase exponentially for any subsequent connection failures.

The default value is DEFAULT_INITIAL_RECONNECT_DELAY_MILLIS.

Parameters:

initialReconnectDelayMillis - the reconnect time base value in milliseconds

Returns:

the builder

pollingBaseURI

public StreamingDataSourceBuilder pollingBaseURI(java.net.URI pollingBaseURI)

Sets a custom base URI for special polling requests.

Even in streaming mode, the SDK sometimes temporarily must do a polling request. You do not need to modify this property unless you are connecting to a test server or a nonstandard endpoint for the LaunchDarkly service. If you are using the Relay Proxy, you only need to set baseURI(URI).

Parameters:

pollingBaseURI - the polling endpoint URI; null to use the default

Returns:

the builder