com.jcorporate.expresso.core.dbobj
Class MultiDBObjectTransaction

java.lang.Object
  com.jcorporate.expresso.core.dbobj.MultiDBObject
      com.jcorporate.expresso.core.dbobj.MultiDBObjectTransaction

public class MultiDBObjectTransaction

extends MultiDBObject

A MultiDBObjectTransaction is a group of dbobjects that are "related" - e.g. defined as being part of a foreign-key/primary-key relationship. This may be master/detail or a more complex relationship, but it can be expressed as a "join" operation between the tables.

After establishing the relationships between the objects the MultiDBObject can have search criteria set for it & searchAndRetrieve operations done just like a 'regular' DBObject, but these operations affect the entire related group of objects. At the moment, MultiDBObjects are read-only, though that may change in the future.

Creation date: (10-12-2003 11:32:03 AM) author Yves Henri AMAIZO

Field Summary

Fields inherited from class com.jcorporate.expresso.core.dbobj.MultiDBObject

INNER_JOIN, LEFT_JOIN, localConnection, maxRecords, offsetRecord, RIGHT_JOIN, SHORT_NAME

Constructor Summary

MultiDBObjectTransaction()
MultiDBObjectTransaction constructor comment.

Method Summary

DBConnection	getConnection()
String	getDBName() Return the name of the context/database connection that this DB object is using.
void	setConnection(DBConnection connection)
void	setDBName(String newOther) Set the database name/context for this multi db object.

Methods inherited from class com.jcorporate.expresso.core.dbobj.MultiDBObject

addDBObj, addDBObj, assembleObject, buildFromClause, buildWhereClause, buildWhereClauseBuffer, buildWhereClauseBuffer, clear, count, count, getAppendCustomWhereClause, getAttribute, getCustomFromClause, getCustomWhereClause, getDataContext, getDBObject, getField, getFieldBigDecimal, getFieldDate, getFieldDecimalFormatted, getFieldDouble, getFieldFloat, getFieldInt, getFieldLong, getMaxRecords, getOffsetRecord, getShortNameAsAlias, getThisMultiDBObj, isFieldNull, makeDirectQueryList, makeLimitationStub, searchAndRetrieveList, searchAndRetrieveList, selectFieldString, setAppendCustomWhereClause, setAttribute, setCaseSensitiveQuery, setCustomFromClause, setCustomWhereClause, setCustomWhereClause, setField, setFieldDistinct, setFieldsToRetrieve, setFieldsToRetrieveToNone, setForeignKey, setInnerJoin, setLeftJoin, setMaxRecords, setOffsetRecord, setRightJoin, setSelectDistinct, setShortNameAsAlias, setupFields

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiDBObjectTransaction

public MultiDBObjectTransaction()
                         throws DBException

MultiDBObjectTransaction constructor comment.

Method Detail

getDBName

public String getDBName()

Return the name of the context/database connection that this DB object is using. If none is set, then we are using the "default" database/context.

Overrides:

getDBName in class MultiDBObject

Returns:

the name of the datacontext

setDBName

public void setDBName(String newOther)
               throws DBException

Set the database name/context for this multi db object. If setDBName is not called, the "default" db name and context is used. See com.jcorporate.expresso.core.misc.ConfigManager for information about multiple contexts. Note that setting a db/context name only affects the object when it allocates it's own db connections - if a specific connection is used (via the setConnection(DBConnection) method) then that connection must be already associated with the correct db/context.

Overrides:

setDBName in class MultiDBObject

Parameters:

newOther - The name of the context or database to use

Throws:

DBException

getConnection

public DBConnection getConnection()

Overrides:

getConnection in class MultiDBObject

Returns:

setConnection

public void setConnection(DBConnection connection)

Overrides:

setConnection in class MultiDBObject

Parameters:

connection -