Package com.semedy.reasoner.reasoning.monitor

Class RelationAdapter

java.lang.Object

com.semedy.reasoner.reasoning.monitor.RelationAdapter

All Implemented Interfaces:

BaseRelation, Relation

Direct Known Subclasses:

ReasoningMonitorRelation

public class RelationAdapter
extends Object
implements Relation

Adapter to BaseRelation. Throws UnsupportedOperationException when a method is called which is not part of the base relation.

Author:

Juergen Angele

Constructor Summary

Constructors

Constructor	Description
RelationAdapter(BaseRelation relation)

Method Summary

Modifier and Type	Method	Description
void	addSubRelation(Relation R)
boolean	addTuple(int tupleaddress)	add a tuple to the relation
boolean	addTuple(long[] tuple)	add a tuple to the relation
boolean	addTuple(TupleBuffer terms)	add a tuple to the relation
boolean	checkSanity(String message, boolean shadow)	check the sanity of a relation
void	clear()	remove all tuples
void	close()	Close the relation.
boolean	containsTuple(int tuple)	Is tuple contained in relation?
boolean	containsTuple(long[] tuple)	Is tuple contained in relation?
boolean	containsTuple(TupleBuffer tuple)	Is tuple contained in relation?
Index	createIndex(int[] indexedpositions)	Get or create a simple (not sorted index) by the argument positions in indexed positions.
SortedIndex	createSortedIndex(int[] indexedpositions)	ret or create a sorted index given by the argument positions in indexed positions
void	delete()	remove all tuples and release files
void	deSelect()	release ressources because relation is currently not used
TupleEnumerator	elements()	returns an enumerator for all tuples
TupleEnumerator	elements(long[] filter)	returns an filteres enumerator for all tuples
void	flush()	Flush the relation.
int	getArity()	returns the arity of the relation
CacheInfo	getCacheInfo()	get the caching info
String	getDataFilePath()	get standard path for binary file
int	getDirectEncodedType(int i)	get the type of the direct encoded argument
String	getFilename()	returns the file name for the relation
long[]	getGrounds()	get the grounds
String	getIdentifier()	returns a unique identifier for the relation
Index	getIndex(int[] indexedpositions)	Get an index given by the argument positions in indexed positions (if it already exists).
TupleStore	getInputBuffer()	get an input buffer for relation
int	getInternalArity()	returns the internal arity of tuples
long	getMaxValue(int argument)	returns the maximal value at that argument position
long	getMinValue(int argument)	returns the minimal value at that argument position
String	getName()	get a unique name of the relation
long	getNumberOfDifferentValues(int argument)	Returns the number of different values at the argument positions.
long	getNumberOfDifferentValues(int argument, long v)	Returns the number of values occurring at the argument positions Used for statistics
long	getNumberOfMatchingTuples(int[] arguments, long[] values)
String	getPredicateSymbol()	returns the predicate symbol for the relation
SortedIndex	getSortedIndex(int[] indexedpositions)	Get a sorted index given by the argument positions in indexed positions (if it already exists).
boolean	hasDuplicates()	may relation contain duplicates?
boolean	hasIndices()
boolean	isDirectEncoded(int i)	are all values at argument i direct encoded
boolean	isEmpty()	Is the relation empty?
long[]	isOverwrittenByTuple(long[] buffer)	returns the tuple which will be overwritten by tuple.
boolean	isPersistent()	Is the relation persistent?
boolean	isTemporary()	Is the relation temporary only?
long	lastModificationTime()	last modification time
boolean	mayContainDuplicates()	Might there be duplicates?
long[]	overwriteTuple(long[] buffer)	Overwrite last argument of tuple.
TupleBuffer	overwriteTuple(TupleBuffer buffer)	Overwrite last argument of tuple.
void	readBinaryFromBackup(String filepath)	read tuples from a binary backup file
void	readTupleFile(String filepath)	read tuples from a (compressed) binary file
void	registerListener(RelationListener listener)	register a listener for adding, removing, modifying tuples
void	removeIndices()
boolean	removeTuple(int tupleaddress)	remove a tuple from the relation
boolean	removeTuple(long[] buffer)	remove a tuple from the relation
boolean	removeTuple(TupleBuffer buffer)	remove a tuple from the relation
void	select()	initialize it before using it
long	size()	returns the number of tuples in relation
long	sizeInBytes()	return number of bytes used in main memory.
void	subtractRelation(Relation R)
void	transactionBegin()	begin transaction
void	transactionCommit()	commit last changes
void	transactionRollback()	rbort last changes
void	union(BaseRelation R)	add all tuples of R to this
void	unionRelation(Relation R)
void	writeBinary(String filepath)	write tuples to a binary file
void	writeBinaryToBackup(String filepath)	write tuples to a binary backup file
void	writeBinaryWithGrounds(String filepath)	write complete tuples to a binary file

