Package com.semedy.reasoner.reasoning.processes

Class UnbufferedStore

java.lang.Object

com.semedy.reasoner.reasoning.processes.ProcessImp

com.semedy.reasoner.reasoning.processes.UnbufferedStore

All Implemented Interfaces:

Receiver, Process, Store

Direct Known Subclasses:

BufferedStore, TopDownUnbufferedStore

public class UnbufferedStore
extends ProcessImp
implements Store

A store with an unbuffered input.
Used between the rule body operators

Author:

angele

Constructor Summary

Constructors

Constructor	Description
UnbufferedStore(InterruptFlag interruptflag, ReasoningMonitor monitor, int arity, String predicate, boolean not, 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
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
int	getArity()	arity of the tuples
ReasoningRelation	getLastResults()	get the last stores results
List<And>	getNeighbours()	get all neighbours
TupleStore	getTupleStore()	get the basic tuple store
List<ReasoningRelation>	incrementalRelations()
long	incrementalSize()
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 pushed)	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
List<ReasoningRelation>	relations()
long	size()
Receiver	startTuples(Receiver source, boolean check4Duplicates)	start delivering single tuples
String	toString()
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.ProcessImp

addNextReceiver, dispose, evaluationFinished, getPriority, getStratum, isNotQueuedSetQueued, isQueued, nextReceiver, operationFinished, receiveTuple, 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.api.reasoning.Receiver

receiveTuple

Constructor Details

UnbufferedStore

public UnbufferedStore(InterruptFlag interruptflag,
 ReasoningMonitor monitor,
 int arity,
 String predicate,
 boolean not,
 boolean cepReasoning,
 boolean cepReasoningWithRetracts,
 String tempDir,
 boolean swapping,
 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 ProcessImp

Throws:

ReasoningException

SemReasonerException

size

public long size()
          throws IOException,
EDBException

Specified by:

size in interface Store

Returns:

Throws:

IOException

EDBException - How many tuples are stored

getAllTuples

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

Specified by:

getAllTuples in interface Store

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

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

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

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

readAccessEnd

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

Description copied from interface: Store

Reading of a store ends.

Specified by:

readAccessEnd in interface Store

Parameters:

source - , the reader

tickets - , the ticket of the reading process

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

pushed - , have relations be pushed instead of joined

Returns:

Throws:

IOException

SemReasonerException

receiveRelation

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

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 ProcessImp

Parameters:

R - the whole relation to be received

Returns:

true, if relation is later on dissolved, false otherwise

Throws:

InterruptedException

IOException

ReasoningException

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 ProcessImp

Parameters:

R - the relation to be added

Throws:

IOException

EDBException

startTuples

public Receiver startTuples(Receiver source,
 boolean check4Duplicates)
                     throws EDBException,
IOException

Description copied from interface: Receiver

start delivering single tuples

Specified by:

startTuples in interface Receiver

Specified by:

startTuples in interface Store

Overrides:

startTuples in class ProcessImp

Parameters:

source - , the delivering process

check4Duplicates - , check for duplicates in the target store

Returns:

an object receiving the results

Throws:

EDBException

IOException

incrementalRelations

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

Specified by:

incrementalRelations in interface Store

Returns:

Throws:

IOException

EDBException - get a list of incremental relations

relations

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

Specified by:

relations in interface Store

Returns:

Throws:

IOException

EDBException - get a list of received relations

getArity

public int getArity()

Description copied from interface: Receiver

arity of the tuples

Specified by:

getArity in interface Process

Specified by:

getArity in interface Receiver

Specified by:

getArity in interface Store

Overrides:

getArity in class ProcessImp

Returns:

the arity of the receiver

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

Returns:

receiveTuple

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

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 ProcessImp

Parameters:

tuple - the tuple to be received

Returns:

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

Throws:

IOException

SemReasonerException

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 ProcessImp

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 ProcessImp

Returns:

the tuple store

evaluate

public void evaluate()
              throws InterruptedException,
IOException,
SemReasonerException

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 ProcessImp

Throws:

InterruptedException

IOException

ReasoningException

SemReasonerException

toString

public String toString()

Specified by:

toString in interface Store

Overrides:

toString in class Object

triggerNeighbours

public void triggerNeighbours(int ticket)
                       throws IOException,
SemReasonerException

Description copied from interface: Store

trigger neighbours for evaluation

Specified by:

triggerNeighbours in interface Store

Throws:

IOException

ReasoningException

SemReasonerException

tuplesFinished

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

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 ProcessImp

Parameters:

annotation - , an annotation used for caching

R1 - , the relations which have been combined

R2 - , the relations which have been combined

Throws:

InterruptedException

IOException

ReasoningException

SemReasonerException

incrementalSize

public long incrementalSize()
                     throws IOException,
EDBException

Throws:

IOException

EDBException

tuplesFinished

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

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 ProcessImp

Parameters:

isBottomUp - TODO

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 ProcessImp

Throws:

IOException

getNeighbours

public List<And> getNeighbours()

Description copied from interface: Store

get all neighbours

Specified by:

getNeighbours in interface Store

Returns:

getLastResults

public ReasoningRelation getLastResults()

Description copied from interface: Store

get the last stores results

Specified by:

getLastResults in interface Store

Returns: