com.bigdata.bop.solutions

Interface ISolutionSet

All Superinterfaces:

ICheckpointProtocol, ICommitter, ICounterSetAccess, IReadWriteLockManager, ISimpleIndexAccess

All Known Implementing Classes:

SolutionSetStream

public interface ISolutionSet
extends ICheckpointProtocol

Interface for durable solution sets.

Author:

Bryan Thompson TODO Provide ISolutionSet implementations derived from HTree and BTree.

I am not sure that we will require this. We can probably use the SolutionSetStream for named solution sets for quite a while without supporting declaration of named solution sets with specific join variables. However, if we do add support for this, then we need to reconcile the HTree version with the hash join code and INamedSolutionSetRef and also add an IAccessPath for HTree and Stream backed solution sets so they can be played out through a simple iterator model. The AccessPath is relation specific, but it could be relayered to provide support for the BTree backed solution sets.

Method Summary

Methods

Modifier and Type	Method and Description
ICloseableIterator<IBindingSet[]>	get() Return an ICloseableIterator reading the solutions from the stream.
ISolutionSetStats	getStats() Return the ISolutionSetStats for the saved solution set.
void	put(ICloseableIterator<IBindingSet[]> src) Replace the contents of the stream with the solutions read from the source.
ICloseableIterator<IBindingSet>	scan() Visit all entries in the index in the natural order of the index.

Methods inherited from interface com.bigdata.btree.ICheckpointProtocol

close, dumpPages, getCheckpoint, getDirtyListener, getIndexMetadata, getLastCommitTime, getMetadataAddr, getRecordVersion, getRootAddr, isOpen, reopen, setDirtyListener, setLastCommitTime, writeCheckpoint, writeCheckpoint2

Methods inherited from interface com.bigdata.journal.ICommitter

handleCommit, invalidate

Methods inherited from interface com.bigdata.counters.ICounterSetAccess

getCounters

Methods inherited from interface com.bigdata.btree.ISimpleIndexAccess

getStore, rangeCount, removeAll

Methods inherited from interface com.bigdata.btree.IReadWriteLockManager

getReadLockCount, isReadOnly, readLock, writeLock

Method Detail

getStats

ISolutionSetStats getStats()

Return the ISolutionSetStats for the saved solution set. This may be used for query planning and should not require the backing solutions to be materialized.

Returns:

The ISolutionSetStats.

scan

ICloseableIterator<IBindingSet> scan()

Visit all entries in the index in the natural order of the index.

Specified by:

scan in interface ISimpleIndexAccess

get

ICloseableIterator<IBindingSet[]> get()

Return an ICloseableIterator reading the solutions from the stream.

put

void put(ICloseableIterator<IBindingSet[]> src)

Replace the contents of the stream with the solutions read from the source.

Parameters:

src - The source.