org.tentackle.persist

Class DbModification

java.lang.Object

org.tentackle.persist.AbstractDbObject<DbModification>

org.tentackle.persist.DbModification

All Implemented Interfaces:

Serializable, Cloneable, Comparable<DbModification>, Identifiable, Immutable, SerialNumbered, SessionDependable, SessionProvider

public class DbModification
extends AbstractDbObject<DbModification>

Modification information per table.

Author:

harald

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	CN_TRACKEDNAME database column name for 'trackedName'.
static String	TABLENAME the database tablename.

Fields inherited from class org.tentackle.persist.AbstractDbObject

AN_CLASSID, AN_ID, AN_SERIAL, AN_TABLESERIAL, CN_CLASSID, CN_ID, CN_SERIAL, CN_TABLESERIAL, idComparator, nameComparator, nameIdComparator, preparePending, TX_DELETE_LIST, TX_DELETE_MISSING_IN_LIST, TX_DELETE_OBJECT, TX_DUMMY_UPDATE, TX_INSERT_OBJECT, TX_INSERT_PLAIN, TX_SAVE, TX_SAVE_LIST, TX_SYNC, TX_UPDATE_OBJECT, TX_UPDATE_PLAIN, TX_UPDATE_SERIAL, TX_UPDATE_SERIAL_AND_TABLESERIAL, TX_UPDATE_TABLESERIAL

Constructor Summary

Constructors

Constructor and Description
DbModification() Creates an empty modification object.
DbModification(Db db) Creates an empty modification object.
DbModification(Db db, String trackedName) Creates a modification object for a given tablename.

Method Summary

Modifier and Type	Method and Description
void	addToModificationTable(boolean tableExists, String tableSerialTableName) Adds an entry for this counter (== database object class) to the modification table.
int	countModification(long count) Counts modifications. Adds the count to the table's entry and the master entry.
String	createInsertSql() Creates the SQL code for the insert statement.
String	createUpdateSql() Creates the SQL code for the update statement.
DbObjectClassVariables<DbModification>	getClassVariables() Gets the some attributes and variables common to all objects of the same class.
void	getFields(ResultSetWrapper rs) Retrieves the values of all fields.
String	getTrackedName() Gets the attribute trackedName.
static void	initializeModificationTable(Db db) Initializes the modification table.
long	refresh() Refreshes the contents of this modification entry by its name.
IdSerialTuple	selectIdSerial(String tableName) Selects the id and serial by tablename.
long	selectMasterSerial() Reads the master-serial.
String	selectTableNameForId(long id) Selects the tablename for a given ID.
int	setFields(PreparedStatementWrapper st) Sets the values of all fields (all columns of the database table) in the given PreparedStatementWrapper from the object's attributes.
void	setTrackedName(String trackedName) Sets the attribute trackedName.
String	toString() Gets the default string value. The default implementation invokes AbstractDbObject.toGenericString().

Methods inherited from class org.tentackle.persist.AbstractDbObject

acceptPersistenceVisitor, addPropertyChangeListener, addPropertyChangeListener, assertMutable, assertNotNew, assertNotOverloaded, assertNotRemote, assertNumberOfRowsAffected, assertPersistable, assertRemote, assertThisRowAffected, attributesModified, beginTx, clearOnRemoteSave, clone, compareTo, copyToDb, countModification, createDeleteAllSql, createDeleteSql, createDummyUpdateSql, createModificationLog, createPreparedStatement, createPreparedStatement, createSelectAllByIdInnerSql, createSelectAllIdSerialInnerSql, createSelectAllInnerSql, createSelectExpiredTableSerials1Sql, createSelectExpiredTableSerials2Sql, createSelectIdInnerSql, createSelectMaxIdSql, createSelectMaxTableSerialSql, createSelectSerialSql, createSelectSql, createSqlUpdate, createUpdateSerialAndTableSerialSql, createUpdateSerialSql, deleteImpl, deleteObject, deletePlain, deleteReferencedRelations, deleteReferencingRelations, dummyUpdate, equals, finishModification, finishNotUpdated, firePropertyChange, getBackend, getClassBaseName, getClassId, getColumnCount, getExpirationBacklog, getExpiredTableSerials, getId, getIdSource, getImmutableLoggingLevel, getModificationCount, getModificationLog, getPreparedStatement, getPreparedStatement, getPropertyChangeListeners, getPropertyChangeListeners, getRemoteDelegate, getSerial, getSession, getSessionHolder, getTableName, getTableSerial, hashCode, initModification, insertImpl, insertObject, insertPlain, isCountingModification, isDeleted, isEntity, isIdValid, isImmutable, isLoggingModification, isModified, isNew, isOverloadable, isPersistable, isReferenced, isRemovable, isSessionImmutable, isStatementAlwaysPrepared, isTableSerialProvided, isTracked, isUpdateNecessary, isUpdatingSerialEvenIfNotModified, isVirgin, loadLazyReferences, logModification, markDeleted, newId, newInstance, newInstance, newInstance, persistObject, prepareDelete, prepareSave, prepareSetFields, readFromResultSetWrapper, reloadLockedObject, reloadObject, removeAllPropertyChangeListeners, removePropertyChangeListener, removePropertyChangeListener, reserveId, resultAllIdSerial, resultAllObjects, revertAttributesToSnapshot, saveObject, saveReferencedRelations, saveReferencingRelations, selectAllIdSerial, selectAllObjects, selectExpiredTableSerials, selectExpiredTableSerials, selectLockedObject, selectMaxId, selectMaxTableSerial, selectNextObject, selectObject, selectSerial, setClassId, setId, setImmutable, setImmutableLoggingLevel, setModificationLog, setModified, setOverloadable, setSerial, setSession, setSessionHolder, setSessionImmutable, setStatementAlwaysPrepared, setTableSerial, toGenericString, toIdString, unmarkDeleted, updateImpl, updateObject, updatePlain, updateSerial, updateSerialAndTableSerial

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

TABLENAME

public static final String TABLENAME

the database tablename.

See Also:

Constant Field Values

CN_TRACKEDNAME

public static final String CN_TRACKEDNAME

database column name for 'trackedName'.

See Also:

Constant Field Values

Constructor Detail

DbModification

public DbModification(Db db,
                      String trackedName)

Creates a modification object for a given tablename.

Parameters:

db - the database connection

trackedName - the tracked name

DbModification

public DbModification(Db db)

Creates an empty modification object.

Parameters:

db - the database connection

DbModification

public DbModification()

Creates an empty modification object. Constructor only provided for Class.newInstance().

Method Detail

initializeModificationTable

public static void initializeModificationTable(Db db)

Initializes the modification table.

Parameters:

db - the session

getClassVariables

public DbObjectClassVariables<DbModification> getClassVariables()

Description copied from class: AbstractDbObject

Gets the some attributes and variables common to all objects of the same class. Class variables for classes derived from AbstractDbObject are kept in an instance of DbObjectClassVariables.

Overrides:

getClassVariables in class AbstractDbObject<DbModification>

Returns:

the class variables

toString

public String toString()

Description copied from class: AbstractDbObject

Gets the default string value.
The default implementation invokes AbstractDbObject.toGenericString().

Overrides:

toString in class AbstractDbObject<DbModification>

Returns:

the string value of this AbstractDbObject

getFields

public void getFields(ResultSetWrapper rs)

Description copied from class: AbstractDbObject

Retrieves the values of all fields.

Overrides:

getFields in class AbstractDbObject<DbModification>

Parameters:

rs - the result set

setFields

public int setFields(PreparedStatementWrapper st)

Description copied from class: AbstractDbObject

Sets the values of all fields (all columns of the database table) in the given PreparedStatementWrapper from the object's attributes.

Overrides:

setFields in class AbstractDbObject<DbModification>

Parameters:

st - the statement

Returns:

the number of fields set

createInsertSql

public String createInsertSql()

Description copied from class: AbstractDbObject

Creates the SQL code for the insert statement.

Overrides:

createInsertSql in class AbstractDbObject<DbModification>

Returns:

the SQL code

createUpdateSql

public String createUpdateSql()

Description copied from class: AbstractDbObject

Creates the SQL code for the update statement.

Overrides:

createUpdateSql in class AbstractDbObject<DbModification>

Returns:

the SQL code

getTrackedName

public String getTrackedName()

Gets the attribute trackedName.

Returns:

the tablename

setTrackedName

public void setTrackedName(String trackedName)

Sets the attribute trackedName.

Parameters:

trackedName - the tablename

countModification

public int countModification(long count)

Counts modifications.
Adds the count to the table's entry and the master entry.

Parameters:

count - the number of modifications to add

Returns:

the number of modification rows updated (should be 2)

addToModificationTable

public void addToModificationTable(boolean tableExists,
                                   String tableSerialTableName)

Adds an entry for this counter (== database object class) to the modification table. The tableserial is derived from the highest serial of all objects (i.e. class) this counter refers to.

Parameters:

tableExists - true if related to a PDO, false if just a name

tableSerialTableName - the table to scan for max tableserial if PDO manages a tableserial

refresh

public long refresh()

Refreshes the contents of this modification entry by its name.

Returns:

the modification count

selectIdSerial

public IdSerialTuple selectIdSerial(String tableName)

Selects the id and serial by tablename.

Parameters:

tableName - the database tablename

Returns:

the id/serial tuple, null if no such table registered so far

selectTableNameForId

public String selectTableNameForId(long id)

Selects the tablename for a given ID.

Parameters:

id - the table ID

Returns:

the tablename, null if the such an ID does not exist

selectMasterSerial

public long selectMasterSerial()

Reads the master-serial.

Returns:

the master serial