Interface SAOData<O>

All Superinterfaces:

AbstractData<String,O>, Datable, Iterable<Entry<String,O>>

All Known Subinterfaces:

SAODataWrapper<O>, SOData, SODataWrapper

All Known Implementing Classes:

SAOContentOnlyDataListImpl, SAODataListImpl, SAODataMapImpl, SAODataWrapperImpl, SODataListImpl, SODataMapImpl, SODataWrapperImpl

public interface SAOData<O>
extends AbstractData<String,O>

Field Summary

Fields inherited from interface de.linusdev.data.AbstractData

PARSER

Method Summary

Modifier and Type	Method	Description
@NotNull SAOData<O>	add(@NotNull String key, O value)	Adds a new Entry.
static <O> @NotNull SAOData<O>	newHashMapData(int initialCapacity)
static <O> @NotNull SAOData<O>	newOrderedDataWithKnownSize(int initialCapacity)	This will create a new SAOData which will keep the order the elements are added.
static <O> @NotNull SAOData<O>	newOrderedDataWithUnknownSize()	This will create a new SAOData which will keep the order the elements are added.
static <V> @NotNull SAOData<V>	ofMap(@NotNull Map<String,V> map)	Create a SAOData of given map.

Methods inherited from interface de.linusdev.data.AbstractData

addAndGet, addEntry, addIfNotNull, addIfOptionalExists, addOrReplace, clear, computeIfAbsent, computeIfAbsentOrNull, convertAndProcessIfContained, convertAndProcessIfContainedAndRequireNotNull, convertAndProcessListIfContained, convertWithExceptionAndProcessIfContained, convertWithExceptionAndProcessIfContainedAndRequireNotNull, convertWithExceptionAndProcessListIfContained, get, get, get, getAndConvert, getAndConvert, getAndConvertOrDefault, getAndConvertOrDefaultBoth, getAndConvertWithException, getAndConvertWithException, getAndRequireNotNull, getAndRequireNotNullAndConvert, getAndRequireNotNullAndConvertWithException, getAs, getAs, getAs, getAsAndRequireNotNull, getContainer, getData, getEntry, getList, getList, getListAndConvert, getListAndConvertAndFreeMemory, getListAndConvertWithException, getListAndConvertWithExceptionAndFreeMemory, getNumberAsByte, getNumberAsDouble, getNumberAsFloat, getNumberAsInt, getNumberAsLong, getNumberAsShort, getOptionalValue, getOptionalValueAndConvert, getOptionalValueAndConvertWithException, getOrDefault, getOrDefault, getOrDefaultBoth, getParseType, isEmpty, processIfContained, processIfContainedAndRequireNotNull, processIfNotNull, processListIfContained, remove, size, toJsonString, toRecord

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Method Details

newOrderedDataWithKnownSize

@Contract(pure=true)
@NotNull
static <O> @NotNull SAOData<O> newOrderedDataWithKnownSize(int initialCapacity)

This will create a new SAOData which will keep the order the elements are added. This SAOData will be backed by a ArrayList with given initialCapacity.
This is useful for data objects with known sizes or for data objects with small sizes.

The AbstractData.get(Object) and AbstractData.remove(Object) methods of the returned SAOData will be in O(n), but the add(String, Object) methods will be in O(1).

Parameters:

initialCapacity - the initialCapacity of the ArrayList, which will back the SAOData

Returns:

SAOData backed by a ArrayList

newOrderedDataWithUnknownSize

@Contract(pure=true)
@NotNull
static <O> @NotNull SAOData<O> newOrderedDataWithUnknownSize()

This will create a new SAOData which will keep the order the elements are added. This SODataListImpl will be backed by a backed by a LinkedList.
This is useful for data objects with Unknown sizes.

The AbstractData.get(Object) methods of the returned SAOData will be in O(n), but the add(String, Object) and AbstractData.remove(Object) methods will be in O(1).

Returns:

SAOData backed by a LinkedList

See Also:

• for very small (less than 10 elemets) you should generrally use the ArrayList implemenation

newHashMapData

@NotNull
static <O> @NotNull SAOData<O> newHashMapData(int initialCapacity)

Parameters:

initialCapacity - the initialCapacity of the HashMap which will back the SAOData

Returns:

SAOData backed by a HashMap

ofMap

@NotNull
static <V> @NotNull SAOData<V> ofMap(@NotNull
 @NotNull Map<String,V> map)

Create a SAOData of given map. The SAOData will have the same content as given map.

Returns:

New SAOData backed by given map.

add

@NotNull
@NotNull SAOData<O> add(@NotNull
 @NotNull String key,
 @Nullable
 O value)

Description copied from interface: AbstractData

Adds a new Entry.

This method might not check, if a Entry with given key already exits. Depending on the implementation, this might even override existing mappings (for Example SODataMapImpl).

Specified by:

add in interface AbstractData<String,O>

Parameters:

key - key

value - value

Returns:

this