Package com.launchdarkly.sdk.android.integrations

Class 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 by flag(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

    • 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 a TestData.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 and false variations, and is true by default for all contexts. You can change any of those properties, and provide more complex behavior, using the TestData.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 this TestData. If no LDClient has been started yet, it simply adds this flag to the test data which will be provided to any LDClient that you subsequently configure.

        Any subsequent changes to this TestData.FlagBuilder instance do not affect the test data, unless you call update(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 interface ComponentConfigurer<DataSource>
        Parameters:
        clientContext - provides configuration properties and other components from the current SDK client instance
        Returns:
        a instance of the component type