com.launchdarkly.sdk.server.integrations

Class FileDataSourceBuilder

java.lang.Object

com.launchdarkly.sdk.server.integrations.FileDataSourceBuilder

All Implemented Interfaces:

DataSourceFactory

public final class FileDataSourceBuilder
extends java.lang.Object
implements DataSourceFactory

To use the file data source, obtain a new instance of this class with FileData.dataSource(), call the builder method filePaths(String...) to specify file path(s), then pass the resulting object to LDConfig.Builder.dataSource(DataSourceFactory).

For more details, see FileData.

Since:

4.12.0

Constructor Summary

Constructors

Constructor and Description
FileDataSourceBuilder()

Method Summary

Modifier and Type	Method and Description
FileDataSourceBuilder	autoUpdate(boolean autoUpdate) Specifies whether the data source should watch for changes to the source file(s) and reload flags whenever there is a change.
DataSource	createDataSource(ClientContext context, DataSourceUpdates dataSourceUpdates) Used internally by the LaunchDarkly client.
FileDataSourceBuilder	filePaths(java.nio.file.Path... filePaths) Adds any number of source files for loading flag data, specifying each file path as a Path.
FileDataSourceBuilder	filePaths(java.lang.String... filePaths) Adds any number of source files for loading flag data, specifying each file path as a string.

Methods inherited from class java.lang.Object

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

Constructor Detail

FileDataSourceBuilder

public FileDataSourceBuilder()

Method Detail

filePaths

public FileDataSourceBuilder filePaths(java.lang.String... filePaths)
                                throws java.nio.file.InvalidPathException

Adds any number of source files for loading flag data, specifying each file path as a string. The files will not actually be loaded until the LaunchDarkly client starts up.

Files will be parsed as JSON if their first non-whitespace character is '{'. Otherwise, they will be parsed as YAML.

Parameters:

filePaths - path(s) to the source file(s); may be absolute or relative to the current working directory

Returns:

the same factory object

Throws:

java.nio.file.InvalidPathException - if one of the parameters is not a valid file path

filePaths

public FileDataSourceBuilder filePaths(java.nio.file.Path... filePaths)

Adds any number of source files for loading flag data, specifying each file path as a Path. The files will not actually be loaded until the LaunchDarkly client starts up.

Files will be parsed as JSON if their first non-whitespace character is '{'. Otherwise, they will be parsed as YAML.

Parameters:

filePaths - path(s) to the source file(s); may be absolute or relative to the current working directory

Returns:

the same factory object

autoUpdate

public FileDataSourceBuilder autoUpdate(boolean autoUpdate)

Specifies whether the data source should watch for changes to the source file(s) and reload flags whenever there is a change. By default, it will not, so the flags will only be loaded once.

Note that auto-updating will only work if all of the files you specified have valid directory paths at startup time; if a directory does not exist, creating it later will not result in files being loaded from it.

Parameters:

autoUpdate - true if flags should be reloaded whenever a source file changes

Returns:

the same factory object

createDataSource

public DataSource createDataSource(ClientContext context,
                                   DataSourceUpdates dataSourceUpdates)

Used internally by the LaunchDarkly client.

Specified by:

createDataSource in interface DataSourceFactory

Parameters:

context - allows access to the client configuration

dataSourceUpdates - the component pushes data into the SDK via this interface

Returns:

an DataSource