Package com.semedy.reasoner.reasoning.processes

Class BufferedStore

java.lang.Object

com.semedy.reasoner.reasoning.processes.ProcessImp

com.semedy.reasoner.reasoning.processes.UnbufferedStore

com.semedy.reasoner.reasoning.processes.BufferedStore

All Implemented Interfaces:

Receiver, Process, Store

Direct Known Subclasses:

EmptyStore, SynchronizedBufferedStore, TopDownBufferedStore

public class BufferedStore
extends UnbufferedStore
implements Store

Stores intermediate results: results between two rule bodies or results of rule evaluations
For recursive rules or recursion cycles results must be buffered.
Performs duplicate elimination if necessary

Author:

angele

Constructor Summary

Constructors

Constructor	Description
BufferedStore(InterruptFlag interruptFlag, ReasoningMonitor monitor, int arity, String predicate, boolean cepReasoning, boolean cepReasoningWithRetracts, ProcessExecutor executor, boolean sorted)
BufferedStore(InterruptFlag interruptFlag, ReasoningMonitor monitor, int arity, String predicate, boolean cepReasoning, boolean cepReasoningWithRetracts, String tempDir, boolean swapping, ProcessExecutor executor, boolean sorted)

Method Summary

Modifier and Type	Method	Description
void	addNegatedNeighbour(And join)	add a negated rule body operator as next operator
void	addNeighbour(And join)	add a rule body operator as next operator
void	addRelation(ReasoningRelation R)	add a whole relation at the beginning
long	bufferedSize()
void	clear()	free up ressources
void	evaluate()	evaluate a process during reasoning.
void	evaluationFinished(long querykey)	the whole evaluation is finished
List<ReasoningRelation>	getAllTuples()
ReasoningRelation	getAllTuplesInOne()	get all received tuples
ReasoningRelation	getLastResults()	get the last stores results
List<And>	getNeighbours()	get all neighbours
TupleStore	getTupleStore()	get the basic tuple store
boolean	isSubsumed()	Store is subsumed.
void	readAccessBegin(Set<Integer> tickets, boolean lock)	Reading of the store by an operator starts.
boolean	readAccessEnd(ProcessImp source, Set<Integer> tickets, boolean lock, boolean notDissolve)	Reading of a store ends.
boolean	receiveRelation(ReasoningRelation R)	receive a whole relation
boolean	receiveTuple(int tuple)	receive a single tuple
boolean	receiveTuple(long[] tuple)	receive a single tuple
boolean	receiveTuple(TupleBuffer tuple)	receive a single tuple
void	reset1()
long	size()
void	triggerNeighbours(int ticket)	trigger neighbours for evaluation
void	tuplesFinished(boolean isBottomUp)	finish delivering single tuples
void	tuplesFinished(String annotation, ReasoningRelation R1, ReasoningRelation R2)	Finish delivering single tuples.

Methods inherited from class com.semedy.reasoner.reasoning.processes.UnbufferedStore

getArity, incrementalRelations, incrementalSize, relations, startTuples, toString

Methods inherited from class com.semedy.reasoner.reasoning.processes.ProcessImp

addNextReceiver, dispose, evaluationFinished, getPriority, getStratum, isNotQueuedSetQueued, isQueued, nextReceiver, operationFinished, setDataFlowGraph, setQueued, setStratum

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.semedy.reasoner.reasoning.processes.Process

addNextReceiver, dispose, getPriority, getStratum, isNotQueuedSetQueued, isQueued, nextReceiver, operationFinished, setDataFlowGraph, setQueued, setStratum

Methods inherited from interface com.semedy.reasoner.reasoning.processes.Store

getArity, incrementalRelations, relations, startTuples, toString

Constructor Details

BufferedStore

public BufferedStore(InterruptFlag interruptFlag,
 ReasoningMonitor monitor,
 int arity,
 String predicate,
 boolean cepReasoning,
 boolean cepReasoningWithRetracts,
 String tempDir,
 boolean swapping,
 ProcessExecutor executor,
 boolean sorted)

BufferedStore

