io.split.client

Class SplitClientConfig.Builder

java.lang.Object

io.split.client.SplitClientConfig.Builder

Enclosing class:

SplitClientConfig

public static final class SplitClientConfig.Builder
extends Object

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
SplitClientConfig	build()
SplitClientConfig.Builder	connectionTimeout(int ms)
SplitClientConfig.Builder	connectionTimeoutInMs(int ms) Deprecated.
SplitClientConfig.Builder	enableDebug()
SplitClientConfig.Builder	endpoint(String endpoint) The rest endpoint that sdk will hit for latest features and segments.
SplitClientConfig.Builder	eventsEndpoint(String eventsEndpoint) The rest endpoint that sdk will hit for impressions and metrics.
SplitClientConfig.Builder	featuresRefreshRate(int seconds) The SDK will poll the endpoint for changes to features at this period.
SplitClientConfig.Builder	impressionsRefreshRate(int seconds) The treatment log captures the which key saw what treatment ("on", "off", etc) at what time.
SplitClientConfig.Builder	metricsRefreshRate(int seconds) The diagnostic metrics collected by the SDK are pushed back to split endpoint at this period.
SplitClientConfig.Builder	numThreadsForSegmentFetch(int numThreads) Deprecated.
SplitClientConfig.Builder	pollForFeatureChangesEveryNSeconds(int n) Deprecated.
SplitClientConfig.Builder	pollForSegmentChangesEveryNSeconds(int n) Deprecated.
SplitClientConfig.Builder	readTimeout(int ms)
SplitClientConfig.Builder	readTimeoutInMs(int ms) Deprecated.
SplitClientConfig.Builder	ready(int milliseconds) The SDK kicks off background threads to download data necessary for using the SDK.
SplitClientConfig.Builder	segmentsRefreshRate(int seconds) The SDK will poll the endpoint for changes to segments at this period in seconds.
SplitClientConfig.Builder	treatmentLogCacheExpireNSecondsAfterWrite(int n) Deprecated.

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

endpoint

public SplitClientConfig.Builder endpoint(String endpoint)

The rest endpoint that sdk will hit for latest features and segments.

Parameters:

endpoint - MUST NOT be null

Returns:

eventsEndpoint

public SplitClientConfig.Builder eventsEndpoint(String eventsEndpoint)

The rest endpoint that sdk will hit for impressions and metrics.

Parameters:

eventsEndpoint - MUST NOT be null

Returns:

pollForFeatureChangesEveryNSeconds

@Deprecated
public SplitClientConfig.Builder pollForFeatureChangesEveryNSeconds(int n)

Deprecated.

The SDK will poll the endpoint for changes to features at this period.

Implementation Note: The SDK actually polls at a random interval chosen between (0.5 * n, n). This is to ensure that SDKs that are deployed simultaneously on different machines do not inundate the backend with requests at the same interval.

Parameters:

n - MUST be greater than 0. Default value is 60.

Returns:

featuresRefreshRate

public SplitClientConfig.Builder featuresRefreshRate(int seconds)

The SDK will poll the endpoint for changes to features at this period.

Implementation Note: The SDK actually polls at a random interval chosen between (0.5 * n, n). This is to ensure that SDKs that are deployed simultaneously on different machines do not inundate the backend with requests at the same interval.

Parameters:

seconds - MUST be greater than 0. Default value is 60.

Returns:

pollForSegmentChangesEveryNSeconds

@Deprecated
public SplitClientConfig.Builder pollForSegmentChangesEveryNSeconds(int n)

Deprecated.

The SDK will poll the endpoint for changes to segments at this period in seconds.

Implementation Note: The SDK actually polls at a random interval chosen between (0.5 * n, n). This is to ensure that SDKs that are deployed simultaneously on different machines do not inundate the backend with requests at the same interval.

Parameters:

n - MUST be greater than 0. Default value is 60.

Returns:

segmentsRefreshRate

public SplitClientConfig.Builder segmentsRefreshRate(int seconds)

The SDK will poll the endpoint for changes to segments at this period in seconds.

Implementation Note: The SDK actually polls at a random interval chosen between (0.5 * n, n). This is to ensure that SDKs that are deployed simultaneously on different machines do not inundate the backend with requests at the same interval.

Parameters:

seconds - MUST be greater than 0. Default value is 60.

Returns:

treatmentLogCacheExpireNSecondsAfterWrite

@Deprecated
public SplitClientConfig.Builder treatmentLogCacheExpireNSecondsAfterWrite(int n)

Deprecated.

The treatment log captures the which key saw what treatment ("on", "off", etc) at what time. This log is periodically pushed back to split endpoint. This parameter controls how quickly does the cache expire after a write. This is an ADVANCED parameter

Parameters:

n - MUST be > 0.

Returns:

impressionsRefreshRate

public SplitClientConfig.Builder impressionsRefreshRate(int seconds)

The treatment log captures the which key saw what treatment ("on", "off", etc) at what time. This log is periodically pushed back to split endpoint. This parameter controls how quickly does the cache expire after a write. This is an ADVANCED parameter

Parameters:

seconds - MUST be > 0.

Returns:

metricsRefreshRate

public SplitClientConfig.Builder metricsRefreshRate(int seconds)

The diagnostic metrics collected by the SDK are pushed back to split endpoint at this period. This is an ADVANCED parameter

Parameters:

seconds - MUST be > 0.

Returns:

connectionTimeoutInMs

@Deprecated
public SplitClientConfig.Builder connectionTimeoutInMs(int ms)

Deprecated.

Http client connection timeout. Default value is 15000ms.

Parameters:

ms - MUST be greater than 0.

Returns:

Builder

connectionTimeout

public SplitClientConfig.Builder connectionTimeout(int ms)

readTimeoutInMs

@Deprecated
public SplitClientConfig.Builder readTimeoutInMs(int ms)

Deprecated.

Http client read timeout. Default value is 15000ms.

Parameters:

ms - MUST be greater than 0.

Returns:

this Builder instance

readTimeout

public SplitClientConfig.Builder readTimeout(int ms)

enableDebug

public SplitClientConfig.Builder enableDebug()

numThreadsForSegmentFetch

@Deprecated
public SplitClientConfig.Builder numThreadsForSegmentFetch(int numThreads)

Deprecated.

The SDK fetches segment memberships on a schedule in an asynchrnonous manner. This parameter controls the number of threads in that thread pool.

Parameters:

numThreads - MUST BE greater than 0;

Returns:

this Builder instance

ready

public SplitClientConfig.Builder ready(int milliseconds)

The SDK kicks off background threads to download data necessary for using the SDK. You can choose to block until the SDK has downloaded split definitions so that you will not get the 'control' treatment.

If this parameter is set to a non-negative value, the SDK will block for that number of milliseconds for the data to be downloaded.

If the download is not successful in this time period, a TimeOutException will be thrown.

A negative value implies that the SDK building MUST NOT block. In this scenario, the SDK might return the 'control' treatment until the desired data has been downloaded.

Parameters:

milliseconds - MUST BE greater than or equal to 0;

Returns:

build

public SplitClientConfig build()