Module me.linusdev.data

Package de.linusdev.data.so

Interface SOData

All Superinterfaces:

AbstractData<String,Object>, Datable, Iterable<Entry<String,Object>>, SAOData<Object>, SAODatable, SODatable

All Known Subinterfaces:

SODataWrapper

All Known Implementing Classes:

SODataListImpl, SODataMapImpl, SODataWrapperImpl

public interface SOData
extends SAOData<Object>, SODatable

This represents a AbstractData, but the keys are strings and the values are objects.

SOData can be parsed to a json and json can be parsed to SOData using JsonParser. See JsonParser for restrictions.

There are different SOData implementations:

• SODataListImpl
• SODataMapImpl

The static methods of this interface should be used to create new SOData instances:

• newOrderedDataWithKnownSize(int)
• newOrderedDataWithUnknownSize()
• newHashMapData(int)

Field Summary

Fields inherited from interface de.linusdev.data.AbstractData

PARSER

Method Summary

Modifier and Type	Method	Description
default SOData	getData()
static @NotNull SOData	newHashMapData(int initialCapacity)
static @NotNull SOData	newOrderedDataWithKnownSize(int initialCapacity)	This will create a new SOData which will keep the order the elements are added.
static @NotNull SOData	newOrderedDataWithUnknownSize()	This will create a new SOData which will keep the order the elements are added.
static @NotNull SODataWrapper	wrap(Object object)

Methods inherited from interface de.linusdev.data.AbstractData

add, addEntry, addIfNotNull, addIfOptionalExists, addOrReplace, convertAndProcessIfContained, convertAndProcessIfContainedAndRequireNotNull, convertAndProcessListIfContained, convertWithExceptionAndProcessIfContained, convertWithExceptionAndProcessIfContainedAndRequireNotNull, convertWithExceptionAndProcessListIfContained, get, get, get, getAndConvert, getAndConvert, getAndConvertOrDefault, getAndConvertOrDefaultBoth, getAndConvertWithException, getAndConvertWithException, getAndRequireNotNull, getAndRequireNotNullAndConvert, getAndRequireNotNullAndConvertWithException, getAs, getAs, getAs, getAsAndRequireNotNull, getContainer, 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 @NotNull SOData newOrderedDataWithKnownSize(int initialCapacity)

This will create a new SOData which will keep the order the elements are added. This SOData 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 SOData will be in O(n), but the AbstractData.add(Object, Object) methods will be in O(1).

Parameters:

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

Returns:

SOData backed by a ArrayList

newOrderedDataWithUnknownSize

@Contract(pure=true)
@NotNull
static @NotNull SOData newOrderedDataWithUnknownSize()

This will create a new SOData 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 SOData will be in O(n), but the AbstractData.add(Object, Object) and AbstractData.remove(Object) methods will be in O(1).

Returns:

SOData backed by a LinkedList

See Also:

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

newHashMapData

@NotNull
static @NotNull SOData newHashMapData(int initialCapacity)

Parameters:

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

Returns:

SOData backed by a HashMap

wrap

@NotNull
static @NotNull SODataWrapper wrap(Object object)

Parameters:

object - object to wrap

Returns:

SODataWrapper wrapping given object

See Also:

• DataWrapper

getData

default SOData getData()

Specified by:

getData in interface AbstractData<String,Object>

Specified by:

getData in interface Datable

Specified by:

getData in interface SAODatable

Specified by:

getData in interface SODatable