Package org.aksw.commons.index.core

Class StorageNodeLeafComponentSet<D,C,V,S extends Set<V>>

java.lang.Object

org.aksw.commons.index.core.StorageNodeBase<D,C,S>

org.aksw.commons.index.core.StorageNodeLeafComponentSet<D,C,V,S>

Type Parameters:

D -

C -

V -

All Implemented Interfaces:

StorageNode<D,C,S>, StorageNodeMutable<D,C,S>

public class StorageNodeLeafComponentSet<D,C,V,S extends Set<V>>
extends StorageNodeBase<D,C,S>

Essentially a view of a Set as a Map

Author:

Claus Stadler 11/09/2020

Field Summary

Fields

Modifier and Type	Field	Description
protected org.aksw.commons.tuple.TupleAccessorCore<? super V,? extends C>	keyToComponent
protected SetSupplier	setSupplier
protected TupleValueFunction<C,V>	valueFunction

Fields inherited from class org.aksw.commons.index.core.StorageNodeBase

tupleAccessor, tupleIdxs

Constructor Summary

Constructors

Constructor	Description
StorageNodeLeafComponentSet(int[] tupleIdxs, org.aksw.commons.tuple.TupleAccessor<D,C> tupleAccessor, SetSupplier setSupplier, TupleValueFunction<C,V> valueFunction, org.aksw.commons.tuple.TupleAccessorCore<? super V,? extends C> keyToComponent)

Method Summary

Modifier and Type	Method	Description
boolean	add(S set, D tupleLike)
Object	chooseSubStore(S store, int subStoreIdx)
void	clear(S store)	Clear a store's content.
List<StorageNode<D,C,?>>	getChildren()	Each node in the storage expression may have 0 or more children
C	getKeyComponentRaw(Object key, int idx)	Obtain components from the internal representation of key that was used for indexing w.r.t.
Set<?>	getStoreAsSet(Object store)
boolean	isEmpty(S store)
boolean	isSetNode()	Whether this storage node stores are sets Experimental method; may be replaced by a generic getStoreType() method that returns e.g Alt.class, Set.class, etc.
S	newStore()
boolean	remove(S set, D tupleLike)
<T> java.util.stream.Stream<V>	streamEntries(S set, T tupleLike, org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> tupleAccessor)	Stream all entries under equality constraints obtained from a tuple-like pattern
<T> Streamer<S,? extends Map.Entry<?,?>>	streamerForKeyAndSubStoreAlts(T pattern, org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> accessor)	The streamer returns entry that hold a tuple-like key and conceptually alternatives of sub-stores The tuple components of the key can be accessed using StorageNode.getKeyComponentRaw(Object, int) There are as many components as the length of StorageNode.getKeyTupleIdxs() If there is 0 components then any invocation of StorageNode.getKeyComponentRaw(Object, int) will fail with a UnsupportedOperationException.
<T> Streamer<S,?>	streamerForKeys(T pattern, org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> accessor)
<T> Streamer<S,C>	streamerForKeysAsComponent(T pattern, org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> accessor)	Compiles from a given pattern a function that can stream the matching keys from the appropriate store.
<T> Streamer<S,List<C>>	streamerForKeysAsTuples(T pattern, org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> accessor)	Compiles from a given pattern a function that can stream the matching keys from the appropriate store.
<T> Streamer<S,V>	streamerForKeysUnderConstraints(T tupleLike, org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> tupleAccessor)
<T> Streamer<S,V>	streamerForValues(T pattern, org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> accessor)	Returns an object that can extract the stream of values at an index node under constraints map: { entry.value | entry in map and entry.key matches condition} leafSet: set.entries.stream() A leaf set does not have any keys that could affect the result stream
String	toString()
V	tupleToValue(D tupleLike)

Methods inherited from class org.aksw.commons.index.core.StorageNodeBase

getKeyTupleIdxs, getTupleAccessor

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.aksw.commons.index.core.StorageNode

chooseSubStoreRaw, getKeyTupleIdxs, getPublicDelegate, getStoreAsList, getStoreAsMap, getTupleAccessor, holdsDomainTuples, isAltNode, isDelegate, isListNode, isMapNode, streamEntries, streamEntriesRaw, streamEntriesRaw

Methods inherited from interface org.aksw.commons.index.core.StorageNodeMutable

addRaw, clearRaw, isEmptyRaw, removeRaw

Field Detail

valueFunction

protected TupleValueFunction<C,V> valueFunction

keyToComponent

protected org.aksw.commons.tuple.TupleAccessorCore<? super V,? extends C> keyToComponent

setSupplier

protected SetSupplier setSupplier

Constructor Detail

StorageNodeLeafComponentSet

public StorageNodeLeafComponentSet(int[] tupleIdxs,
                                   org.aksw.commons.tuple.TupleAccessor<D,C> tupleAccessor,
                                   SetSupplier setSupplier,
                                   TupleValueFunction<C,V> valueFunction,
                                   org.aksw.commons.tuple.TupleAccessorCore<? super V,? extends C> keyToComponent)

Method Detail

tupleToValue

public V tupleToValue(D tupleLike)

getChildren

public List<StorageNode<D,C,?>> getChildren()

Description copied from interface: StorageNode

Each node in the storage expression may have 0 or more children

Returns:

add

public boolean add(S set,
                   D tupleLike)

remove

public boolean remove(S set,
                      D tupleLike)

clear

public void clear(S store)

Description copied from interface: StorageNodeMutable

Clear a store's content. Cascades to any sub-stores.

toString

public String toString()

Overrides:

toString in class Object

streamerForKeysAsComponent

public <T> Streamer<S,C> streamerForKeysAsComponent(T pattern,
                                                          org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> accessor)

Description copied from interface: StorageNode

Compiles from a given pattern a function that can stream the matching keys from the appropriate store. The keys must be instances of the component type otherwise an exception is raised

Returns:

streamerForKeysUnderConstraints

public <T> Streamer<S,V> streamerForKeysUnderConstraints(T tupleLike,
                                                               org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> tupleAccessor)

streamerForKeysAsTuples

public <T> Streamer<S,List<C>> streamerForKeysAsTuples(T pattern,
                                                             org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> accessor)

Description copied from interface: StorageNode

Compiles from a given pattern a function that can stream the matching keys from the appropriate store. The keys must be instances of the component type otherwise an exception is raised if getKeyTupleIdxs().length == 0 then returns a single tuple that projects no components

Returns:

streamerForValues

public <T> Streamer<S,V> streamerForValues(T pattern,
                                                 org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> accessor)

Description copied from interface: StorageNode

Returns an object that can extract the stream of values at an index node under constraints map: { entry.value | entry in map and entry.key matches condition} leafSet: set.entries.stream() A leaf set does not have any keys that could affect the result stream

Returns:

streamerForKeyAndSubStoreAlts

public <T> Streamer<S,? extends Map.Entry<?,?>> streamerForKeyAndSubStoreAlts(T pattern,
                                                                                          org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> accessor)

Description copied from interface: StorageNode

The streamer returns entry that hold a tuple-like key and conceptually alternatives of sub-stores The tuple components of the key can be accessed using StorageNode.getKeyComponentRaw(Object, int) There are as many components as the length of StorageNode.getKeyTupleIdxs() If there is 0 components then any invocation of StorageNode.getKeyComponentRaw(Object, int) will fail with a UnsupportedOperationException. To extract a specific alternative from the substore use StorageNode.chooseSubStore(Object, int). If StorageNode.getChildren() is not empty then there are as many substore indices as there are children If there are no children then there is an implicit single sub store with index 0

Returns:

streamEntries

public <T> java.util.stream.Stream<V> streamEntries(S set,
                                                    T tupleLike,
                                                    org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> tupleAccessor)

Description copied from interface: StorageNode

Stream all entries under equality constraints obtained from a tuple-like pattern

Returns:

streamerForKeys

public <T> Streamer<S,?> streamerForKeys(T pattern,
                                               org.aksw.commons.tuple.TupleAccessorCore<? super T,? extends C> accessor)

getKeyComponentRaw

public C getKeyComponentRaw(Object key,
                            int idx)

Description copied from interface: StorageNode

Obtain components from the internal representation of key that was used for indexing w.r.t. StorageNode.getKeyTupleIdxs().

idx - In the range 0 to {@link getKeyTupleIdxs().length} (exclusive) If a key has no components calling this method will always raise IndexOutOfBoundsException

Returns:

chooseSubStore

public Object chooseSubStore(S store,
                             int subStoreIdx)

newStore

public S newStore()

Specified by:

newStore in interface StorageNodeMutable<D,C,V>

isSetNode

public boolean isSetNode()

Description copied from interface: StorageNode

Whether this storage node stores are sets Experimental method; may be replaced by a generic getStoreType() method that returns e.g Alt.class, Set.class, etc.

Specified by:

isSetNode in interface StorageNode<D,C,V>

Returns:

getStoreAsSet

public Set<?> getStoreAsSet(Object store)

Specified by:

getStoreAsSet in interface StorageNode<D,C,V>

isEmpty

public boolean isEmpty(S store)

Specified by:

isEmpty in interface StorageNodeMutable<D,C,V>