Methods inherited from class java.lang.Object

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

Constructor Details

RelationAdapter

public RelationAdapter(BaseRelation relation)

Method Details

sizeInBytes

public long sizeInBytes()

return number of bytes used in main memory. Used for cache management

Specified by:

sizeInBytes in interface BaseRelation

Returns:

approximate number of size in bytes

getArity

public int getArity()

Description copied from interface: BaseRelation

returns the arity of the relation

Specified by:

getArity in interface BaseRelation

Returns:

arity of relation

elements

public TupleEnumerator elements()
                         throws IOException,
EDBException

Description copied from interface: BaseRelation

returns an enumerator for all tuples

Specified by:

elements in interface BaseRelation

Returns:

returns enumerator for tuples

Throws:

IOException

EDBException

size

public long size()
          throws IOException,
EDBException

Description copied from interface: BaseRelation

returns the number of tuples in relation

Specified by:

size in interface BaseRelation

Returns:

number of tuples in relation

Throws:

IOException

EDBException

createSortedIndex

public SortedIndex createSortedIndex(int[] indexedpositions)
                              throws IOException,
EDBException

Description copied from interface: BaseRelation

ret or create a sorted index given by the argument positions in indexed positions

Specified by:

createSortedIndex in interface BaseRelation

Returns:

Throws:

IOException

EDBException

getSortedIndex

public SortedIndex getSortedIndex(int[] indexedpositions)

Description copied from interface: BaseRelation

Get a sorted index given by the argument positions in indexed positions (if it already exists).
Returns null if it does not exist.

Specified by:

getSortedIndex in interface BaseRelation

Parameters:

indexedpositions - the indexed positions

Returns:

the corresponding index or null if none is available

createIndex

public Index createIndex(int[] indexedpositions)
                  throws IOException,
EDBException

Description copied from interface: BaseRelation

Get or create a simple (not sorted index) by the argument positions in indexed positions.

Specified by:

createIndex in interface BaseRelation

Parameters:

indexedpositions - , positions which are indexed

Returns:

index

Throws:

IOException

EDBException

getIndex

public Index getIndex(int[] indexedpositions)

Description copied from interface: BaseRelation

Get an index given by the argument positions in indexed positions (if it already exists).
Returns null if it does not exist.

Specified by:

getIndex in interface BaseRelation

Parameters:

indexedpositions - the indexed positions

Returns:

the corresponding index or null if none is available

getIdentifier

public String getIdentifier()

Description copied from interface: BaseRelation

returns a unique identifier for the relation

Specified by:

getIdentifier in interface BaseRelation

Returns:

unique identifier for relation

clear

public void clear()
           throws IOException,
EDBException

Description copied from interface: BaseRelation

remove all tuples

Specified by:

clear in interface BaseRelation

Throws:

IOException

EDBException

isEmpty

public boolean isEmpty()
                throws IOException

Description copied from interface: BaseRelation

Is the relation empty?

Specified by:

isEmpty in interface BaseRelation

Returns:

relation is empty

Throws:

IOException

isPersistent

public boolean isPersistent()

Description copied from interface: BaseRelation

Is the relation persistent?

Specified by:

isPersistent in interface BaseRelation

Returns:

is the relation persistent

close