public BufferedStore(InterruptFlag interruptFlag,
 ReasoningMonitor monitor,
 int arity,
 String predicate,
 boolean cepReasoning,
 boolean cepReasoningWithRetracts,
 ProcessExecutor executor,
 boolean sorted)

Method Details

evaluationFinished

public void evaluationFinished(long querykey)
                        throws SemReasonerException

Description copied from interface: Process

the whole evaluation is finished

Specified by:

evaluationFinished in interface Process

Specified by:

evaluationFinished in interface Store

Overrides:

evaluationFinished in class UnbufferedStore

Throws:

ReasoningException

SemReasonerException

size

public long size()
          throws IOException,
EDBException

Specified by:

size in interface Store

Overrides:

size in class UnbufferedStore

Returns:

Throws:

IOException

EDBException - How many tuples are stored

getAllTuples

public List<ReasoningRelation> getAllTuples()
                                     throws IOException,
EDBException

Specified by:

getAllTuples in interface Store

Overrides:

getAllTuples in class UnbufferedStore

Returns:

Throws:

EDBException - get a list of all relations stored in store

IOException

getAllTuplesInOne

public ReasoningRelation getAllTuplesInOne()
                                    throws IOException,
EDBException

Description copied from interface: Store

get all received tuples

Specified by:

getAllTuplesInOne in interface Store

Overrides:

getAllTuplesInOne in class UnbufferedStore

Returns:

Throws:

IOException

EDBException

addNegatedNeighbour

public void addNegatedNeighbour(And join)

Description copied from interface: Store

add a negated rule body operator as next operator

Specified by:

addNegatedNeighbour in interface Store

Overrides:

addNegatedNeighbour in class UnbufferedStore

addNeighbour

public void addNeighbour(And join)

Description copied from interface: Store

add a rule body operator as next operator

Specified by:

addNeighbour in interface Store

Overrides:

addNeighbour in class UnbufferedStore

readAccessBegin

public void readAccessBegin(Set<Integer> tickets,
 boolean lock)

Description copied from interface: Store

Reading of the store by an operator starts.
Every reading is uniquely identified by a ticket.
Lock indicates that ressources must be locked

Specified by:

readAccessBegin in interface Store

Overrides:

readAccessBegin in class UnbufferedStore

readAccessEnd

public boolean readAccessEnd(ProcessImp source,
 Set<Integer> tickets,
 boolean lock,
 boolean notDissolve)
                      throws SemReasonerException,
IOException

Description copied from interface: Store

Reading of a store ends.

Specified by:

readAccessEnd in interface Store

Overrides:

readAccessEnd in class UnbufferedStore

Parameters:

source - , the reader

tickets - , the ticket of the reading process

lock - , was a lock required at begin of the reading process

notDissolve - , have relations be pushed instead of joined

Returns:

Throws:

SemReasonerException

IOException

reset1

public void reset1()
            throws IOException

Throws:

IOException

receiveRelation

public boolean receiveRelation(ReasoningRelation R)
                        throws SemReasonerException,
InterruptedException,
IOException

Description copied from interface: Receiver

receive a whole relation

Specified by:

receiveRelation in interface Receiver

Specified by:

receiveRelation in interface Store

Overrides:

receiveRelation in class UnbufferedStore

Parameters:

R - the whole relation to be received

Returns:

true, if relation is later on dissolved, false otherwise

Throws:

ReasoningException

InterruptedException

IOException

SemReasonerException

addRelation

public void addRelation(ReasoningRelation R)
                 throws IOException,
EDBException

Description copied from interface: Receiver

add a whole relation at the beginning

Specified by:

addRelation in interface Process

Specified by:

addRelation in interface Receiver

Specified by:

addRelation in interface Store

Overrides:

addRelation in class UnbufferedStore

Parameters:

R - the relation to be added

Throws:

IOException

EDBException

triggerNeighbours

public void triggerNeighbours(int ticket)
                       throws IOException,
SemReasonerException

Description copied from interface: Store

trigger neighbours for evaluation

Specified by:

triggerNeighbours in interface Store

Overrides:

triggerNeighbours in class UnbufferedStore

Throws:

IOException

ReasoningException

SemReasonerException

isSubsumed

public boolean isSubsumed()

Description copied from interface: Store

