Package org.spongepowered.api.data

Interface DataRegistration

public interface DataRegistration

An optional registration of keys to associate a semi-persistent state of their associated values that can be stored, retrieved, persisted, and/or associated with DataHolders. A registration identifies the given Keys are provided by an implementation for specific DataHolders that may support and not support those keys. All API provided keys exposed through the Keys class will have an associated registration by the implementation of the API, whether they are usable through DataProviders or DataStores.

If dynamic or persistent retention of the Values by keys is not desired, a registration is optional. This would mean that any submitted Values of a Key without an associated DataRegistration will be only stored on a mutable DataHolder for the duration that that holder exists. The value would not persist between reloads, restarts, etc.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	DataRegistration.Builder	A standard builder for constructing new DataRegistrations.

Method Summary

Modifier and Type	Method	Description
static DataRegistration.Builder	builder()	Creates a new DataRegistration.Builder to build a DataRegistration.
Optional<DataStore>	dataStore(io.leangen.geantyref.TypeToken<? extends DataHolder> token)	Gets the appropriate DataStore for the context of the TypeToken that is being serialized/deserialized.
Optional<DataStore>	dataStore(Class<? extends DataHolder> token)	Gets the appropriate DataStore for the context of the TypeToken that is being serialized/deserialized.
Iterable<Key<?>>	keys()	Gets the registered Keys this controls.
static <T,V extends Value<T>> DataRegistration	of(Key<V> key, Class<? extends DataHolder> dataHolder, Class<? extends DataHolder>... dataHolders)	Creates a DataRegistration for a single key with a DataStore for given data-holders.
<V extends Value<E>,E> Collection<DataProvider<V,E>>	providersFor(Key<V> key)	Gets the DataProvider for the given Key to potentially get or offer Values from any ValueContainer provided that the container is supported by the DataProvider.

Method Detail

builder

static DataRegistration.Builder builder()

Creates a new DataRegistration.Builder to build a DataRegistration. Through the use of generics, this can be duck-typed to the generics of the desired DataManipulator type to be registered.

Returns:

The new builder instance

providersFor

<V extends Value<E>,E> Collection<DataProvider<V,E>> providersFor(Key<V> key)
                                                                       throws UnregisteredKeyException

Gets the DataProvider for the given Key to potentially get or offer Values from any ValueContainer provided that the container is supported by the DataProvider. If the key is not actually registered with this DataRegistration, an UnregisteredKeyException is thrown. If there is no DataProvider registered for the particular Key, Optional.empty() is returned.

Type Parameters:

V - The value type

E - The element type

Parameters:

key - The requested key

Returns:

The provider, if there is one for the key

Throws:

UnregisteredKeyException - If the key is not registered in this registration

dataStore

Optional<DataStore> dataStore(io.leangen.geantyref.TypeToken<? extends DataHolder> token)

Gets the appropriate DataStore for the context of the TypeToken that is being serialized/deserialized. It is always possible that there may be a DataStore that does not support the provided TypeToken, while a DataProvider may be provided for a particular Key.

Parameters:

token - The type token of the desired ValueContainer

Returns:

The relevant DataStore for the desired type token of the target type.

dataStore

Optional<DataStore> dataStore(Class<? extends DataHolder> token)

Gets the appropriate DataStore for the context of the TypeToken that is being serialized/deserialized. It is always possible that there may be a DataStore that does not support the provided Class, while a DataProvider may be provided for a particular Key.

Parameters:

token - The class of the desired ValueContainer. Cannot be a raw type

Returns:

The relevant DataStore for the desired type token of the target type.

keys

Iterable<Key<?>> keys()

Gets the registered Keys this controls. Note that each Key can only be registered/owned by a single PluginContainer. It is possible for there to be only a single key registered, or multiple, depending on the basis of what potentially grouped values are controlled by a single DataStore or multiple DataProviders, based on the supported DataHolders.

Returns:

The keys registered

of

@SafeVarargs
static <T,V extends Value<T>> DataRegistration of(Key<V> key,
                                                        Class<? extends DataHolder> dataHolder,
                                                        Class<? extends DataHolder>... dataHolders)

Creates a DataRegistration for a single key with a DataStore for given data-holders.

Type Parameters:

T - the value's type

V - the value type

Parameters:

key - the data key

dataHolders - the data-holders

Returns:

The built data registration