public void close()
           throws IOException,
EDBException

Description copied from interface: BaseRelation

Close the relation. Must be called to finalize the relation correctly

Specified by:

close in interface BaseRelation

Throws:

IOException

EDBException

getCacheInfo

public CacheInfo getCacheInfo()

Description copied from interface: BaseRelation

get the caching info

Specified by:

getCacheInfo in interface BaseRelation

Returns:

object containing caching info

addTuple

public boolean addTuple(TupleBuffer terms)
                 throws IOException,
EDBException

Description copied from interface: BaseRelation

add a tuple to the relation

Specified by:

addTuple in interface BaseRelation

Parameters:

terms - the tuple to add

Returns:

tuple has been added

Throws:

IOException

EDBException

addTuple

public boolean addTuple(long[] tuple)
                 throws IOException,
EDBException

Description copied from interface: BaseRelation

add a tuple to the relation

Specified by:

addTuple in interface BaseRelation

Parameters:

tuple - the tuple to add

Returns:

tuple has been added

Throws:

IOException

EDBException

removeTuple

public boolean removeTuple(int tupleaddress)
                    throws IOException,
EDBException

Description copied from interface: BaseRelation

remove a tuple from the relation

Specified by:

removeTuple in interface BaseRelation

Parameters:

tupleaddress - , address of tuple in tuple store

Returns:

true, if tuple has been removed

Throws:

IOException

EDBException

removeTuple

public boolean removeTuple(TupleBuffer buffer)
                    throws IOException,
EDBException

Description copied from interface: BaseRelation

remove a tuple from the relation

Specified by:

removeTuple in interface BaseRelation

Parameters:

buffer - , tuple to be removed

Returns:

true, if tuple has been removed

Throws:

IOException

EDBException

overwriteTuple

public long[] overwriteTuple(long[] buffer)
                      throws IOException,
EDBException

Description copied from interface: BaseRelation

Overwrite last argument of tuple.
First arguments are unique keys for tuple
Especially useful for triples [subject,predicate,object]
and object is changed

Specified by:

overwriteTuple in interface BaseRelation

Parameters:

buffer - , overwrite tuple

Returns:

the overwritten tuple

Throws:

IOException

EDBException

overwriteTuple

public TupleBuffer overwriteTuple(TupleBuffer buffer)
                           throws IOException,
EDBException

Description copied from interface: BaseRelation

Overwrite last argument of tuple.
First arguments are unique keys for tuple
Especially useful for triples [subject,predicate,object]
and object is changed

Specified by:

overwriteTuple in interface BaseRelation

Parameters:

buffer - , overwrite tuple

Returns:

the overwritten tuple

Throws:

IOException

EDBException

isOverwrittenByTuple

public long[] isOverwrittenByTuple(long[] buffer)
                            throws IOException,
EDBException

Description copied from interface: BaseRelation

returns the tuple which will be overwritten by tuple.

Specified by:

isOverwrittenByTuple in interface BaseRelation

Returns:

Throws:

IOException

EDBException

removeTuple

public boolean removeTuple(long[] buffer)
                    throws IOException,
EDBException

Description copied from interface: BaseRelation

remove a tuple from the relation

Specified by:

removeTuple in interface BaseRelation

Parameters:

buffer - , tuple to be removed

Returns:

true, if tuple has been removed

Throws:

IOException

EDBException

getInputBuffer

public TupleStore getInputBuffer()

Description copied from interface: BaseRelation

get an input buffer for relation

Specified by:

getInputBuffer in interface BaseRelation

Returns:

a tuple store which serves as buffer for input tuples

addTuple

public boolean addTuple(int tupleaddress)
                 throws IOException,
EDBException

Description copied from interface: BaseRelation

add a tuple to the relation

Specified by:

addTuple in interface BaseRelation

Parameters:

tupleaddress - the tuple to add

Returns:

tuple has been added

Throws:

IOException

EDBException

unionRelation

public void unionRelation(Relation R)

subtractRelation

public void subtractRelation(Relation R)

getNumberOfDifferentValues

