|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.ObjectkernelInterface.DbInterface
This class implements the primitive operations that can be used for manipulation of semistructured data stored in a database.
Constructor Summary | |
DbInterface(DbStorage.primitives.DbManager dbm,
concurrency.ConcurrencyManager cm)
Constructs a new database interface without time out. |
|
DbInterface(DbStorage.primitives.DbManager dbm,
concurrency.ConcurrencyManager cm,
long timeOut)
Constructs a new database interface with a specified time out. |
Method Summary | |
void |
add(ssdbms.ssd.ID parent,
ssdbms.ssd.Label childsLabel,
ssdbms.ssd.ID child)
Adds a labeled semistructured datum in other's content. |
void |
addSSDTable(ssdbms.ssd.Label name,
ssdbms.ssd.ID root)
Adds a SSD Table in the database. |
boolean |
belongs(ssdbms.ssd.ID child,
ssdbms.ssd.ID parent)
Checks if a given semistructured belongs to another given datum. |
void |
commit()
Commits the current Transaction and leaves the system ready to init another new. |
boolean |
contains(ssdbms.ssd.ID parent,
ssdbms.ssd.ID child)
Checks if a given semistructured datum owns another given datum in its content. |
boolean |
containsLabel(ssdbms.ssd.ID parent,
ssdbms.ssd.Label childLabel)
Checks if a given semistructured datum owns a specified label. |
ssdbms.ssd.ID |
createBLOB()
Creates a new primitive BLOB datum. |
ssdbms.ssd.ID |
createByteSequence(ssdbms.ssd.ByteSequenceValue value)
Creates a new primitive byte sequence datum. |
ssdbms.ssd.ID |
createCLOB()
Creates a new primitive CLOB datum. |
ssdbms.ssd.ID |
createInteger(ssdbms.ssd.IntegerValue value)
Creates a new primitive integer datum. |
ssdbms.ssd.ID |
createNonPrimitive()
Creates a new non primitive semistructured datum. |
ssdbms.ssd.ID |
createReal(ssdbms.ssd.RealValue value)
Creates a new primitive real datum. |
ssdbms.ssd.ID |
createString(ssdbms.ssd.StringValue value)
Creates a new primitive string datum. |
void |
drop(ssdbms.ssd.ID id)
Drops a semistructured datum giving its identifier. |
ssdbms.manager.primitives.SetOfLabeledSSD |
getAllContent(ssdbms.ssd.ID parent)
Given a semistructured datum, this returns the semistructured data in its content. |
ssdbms.ssd.SSDValue |
getContent(ssdbms.ssd.ID id)
Returns the content of a specified datum in a SSDValue object. |
ssdbms.manager.primitives.SetOfLabeledSSD |
getContentWithID(ssdbms.ssd.ID parent,
ssdbms.ssd.ID child)
Given a semistructured datum, this returns the semistructured data in its content with the specified identifier. |
ssdbms.manager.primitives.SetOfLabeledSSD |
getContentWithLabel(ssdbms.ssd.ID parent,
ssdbms.ssd.Label childLabel)
Given a semistructured datum, this returns the semistructured data in its content with the specified label. |
DbStorage.primitives.DbManager |
getDbManager()
Returns the enclosed database manager. |
ssdbms.manager.primitives.SetOfID |
getParents(ssdbms.ssd.ID id)
Returns the parents of a given semistructured datum. |
ssdbms.ssd.ID |
getRoot(ssdbms.ssd.Label name)
Returns the identifier of the semistructured datum which is the root of the SSD-Table. |
long |
getTimeOut()
Returns the current time out. |
int |
getType(ssdbms.ssd.ID id)
Returns the kind of this semistructured datum. |
boolean |
isPrimitive(ssdbms.ssd.ID id)
Checks if a semistructured datum with a given identifier is primitive or not. |
void |
remove(ssdbms.ssd.ID parent,
ssdbms.ssd.Label childsLabel,
ssdbms.ssd.ID child)
Removes a labeled semistructured datum from other's content. |
void |
removeID(ssdbms.ssd.ID parent,
ssdbms.ssd.ID child)
Removes a datum from other's content. |
void |
removeLabel(ssdbms.ssd.ID parent,
ssdbms.ssd.Label childsLabel)
Removes all subdata from a specified datum with a given label. |
void |
removeSSDTable(ssdbms.ssd.Label name)
Removes a SSD-Table from the database. |
void |
removeSSDTablesWithID(ssdbms.ssd.ID id)
Removes the SSD-Tables whith the specified datum. |
void |
rollback()
Rollbacks the current Transaction and leaves the system ready to init another new. |
void |
setTimeOut(long timeOut)
Sets a new time out. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public DbInterface(DbStorage.primitives.DbManager dbm, concurrency.ConcurrencyManager cm, long timeOut)
public DbInterface(DbStorage.primitives.DbManager dbm, concurrency.ConcurrencyManager cm)
Method Detail |
public void setTimeOut(long timeOut)
public long getTimeOut()
public DbStorage.primitives.DbManager getDbManager()
public void commit() throws ssdbms.manager.primitives.FatalErrorException
commit
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
ssdbms.manager.primitives.FatalErrorException
public void rollback() throws ssdbms.manager.primitives.FatalErrorException
rollback
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
ssdbms.manager.primitives.FatalErrorException
public ssdbms.ssd.ID createNonPrimitive() throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
createNonPrimitive
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.ssd.ID createInteger(ssdbms.ssd.IntegerValue value) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
createInteger
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
value
- The integer value of the semistructured datum to be created.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.ssd.ID createReal(ssdbms.ssd.RealValue value) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
createReal
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
value
- The real value of the semistructured datum to be created.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.ssd.ID createString(ssdbms.ssd.StringValue value) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
createString
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
value
- The string value of the semistructured datum to be created.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.ssd.ID createByteSequence(ssdbms.ssd.ByteSequenceValue value) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
createByteSequence
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
value
- The byte sequence value of the semistructured datum to be created.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.ssd.ID createBLOB() throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
createBLOB
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.ssd.ID createCLOB() throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
createCLOB
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public int getType(ssdbms.ssd.ID id) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.FatalErrorException
getType
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
id
- The identifier of the datum to check.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.FatalErrorException
SSDValue.NON_PRIMITIVE
,
SSDValue.INTEGER
,
SSDValue.REAL
,
SSDValue.STRING
,
SSDValue.BYTE_SEQUENCE
,
SSDValue.BLOB
,
SSDValue.CLOB
public ssdbms.ssd.SSDValue getContent(ssdbms.ssd.ID id) throws ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
SSDValue
object.
getContent
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
id
- The identifier of the datum to get the content.
SSDValue
.
Returns a SetOfLabeledSSD
if the datum in non primitive.
Returns a IntegerValue
if the datum is an integer number.
Returns a RealValue
if the datum is a real number.
Returns a StringValue
if the datum is a string.
Returns a ByteSequenceValue
if the datum is a byte sequence.
Returns a BLOBManager
if the datum is BLOB.
Returns a CLOBManager
if the datum is CLOB.
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public boolean isPrimitive(ssdbms.ssd.ID id) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.FatalErrorException
isPrimitive
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
id
- The datum's identifier to be checked.
true
if the datum is primitive, false
otherwise.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.FatalErrorException
public void add(ssdbms.ssd.ID parent, ssdbms.ssd.Label childsLabel, ssdbms.ssd.ID child) throws ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.InvalidDatumOperationException, ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
add
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
parent
- The identifier of the semistructured datum which its content will be modified,
this has to be non-primitive.childsLabel
- The label of the datum to be added.child
- The identifier of the datum to be added.
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.InvalidDatumOperationException
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public void remove(ssdbms.ssd.ID parent, ssdbms.ssd.Label childsLabel, ssdbms.ssd.ID child) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.InvalidDatumOperationException, ssdbms.manager.primitives.FatalErrorException
remove
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
parent
- The identifier of the semistructured datum which its content will be modified.childsLabel
- The label of the datum to be removed.child
- The identifier of the datum to be removed.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.InvalidDatumOperationException
ssdbms.manager.primitives.FatalErrorException
public void removeID(ssdbms.ssd.ID parent, ssdbms.ssd.ID child) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.InvalidDatumOperationException, ssdbms.manager.primitives.FatalErrorException
removeID
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
parent
- The identifier of the semistructured datum which its content will be modified.child
- The identifier of the datum to be removed.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.InvalidDatumOperationException
ssdbms.manager.primitives.FatalErrorException
public void removeLabel(ssdbms.ssd.ID parent, ssdbms.ssd.Label childsLabel) throws ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.InvalidDatumOperationException, ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
removeLabel
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
parent
- The identifier of the semistructured datum which its content will be modified.childsLabel
- The label of the data to be removed.
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.InvalidDatumOperationException
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public boolean contains(ssdbms.ssd.ID parent, ssdbms.ssd.ID child) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.FatalErrorException
contains
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
parent
- The datum's identifier which content will be analized.child
- The datum's identifier will be searched in parent
's content.
true
if child
is in parents
's content,
false
otherwise. Note: If parent
is primitive this method
returns false.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.FatalErrorException
public boolean belongs(ssdbms.ssd.ID child, ssdbms.ssd.ID parent) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.FatalErrorException
belongs
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
child
- The datum's identifier will be searched in parent
's content.parent
- The datum's identifier which content will be analized.
true
if child
is in parents
's content,
false
otherwise. Note: If parent
is primitive this method
returns false.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.FatalErrorException
public boolean containsLabel(ssdbms.ssd.ID parent, ssdbms.ssd.Label childLabel) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.FatalErrorException
containsLabel
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
parent
- The datum's identifier which content will be analized.childLabel
- The label to be searched in parent
's content.
true
if childLabel
is in parents
's content,
false
otherwise. Note: If parent
is primitive this method
returns false.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.FatalErrorException
public void addSSDTable(ssdbms.ssd.Label name, ssdbms.ssd.ID root) throws ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.AlreadyDefinedSSDTableException, ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
addSSDTable
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
name
- The name of the new table.root
- The identifier of the semistructured datum which will be the root of
the new SSD-Table.
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.AlreadyDefinedSSDTableException
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.ssd.ID getRoot(ssdbms.ssd.Label name) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.NotDefinedSSDTableException, ssdbms.manager.primitives.FatalErrorException
getRoot
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
name
- The name of the SSD-Table to get its root.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.NotDefinedSSDTableException
ssdbms.manager.primitives.FatalErrorException
public void removeSSDTable(ssdbms.ssd.Label name) throws ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.NotDefinedSSDTableException, ssdbms.manager.primitives.FatalErrorException
removeSSDTable
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
name
- The name of the SSD-Table to be removed.
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.NotDefinedSSDTableException
ssdbms.manager.primitives.FatalErrorException
public void removeSSDTablesWithID(ssdbms.ssd.ID id) throws ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.NotDefinedSSDTableException, ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
removeSSDTablesWithID
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
id
- The identifier of the root of the SSD-Tables to be removed.
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.NotDefinedSSDTableException
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public void drop(ssdbms.ssd.ID id) throws ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.NotIsolatedDatumException, ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
drop
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
id
- The identifier of the semistructured datum to be dropped.
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.NotIsolatedDatumException
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.manager.primitives.SetOfID getParents(ssdbms.ssd.ID id) throws ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
getParents
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
id
- The datum's identifier to obtain its parents.
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.manager.primitives.SetOfLabeledSSD getContentWithID(ssdbms.ssd.ID parent, ssdbms.ssd.ID child) throws ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.InvalidDatumOperationException, ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
getContentWithID
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
parent
- The datum's identifier which its content will be analized.child
- The datum to search in parent
's content.
parent
's content with
the child
identifier.
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.InvalidDatumOperationException
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.manager.primitives.SetOfLabeledSSD getContentWithLabel(ssdbms.ssd.ID parent, ssdbms.ssd.Label childLabel) throws ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.InvalidDatumOperationException, ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
getContentWithLabel
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
parent
- The datum's identifier which its content will be analized.childLabel
- The label which data of parent
's content
must match to be returned.
parent
's content labeled
as childrenLabel
.
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.InvalidDatumOperationException
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
public ssdbms.manager.primitives.SetOfLabeledSSD getAllContent(ssdbms.ssd.ID parent) throws ssdbms.manager.primitives.NotExistingDatumException, ssdbms.manager.primitives.InvalidDatumOperationException, ssdbms.manager.primitives.BadFunctionException, ssdbms.manager.primitives.FatalErrorException
getAllContent
in interface ssdbms.manager.primitives.SSDBPrimitiveManager
parent
- The datum's identifier which its content will be analized.
parent
's content.
ssdbms.manager.primitives.NotExistingDatumException
ssdbms.manager.primitives.InvalidDatumOperationException
ssdbms.manager.primitives.BadFunctionException
ssdbms.manager.primitives.FatalErrorException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |