org.apache.empire.db

Class DBRecord

java.lang.Object

org.apache.empire.db.DBObject

org.apache.empire.db.DBRecordData

org.apache.empire.db.DBRecordBase

org.apache.empire.db.DBRecord

All Implemented Interfaces:

Serializable, Cloneable, Record, RecordData, DBContextAware

Direct Known Subclasses:

TRecord

public class DBRecord
extends DBRecordBase

This class represents a record from a database table, view or query The class provides methods to create, read, update and delete records If an Idendity-column (AUTOINC) is defined, the value will be set upon creation by the dbms to the next value If a Timestamp-column is defined the value will be automatically set and concurrent changes of the record will be detected If changes to the record are made, but a rollback on the connection is performed, the changes will be reverted (Rollback-Handling) The record is Serializable either if the provided DBContext is serializable, or if the Context is provided on deserialization in a derived class.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.empire.db.DBRecordBase

DBRecordBase.DBRecordRollbackHandler, DBRecordBase.State

Field Summary

Fields

Modifier and Type	Field and Description
protected DBContext	context
protected DBRowSet	rowset

Fields inherited from class org.apache.empire.db.DBRecordBase

validateFieldValues

Constructor Summary

Constructors

Modifier	Constructor and Description
	DBRecord(DBContext context, DBRowSet rowset) Constructs a new DBRecord.
protected	DBRecord(DBContext context, DBRowSet rowset, boolean enableRollbackHandling) Internal constructor for DBRecord May be used by derived classes to provide special behaviour

Method Summary

Modifier and Type	Method and Description
DBRecord	create() Creates a new record
DBRecord	create(Object[] initalKey) Creates a new record
void	delete() This helper function calls the DBRowset.deleteRecord method to delete the record.
DBContext	getContext() Returns the current Context
long	getIdentity() Returns the record identity for tables which have a single numeric primary key like AUTOINC This method is provided for convenience in addition to the the getKey() method
DBRowSet	getRowSet() Returns the DBRowSet object.
boolean	isRollbackHandlingEnabled() Returns whether or not RollbackHandling is enabled for this record
static Object[]	key(Object... values) varArgs to Array
DBRecord	read(DBCompareExpr whereConstraints) Reads a record from the database
DBRecord	read(long identity) Reads a record from the database
DBRecord	read(Object[] key) Reads a record from the database Hint: variable args param (Object...) caused problems with migration
DBRecord	read(Object[] key, DBRowSet.PartialMode mode, DBColumn... columns) Reads a record partially i.e. not with all but just some selected fields There are two modes: 1.
protected DBContext	readContext(ObjectInputStream strm)
protected DBRowSet	readRowSet(ObjectInputStream strm)
DBRecord	set(Column column, Object value) Overridden to change return type from DBCommandExpr to DBCommand
void	setRollbackHandlingEnabled(boolean enabled) Set whether or not RollbackHandling will be performed for this record Since Rollback handling requires additional resources it should only be used if necessary Especially for bulk operations it should be disabled
void	update() Updates the record and saves all changes in the database.
protected void	writeContext(ObjectOutputStream strm)
protected void	writeRowSet(ObjectOutputStream strm)

Methods inherited from class org.apache.empire.db.DBRecordBase

addXmlData, addXmlMeta, allowFieldChange, assignParentIdentities, changeState, checkUpdateable, checkValid, checkValid, clone, close, createRollbackHandler, getColumn, getDatabase, getEntityType, getFieldCount, getFieldIndex, getFieldIndex, getFieldOptions, getFieldOptions, getFields, getKey, getKeyColumns, getState, getValue, getXmlDictionary, getXmlDocument, initData, isColumn, isExists, isFieldReadOnly, isFieldRequired, isFieldVisible, isModified, isNew, isReadOnly, isSame, isValid, isValidateFieldValues, isValueValid, modifyValue, onFieldChanged, onRecordChanged, setParentRecord, setRecordValue, setRecordValues, setRecordValues, setValidateFieldValues, setValue, setValue, updateComplete, validateAllValues, validateValue, wasAnyModified, wasModified, wasModified

Methods inherited from class org.apache.empire.db.DBRecordData

