Package org.spongepowered.api.data

Interface DataProvider<V extends Value<E>,E>

All Known Subinterfaces:

CollectionDataProvider<E,V,C>, DirectionRelativeDataProvider<V,E>

public interface DataProvider<V extends Value<E>,E>

Method Summary

Modifier and Type	Method	Description
boolean	allowsAsynchronousAccess(DataHolder dataHolder)	Gets whether this provider will allow asynchronous access for retrieving and storing value changes through the API and implementation.
Optional<E>	get(DataHolder dataHolder)	Gets the elemental value from the provided DataHolder.
static <H extends DataHolder, V extends Value<E>, E> ImmutableDataProviderBuilder<H,V,E>	immutableBuilder()	Constructs a new ImmutableDataProviderBuilder.
default boolean	isSupported(io.leangen.geantyref.TypeToken<? extends DataHolder> dataHolder)
boolean	isSupported(Type dataHolder)
boolean	isSupported(DataHolder dataHolder)	Gets whether this value provider is supported by the given ValueContainer.
Key<V>	key()	Gets the Key this provider supports.
static <H extends DataHolder.Mutable, V extends Value<E>, E> MutableDataProviderBuilder<H,V,E>	mutableBuilder()	Constructs a new MutableDataProviderBuilder.
DataTransactionResult	offer(DataHolder.Mutable dataHolder, E element)
default DataTransactionResult	offerValue(DataHolder.Mutable dataHolder, V value)
DataTransactionResult	remove(DataHolder.Mutable dataHolder)
default Optional<V>	value(DataHolder dataHolder)	Gets a constructed Value for the provided DataHolder.
<I extends DataHolder.Immutable<I>> Optional<I>	with(I immutable, E element)
<I extends DataHolder.Immutable<I>> Optional<I>	without(I immutable)	Gets a DataHolder.Immutable without a Value with the target Key, if successful.
default <I extends DataHolder.Immutable<I>> Optional<I>	withValue(I immutable, V value)

Method Details

mutableBuilder

static <H extends DataHolder.Mutable,
V extends Value<E>,
E>
MutableDataProviderBuilder<H,V,E> mutableBuilder()

Constructs a new MutableDataProviderBuilder.

Returns:

The builder

immutableBuilder

static <H extends DataHolder,
V extends Value<E>,
E>
ImmutableDataProviderBuilder<H,V,E> immutableBuilder()

Constructs a new ImmutableDataProviderBuilder.

Returns:

The builder

key

Key<V> key()

Gets the Key this provider supports.

Returns:

The key

allowsAsynchronousAccess

boolean allowsAsynchronousAccess(DataHolder dataHolder)

Gets whether this provider will allow asynchronous access for retrieving and storing value changes through the API and implementation. This is usually sanity checked by the implementation through a simplified Engine.onMainThread() as a majority of datas are required to be synchronous if the changes can end up throwing ChangeDataHolderEvents.

A list of methods that are constrained by this check are:

• - get(DataHolder)
• - offer(DataHolder.Mutable, Object)
• - remove(DataHolder.Mutable)

Conceptually, an immutable DataHolder will be ignorant of asynchronous access, however, some cases may exist where attempting to create new immutable variants with different values can be still limited by synchronous access.

Parameters:

dataHolder - The data holder

Returns:

True if this provider allows asynchronous access

get

Optional<E> get(DataHolder dataHolder)

Gets the elemental value from the provided DataHolder. This is generally considered the underlying implementation access for any ValueContainer.get(Key) where the Key is registered with this DataProvider. Nominally, this means the data is provided outside traditional serialized data that is stored with the DataHolder. It's possible that there may be changing return values for even immutable types, since the provider is providing the data.

Parameters:

dataHolder - The data holder

Returns:

The value, if it's supported and exists

value

default Optional<V> value(DataHolder dataHolder)

Gets a constructed Value for the provided DataHolder. Much like get(DataHolder), this is generally considered the underlying implementation access for any ValueContainer.get(Key) where the Key is registered with this DataProvider. Nominally, this means the data is provided outside traditional serialized data that is stored with the DataHolder. It's possible that there may be changing return values for even immutable types, since the provider is providing the data.

Parameters:

dataHolder - The data holder to get the constructed value from

Returns:

The value

isSupported

boolean isSupported(DataHolder dataHolder)

Gets whether this value provider is supported by the given ValueContainer.

Parameters:

dataHolder - The data holder

Returns:

Whether it's supported

isSupported

default boolean isSupported(io.leangen.geantyref.TypeToken<? extends DataHolder> dataHolder)

isSupported

boolean isSupported(Type dataHolder)

offer

DataTransactionResult offer(DataHolder.Mutable dataHolder,
 E element)

offerValue

default DataTransactionResult offerValue(DataHolder.Mutable dataHolder,
 V value)

remove

DataTransactionResult remove(DataHolder.Mutable dataHolder)

with

<I extends DataHolder.Immutable<I>> Optional<I> with(I immutable,
 E element)

withValue

default <I extends DataHolder.Immutable<I>>
Optional<I> withValue(I immutable,
 V value)

without

<I extends DataHolder.Immutable<I>> Optional<I> without(I immutable)

Gets a DataHolder.Immutable without a Value with the target Key, if successful.

Type Parameters:

I - The type of the immutable value store

Parameters:

immutable - The immutable value store

Returns:

The new value store, if successful