Package com.terracottatech.store.definition

Class StoreListImpl

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<TypedValue<?>>

com.terracottatech.store.definition.StoreListImpl

All Implemented Interfaces:

ComplexData, StoreList, Iterable<TypedValue<?>>, Collection<TypedValue<?>>, List<TypedValue<?>>

public class StoreListImpl
extends AbstractList<TypedValue<?>>
implements StoreList

Nested Class Summary

Nested classes/interfaces inherited from interface com.terracottatech.store.ComplexData

ComplexData.DotSpecParseException

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor	Description
StoreListImpl()
StoreListImpl(com.terracottatech.tcson.MutableSonList mutable)
StoreListImpl(com.terracottatech.tcson.MutableSonList list, boolean mutable)
StoreListImpl(com.terracottatech.tcson.ReadableSonList list)
StoreListImpl(List<TypedValue<?>> incoming)

Method Summary

Modifier and Type	Method	Description
void	add(int index, TypedValue<?> element)
boolean	add(TypedValue<?> value)
void	clear()
boolean	equals(Object o)
TypedValueSelection	find(String dotSpec)	Do a filtering find operation across this object based on the Dot Notation given.
TypedValue<?>	get(int index)
int	hashCode()	hashcode() implementations of Complex list objects do not necessarily adhere to the default Java List contract for hashcode.
boolean	isEmpty()	Is this object empty?
boolean	isMutable()	Is this a mutable representation?
Iterator<TypedValue<?>>	iterator()
com.terracottatech.tcson.SonList<? extends com.terracottatech.tcson.SonValue>	liveList()
StoreListImpl	mutableCopy()	Make a copy of this instance that is assured to be mutable.
TypedValue<?>	remove(int index)
boolean	remove(Object o)
TypedValue<?>	set(int index, TypedValue<?> element)
int	size()	Size (number of elements) in this object.
String	toString()
String	toString(boolean skipWhitespace)	Generate a string representation of this object in the specified format, with the specified compactness.

Methods inherited from class java.util.AbstractList

addAll, indexOf, lastIndexOf, listIterator, listIterator, removeRange, subList

Methods inherited from class java.util.AbstractCollection

addAll, contains, containsAll, removeAll, retainAll, toArray, toArray

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface com.terracottatech.store.ComplexData

notEmpty

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

addAll, addAll, contains, containsAll, indexOf, lastIndexOf, listIterator, listIterator, removeAll, replaceAll, retainAll, sort, spliterator, subList, toArray, toArray

Methods inherited from interface com.terracottatech.store.StoreList

with, with, with, with, with, with, with, with, with, with

Constructor Details

StoreListImpl

public StoreListImpl(List<TypedValue<?>> incoming)

StoreListImpl

public StoreListImpl(com.terracottatech.tcson.ReadableSonList list)

StoreListImpl

public StoreListImpl(com.terracottatech.tcson.MutableSonList mutable)

StoreListImpl

public StoreListImpl(com.terracottatech.tcson.MutableSonList list,
 boolean mutable)

StoreListImpl

public StoreListImpl()

Method Details

find

public TypedValueSelection find(String dotSpec)

Description copied from interface: ComplexData

Do a filtering find operation across this object based on the Dot Notation given.

Dot notation is fairly simple yet powerful.

• '.' by itself matches the current object.
• '.foo' if the top level object is a map, matches the value of the 'foo' key
• '.foo.bar' matches the top level object as a map, then the value at key 'foo', then matches if that value is a map, then matches the value of its key 'bar'. etc.
• map keys for matching can also be expressed with more explicit
  • '.[foo bar].[baz]'
  • '.["foo\nbar"].baz'
• '.[1]' matches the list entry at index 1 (lists are zero based)
• '.[1:3]' matches the slice from 1 to 3 inclusive.
• finally, a stanza of '.[].' matches all entries. (wildcard)

This allows for reaching inside a nested complex structure and identifying only those pieces of interest. For example: '.employees.[].[first name]' might reach into a map, grab the list at key 'employees', go through every entry in the list, treat as a map, then grab the value of the 'first name' key in each map, this returning a list of every employee's first name.

Specified by:

find in interface ComplexData

Parameters:

dotSpec - dot specification

