Class TestData
- java.lang.Object
-
- com.launchdarkly.sdk.android.integrations.TestData
-
- All Implemented Interfaces:
ComponentConfigurer<DataSource>
public final class TestData extends java.lang.Object implements ComponentConfigurer<DataSource>
A mechanism for providing dynamically updatable feature flag state in a simplified form to an SDK client in test scenarios.This mechanism does not use any external resources. It provides only the data that the application has put into it using the
update(FlagBuilder)
method.The example code below uses a simple boolean flag, but more complex configurations are possible using the methods of the
TestData.FlagBuilder
that is returned byflag(String)
.TestData td = TestData.dataSource(); td.update(testData.flag("flag-key-1").booleanFlag().variation(true)); LDConfig config = new LDConfig.Builder() .mobileKey("my-mobile-key") .dataSource(td) .build(); LDClient client = new LDClient(sdkKey, config, initialContext, startWaitSeconds); // flags can be updated at any time: td.update(testData.flag("flag-key-2") .variationForUser("some-user-key", false));
- Since:
- 4.0.0
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
TestData.FlagBuilder
A builder for feature flag configurations to be used withTestData
.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description DataSource
build(ClientContext clientContext)
Called internally by the SDK to create an implementation instance.static TestData
dataSource()
Creates a new instance of the test data source.TestData.FlagBuilder
flag(java.lang.String key)
Creates or copies aTestData.FlagBuilder
for building a test flag configuration.TestData
update(TestData.FlagBuilder flagBuilder)
Updates the test data with the specified flag configuration.
-
-
-
Method Detail
-
dataSource
public static TestData dataSource()
Creates a new instance of the test data source.See
TestData
for details.- Returns:
- a new configurable test data source
-
flag
public TestData.FlagBuilder flag(java.lang.String key)
Creates or copies aTestData.FlagBuilder
for building a test flag configuration.If this flag key has already been defined in this
TestData
instance, then the builder starts with the same configuration that was last provided for this flag.Otherwise, it starts with a new default configuration in which the flag has
true
andfalse
variations, and istrue
by default for all contexts. You can change any of those properties, and provide more complex behavior, using theTestData.FlagBuilder
\ methods.Once you have set the desired configuration, pass the builder to
update(FlagBuilder)
.- Parameters:
key
- the flag key- Returns:
- a flag configuration builder
- See Also:
update(FlagBuilder)
-
update
public TestData update(TestData.FlagBuilder flagBuilder)
Updates the test data with the specified flag configuration.This has the same effect as if a flag were added or modified on the LaunchDarkly dashboard. It immediately propagates the flag change to any
LDClient
instance(s) that you have already configured to use thisTestData
. If noLDClient
has been started yet, it simply adds this flag to the test data which will be provided to anyLDClient
that you subsequently configure.Any subsequent changes to this
TestData.FlagBuilder
instance do not affect the test data, unless you callupdate(FlagBuilder)
again.- Parameters:
flagBuilder
- a flag configuration builder- Returns:
- the same
TestData
instance - See Also:
flag(String)
-
build
public DataSource build(ClientContext clientContext)
Description copied from interface:ComponentConfigurer
Called internally by the SDK to create an implementation instance. Applications should not need to call this method.- Specified by:
build
in interfaceComponentConfigurer<DataSource>
- Parameters:
clientContext
- provides configuration properties and other components from the current SDK client instance- Returns:
- a instance of the component type
-
-