formatValue, get, get, getArray, getBoolean, getBoolean, getDateTime, getDateTime, getDecimal, getDecimal, getDouble, getDouble, getEnum, getEnum, getEnum, getInt, getInt, getLocalDate, getLocalDate, getLocalDateTime, getLocalDateTime, getLong, getLong, getString, getString, getText, getValue, getValue, getValues, isNull, isNull, setBeanProperties, setBeanProperties, setBeanProperty

Methods inherited from class org.apache.empire.db.DBObject

checkParamNull

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.empire.data.RecordData

get, isNull, isNull, setBeanProperties

Field Detail

context

protected final transient DBContext context

rowset

protected final transient DBRowSet rowset

Constructor Detail

DBRecord

protected DBRecord(DBContext context,
                   DBRowSet rowset,
                   boolean enableRollbackHandling)

Internal constructor for DBRecord May be used by derived classes to provide special behaviour

DBRecord

public DBRecord(DBContext context,
                DBRowSet rowset)

Constructs a new DBRecord.

Parameters:

context - the DBContext for this record

rowset - the corresponding RowSet(Table, View, Query, etc.)

Method Detail

key

public static Object[] key(Object... values)

varArgs to Array

Parameters:

values -

Returns:

the key

writeContext

protected void writeContext(ObjectOutputStream strm)
                     throws IOException

Throws:

IOException

writeRowSet

protected void writeRowSet(ObjectOutputStream strm)
                    throws IOException

Throws:

IOException

readContext

protected DBContext readContext(ObjectInputStream strm)
                         throws IOException,
                                ClassNotFoundException

Throws:

IOException

ClassNotFoundException

readRowSet

protected DBRowSet readRowSet(ObjectInputStream strm)
                       throws IOException,
                              ClassNotFoundException

Throws:

IOException

ClassNotFoundException

getContext

public DBContext getContext()

Returns the current Context

Returns:

getRowSet

public DBRowSet getRowSet()

Returns the DBRowSet object.

Specified by:

getRowSet in class DBRecordBase

Returns:

the DBRowSet object

isRollbackHandlingEnabled

public boolean isRollbackHandlingEnabled()

Returns whether or not RollbackHandling is enabled for this record

Specified by:

isRollbackHandlingEnabled in class DBRecordBase

setRollbackHandlingEnabled

public void setRollbackHandlingEnabled(boolean enabled)

Set whether or not RollbackHandling will be performed for this record Since Rollback handling requires additional resources it should only be used if necessary Especially for bulk operations it should be disabled

Parameters:

enabled - flag whether to enable or disable RollbackHandling

getIdentity

public long getIdentity()

Returns the record identity for tables which have a single numeric primary key like AUTOINC This method is provided for convenience in addition to the the getKey() method

Returns:

the record id or 0 if the key is null

Throws:

NoPrimaryKeyException - if the table has no primary key

NotSupportedException - if the primary key is not a single column of if the column is not numeric

create

public DBRecord create(Object[] initalKey)

Creates a new record

create

public DBRecord create()

Creates a new record

read

public DBRecord read(Object[] key)

Reads a record from the database Hint: variable args param (Object...) caused problems with migration

Parameters:

key - an array of the primary key values

read

public final DBRecord read(long identity)

Reads a record from the database

Parameters:

identity - the record id value

read

public DBRecord read(DBCompareExpr whereConstraints)

Reads a record from the database

Parameters:

key - an array of the primary key values

read

public DBRecord read(Object[] key,
                     DBRowSet.PartialMode mode,
                     DBColumn... columns)

Reads a record partially i.e. not with all but just some selected fields There are two modes: 1. PartialMode.INCLUDE reads only the fields provided with the column list 2. PartialMode.EXCLUDE reads all but the fields provided with the column list The primary key is always fetched implicitly

Parameters:

key - the primary key values

mode - flag whether to include only the given columns or whether to add all but the given columns

columns - the columns to include or exclude (depending on mode)

set

public DBRecord set(Column column,
                    Object value)

Overridden to change return type from DBCommandExpr to DBCommand

Specified by:

set in interface Record

Overrides:

set in class DBRecordBase

Parameters:

column - a DBColumn object

value - the value

update

public void update()

Updates the record and saves all changes in the database.

delete

public void delete()

This helper function calls the DBRowset.deleteRecord method to delete the record. WARING: There is no guarantee that it ist called Implement delete logic in the table's deleteRecord method if possible

Parameters:

conn - a valid connection to the database.

See Also:

org.apache.empire.db.DBTable#deleteRecord(Object[], Connection)