Returns:

Selection of matching TypedValue

get

public TypedValue<?> get(int index)

Specified by:

get in interface List<TypedValue<?>>

Specified by:

get in class AbstractList<TypedValue<?>>

liveList

public com.terracottatech.tcson.SonList<? extends com.terracottatech.tcson.SonValue> liveList()

mutableCopy

public StoreListImpl mutableCopy()

Description copied from interface: StoreList

Make a copy of this instance that is assured to be mutable.

Specified by:

mutableCopy in interface ComplexData

Specified by:

mutableCopy in interface StoreList

Returns:

mutable copy.

isMutable

public boolean isMutable()

Description copied from interface: ComplexData

Is this a mutable representation?

Specified by:

isMutable in interface ComplexData

Returns:

true if mutable

size

public int size()

Description copied from interface: ComplexData

Size (number of elements) in this object.

Specified by:

size in interface Collection<TypedValue<?>>

Specified by:

size in interface ComplexData

Specified by:

size in interface List<TypedValue<?>>

Specified by:

size in class AbstractCollection<TypedValue<?>>

Returns:

number of elements.

isEmpty

public boolean isEmpty()

Description copied from interface: ComplexData

Is this object empty?

Specified by:

isEmpty in interface Collection<TypedValue<?>>

Specified by:

isEmpty in interface ComplexData

Specified by:

isEmpty in interface List<TypedValue<?>>

Overrides:

isEmpty in class AbstractCollection<TypedValue<?>>

Returns:

true if empty.

iterator

public Iterator<TypedValue<?>> iterator()

Specified by:

iterator in interface Collection<TypedValue<?>>

Specified by:

iterator in interface Iterable<TypedValue<?>>

Specified by:

iterator in interface List<TypedValue<?>>

Overrides:

iterator in class AbstractList<TypedValue<?>>

add

public boolean add(TypedValue<?> value)

Specified by:

add in interface Collection<TypedValue<?>>

Specified by:

add in interface List<TypedValue<?>>

Overrides:

add in class AbstractList<TypedValue<?>>

set

public TypedValue<?> set(int index,
 TypedValue<?> element)

Specified by:

set in interface List<TypedValue<?>>

Overrides:

set in class AbstractList<TypedValue<?>>

add

public void add(int index,
 TypedValue<?> element)

Specified by:

add in interface List<TypedValue<?>>

Overrides:

add in class AbstractList<TypedValue<?>>

remove

public TypedValue<?> remove(int index)

Specified by:

remove in interface List<TypedValue<?>>

Overrides:

remove in class AbstractList<TypedValue<?>>

clear

public void clear()

Specified by:

clear in interface Collection<TypedValue<?>>

Specified by:

clear in interface List<TypedValue<?>>

Overrides:

clear in class AbstractList<TypedValue<?>>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<TypedValue<?>>

Specified by:

remove in interface List<TypedValue<?>>

Overrides:

remove in class AbstractCollection<TypedValue<?>>

equals

public boolean equals(Object o)

Specified by:

equals in interface Collection<TypedValue<?>>

Specified by:

equals in interface List<TypedValue<?>>

Overrides:

equals in class AbstractList<TypedValue<?>>

hashCode

public int hashCode()

Description copied from interface: StoreList

hashcode() implementations of Complex list objects do not necessarily adhere to the default Java List contract for hashcode.

Specified by:

hashCode in interface Collection<TypedValue<?>>

Specified by:

hashCode in interface List<TypedValue<?>>

Specified by:

hashCode in interface StoreList

Overrides:

hashCode in class AbstractList<TypedValue<?>>

Returns:

hashcode.

toString

public String toString(boolean skipWhitespace)

Description copied from interface: ComplexData

Generate a string representation of this object in the specified format, with the specified compactness.

Native format is TC son, which is a more strongly typed version of JSON. Alternatively, the JSON compatible format grinds everything without a JSON type (chars, byte arrays) to strings, and all three numeric types become just JSON numbers.

Specified by:

toString in interface ComplexData

Parameters:

skipWhitespace - line breaks and indention, or not.

Returns:

String version of this object.

toString

public String toString()

Overrides:

toString in class AbstractCollection<TypedValue<?>>