Store is subsumed. This means that no additional tuples are stored.

Specified by:

isSubsumed in interface Store

Overrides:

isSubsumed in class UnbufferedStore

Returns:

receiveTuple

public boolean receiveTuple(long[] tuple)
                     throws SemReasonerException,
IOException

Description copied from interface: Receiver

receive a single tuple

Specified by:

receiveTuple in interface Receiver

Specified by:

receiveTuple in interface Store

Overrides:

receiveTuple in class UnbufferedStore

Parameters:

tuple - the tuple to be received

Returns:

true if tuple has been used (tuple cannot be free'd up)

Throws:

SemReasonerException

IOException

receiveTuple

public boolean receiveTuple(TupleBuffer tuple)
                     throws SemReasonerException,
IOException

Description copied from interface: Receiver

receive a single tuple

Specified by:

receiveTuple in interface Receiver

Overrides:

receiveTuple in class ProcessImp

Parameters:

tuple - the tuple to be received

Returns:

true if tuple has been used (tuple cannot be free'd up)

Throws:

ReasoningException

SemReasonerException

IOException

receiveTuple

public boolean receiveTuple(int tuple)
                     throws SemReasonerException,
IOException

Description copied from interface: Receiver

receive a single tuple

Specified by:

receiveTuple in interface Receiver

Specified by:

receiveTuple in interface Store

Overrides:

receiveTuple in class UnbufferedStore

Parameters:

tuple - the tuple to be received

Returns:

true if tuple has been used (tuple cannot be free'd up)

Throws:

SemReasonerException

IOException

getTupleStore

public TupleStore getTupleStore()

Description copied from interface: Receiver

get the basic tuple store

Specified by:

getTupleStore in interface Process

Specified by:

getTupleStore in interface Receiver

Specified by:

getTupleStore in interface Store

Overrides:

getTupleStore in class UnbufferedStore

Returns:

the tuple store

evaluate

public void evaluate()
              throws InterruptedException,
SemReasonerException,
IOException

Description copied from interface: Process

evaluate a process during reasoning.
Returns how the number of tuples sent away

Specified by:

evaluate in interface Process

Specified by:

evaluate in interface Store

Overrides:

evaluate in class UnbufferedStore

Throws:

InterruptedException

ReasoningException

IOException

SemReasonerException

tuplesFinished

public void tuplesFinished(String annotation,
 ReasoningRelation R1,
 ReasoningRelation R2)
                    throws SemReasonerException,
InterruptedException,
IOException

Description copied from interface: Receiver

Finish delivering single tuples.
Cache result and annotate result.

Specified by:

tuplesFinished in interface Receiver

Specified by:

tuplesFinished in interface Store

Overrides:

tuplesFinished in class UnbufferedStore

Parameters:

annotation - , an annotation used for caching

R1 - , the relations which have been combined

R2 - , the relations which have been combined

Throws:

ReasoningException

SemReasonerException

InterruptedException

IOException

clear

public void clear()
           throws IOException

Description copied from class: ProcessImp

free up ressources

Specified by:

clear in interface Process

Overrides:

clear in class UnbufferedStore

Throws:

IOException

tuplesFinished

public void tuplesFinished(boolean isBottomUp)
                    throws SemReasonerException,
InterruptedException,
IOException

Description copied from interface: Receiver

finish delivering single tuples

Specified by:

tuplesFinished in interface Receiver

Specified by:

tuplesFinished in interface Store

Overrides:

tuplesFinished in class UnbufferedStore

Parameters:

isBottomUp - TODO

Throws:

ReasoningException

SemReasonerException

InterruptedException

IOException

getNeighbours

public List<And> getNeighbours()

Description copied from interface: Store

get all neighbours

Specified by:

getNeighbours in interface Store

Overrides:

getNeighbours in class UnbufferedStore

Returns:

bufferedSize

public long bufferedSize()
                  throws IOException,
EDBException

Throws:

IOException

EDBException

getLastResults

public ReasoningRelation getLastResults()

Description copied from interface: Store

get the last stores results

Specified by:

getLastResults in interface Store

Overrides:

getLastResults in class UnbufferedStore

Returns: