com.launchdarkly.client

Class InMemoryFeatureStore

java.lang.Object

com.launchdarkly.client.InMemoryFeatureStore

All Implemented Interfaces:

FeatureStore, DiagnosticDescription, java.io.Closeable, java.lang.AutoCloseable

Direct Known Subclasses:

TestFeatureStore

public class InMemoryFeatureStore
extends java.lang.Object
implements FeatureStore, DiagnosticDescription

A thread-safe, versioned store for feature flags and related data based on a HashMap. This is the default implementation of FeatureStore.

Constructor Summary

Constructors

Constructor and Description
InMemoryFeatureStore()

Method Summary

Modifier and Type	Method and Description
<T extends VersionedData> java.util.Map<java.lang.String,T>	all(VersionedDataKind<T> kind) Returns a Map of all associated objects of a given kind.
void	close() Does nothing; this class does not have any resources to release
<T extends VersionedData> void	delete(VersionedDataKind<T> kind, java.lang.String key, int version) Deletes the object associated with the specified key, if it exists and its version is less than or equal to the specified version.
LDValue	describeConfiguration(LDConfig config) Used internally by the SDK to inspect the configuration.
<T extends VersionedData> T	get(VersionedDataKind<T> kind, java.lang.String key) Returns the object to which the specified key is mapped, or null if the key is not associated or the associated object has been deleted.
void	init(java.util.Map<VersionedDataKind<?>,java.util.Map<java.lang.String,? extends VersionedData>> allData) Initializes (or re-initializes) the store with the specified set of objects.
boolean	initialized() Returns true if this store has been initialized.
<T extends VersionedData> void	upsert(VersionedDataKind<T> kind, T item) Update or insert the object associated with the specified key, if its version is less than or equal to the version specified in the argument object.

Methods inherited from class java.lang.Object

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

Constructor Detail

InMemoryFeatureStore

public InMemoryFeatureStore()

Method Detail

get

public <T extends VersionedData> T get(VersionedDataKind<T> kind,
                                       java.lang.String key)

Description copied from interface: FeatureStore

Returns the object to which the specified key is mapped, or null if the key is not associated or the associated object has been deleted.

Specified by:

get in interface FeatureStore

Type Parameters:

T - class of the object that will be returned

Parameters:

kind - the kind of object to get

key - the key whose associated object is to be returned

Returns:

the object to which the specified key is mapped, or null if the key is not associated or the associated object has been deleted.

all

public <T extends VersionedData> java.util.Map<java.lang.String,T> all(VersionedDataKind<T> kind)

Description copied from interface: FeatureStore

Returns a Map of all associated objects of a given kind.

Specified by:

all in interface FeatureStore

Type Parameters:

T - class of the objects that will be returned in the map

Parameters:

kind - the kind of objects to get

Returns:

a map of all associated object.

init

public void init(java.util.Map<VersionedDataKind<?>,java.util.Map<java.lang.String,? extends VersionedData>> allData)

Description copied from interface: FeatureStore

Initializes (or re-initializes) the store with the specified set of objects. Any existing entries will be removed. Implementations can assume that this set of objects is up to date-- there is no need to perform individual version comparisons between the existing objects and the supplied features.

If possible, the store should update the entire data set atomically. If that is not possible, it should iterate through the outer map and then the inner map in the order provided (the SDK will use a Map subclass that has a defined ordering), storing each item, and then delete any leftover items at the very end.

The store should not attempt to modify any of the Maps, and if it needs to retain the data in memory it should copy the Maps.

Specified by:

init in interface FeatureStore

Parameters:

allData - all objects to be stored

delete

public <T extends VersionedData> void delete(VersionedDataKind<T> kind,
                                             java.lang.String key,
                                             int version)

Description copied from interface: FeatureStore

Deletes the object associated with the specified key, if it exists and its version is less than or equal to the specified version.

Specified by:

delete in interface FeatureStore

Type Parameters:

T - class of the object to be deleted

Parameters:

kind - the kind of object to delete

key - the key of the object to be deleted

version - the version for the delete operation

upsert

public <T extends VersionedData> void upsert(VersionedDataKind<T> kind,
                                             T item)

Description copied from interface: FeatureStore

Update or insert the object associated with the specified key, if its version is less than or equal to the version specified in the argument object.

Specified by:

upsert in interface FeatureStore

Type Parameters:

T - class of the object to be updated

Parameters:

kind - the kind of object to update

item - the object to update or insert

initialized

public boolean initialized()

Description copied from interface: FeatureStore

Returns true if this store has been initialized.

Specified by:

initialized in interface FeatureStore

Returns:

true if this store has been initialized

close

public void close()
           throws java.io.IOException

Does nothing; this class does not have any resources to release

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException - will never happen

describeConfiguration

public LDValue describeConfiguration(LDConfig config)

Description copied from interface: DiagnosticDescription

Used internally by the SDK to inspect the configuration.

Specified by:

describeConfiguration in interface DiagnosticDescription

Parameters:

config - the full configuration, in case this component depends on properties outside itself

Returns:

an LDValue or null