public long getNumberOfDifferentValues(int argument)
                                throws IOException

Description copied from interface: Relation

Returns the number of different values at the argument positions.
Used for statistics.

Specified by:

getNumberOfDifferentValues in interface Relation

Parameters:

argument - , argument position

Returns:

Throws:

IOException

getNumberOfDifferentValues

public long getNumberOfDifferentValues(int argument,
 long v)
                                throws IOException

Description copied from interface: Relation

Returns the number of values occurring at the argument positions
Used for statistics

Specified by:

getNumberOfDifferentValues in interface Relation

Parameters:

argument - , argument position

v - , the concrete value

Returns:

Throws:

IOException

getMinValue

public long getMinValue(int argument)
                 throws IOException

Description copied from interface: BaseRelation

returns the minimal value at that argument position

Specified by:

getMinValue in interface BaseRelation

Parameters:

argument - , argument position @return, minimal value

Throws:

IOException

getMaxValue

public long getMaxValue(int argument)
                 throws IOException

Description copied from interface: BaseRelation

returns the maximal value at that argument position

Specified by:

getMaxValue in interface BaseRelation

Parameters:

argument - , argument position

Returns:

max value at argument position

Throws:

IOException

removeIndices

public void removeIndices()

delete

public void delete()
            throws IOException

Description copied from interface: Relation

remove all tuples and release files

Specified by:

delete in interface Relation

Throws:

IOException

writeBinary

public void writeBinary(String filepath)
                 throws IOException

Description copied from interface: Relation

write tuples to a binary file

Specified by:

writeBinary in interface BaseRelation

Specified by:

writeBinary in interface Relation

Throws:

IOException

readTupleFile

public void readTupleFile(String filepath)
                   throws IOException

Description copied from interface: Relation

read tuples from a (compressed) binary file

Specified by:

readTupleFile in interface BaseRelation

Specified by:

readTupleFile in interface Relation

Parameters:

filepath - , the file path to read from

Throws:

IOException

getDataFilePath

public String getDataFilePath()

Description copied from interface: Relation

get standard path for binary file

Specified by:

getDataFilePath in interface Relation

Returns:

select

public void select()
            throws IOException

Description copied from interface: Relation

initialize it before using it

Specified by:

select in interface BaseRelation

Specified by:

select in interface Relation

Throws:

IOException

deSelect

public void deSelect()
              throws IOException

Description copied from interface: Relation

release ressources because relation is currently not used

Specified by:

deSelect in interface Relation

Throws:

IOException

getPredicateSymbol

public String getPredicateSymbol()

Description copied from interface: Relation

returns the predicate symbol for the relation

Specified by:

getPredicateSymbol in interface Relation

Returns:

getFilename

public String getFilename()

Description copied from interface: Relation

returns the file name for the relation

Specified by:

getFilename in interface Relation

Returns:

transactionRollback

public void transactionRollback()
                         throws IOException

Description copied from interface: Relation

rbort last changes

Specified by:

transactionRollback in interface Relation

Throws:

IOException

transactionCommit

public void transactionCommit()
                       throws IOException

Description copied from interface: Relation

commit last changes

Specified by:

transactionCommit in interface Relation

Throws:

IOException

lastModificationTime

public long lastModificationTime()

Description copied from interface: Relation

last modification time

Specified by:

lastModificationTime in interface BaseRelation

Specified by:

lastModificationTime in interface Relation

Returns:

time of last modification

addSubRelation

public void addSubRelation(Relation R)

mayContainDuplicates

public boolean mayContainDuplicates()

Description copied from interface: BaseRelation

Might there be duplicates?

Specified by:

mayContainDuplicates in interface BaseRelation

Returns:

, might there be duplicates in relation

getNumberOfMatchingTuples

public long getNumberOfMatchingTuples(int[] arguments,
 long[] values)
                               throws IOException,
EDBException

Throws:

IOException

EDBException

isDirectEncoded

public boolean isDirectEncoded(int i)

Description copied from interface: BaseRelation

are all values at argument i direct encoded

Specified by:

isDirectEncoded in interface BaseRelation

Parameters:

i - , argument index

Returns:

isTemporary

public boolean isTemporary()

Description copied from interface: BaseRelation

Is the relation temporary only?

Specified by:

isTemporary in interface BaseRelation

Returns:

is the relation persistent

containsTuple

public boolean containsTuple(TupleBuffer tuple)
                      throws IOException

Description copied from interface: BaseRelation

Is tuple contained in relation?

Specified by:

containsTuple in interface BaseRelation

Parameters:

tuple - to be checked

Returns:

tuple is contained

Throws:

IOException

containsTuple

public boolean containsTuple(long[] tuple)
                      throws IOException

Description copied from interface: BaseRelation

Is tuple contained in relation?

Specified by:

containsTuple in interface BaseRelation

Parameters:

tuple - to be checked

Returns:

tuple is contained

Throws:

IOException

flush

public void flush()

Description copied from interface: BaseRelation

Flush the relation. Must be called to finalize the relation correctly

Specified by:

flush in interface BaseRelation

hasIndices

public boolean hasIndices()

checkSanity

public boolean checkSanity(String message,
 boolean shadow)
                    throws IOException

Description copied from interface: Relation

check the sanity of a relation

Specified by:

checkSanity in interface Relation

shadow - , check in shadow tree

Throws:

IOException

registerListener

public void registerListener(RelationListener listener)

Description copied from interface: BaseRelation

register a listener for adding, removing, modifying tuples

Specified by:

registerListener in interface BaseRelation

getGrounds

public long[] getGrounds()

Description copied from interface: Relation

get the grounds

Specified by:

getGrounds in interface Relation

Returns:

writeBinaryToBackup

public void writeBinaryToBackup(String filepath)
                         throws IOException

Description copied from interface: Relation

write tuples to a binary backup file

Specified by:

writeBinaryToBackup in interface Relation

Throws:

IOException

readBinaryFromBackup

public void readBinaryFromBackup(String filepath)
                          throws IOException

Description copied from interface: Relation

read tuples from a binary backup file

Specified by:

readBinaryFromBackup in interface Relation

Throws:

IOException

writeBinaryWithGrounds

public void writeBinaryWithGrounds(String filepath)
                            throws IOException

Description copied from interface: Relation

write complete tuples to a binary file

Specified by:

writeBinaryWithGrounds in interface Relation

Throws:

IOException

getName

public String getName()

Description copied from interface: Relation

get a unique name of the relation

Specified by:

getName in interface Relation

Returns:

union

public void union(BaseRelation R)
           throws IOException

Description copied from interface: BaseRelation

add all tuples of R to this

Specified by:

union in interface BaseRelation

Throws:

IOException

containsTuple

public boolean containsTuple(int tuple)
                      throws IOException

Description copied from interface: BaseRelation

Is tuple contained in relation?

Specified by:

containsTuple in interface BaseRelation

Parameters:

tuple - to be checked

Returns:

tuple is contained

Throws:

IOException

hasDuplicates

public boolean hasDuplicates()

Description copied from interface: BaseRelation

may relation contain duplicates?

Specified by:

hasDuplicates in interface BaseRelation

Returns:

transactionBegin

public void transactionBegin()
                      throws IOException,
EDBException

Description copied from interface: Relation

begin transaction

Specified by:

transactionBegin in interface Relation

Throws:

EDBException

IOException

getInternalArity

public int getInternalArity()

Description copied from interface: BaseRelation

returns the internal arity of tuples

Specified by:

getInternalArity in interface BaseRelation

Returns:

elements

public TupleEnumerator elements(long[] filter)
                         throws IOException,
EDBException

Description copied from interface: BaseRelation

returns an filteres enumerator for all tuples

Specified by:

elements in interface BaseRelation

Returns:

returns enumerator for tuples

Throws:

IOException

EDBException

getDirectEncodedType

public int getDirectEncodedType(int i)

Description copied from interface: BaseRelation

get the type of the direct encoded argument

Specified by:

getDirectEncodedType in interface BaseRelation

Returns: