com.hfg.sql.table

Class DatabaseRow

java.lang.Object

com.hfg.sql.table.DatabaseRow

All Implemented Interfaces:

Cloneable

Direct Known Subclasses:

DatabaseRowWithIntPrimaryKey, DatabaseRowWithLongPrimaryKey

public abstract class DatabaseRow
extends Object
implements Cloneable

Database row object.

Constructor Summary

Constructors

Constructor and Description
DatabaseRow(DatabaseTable<? extends DatabaseRow> inTable)
DatabaseRow(DatabaseTable<? extends DatabaseRow> inTable, ResultSet inResultSet)
DatabaseRow(XMLTag inXMLTag)

Method Summary

Modifier and Type	Method and Description
protected void	addField(DatabaseField inField)
protected DatabaseField	allocateField(DatabaseCol inCol)
protected DatabaseField	allocateField(DatabaseCol inCol, Object inValue)
protected DatabaseField	allocateField(DatabaseCol inCol, ResultSet inResultSet)
void	bless() Sets the dirty flag on all fields to false.
DatabaseRow	clone()
boolean	delete(Connection inConn)
abstract DatabaseTable<? extends DatabaseRow>	getDatabaseTable()
DatabaseField	getField(DatabaseCol inCol)
Collection<DatabaseField>	getFields()
DatabaseCol	getIdCol()
boolean	insert(Connection inConn)
static DatabaseRow	instantiate(XMLTag inXMLTag)
boolean	isDirty()
boolean	isDirty(DatabaseCol inColumn) Indicates whether the specified field is dirty or not.
protected void	postDelete(Connection inConn)
protected void	postInsert(Connection inConn)
protected void	postUpdate(Connection inConn)
protected void	preDelete(Connection inConn)
protected void	preInsert(Connection inConn)
protected void	preUpdate(Connection inConn)
boolean	save(Connection inConn) Invokes insert() or update() depending on whether there is an id column and if it already has a value.
XMLTag	toXMLTag()
boolean	update(Connection inConn)

Methods inherited from class java.lang.Object

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

Constructor Detail

DatabaseRow

public DatabaseRow(DatabaseTable<? extends DatabaseRow> inTable)

DatabaseRow

public DatabaseRow(DatabaseTable<? extends DatabaseRow> inTable,
                   ResultSet inResultSet)

DatabaseRow

public DatabaseRow(XMLTag inXMLTag)

Method Detail

instantiate

public static DatabaseRow instantiate(XMLTag inXMLTag)

clone

public DatabaseRow clone()

Overrides:

clone in class Object

toXMLTag

public XMLTag toXMLTag()

getField

public DatabaseField getField(DatabaseCol inCol)

getFields

public Collection<DatabaseField> getFields()

getDatabaseTable

public abstract DatabaseTable<? extends DatabaseRow> getDatabaseTable()

save

public boolean save(Connection inConn)
             throws SQLException

Invokes insert() or update() depending on whether there is an id column and if it already has a value.

Parameters:

inConn - the connection to use

Returns:

the result of the insert() or update()

Throws:

SQLException - exception thrown if the insert/update fails

insert

public boolean insert(Connection inConn)
               throws SQLException

Throws:

SQLException

update

public boolean update(Connection inConn)
               throws SQLException

Throws:

SQLException

delete

public boolean delete(Connection inConn)
               throws SQLException

Throws:

SQLException

getIdCol

public DatabaseCol getIdCol()

isDirty

public boolean isDirty()

isDirty

public boolean isDirty(DatabaseCol inColumn)

Indicates whether the specified field is dirty or not.

Parameters:

inColumn - the DatabaseCol corresponding to the field

Returns:

whether or not the specified field is dirty

bless

public void bless()

Sets the dirty flag on all fields to false.

allocateField

protected DatabaseField allocateField(DatabaseCol inCol)

allocateField

protected DatabaseField allocateField(DatabaseCol inCol,
                                      Object inValue)

allocateField

protected DatabaseField allocateField(DatabaseCol inCol,
                                      ResultSet inResultSet)

addField

protected void addField(DatabaseField inField)

preInsert

protected void preInsert(Connection inConn)
                  throws SQLException

Throws:

SQLException

postInsert

protected void postInsert(Connection inConn)
                   throws SQLException

Throws:

SQLException

preUpdate

protected void preUpdate(Connection inConn)
                  throws SQLException

Throws:

SQLException

postUpdate

protected void postUpdate(Connection inConn)
                   throws SQLException

Throws:

SQLException

preDelete

protected void preDelete(Connection inConn)
                  throws SQLException

Throws:

SQLException

postDelete

protected void postDelete(Connection inConn)
                   throws SQLException

Throws:

SQLException