Package com.semedy.reasoner.edb.ramstore

Class MixedRelation

java.lang.Object

com.semedy.reasoner.edb.ramstore.MainMemoryRelation

com.semedy.reasoner.edb.ramstore.MixedRelation

All Implemented Interfaces:

BaseRelation, Relation, CacheUnit

Direct Known Subclasses:

MainMemorySubRelation

public class MixedRelation
extends MainMemoryRelation
implements CacheUnit

Represents a mixed relation, i.e. tuples are stored persistent and in main memory.
Used to cache tuples from persistent storage model. Writes through, i.e.
tuples added or removed are also removed in persistent part.
For reading and reasoning the main memory part is used. Tuples are always copied from persistent
part to main memory part and not vice versa (e.g. for readBinary tuples are read into persistent
part and then copied into the main memory part, the same with setPersistentRelation

Author:

angele

Field Summary

Fields inherited from class com.semedy.reasoner.edb.ramstore.MainMemoryRelation

_baseRelation

Constructor Summary

Constructors

Constructor	Description
MixedRelation(PersistentRelation baseRelation)
MixedRelation(String name, int arity, long[] grounds)

Method Summary

Modifier and Type	Method	Description
boolean	addTuple(long[] tuple)	add a tuple to the relation
boolean	addTuple(TupleBuffer buf)	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.
long	count()
void	delete()	remove all tuples and release files
void	destroy()	free up ressources at the end (CacheManager.clear)
void	flush()	Flush the relation.
String	getDataFilePath()	get standard path for binary file
CacheUnit	getLast()
long	getMaxValue(int argument)	returns the maximal value at that argument position
long	getMinValue(int argument)	returns the minimal value at that argument position
CacheUnit	getNext()
long	getNumberOfDifferentValues(int argument)	Returns the number of different values at the argument positions.
long	getNumberOfDifferentValues(int argument, long value)	Returns the number of values occurring at the argument positions Used for statistics
PersistentRelation	getPersistentRelation()	get the persistent relation behind it
boolean	isEmpty()	Is the relation empty?
boolean	isReleasable()	is this unit releasable
void	readTupleFile(String filepath)	read tuples from a (compressed) binary file
void	release()	Cache management calls this method to release the cache unit.
void	remove()
boolean	removeTuple(long[] buf)	remove a tuple from the relation
boolean	removeTuple(TupleBuffer buf)	remove a tuple from the relation
void	select()	intialize the use: the tuples are copied from the persistent part to the main memory part
void	setLast(CacheUnit last)
void	setNext(CacheUnit next)	pointers in a list for cache management
void	setPersistentRelation(PersistentRelation persistentRelation)	adds the persistent part
long	size()	returns the number of tuples in relation
long	sizeInBytes()	size in bytes, usded for cache management
String	toString()
void	touch()	touch a cache unit.
void	transactionBegin()	begin transaction
void	transactionCommit()	commit last changes
void	transactionRollback()	rbort last changes

Methods inherited from class com.semedy.reasoner.edb.ramstore.MainMemoryRelation

addSubRelation, addTuple, containsTuple, containsTuple, containsTuple, createIndex, createSortedIndex, deSelect, elements, elements, getArity, getCacheInfo, getDirectEncodedType, getFilename, getGrounds, getIdentifier, getIndex, getInputBuffer, getInternalArity, getName, getPredicateSymbol, getSortedIndex, getTupleStore, getValues, hasDuplicates, isDirectEncoded, isOverwrittenByTuple, isPersistent, isTemporary, lastModificationTime, mayContainDuplicates, overwriteTuple, overwriteTuple, readBinaryFromBackup, registerListener, removeTuple, union, writeBinary, writeBinaryToBackup, writeBinaryWithGrounds

Methods inherited from class java.lang.Object

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

Constructor Details

MixedRelation

public MixedRelation(String name,
 int arity,
 long[] grounds)

MixedRelation

public MixedRelation(PersistentRelation baseRelation)

Parameters:

baseRelation -

Method Details

count

public long count()
           throws EDBException,
IOException

Throws:

EDBException

IOException

getNumberOfDifferentValues

public long getNumberOfDifferentValues(int argument)
                                throws IOException,
EDBException

Description copied from interface: Relation

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

Specified by:

getNumberOfDifferentValues in interface Relation

Overrides:

getNumberOfDifferentValues in class MainMemoryRelation

Parameters:

argument - , argument position

Returns:

Throws:

EDBException

IOException

getNumberOfDifferentValues

public long getNumberOfDifferentValues(int argument,
 long value)
                                throws IOException,
EDBException

Description copied from interface: Relation

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

Specified by:

getNumberOfDifferentValues in interface Relation

Overrides:

getNumberOfDifferentValues in class MainMemoryRelation

Parameters:

argument - , argument position

value - , the concrete value

Returns:

Throws:

EDBException

IOException

getMinValue

public long getMinValue(int argument)
                 throws IOException,
EDBException

Description copied from interface: BaseRelation

returns the minimal value at that argument position

Specified by:

getMinValue in interface BaseRelation

Overrides:

getMinValue in class MainMemoryRelation

Parameters:

argument - , argument position @return, minimal value

Throws:

IOException

EDBException

getMaxValue

public long getMaxValue(int argument)
                 throws IOException,
EDBException

Description copied from interface: BaseRelation

returns the maximal value at that argument position

Specified by:

getMaxValue in interface BaseRelation

Overrides:

getMaxValue in class MainMemoryRelation

Parameters:

argument - , argument position

Returns:

max value at argument position

Throws:

IOException

EDBException

isEmpty

public boolean isEmpty()
                throws IOException

Description copied from interface: BaseRelation

Is the relation empty?

Specified by:

isEmpty in interface BaseRelation

Overrides:

isEmpty in class MainMemoryRelation

Returns:

relation is empty

Throws:

IOException

setPersistentRelation

public void setPersistentRelation(PersistentRelation persistentRelation)

adds the persistent part

Parameters:

persistentRelation -

getPersistentRelation

public PersistentRelation getPersistentRelation()

get the persistent relation behind it

Returns:

select

public void select()
            throws IOException,
EDBException

intialize the use: the tuples are copied from the persistent part to the main memory part

Specified by:

select in interface BaseRelation

Specified by:

select in interface Relation

Overrides:

select in class MainMemoryRelation

Throws:

EDBException

IOException

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

Overrides:

size in class MainMemoryRelation

Returns:

number of tuples in relation

Throws:

IOException

EDBException

addTuple

public boolean addTuple(TupleBuffer buf)
                 throws IOException,
EDBException

Description copied from interface: BaseRelation

add a tuple to the relation

Specified by:

addTuple in interface BaseRelation

Overrides:

addTuple in class MainMemoryRelation

Parameters:

buf - 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

Overrides:

addTuple in class MainMemoryRelation

Parameters:

tuple - the tuple to add

Returns:

tuple has been added

Throws:

IOException

EDBException

removeTuple

public boolean removeTuple(TupleBuffer buf)
                    throws IOException,
EDBException

Description copied from interface: BaseRelation

remove a tuple from the relation

Specified by:

removeTuple in interface BaseRelation

Overrides:

removeTuple in class MainMemoryRelation

Parameters:

buf - , tuple to be removed

Returns:

true, if tuple has been removed

Throws:

IOException

EDBException

removeTuple

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

Description copied from interface: BaseRelation

remove a tuple from the relation

Specified by:

removeTuple in interface BaseRelation

Overrides:

removeTuple in class MainMemoryRelation

Parameters:

buf - , tuple to be removed

Returns:

true, if tuple has been removed

Throws:

IOException

EDBException

clear

public void clear()
           throws IOException,
EDBException

Description copied from interface: BaseRelation

remove all tuples

Specified by:

clear in interface BaseRelation

Overrides:

clear in class MainMemoryRelation

Throws:

IOException

EDBException

delete

public void delete()
            throws IOException

Description copied from interface: Relation

remove all tuples and release files

Specified by:

delete in interface Relation

Overrides:

delete in class MainMemoryRelation

Throws:

IOException

readTupleFile

public void readTupleFile(String filepath)
                   throws IOException,
EDBException

Description copied from interface: Relation

read tuples from a (compressed) binary file

Specified by:

readTupleFile in interface BaseRelation

Specified by:

readTupleFile in interface Relation

Overrides:

readTupleFile in class MainMemoryRelation

Parameters:

filepath - , the file path to read from

Throws:

IOException

EDBException

close

public void close()
           throws IOException

Description copied from interface: BaseRelation

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

Specified by:

close in interface BaseRelation

Overrides:

close in class MainMemoryRelation

Throws:

IOException

flush

public void flush()
           throws IOException,
EDBException

Description copied from interface: BaseRelation

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

Specified by:

flush in interface BaseRelation

Overrides:

flush in class MainMemoryRelation

Throws:

IOException

EDBException

touch

public void touch()
           throws IOException,
EDBException

touch a cache unit.
this means for cache management that this unit
will be used and has a lower prio to be released

Specified by:

touch in interface CacheUnit

Throws:

EDBException

IOException

setNext

public void setNext(CacheUnit next)

pointers in a list for cache management

Specified by:

setNext in interface CacheUnit

Parameters:

next -

getNext

public CacheUnit getNext()

Specified by:

getNext in interface CacheUnit

setLast

public void setLast(CacheUnit last)

Specified by:

setLast in interface CacheUnit

getLast

public CacheUnit getLast()

Specified by:

getLast in interface CacheUnit

release

public void release()
             throws EDBException,
IOException

Cache management calls this method to release the cache unit.

Specified by:

release in interface CacheUnit

Throws:

IOException

EDBException

isReleasable

public boolean isReleasable()

is this unit releasable

Specified by:

isReleasable in interface CacheUnit

Returns:

sizeInBytes

public long sizeInBytes()

Description copied from class: MainMemoryRelation

size in bytes, usded for cache management

Specified by:

sizeInBytes in interface BaseRelation

Specified by:

sizeInBytes in interface CacheUnit

Overrides:

sizeInBytes in class MainMemoryRelation

Returns:

approximate number of size in bytes

remove

public void remove()

destroy

public void destroy()

Description copied from interface: CacheUnit

free up ressources at the end (CacheManager.clear)

Specified by:

destroy in interface CacheUnit

transactionRollback

public void transactionRollback()
                         throws IOException,
EDBException

Description copied from interface: Relation

rbort last changes

Specified by:

transactionRollback in interface Relation

Overrides:

transactionRollback in class MainMemoryRelation

Throws:

EDBException

IOException

transactionCommit

public void transactionCommit()
                       throws IOException,
EDBException

Description copied from interface: Relation

commit last changes

Specified by:

transactionCommit in interface Relation

Overrides:

transactionCommit in class MainMemoryRelation

Throws:

EDBException

IOException

checkSanity

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

Description copied from interface: Relation

check the sanity of a relation

Specified by:

checkSanity in interface Relation

Overrides:

checkSanity in class MainMemoryRelation

shadow - , check in shadow tree

Throws:

IOException

EDBException

getDataFilePath

public String getDataFilePath()

Description copied from interface: Relation

get standard path for binary file

Specified by:

getDataFilePath in interface Relation

Overrides:

getDataFilePath in class MainMemoryRelation

Returns:

transactionBegin

public void transactionBegin()
                      throws IOException,
EDBException

Description copied from interface: Relation

begin transaction

Specified by:

transactionBegin in interface Relation

Overrides:

transactionBegin in class MainMemoryRelation

Throws:

EDBException

IOException

toString

public String toString()

Overrides:

toString in class MainMemoryRelation