Package tools.refinery.interpreter.matchers.memories

Class UnaryMaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

java.lang.Object

tools.refinery.interpreter.matchers.memories.MaskedTupleMemory<Timestamp>

tools.refinery.interpreter.matchers.memories.UnaryMaskedTupleMemory<Timestamp>

All Implemented Interfaces:

Clearable, MaskedResumable<Timestamp>, Resumable<Timestamp>

public final class UnaryMaskedTupleMemory<Timestamp extends Comparable<Timestamp>>
extends MaskedTupleMemory<Timestamp>

Specialized for unary mask; tuples are indexed by a single column as opposed to a projection (signature) tuple.

Since:

2.0

Field Summary

Fields

Modifier and Type	Field	Description
protected IMultiLookup<Object,Tuple>	columnToTuples
protected final int	keyPosition

Fields inherited from class tools.refinery.interpreter.matchers.memories.MaskedTupleMemory

mask, owner

Constructor Summary

Constructors

Constructor	Description
UnaryMaskedTupleMemory(TupleMask mask, CollectionsFactory.MemoryType bucketType, Object owner)

Method Summary

Modifier and Type	Method	Description
boolean	add(Tuple tuple)	Adds a tuple occurrence to the memory.
boolean	add(Tuple tuple, Tuple signature)	Adds a tuple occurrence to the memory with the given signature.
protected boolean	addInternal(Tuple tuple, Object key)
void	clear()	Clear all partial matchings stored in memory
Collection<Tuple>	get(ITuple signature)	Retrieves tuples that have the specified signature
int	getKeysetSize()
Iterable<Tuple>	getSignatures()	Retrieves a read-only view of exactly those signatures for which at least one tuple is stored
int	getTotalSize()
Map<Tuple,Timeline<Timestamp>>	getWithTimeline(ITuple signature)	Retrieves the tuples and their associated timelines that have the specified signature.
Iterator<Tuple>	iterator()	Iterates over distinct tuples stored in the memory, regardless of their signatures.
boolean	remove(Tuple tuple)	Removes a tuple occurrence from the memory.
boolean	remove(Tuple tuple, Tuple signature)	Removes a tuple occurrence from the memory with the given signature.
protected boolean	removeInternal(Tuple tuple, Object key)

Methods inherited from class tools.refinery.interpreter.matchers.memories.MaskedTupleMemory

addWithTimestamp, addWithTimestamp, create, create, create, getMask, getOrEmpty, getOrEmptyWithTimeline, getOwner, getResumableSignatures, getResumableTimestamp, initializeWith, isPresentAtInfinity, isTimely, raiseDuplicateDeletion, raiseDuplicateInsertion, removeWithTimestamp, removeWithTimestamp, resumeAt, toString

Methods inherited from class java.lang.Object

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

Field Details

columnToTuples

protected IMultiLookup<Object,Tuple> columnToTuples

keyPosition

protected final int keyPosition

Constructor Details

UnaryMaskedTupleMemory

public UnaryMaskedTupleMemory(TupleMask mask,
 CollectionsFactory.MemoryType bucketType,
 Object owner)

Parameters:

mask - The mask used to index the matchings

bucketType - the kind of tuple collection maintained for each indexer bucket

owner - the object "owning" this memory

Since:

2.0

Method Details

clear

public void clear()

Description copied from interface: Clearable

Clear all partial matchings stored in memory

getKeysetSize

public int getKeysetSize()

Specified by:

getKeysetSize in class MaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

Returns:

the number of distinct signatures of all stored tuples.

getTotalSize

public int getTotalSize()

Specified by:

getTotalSize in class MaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

Returns:

the total number of distinct tuples stored. Multiple copies of the same tuple, if allowed, are counted as one.

This is currently not cached but computed on demand. It is therefore not efficient, and shall only be used for debug / profiling purposes.

iterator

public Iterator<Tuple> iterator()

Description copied from class: MaskedTupleMemory

Iterates over distinct tuples stored in the memory, regardless of their signatures.

Specified by:

iterator in class MaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

getSignatures

public Iterable<Tuple> getSignatures()

Description copied from class: MaskedTupleMemory

Retrieves a read-only view of exactly those signatures for which at least one tuple is stored

Specified by:

getSignatures in class MaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

get

public Collection<Tuple> get(ITuple signature)

Description copied from class: MaskedTupleMemory

Retrieves tuples that have the specified signature

Specified by:

get in class MaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

Returns:

collection of tuples found, null if none

getWithTimeline

public Map<Tuple,Timeline<Timestamp>> getWithTimeline(ITuple signature)

Description copied from class: MaskedTupleMemory

Retrieves the tuples and their associated timelines that have the specified signature.

Specified by:

getWithTimeline in class MaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

Returns:

the mappings from tuples to timelines, null if there is no mapping for the signature

remove

public boolean remove(Tuple tuple,
 Tuple signature)

Description copied from class: MaskedTupleMemory

Removes a tuple occurrence from the memory with the given signature.

Overrides:

remove in class MaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

Parameters:

tuple - the tuple to be removed from the memory

signature - precomputed footprint of the tuple according to the mask

Returns:

true if this was the the last occurrence of the signature (according to the mask)

remove

public boolean remove(Tuple tuple)

Description copied from class: MaskedTupleMemory

Removes a tuple occurrence from the memory.

Overrides:

remove in class MaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

Parameters:

tuple - the tuple to be removed from the memory

Returns:

true if this was the the last occurrence of the signature (according to the mask)

add

public boolean add(Tuple tuple,
 Tuple signature)

Description copied from class: MaskedTupleMemory

Adds a tuple occurrence to the memory with the given signature.

Overrides:

add in class MaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

Parameters:

tuple - the tuple to be added to the memory

signature - precomputed footprint of the tuple according to the mask

Returns:

true if new signature encountered (according to the mask)

add

public boolean add(Tuple tuple)

Description copied from class: MaskedTupleMemory

Adds a tuple occurrence to the memory.

Overrides:

add in class MaskedTupleMemory<Timestamp extends Comparable<Timestamp>>

Parameters:

tuple - the tuple to be added to the memory

Returns:

true if new signature encountered (according to the mask)

addInternal

protected boolean addInternal(Tuple tuple,
 Object key)

removeInternal

protected boolean removeInternal(Tuple tuple,
 Object key)