DataObject (Cameleon OSP Specification)

java.lang.Object
- de.must.dataobj.DataObject

All Implemented Interfaces:

DataObjectConstructionDetails, EntityInfo, Exemptible

Direct Known Subclasses:

AssoDataObject, DataObjectReadOnlyWithCache, DataObjectWithGroupOverview, DirectDataObject, DoChangeLog, SelfChainingDataObject
```
public abstract class DataObject
extends java.lang.Object
implements EntityInfo, DataObjectConstructionDetails, Exemptible
```
The central class to read and write to database tables. Define your table in a database independent way as shown in the samples (subclasses). The subclasses should contain the table name, a list of attributes and indices and use them for the construction of this class. When data is read, it is buffered in two hashMaps, original and workedOn. Changes are synchronized in hashMap workedOn. To get the appropriate update statement, the values of original and workedOn are compared, and the specific SQL dialect will provide the update statement. Attributes and indices are required for database specific table creation and for knowing how to update the row. Therefore, at least the primary key should be described in attributes and indices.

See Also:

SqlDialect

Field Summary

Fields
Modifier and Type	Field and Description
`protected static ChangeLogger`	`changeLogger`
`protected java.lang.String[]`	`columnNames`
`protected int[]`	`columnType`
`protected java.util.HashMap<java.lang.String,java.lang.Integer>`	`htColumnType`
`static int`	`INSERTMODE`
`protected java.util.HashMap<java.lang.String,java.lang.Integer>`	`maxFieldSize`
`protected java.util.HashMap<java.lang.String,java.lang.Object>`	`original`
`static int`	`UPDATEMODE`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`DataObject(java.sql.Connection connection)` Constructs a new DataObject with the specified connection.
`protected`	`DataObject(java.sql.Connection newConnection, IdentifyTemplate identifyTemplate)` Constructs a new DataObject with the specified connection and identify template
`protected`	`DataObject(java.sql.Connection connection, int maxColumns)` Constructs a new DataObject with the specified connection.
`protected`	`DataObject(java.sql.Connection newConnection, java.lang.String uniqueKeyName)` Constructs a new DataObject with the specified connection and the name of the unique key to process updates.
`protected`	`DataObject(DataObjectConstructionDetails dataObjectConstructionDetails)` Constructs a new DataObject with the specified DB connection details.
`protected`	`DataObject(DataObjectConstructionDetails dataObjectConstructionDetails, int maxColumns)` Constructs a new DataObject with the specified global objects of the individual application.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addDataChangeListener(DataChangeListener listener)` Adds the specified ThreadDoneListener to receive data changed events from any entity.
`void`	`addDataSelectionListener(DataSelectionListener l)` Adds the specified DataSelectionListener to receive data selection events from this entity.
`protected void`	`alertBadUniqueKey()`
`Identifier`	`allocateNewIdentifier()` Allocates a new row identifier (primary key).
`protected boolean`	`checkRecoverConnection()` Checks the DB connection, if it has not been used for a while to prevent Exception "No operations allowed after connection closed"
`protected void`	`closeIfExists(java.sql.Statement statement)`
`void`	`closePreparedStatementsForWhereCondition()` Closes all prepared statements used with where condition for prepared statements if existing.
`void`	`closeQuery()` Closes the query as opened by select or openQuery statements.
`void`	`commitIfNotAutoCommit()` Makes all changes made since the previous commit/rollback permanent and releases any database locks currently held by the Connection.
`boolean`	`contains(AbstractTextAttribute attribute, java.lang.String columnValue)` Indicates, whether a record exists, whose column's value is equals the specified value.
`boolean`	`contains(NumericAttribute attribute, int columnValue)` Indicates, whether a record exists, whose column's value is equals the specified value.
`boolean`	`contains(java.lang.String columnName, java.sql.Date columnValue)` Indicates, whether a record exists, whose column's value is equals the specified date.
`boolean`	`contains(java.lang.String columnName, Identifier identifier)` Indicates, whether a record exists, whose column's value is equals the specified value.
`boolean`	`contains(java.lang.String columnName, int columnValue)` Indicates, whether a record exists, whose column's value is equals the specified value.
`boolean`	`contains(java.lang.String columnName, java.lang.String columnValue)` Indicates, whether a record exists, whose column's value is equals the specified value.
`int`	`count(AbstractTextAttribute attribute, java.lang.String value)` Returns the number of rows of a specific column value.
`int`	`count(NumericAttribute attribute, int number)` Returns the number of rows of a specific column value.
`int`	`count(java.lang.String columnName, int number)` Returns the number of rows of a specific column value.
`int`	`count(java.lang.String columnName, java.lang.String value)` Returns the number of rows of a specific column value.
`int`	`count(java.lang.String field, WhereConditionForPrepStmts wc)` Counts the rows fitting the where condition.
`int`	`count(WhereConditionForPrepStmts wc)` Counts the rows fitting the where condition using the first column of the identify template.
`int`	`countThrowException(java.lang.String columnName, int number)` Returns the number of rows of a specific column value.
`boolean`	`delete()` Deletes the currently accessed row, e.g. a row found by nextRow().
`boolean`	`delete(Identifier identifier)` Deletes a row by primary key.
`protected boolean`	`deleteFreeConditioned(java.lang.String whereCondition)` Deletes rows by a free formulated condition.
`protected boolean`	`deleteFreeConditioned(WhereCondition whereCondition)` Deletes rows by a free formulated condition.
`protected int`	`deleteFreeConditionedAndCount(java.lang.String whereCondition)` Deletes rows by a free formulated condition.
`protected void`	`discardStatements()` Discard prepared statements, e.g. to force new creation due to underlying connection has been closed.
`boolean`	`ensureMetaDataIsAvailableForAllColumns()` Ensures that meta data is available for all columns by executing a query over all columns if necessary.
`protected void`	`finalize()`
`void`	`fireDataChanged(DataChangedEvent e)` Notifies all listeners that have registered interest for notification on this event type.
`void`	`free()` Releases external resources.
`boolean`	`getBoolean(BooleanAttribute attribute)` Gets the value of the specified column as boolean.
`boolean`	`getBoolean(java.lang.String columnName)` Gets the value of the specified column as boolean.
`byte[]`	`getBytes(java.lang.String columnName)` Return the bytes of the specified column.
`int`	`getColumnCount()` Returns the number of available columns.
`java.lang.String`	`getColumnLabel()` Returns the label of the current column.
`int`	`getColumnLength(java.lang.String columnName)` Returns the length of the specified column.
`java.lang.String`	`getColumnName()` Returns the name of the current column.
`java.lang.String`	`getColumnName(int columnPointer)` Returns the column name of the indicated array position.
`int`	`getColumnScale()` Returns the scale of the current column.
`int`	`getColumnType()` Returns the type of the current column.
`int`	`getColumnType(int columnPointer)` Returns the column type of the indicated array position.
`int`	`getColumnType(java.lang.String columnName)` Returns the type of the specified column.
`int`	`getColumnType(java.lang.String columnName, boolean informIfNotAvailable)` Returns the type of the specified column.
`java.sql.Connection`	`getConnection()` Returns the used connection.
`java.sql.Date`	`getDate(DateAttribute attribute)` Gets the value of the specified column as date.
`protected java.sql.Date`	`getDate(java.lang.Integer intDate)`
`java.sql.Date`	`getDate(java.lang.String columnName)` Gets the value of the specified column as date.
`java.lang.String`	`getDateFormattedWithShortYear(java.lang.String columnName)`
`HintContainer`	`getDeletionHindrance(Identifier identifier)` Returns a hint container with hints why an item cannot be deleted - if the container's getHint() method returns null there is no hindrance to delete an item.
`java.lang.String`	`getDescription(java.lang.String field)` Returns the description of the specified field.
`java.lang.String`	`getDescription(java.lang.String columnName, AbstractAttribute[] atrributes)` Retrieves the internal description the specified column.
`double`	`getDouble(NumericAttribute attribute)` Gets the value of the specified column as double.
`double`	`getDouble(java.lang.String columnName)` Gets the value of the specified column as double.
`protected java.lang.String`	`getEntityId()` Returns the entity id.
`java.lang.String`	`getFailedQueryExpression()` Returns the failed query expression.
`float`	`getFloat(java.lang.String columnName)` Gets the value of the specified column as float.
`java.lang.String`	`getGlobalWhereCondition(java.lang.String textToFind)` Gets the global where condition for searching a value in all available and castable columns.
`java.lang.String`	`getGlobalWhereCondition(java.lang.String textToFind, java.lang.String additionalCondition)` Returns the global where condition for searching a value in all available and castable columns.
`Identifier`	`getIdentifier()` Returns the identifier (primary key) of the current row.
`IdentifyTemplate`	`getIdentifyTemplate()` Returns the identify template.
`int`	`getIdentifyValueInt()` Returns the int primary key of the current row.
`java.lang.String`	`getIdentifyWhereCondition()` Returns the where condition to identify the current row without the word "where".
`IdManager`	`getIdManager()` Returns the used Id Manager.
`int`	`getInt(NumericAttribute attribute)` Gets the value of the specified column as integer.
`int`	`getInt(java.lang.String columnName)` Gets the value of the specified column as integer.
`java.lang.String`	`getIntAsStringZeroSuppressed(java.lang.String columnName)` Gets the value of the specified Integer containing column as String with zero suppression.
`protected java.lang.String`	`getKeyExtendedFieldSelection(java.lang.String fieldSelection)` Returns the extended field selection including all primary key fields.
`java.lang.Exception`	`getLastException()` Return the last exception occurring in update().
`java.sql.SQLException`	`getLoadException()` Returns the loadException or null if no exception occurred.
`long`	`getLong(java.lang.String columnName)` Gets the value of the specified column as long.
`int`	`getmaxRow(int licenceType)` Returns the maximum allowed rows to insert.
`int`	`getMode()` Returns the mode.
`int`	`getNbrOfFittingItems(java.lang.String whereCondition)` Returns the number of items which fit the where condition.
`int`	`getNbrOfFittingItems(java.lang.String selectionFieldName, java.lang.String whereCondition)` Returns the number of items which fit the where condition.
`int`	`getNbrOfFittingItems(java.lang.String selectionFieldName, WhereCondition whereCondition)` Returns the number of items which fit the where condition.
`int`	`getNbrOfFittingItems(java.lang.String selectionFieldName, WhereConditionForPrepStmts whereCondition)` Returns the number of items which fit the where condition.
`int`	`getNbrOfFittingItems(WhereCondition whereCondition)` Returns the number of items which fit the where condition.
`int`	`getNbrOfFittingItems(WhereConditionForPrepStmts whereCondition)` Returns the number of items which fit the where condition.
`java.lang.Object`	`getObject(java.lang.String columnName)` Returns the value of a column as an object.
`protected java.lang.Object`	`getOriginalOf(java.lang.String columnName)`
`java.sql.SQLException`	`getQueryException()` Returns the queryException.
`java.sql.Date`	`getRecordingDate()` Returns the recording date.
`java.lang.String`	`getRecordingUser()` Returns the current user recording table rows.
`int`	`getRowCount()`
`java.lang.String`	`getSqlCompareString(boolean b)`
`java.lang.String`	`getSqlCompareString(java.sql.Date date)` Returns the date in the way the database dialect expects it in the where clause.
`java.lang.String`	`getText(AbstractTextAttribute attribute)` Gets the value of the specified column as text.
`java.lang.String`	`getText(java.lang.String columnName)` Gets the value of the specified column as text.
`java.lang.String`	`getTextNoMatterWhatTypeOfColumn(java.lang.String columnName)` Gets the value of the specified column as text.
`java.sql.Time`	`getTime(java.lang.String columnName)` Returns the value of the specified column as time.
`java.sql.Timestamp`	`getTimestamp(java.lang.String columnName)` Returns the value of the specified column as Timestamp.
`java.lang.String`	`getUniqueKeyName()` Returns the name of the primary key.
`protected boolean`	`getWorkedOnBoolean(java.lang.String columnName)` Gets the value of the specified column as boolean in a worked on state - it might already been modified and differ from the original value.
`java.sql.Date`	`getWorkedOnDate(java.lang.String columnName)` Gets the value of the specified column as date in a worked on state - it might already been modified and differ from the original value.
`double`	`getWorkedOnDouble(java.lang.String columnName)` Gets the value of the specified column as double in a worked on state - it might already been modified and differ from the original value.
`int`	`getWorkedOnInt(java.lang.String columnName)` Gets the value of the specified column as int in a worked on state - it might already been modified and differ from the original value.
`protected java.lang.Object`	`getWorkedOnOf(java.lang.String columnName)`
`java.lang.String`	`getWorkedOnText(AbstractTextAttribute attribute)` Gets the value of the specified column as text in a worked on state - it might already been modified and differ from the original value.
`java.lang.String`	`getWorkedOnText(java.lang.String columnName)` Gets the value of the specified column as text in a worked on state - it might already been modified and differ from the original value.
`java.sql.Time`	`getWorkedOnTime(java.lang.String columnName)` Gets the value of the specified column as time in a worked on state - it might already been modified and differ from the original value.
`java.sql.Timestamp`	`getWorkedOnTimestamp(java.lang.String columnName)` Gets the value of the specified column as Timestamp in a worked on state - it might already been modified and differ from the original value.
`void`	`insert()` Inserts the prepared row in the database.
`boolean`	`isAvailable(java.lang.String whereCondition)` Indicates, whether a where condition will find results.
`boolean`	`isAvailable(java.lang.String whereCondition, java.lang.String fieldSelection)` Indicates, whether a where condition will find results.
`boolean`	`isAvailable(WhereConditionForPrepStmts whereCondition)` Indicates, whether a where condition will find results.
`boolean`	`isColumnContained(java.lang.String columnName)` Checks if the specified column is in the currently watched result set.
`protected boolean`	`isColumnToUseForGlobalSearch(java.lang.String columnName)` Returns true if the specified column is to use to build global where condition.
`boolean`	`isDeletionAllowed(Identifier identifier)` Checks of deletion of a row is allowed.
`boolean`	`isKnownAsBoolean(java.lang.String columnName)` Checks whether or not the specified column is of type boolean by evaluating the attributes of the data object if available.
`boolean`	`isMemo(java.lang.String columnName)`
`boolean`	`isModified()` Checks if there have been any modifications made on the current row.
`boolean`	`isModifiedColumn(java.lang.String columnName)` Checks if there have been any modifications made on the current row.
`boolean`	`isQueryFindingRecords(java.lang.String queryExpression)` Indicates, whether a query expression will find results.
`boolean`	`isQueryFindingRecords(WhereCondition wc)` Indicates, whether a query expression will find results.
`boolean`	`load()` Loads a row as specified by the primary key previously specified by `setIdentityValue(int)`
`boolean`	`load(Identifier identifier)` Loads a row as specified by the primary key.
`boolean`	`load(Identifier identifier, java.lang.String columns)` Loads a row as specified by the primary key .
`boolean`	`load(int identifyInt)` Loads a row as specified by the primary key.
`boolean`	`load(int identifyInt, java.lang.String columns)` Loads a row as specified by the primary key.
`boolean`	`load(long identifyLong)` Loads a row as specified by the primary key.
`boolean`	`load(java.lang.String identifyString)` Loads a row as specified by the primary key.
`boolean`	`loadColumns(java.lang.String columns)` Loads a row as specified by the primary key previously specified by `setIdentityValue(int)`
`boolean`	`loadFirst(WhereConditionForPrepStmts wc)` Loads the first row fitting the where condition and returns true if row was found.
`protected void`	`logDebug(java.lang.String text)` Logs a message as a debug information.
`protected void`	`logError(java.lang.String text)` Logs a message as an error.
`protected void`	`logError(java.lang.String text, java.lang.Throwable throwable)` Logs a message as an error.
`protected void`	`logError(java.lang.Throwable throwable)` Logs a message as an error.
`protected void`	`logInfo(java.lang.String text)` Logs a message as information.
`boolean`	`newRow()` Prepares an insert by initializing a new row.
`Identifier`	`newRowWithNextIdentifierAllocation()` Prepares an insert by initializing a new row plus allocating a new primary key value.
`boolean`	`nextColumn()` Increases the column pointer.
`boolean`	`nextRow()` Loads the next row according to the previous select statement.
`boolean`	`openQuery(java.lang.String queryString)` Invokes a database query for following record requests via `nextRow()`.
`void`	`openQueryThrowException(java.lang.String queryString)` Invokes a database query for following record requests via `nextRow()`.
`protected DataObject`	`register(DataObject dataObject)` Registers a DataObject as Co-DataObject
`void`	`removeDataChangeListener(DataChangeListener listener)` Removes the specified DataChangeListener to receive data changed events from any entity.
`void`	`removeDataSelectionListener(DataSelectionListener l)` Removes the specified DataSelectionListener to receive data selection events from this entity.
`void`	`resetColumnPointer()` Sets the column pointer to 0.
`void`	`rollbackIfNotAutoCommit()` Drops all changes made since the previous commit/rollback and releases any database locks currently held by this Connection.
`boolean`	`save()` Saves the current row.
`void`	`save(boolean furtherSaveIsPending)` Saves the current row and indicates if further save calls will follow.
`void`	`save(java.lang.Class<?> dataChangeSender, int sequenceType)` Saves the current row.
`boolean`	`searchGlobal(java.lang.String textToFind)` Starts a select statement for searching a value in all available and castable columns.
`boolean`	`searchGlobal(java.lang.String textToFind, java.lang.String additionalCondition)` Starts a select statement for searching a value in all available and castable columns.
`boolean`	`select(java.lang.String fieldSelection)` Invokes a database query for following record requests via `nextRow()`.
`boolean`	`select(java.lang.String fieldSelection, java.lang.String whereCondition)` Invokes a database query for following record requests via `nextRow()`.
`boolean`	`select(java.lang.String fieldSelection, java.lang.String whereCondition, java.lang.String orderByFields)` Invokes a database query for following record requests via `nextRow()`.
`boolean`	`select(java.lang.String fieldSelection, java.lang.String whereCondition, java.lang.String orderByFields, int limit)` Invokes a database query for following record requests via `nextRow()`.
`boolean`	`select(java.lang.String fieldSelection, java.lang.String whereCondition, java.lang.String orderByFields, int limit, int offset)` Invokes a database query for following record requests via `nextRow()`.
`boolean`	`select(java.lang.String fieldSelection, java.lang.String joinedTables, WhereConditionForPrepStmts wc, java.lang.String orderByFields)` Invokes a database query with multiple joined tables for following record requests via `nextRow()`.
`boolean`	`select(java.lang.String fieldSelection, WhereCondition whereCondition)` Invokes a database query for following record requests via `nextRow()`.
`boolean`	`select(java.lang.String fieldSelection, WhereConditionForPrepStmts wc)` Invokes a database query for following record requests via `nextRow()`.
`boolean`	`select(java.lang.String fieldSelection, WhereConditionForPrepStmts wc, java.lang.String orderByFields)` Invokes a database query for following record requests via `nextRow()`.
`boolean`	`select(java.lang.String fieldSelection, WhereCondition whereCondition, java.lang.String orderByFields)` Invokes a database query for following record requests via `nextRow()`.
`boolean`	`select(WhereCondition whereCondition)` Invokes a database query for following record requests via `nextRow()` loading all available columns.
`boolean`	`select(WhereConditionForPrepStmts wc)` Invokes a database query for following record requests via `nextRow()` loading all available columns.
`boolean`	`select(WhereConditionForPrepStmts wc, java.lang.String orderByFields)` Invokes a database query for following record requests via `nextRow()` loading all available columns.
`boolean`	`select(WhereCondition whereCondition, java.lang.String orderByFields)` Invokes a database query for following record requests via `nextRow()`.
`boolean`	`selectForStreaming(java.lang.String fieldSelection)` Invokes a database query for following record requests via `nextRow()` for streaming.
`void`	`setBoolean(java.lang.String columnName, boolean boolValue)` Sets the value of the specified column.
`static void`	`setChangeLog(ChangeLogStd newChangeLog)`
`static void`	`setChangeLogger(ChangeLogger newChangeLogger)`
`protected void`	`setColumnNameOfRecordingDate(java.lang.String newColumnNameOfRecordingDate)` Sets the column name of the recording date.
`void`	`setConnection(java.sql.Connection connection)` Sets the database connection, which may become necessary in context with connection pooling.
`void`	`setDate(DateAttribute attribute, java.sql.Date dateValue)` Sets the value of the specified column.
`void`	`setDate(java.lang.String columnName, java.util.Date dateValue)` Sets the value of the specified column.
`void`	`setDate(java.lang.String columnName, java.sql.Date dateValue)` Sets the value of the specified column.
`void`	`setDouble(NumericAttribute attribute, double doubleValue)` Sets the value of the specified column.
`void`	`setDouble(java.lang.String columnName, double doubleValue)` Sets the value of the specified column.
`void`	`setDouble(java.lang.String columnName, java.lang.Double doubleValue)` Sets the value of the specified column.
`void`	`setFloat(java.lang.String columnName, float floatValue)` Sets the value of the specified column.
`void`	`setIdentifier(Identifier newIdentifier)` Sets the identifier (primary key) of the row to select.
`void`	`setIdentityValue(int identifyValueInt)` Sets the identify value (primary key) of the row to select.
`void`	`setIdentityValue(long identifyValueLong)` Sets the identify value (primary key) of the row to select.
`void`	`setIdentityValue(java.lang.String identifyString)` Sets the identify value (primary key) of the row to select.
`void`	`setIdInclOriginal(java.lang.String columnName, Identifier newIdentifier)` Sets the identifier of the current row to the specified value.
`void`	`setIdManager(IdManager newIdManager)` Sets the ID manager.
`void`	`setInt(NumericAttribute attr, int intValue)` Sets the value of the specified column.
`void`	`setInt(java.lang.String columnName, int intValue)` Sets the value of the specified column.
`void`	`setLong(java.lang.String columnName, long longValue)` Sets the value of the specified column.
`void`	`setNoLogging()` Blocks the statically logging specification for this instance only.
`void`	`setObject(java.lang.String columnName, java.lang.Object newObject)` Sets the value of a column.
`void`	`setReadBigDecimalAsInt(boolean newReadBigDecimalAsInt)` Indicates if column type BigDecimal should be read as int.
`static void`	`setRecordingUser(java.lang.String newRecordingUser)` Sets the name of the recording user.
`protected void`	`setRecordingUser(java.lang.String columnNameOfRecordingUser, java.lang.String newRecordingUser)` Sets the column name of the recording user.
`void`	`setSilentUpdate(boolean newSilentUpdate)` Sets the specified boolean to indicate whether insert and update should be done with or without firing data change events.
`void`	`setText(AbstractTextAttribute attribute, java.lang.String text)` Sets the text of the specified column.
`void`	`setText(java.lang.String columnName, java.lang.String text)` Sets the text of the specified column.
`void`	`setTime(java.lang.String columnName, java.sql.Time timeValue)` Sets the value of the specified column.
`void`	`setTimestamp(java.lang.String columnName, java.sql.Timestamp timestampValue)` Sets the value of the specified column.
`protected void`	`sqlExceptionConsequences()`
`java.lang.String`	`sqlSecure(java.lang.String stringField)` Replaces ' by '' to avoid SQL error while inserting or updating.
`java.lang.String`	`unifyColumnName(java.lang.String columnName)` Unifies the column name to avoid errors of any kind.
`java.lang.String`	`unifyColumnNameForHashMapKey(java.lang.String columnName)` Unifies the column name to access hash table keys.
`java.lang.String`	`unifyTableName(java.lang.String tableName)` Unifies the table name to avoid errors of any kind.
`boolean`	`update()` Updates the current row if necessary and returns true if update occurred.
`protected void`	`updateIdentifier()`
`void`	`updateOrInsert(Identifier identifier, java.lang.String columnName, java.lang.String columnValue)` Quick update or insert of a single column in a single row.
`void`	`updateOrInsert(java.lang.String identifyString, java.lang.String columnName, java.lang.String columnValue)` Quick update or insert of a single column in a single row.

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface de.must.dataobj.EntityInfo
getAttributes, getForeignKeys, getIndices, getTableName

- Field Detail
  - changeLogger
```
protected static ChangeLogger changeLogger
```
  - INSERTMODE
```
public static final int INSERTMODE
```
    See Also:
    
    Constant Field Values
  - UPDATEMODE
```
public static final int UPDATEMODE
```
    See Also:
    
    Constant Field Values
  - columnNames
```
protected java.lang.String[] columnNames
```
  - columnType
```
protected int[] columnType
```
  - htColumnType
```
protected java.util.HashMap<java.lang.String,java.lang.Integer> htColumnType
```
  - maxFieldSize
```
protected java.util.HashMap<java.lang.String,java.lang.Integer> maxFieldSize
```
  - original
```
protected java.util.HashMap<java.lang.String,java.lang.Object> original
```
- Constructor Detail
  - DataObject
```
protected DataObject(DataObjectConstructionDetails dataObjectConstructionDetails)
```
    Constructs a new DataObject with the specified DB connection details.
    
    Parameters:
    
    dataObjectConstructionDetails - the DB connection details to use
  - DataObject
```
protected DataObject(DataObjectConstructionDetails dataObjectConstructionDetails,
                     int maxColumns)
```
    Constructs a new DataObject with the specified global objects of the individual application. Thus, sharing the ID manager is enabled.
    
    Parameters:
    
    newConnection - the connection to the database to use
    
    maxColumns - the maximum number of columns for cache dimensioning
  - DataObject
```
protected DataObject(java.sql.Connection newConnection,
                     java.lang.String uniqueKeyName)
```
    Constructs a new DataObject with the specified connection and the name of the unique key to process updates.
    
    Parameters:
    
    newConnection - the connection to the database to use
    
    uniqueKeyName - the name of the unique key field
  - DataObject
```
protected DataObject(java.sql.Connection newConnection,
                     IdentifyTemplate identifyTemplate)
```
    Constructs a new DataObject with the specified connection and identify template
    
    Parameters:
    
    newConnection - the connection to the database to use
    
    identifyTemplate - the identify template to build where conditions when loading entries by identifier
  - DataObject
```
protected DataObject(java.sql.Connection connection)
```
    Constructs a new DataObject with the specified connection. If available, the primary key is analyzed and set. Otherwise to process updates the single record has to be identified by a free formulated condition. To get static entity information only, you may create the data object with connection = null.
    
    Parameters:
    
    connection - the connection to the database to use
  - DataObject
```
protected DataObject(java.sql.Connection connection,
                     int maxColumns)
```
    Constructs a new DataObject with the specified connection. If available, the primary key is analyzed and set. Otherwise to process updates the single record has to be identified by a free formulated condition. To get static entity information only, you may create the data object with connection = null.
    
    Parameters:
    
    connection - the connection to the database to use
    
    maxColumns - the maximum number of columns for cache capacity
- Method Detail
  - setChangeLog
```
public static void setChangeLog(ChangeLogStd newChangeLog)
```
  - setChangeLogger
```
public static void setChangeLogger(ChangeLogger newChangeLogger)
```
  - getRecordingDate
```
public java.sql.Date getRecordingDate()
```
    Returns the recording date.
    
    Returns:
    
    the recording date
  - setConnection
```
public void setConnection(java.sql.Connection connection)
```
    Sets the database connection, which may become necessary in context with connection pooling. Sample: when connections are taken back each time a web page is finished, the new page of the session may have a different connection.
    
    Parameters:
    
    connection - the new connection
  - setSilentUpdate
```
public void setSilentUpdate(boolean newSilentUpdate)
```
    Sets the specified boolean to indicate whether insert and update should be done with or without firing data change events. Useful for batch jobs with many updates or inserts.
    
    Parameters:
    
    newSilentUpdate - the boolean to be set, if true insert and update is done silently
  - setNoLogging
```
public void setNoLogging()
```
    Blocks the statically logging specification for this instance only.
  - setReadBigDecimalAsInt
```
public void setReadBigDecimalAsInt(boolean newReadBigDecimalAsInt)
```
    Indicates if column type BigDecimal should be read as int. Used for primary key standardization.
    
    Parameters:
    
    newReadBigDecimalAsInt - a boolean value, true if BigDecimal should be read as int.
  - setColumnNameOfRecordingDate
```
protected void setColumnNameOfRecordingDate(java.lang.String newColumnNameOfRecordingDate)
```
    Sets the column name of the recording date. When records are inserted and this column name is found, it's automatically filled with the actual date.
    
    Parameters:
    
    newColumnNameOfRecordingDate - the name of the column which is to be filled with the recording date.
  - setRecordingUser
```
protected void setRecordingUser(java.lang.String columnNameOfRecordingUser,
                                java.lang.String newRecordingUser)
```
    Sets the column name of the recording user. When records are inserted and this column name is found, it's automatically filled with the name of the recording user.
    
    Parameters:
    
    columnNameOfRecordingUser - the name of the column which is to be filled by the recording user
    
    recordingUser - the name of the recording user
  - setRecordingUser
```
public static void setRecordingUser(java.lang.String newRecordingUser)
```
    Sets the name of the recording user.
    
    Parameters:
    
    recordingUser - the name of the recording user
  - getConnection
```
public java.sql.Connection getConnection()
```
    Returns the used connection. Thus, we can pass construction details from one DataObject to another via new MyDataObject(this).
    
    Specified by:
    
    getConnection in interface DataObjectConstructionDetails
    
    Returns:
    
    the used connection
    
    See Also:
    
    DataObjectConstructionDetails.getConnection()
  - getIdManager
```
public IdManager getIdManager()
```
    Returns the used Id Manager.
    
    Specified by:
    
    getIdManager in interface DataObjectConstructionDetails
    
    Returns:
    
    the used Id Manager
    
    See Also:
    
    DataObjectConstructionDetails.getIdManager()
  - getRecordingUser
```
public java.lang.String getRecordingUser()
```
    Returns the current user recording table rows.
    
    Returns:
    
    the current user recording table rows
  - getDescription
```
public java.lang.String getDescription(java.lang.String field)
```
    Returns the description of the specified field.
    
    Parameters:
    
    field - the name of the field which description should be returned
    
    Returns:
    
    the description of the specified field
  - getDescription
```
public java.lang.String getDescription(java.lang.String columnName,
                                       AbstractAttribute[] atrributes)
```
    Retrieves the internal description the specified column.
    
    Parameters:
    
    columnName - the name of the column
    
    atrributes - an attribute array where the column is to be found
    
    Returns:
    
    the description of the column or the column name itself if the column was not found.
  - contains
```
public boolean contains(AbstractTextAttribute attribute,
                        java.lang.String columnValue)
```
    Indicates, whether a record exists, whose column's value is equals the specified value.
    
    Parameters:
    
    attribute - the attribute of the column to check
    
    columnValue - the value of the column to be found
    
    Returns:
    
    true if the column value was found
  - contains
```
public boolean contains(java.lang.String columnName,
                        java.lang.String columnValue)
```
    Indicates, whether a record exists, whose column's value is equals the specified value.
    
    Parameters:
    
    columnName - the name of the column to check
    
    columnValue - the value of the column to be found
    
    Returns:
    
    true if the column value was found
  - contains
```
public boolean contains(java.lang.String columnName,
                        Identifier identifier)
```
    Indicates, whether a record exists, whose column's value is equals the specified value.
    
    Parameters:
    
    columnName - the name of the column to check
    
    identifier - the value of the column to be found
    
    Returns:
    
    true if the column value was found
  - contains
```
public boolean contains(NumericAttribute attribute,
                        int columnValue)
```
    Indicates, whether a record exists, whose column's value is equals the specified value.
    
    Parameters:
    
    attribute - the attribute of the column
    
    columnValue - the value of the column to be found
    
    Returns:
    
    true if the column value was found
  - contains
```
public boolean contains(java.lang.String columnName,
                        int columnValue)
```
    Indicates, whether a record exists, whose column's value is equals the specified value.
    
    Parameters:
    
    columnName - the name of the column to check
    
    columnValue - the value of the column to be found
    
    Returns:
    
    true if the column value was found
  - contains
```
public boolean contains(java.lang.String columnName,
                        java.sql.Date columnValue)
```
    Indicates, whether a record exists, whose column's value is equals the specified date.
    
    Parameters:
    
    columnName - the name of the date column to check
    
    columnValue - the date value to be found
    
    Returns:
    
    true if the column value was found
  - count
```
public int count(NumericAttribute attribute,
                 int number)
```
    Returns the number of rows of a specific column value.
    
    Parameters:
    
    attribute - the attribute of the column to check value
    
    number - the number to query
    
    Returns:
    
    the number of rows of the specific column value
  - count
```
public int count(java.lang.String columnName,
                 int number)
```
    Returns the number of rows of a specific column value.
    
    Parameters:
    
    columnName - the name of the column to check value
    
    number - the number to query
    
    Returns:
    
    the number of rows of the specific column value
  - countThrowException
```
public int countThrowException(java.lang.String columnName,
                               int number)
                        throws java.sql.SQLException
```
    Returns the number of rows of a specific column value.
    
    Parameters:
    
    columnName - the name of the column to check value
    
    number - the number to query
    
    Returns:
    
    the number of rows of the specific column value
    
    Throws:
    
    java.sql.SQLException
  - count
```
public int count(AbstractTextAttribute attribute,
                 java.lang.String value)
```
    Returns the number of rows of a specific column value.
    
    Parameters:
    
    attribute - the attribute of the column to check value
    
    number - the number to query
    
    Returns:
    
    the number of rows of the specific column value
  - count
```
public int count(java.lang.String columnName,
                 java.lang.String value)
```
    Returns the number of rows of a specific column value.
    
    Parameters:
    
    columnName - the name of the column to check value
    
    number - the number to query
    
    Returns:
    
    the number of rows of the specific column value
  - getSqlCompareString
```
public java.lang.String getSqlCompareString(java.sql.Date date)
```
    Returns the date in the way the database dialect expects it in the where clause.
    
    Parameters:
    
    date - the date to format
    
    Returns:
    
    the date as the database expects it in where conditions
  - getSqlCompareString
```
public java.lang.String getSqlCompareString(boolean b)
```
  - isAvailable
```
public boolean isAvailable(WhereConditionForPrepStmts whereCondition)
```
    Indicates, whether a where condition will find results.
    
    Parameters:
    
    whereCondition - the where condition to be checked
    
    Returns:
    
    true if the condition will return results
  - isAvailable
```
public boolean isAvailable(java.lang.String whereCondition)
```
    Indicates, whether a where condition will find results.
    
    Parameters:
    
    whereCondition - the where condition to be checked
    
    Returns:
    
    true if the condition will return results
  - isAvailable
```
public boolean isAvailable(java.lang.String whereCondition,
                           java.lang.String fieldSelection)
```
    Indicates, whether a where condition will find results.
    
    Parameters:
    
    whereCondition - the where condition to be checked
    
    fieldSelection - the names of the fields/columns to be used in the check statement
    
    Returns:
    
    true if the condition will return results
  - isQueryFindingRecords
```
public boolean isQueryFindingRecords(WhereCondition wc)
```
    Indicates, whether a query expression will find results. The field value buffer will not be filled afters this call!
    
    Parameters:
    
    wc - the where condition to reduce the result set
    
    Returns:
    
    true if the query will return results
    
    See Also:
    
    loadFirst(WhereConditionForPrepStmts)
  - isQueryFindingRecords
```
public boolean isQueryFindingRecords(java.lang.String queryExpression)
```
    Indicates, whether a query expression will find results.
    
    Parameters:
    
    queryExpression - the query expression to check
    
    Returns:
    
    true if the query will return results
  - getRowCount
```
public int getRowCount()
```
  - getNbrOfFittingItems
```
public int getNbrOfFittingItems(WhereConditionForPrepStmts whereCondition)
```
    Returns the number of items which fit the where condition.
    
    Parameters:
    
    whereCondition - the condition to reduce the result set
    
    Returns:
    
    the number of items which fit the where condition
  - getNbrOfFittingItems
```
public int getNbrOfFittingItems(java.lang.String selectionFieldName,
                                WhereConditionForPrepStmts whereCondition)
```
    Returns the number of items which fit the where condition.
    
    Parameters:
    
    selectionFieldName - the name of the fields to be used for the search.
    
    whereCondition - the condition to reduce the result set
    
    Returns:
    
    the number of items which fit the where condition
  - getNbrOfFittingItems
```
public int getNbrOfFittingItems(WhereCondition whereCondition)
```
    Returns the number of items which fit the where condition.
    
    Parameters:
    
    whereCondition - the condition to reduce the result set
    
    Returns:
    
    the number of items which fit the where condition
  - getNbrOfFittingItems
```
public int getNbrOfFittingItems(java.lang.String whereCondition)
```
    Returns the number of items which fit the where condition.
    
    Parameters:
    
    whereCondition - the condition to reduce the result set
    
    Returns:
    
    the number of items which fit the where condition
  - getNbrOfFittingItems
```
public int getNbrOfFittingItems(java.lang.String selectionFieldName,
                                WhereCondition whereCondition)
```
    Returns the number of items which fit the where condition.
    
    Parameters:
    
    selectionFieldName - the name of the fields to be used for the search.
    
    whereCondition - the condition to reduce the result set
    
    Returns:
    
    the number of items which fit the where condition
  - getNbrOfFittingItems
```
public int getNbrOfFittingItems(java.lang.String selectionFieldName,
                                java.lang.String whereCondition)
```
    Returns the number of items which fit the where condition.
    
    Parameters:
    
    selectionFieldName - the name of the fields to be used for the search.
    
    whereCondition - the condition to reduce the result set
    
    Returns:
    
    the number of items which fit the where condition
  - select
```
public boolean select(java.lang.String fieldSelection)
```
    Invokes a database query for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    fieldSelection - the fields to be selected
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    openQuery(java.lang.String), closeQuery()
  - selectForStreaming
```
public boolean selectForStreaming(java.lang.String fieldSelection)
```
    Invokes a database query for following record requests via nextRow() for streaming. This means, no other query may be done with the same connection while the query is used. Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    fieldSelection - the fields to be selected
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    openQuery(java.lang.String), closeQuery()
  - select
```
public boolean select(WhereCondition whereCondition)
```
    Invokes a database query for following record requests via nextRow() loading all available columns. Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    whereCondition - the condition to reduce the result set
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    openQuery(java.lang.String), closeQuery()
  - select
```
public boolean select(java.lang.String fieldSelection,
                      WhereCondition whereCondition)
```
    Invokes a database query for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    fieldSelection - a sequence of field names to be accessed, separated by comma
    
    whereCondition - the condition to reduce the result set
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    openQuery(java.lang.String), closeQuery()
  - select
```
public boolean select(java.lang.String fieldSelection,
                      java.lang.String whereCondition)
```
    Invokes a database query for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
```
 public boolean isDeletionAllowed(Identifier identifier) {
   if (doMedien == null) doMedien = new DoMedien();
   doMedien.select("MedienNi, KatalogNi", "KatalogNi = " + identifier.getIntIdentifier());
   while (doMedien.nextRow()) {
     if (!doMedien.isDeletionAllowed(doMedien.getIdentifier())) {
       doMedien.closeQuery();
       return false;
     }
   }
   doMedien.closeQuery();
   return true;
 }
 
```
    Parameters:
    
    fieldSelection - a sequence of field names to be accessed, separated by comma
    
    whereCondition - the condition to reduce the result set
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    openQuery(java.lang.String), closeQuery()
  - select
```
public boolean select(WhereCondition whereCondition,
                      java.lang.String orderByFields)
```
    Invokes a database query for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    whereCondition - the condition to reduce the result set
    
    orderByFields - the fields to be used for the order by clause, separated by comma
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    openQuery(java.lang.String), closeQuery()
  - select
```
public boolean select(java.lang.String fieldSelection,
                      WhereCondition whereCondition,
                      java.lang.String orderByFields)
```
    Invokes a database query for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    fieldSelection - a sequence of field names to be accessed, separated by comma
    
    whereCondition - the condition to reduce the result set
    
    orderByFields - the fields to be used for the order by clause, separated by comma
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    openQuery(java.lang.String), closeQuery()
  - select
```
public boolean select(java.lang.String fieldSelection,
                      java.lang.String whereCondition,
                      java.lang.String orderByFields)
```
    Invokes a database query for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    fieldSelection - a sequence of field names to be accessed, separated by comma
    
    whereCondition - the condition to reduce the result set
    
    orderByFields - the fields to be used for the order by clause, separated by comma
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    openQuery(java.lang.String), closeQuery()
  - select
```
public boolean select(java.lang.String fieldSelection,
                      java.lang.String whereCondition,
                      java.lang.String orderByFields,
                      int limit)
```
    Invokes a database query for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    fieldSelection - a sequence of field names to be accessed, separated by comma
    
    whereCondition - the condition to reduce the result set
    
    orderByFields - the fields to be used for the order by clause, separated by comma
    
    limit - maximum of entries to be put into the result set - supported by MySQL only
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    openQuery(java.lang.String), closeQuery()
  - select
```
public boolean select(java.lang.String fieldSelection,
                      java.lang.String whereCondition,
                      java.lang.String orderByFields,
                      int limit,
                      int offset)
```
    Invokes a database query for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    fieldSelection - a sequence of field names to be accessed, separated by comma
    
    whereCondition - the condition to reduce the result set
    
    orderByFields - the fields to be used for the order by clause, separated by comma
    
    limit - maximum of entries to be put into the result set - supported by MySQL only
    
    offset - the number of records that don't have to be read anymore - supported by MySQL only
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    openQuery(java.lang.String), closeQuery()
  - getKeyExtendedFieldSelection
```
protected java.lang.String getKeyExtendedFieldSelection(java.lang.String fieldSelection)
```
    Returns the extended field selection including all primary key fields.
    
    Parameters:
    
    fieldSelection - the field selection with or without primary key fields
    
    Returns:
    
    the field selection with primary key fields
  - searchGlobal
```
public boolean searchGlobal(java.lang.String textToFind)
```
    Starts a select statement for searching a value in all available and castable columns.
    
    Parameters:
    
    textToFind - the text to be found globally
    
    Returns:
    
    true if no exception occurred
  - searchGlobal
```
public boolean searchGlobal(java.lang.String textToFind,
                            java.lang.String additionalCondition)
```
    Starts a select statement for searching a value in all available and castable columns.
    
    Parameters:
    
    textToFind - the text to be found globally
    
    additionalCondition - additional where conditions to be combined with the global search
    
    Returns:
    
    true if no exception occurred
  - getGlobalWhereCondition
```
public java.lang.String getGlobalWhereCondition(java.lang.String textToFind)
```
    Gets the global where condition for searching a value in all available and castable columns.
    
    Parameters:
    
    textToFind - the text to be found globally
    
    Returns:
    
    the where condition for the global search
  - getGlobalWhereCondition
```
public java.lang.String getGlobalWhereCondition(java.lang.String textToFind,
                                                java.lang.String additionalCondition)
```
    Returns the global where condition for searching a value in all available and castable columns.
    
    Parameters:
    
    textToFind - the text to be found globally
    
    additionalCondition - additional where conditions to be combined with the global search
    
    Returns:
    
    the where condition for the global search
  - isColumnToUseForGlobalSearch
```
protected boolean isColumnToUseForGlobalSearch(java.lang.String columnName)
```
    Returns true if the specified column is to use to build global where condition. Override method to exclude columns from global search.
    
    Parameters:
    
    columnName - the name of the column to check
    
    Returns:
    
    true if the specified column is to use to build global where condition
  - openQuery
```
public boolean openQuery(java.lang.String queryString)
```
    Invokes a database query for following record requests via nextRow(). If possible, it is recommended to use the select() methods instead. Always invoke closeQuery() to release table handle in the end. SQL Errors will be logged automatically.
    
    Parameters:
    
    queryString - query string to be executed
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    closeQuery()
  - openQueryThrowException
```
public void openQueryThrowException(java.lang.String queryString)
                             throws java.sql.SQLException
```
    Invokes a database query for following record requests via nextRow(). If possible, it is recommended to use the select() methods instead. Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    queryString - query string to be executed
    
    Throws:
    
    java.sql.SQLException
  - nextRow
```
public boolean nextRow()
```
    Loads the next row according to the previous select statement.
    
    Returns:
    
    true if another record is found
    
    See Also:
    
    select(java.lang.String)
  - closeQuery
```
public void closeQuery()
```
    Closes the query as opened by select or openQuery statements. The result set will be closed.
    
    See Also:
    
    select(java.lang.String), openQuery(java.lang.String)
  - closePreparedStatementsForWhereCondition
```
public void closePreparedStatementsForWhereCondition()
```
    Closes all prepared statements used with where condition for prepared statements if existing.
  - getLoadException
```
public java.sql.SQLException getLoadException()
```
    Returns the loadException or null if no exception occurred. With the current concept, processing should not be terminated if a database access fails, e.g. due to network problems. For the other cases, this method provides the last SQL exception as part of load(). Further processing can be canceled on this basis, e.g. to avoid database inconsistencies.
    
    Returns:
    
    SQLException
  - getQueryException
```
public java.sql.SQLException getQueryException()
```
    Returns the queryException.
    
    Returns:
    
    SQLException
  - getFailedQueryExpression
```
public java.lang.String getFailedQueryExpression()
```
    Returns the failed query expression.
    
    Returns:
    
    the failed query expression
  - setIdentityValue
```
public void setIdentityValue(int identifyValueInt)
```
    Sets the identify value (primary key) of the row to select.
    
    Parameters:
    
    identifyValueInt - the value of the primary key to be selected
  - setIdentityValue
```
public void setIdentityValue(long identifyValueLong)
```
    Sets the identify value (primary key) of the row to select.
    
    Parameters:
    
    identifyValueLong - the value of the primary key to be selected
  - setIdentityValue
```
public void setIdentityValue(java.lang.String identifyString)
```
    Sets the identify value (primary key) of the row to select.
    
    Parameters:
    
    identifyString - the value of the primary key to be selected
  - setIdentifier
```
public void setIdentifier(Identifier newIdentifier)
```
    Sets the identifier (primary key) of the row to select.
    
    Parameters:
    
    identifyValueLong - the value of the primary key to be selected
  - newRowWithNextIdentifierAllocation
```
public Identifier newRowWithNextIdentifierAllocation()
```
    Prepares an insert by initializing a new row plus allocating a new primary key value.
    
    Returns:
    
    the created identifier
  - newRow
```
public boolean newRow()
```
    Prepares an insert by initializing a new row.
    
    Returns:
    
    true if no SQL exception occurred
  - ensureMetaDataIsAvailableForAllColumns
```
public boolean ensureMetaDataIsAvailableForAllColumns()
```
    Ensures that meta data is available for all columns by executing a query over all columns if necessary.
    
    Returns:
    
    true if no SQL error occurred
  - setIdManager
```
public void setIdManager(IdManager newIdManager)
```
    Sets the ID manager.
    
    Parameters:
    
    newIdManager - the new ID manager to use
  - allocateNewIdentifier
```
public Identifier allocateNewIdentifier()
```
    Allocates a new row identifier (primary key).
    
    Returns:
    
    the created identifier
  - getEntityId
```
protected java.lang.String getEntityId()
```
    Returns the entity id. By default, this is equals the table name. Override it to use a different id.
    
    Returns:
    
    the entity id
  - setIdInclOriginal
```
public void setIdInclOriginal(java.lang.String columnName,
                              Identifier newIdentifier)
```
    Sets the identifier of the current row to the specified value. This is done for the original value, too. This makes sense for producing a copy of a certain row.
    
    Parameters:
    
    columnName -
    
    newIdentifyValueInt -
  - insert
```
public void insert()
```
    Inserts the prepared row in the database.
    
    See Also:
    
    newRow()
  - alertBadUniqueKey
```
protected void alertBadUniqueKey()
```
  - load
```
public boolean load(int identifyInt)
```
    Loads a row as specified by the primary key.
    
    Parameters:
    
    identifyInt - the primary key value of the row to load
    
    Returns:
    
    true if the wished row was found
  - load
```
public boolean load(int identifyInt,
                    java.lang.String columns)
```
    Loads a row as specified by the primary key.
    
    Parameters:
    
    identifyInt - the primary key value of the row to load
    
    columns - the names of the columns to be part of result set, separated
    
    Returns:
    
    true if the wished row was found
  - load
```
public boolean load(long identifyLong)
```
    Loads a row as specified by the primary key.
    
    Parameters:
    
    identifyLong - the primary key value of the row to load
    
    Returns:
    
    true if the wished row was found
  - load
```
public boolean load(java.lang.String identifyString)
```
    Loads a row as specified by the primary key.
    
    Parameters:
    
    identifyString - the primary key value of the row to load
    
    Returns:
    
    true if the wished row was found
  - load
```
public boolean load(Identifier identifier)
```
    Loads a row as specified by the primary key.
    
    Parameters:
    
    identifier - the primary key value of the row to load
    
    Returns:
    
    true if the wished row was found
  - load
```
public boolean load(Identifier identifier,
                    java.lang.String columns)
```
    Loads a row as specified by the primary key .
    
    Parameters:
    
    newIdentifyValueInt - the primary key value of the row to load
    
    columns - the names of the columns to be part of result set, separated by comma
    
    Returns:
    
    true if the wished row was found
  - loadFirst
```
public boolean loadFirst(WhereConditionForPrepStmts wc)
```
    Loads the first row fitting the where condition and returns true if row was found. Result set will be closed immediately, no following records may be accessed after that call.
    
    Parameters:
    
    wc - the where condition to find the first record
    
    Returns:
    
    true if the wished row was found
  - load
```
public boolean load()
```
    Loads a row as specified by the primary key previously specified by setIdentityValue(int)
    
    Returns:
    
    See Also:
    
    setIdentityValue(int)
  - loadColumns
```
public boolean loadColumns(java.lang.String columns)
```
    Loads a row as specified by the primary key previously specified by setIdentityValue(int)
    
    Parameters:
    
    columns - the names of the columns to be part of result set, separated by comma
    
    Returns:
    
    See Also:
    
    setIdentityValue(int)
  - save
```
public void save(java.lang.Class<?> dataChangeSender,
                 int sequenceType)
```
    Saves the current row. Insert or update is distinguished automatically.
    
    Parameters:
    
    dataChangeSender - the class who causes the data change.
    
    sequenceType - the type of the save sequence which may be DataChangedEvent.SINGLE_TYPE, DataChangedEvent.NOT_THE_LAST_OF_A_SEQUENCE_TYPE or DataChangedEvent.SUMMARY_TYPE
    
    See Also:
    
    DataChangedEvent
  - save
```
public void save(boolean furtherSaveIsPending)
```
    Saves the current row and indicates if further save calls will follow. Insert or update is distinguished automatically.
    
    Parameters:
    
    furtherSaveIsPending - true to indicate that further save calls will follow
  - save
```
public boolean save()
```
    Saves the current row. Insert or update is distinguished automatically.
    
    Returns:
    
    true if any database modification occurred
  - updateOrInsert
```
public void updateOrInsert(java.lang.String identifyString,
                           java.lang.String columnName,
                           java.lang.String columnValue)
```
    Quick update or insert of a single column in a single row.
    
    Parameters:
    
    newIdentifyValueString - the primary key
    
    columnName - the name of the column
    
    columnValue - the value of the column
  - updateOrInsert
```
public void updateOrInsert(Identifier identifier,
                           java.lang.String columnName,
                           java.lang.String columnValue)
```
    Quick update or insert of a single column in a single row.
    
    Parameters:
    
    newIdentifyValueString - the primary key
    
    columnName - the name of the column
    
    columnValue - the value of the column
  - update
```
public boolean update()
```
    Updates the current row if necessary and returns true if update occurred.
  - commitIfNotAutoCommit
```
public void commitIfNotAutoCommit()
```
    Makes all changes made since the previous commit/rollback permanent and releases any database locks currently held by the Connection. Doesn't do anything, if auto-commit is used.
    
    Throws:
    
    java.sql.SQLException - if a database access error occurs
  - rollbackIfNotAutoCommit
```
public void rollbackIfNotAutoCommit()
```
    Drops all changes made since the previous commit/rollback and releases any database locks currently held by this Connection.
    
    Throws:
    
    java.sql.SQLException - if a database access error occurs
  - updateIdentifier
```
protected void updateIdentifier()
```
  - unifyTableName
```
public java.lang.String unifyTableName(java.lang.String tableName)
```
    Unifies the table name to avoid errors of any kind.
    
    Parameters:
    
    tableName - the name of the table to unify
    
    Returns:
    
    the unified table name
  - unifyColumnName
```
public java.lang.String unifyColumnName(java.lang.String columnName)
```
    Unifies the column name to avoid errors of any kind.
    
    Parameters:
    
    columnName - the name of the column to unify
    
    Returns:
    
    the unified column name
  - unifyColumnNameForHashMapKey
```
public java.lang.String unifyColumnNameForHashMapKey(java.lang.String columnName)
```
    Unifies the column name to access hash table keys. Background: transfer cases from one database to another database of different type may have different behavior regarding to upper case conventions. Precondition: We do not use similar column names like Test and test even if supported by database.
    
    Parameters:
    
    columnName - the name of the column to unify
    
    Returns:
    
    the unified column name
  - getIdentifyWhereCondition
```
public java.lang.String getIdentifyWhereCondition()
```
    Returns the where condition to identify the current row without the word "where". Needed to remind the current rows unique key if no primary key is available.
    
    Returns:
    
    the where condition to identify the current row
  - sqlSecure
```
public java.lang.String sqlSecure(java.lang.String stringField)
```
    Replaces ' by '' to avoid SQL error while inserting or updating.
  - resetColumnPointer
```
public void resetColumnPointer()
```
    Sets the column pointer to 0.
  - nextColumn
```
public boolean nextColumn()
```
    Increases the column pointer.
    
    Returns:
    
    false if no further columns are available
  - getColumnName
```
public java.lang.String getColumnName()
```
    Returns the name of the current column.
    
    Returns:
    
    the name of the current column
  - getColumnLabel
```
public java.lang.String getColumnLabel()
```
    Returns the label of the current column.
    
    Returns:
    
    the label of the current column
  - getColumnType
```
public int getColumnType()
```
    Returns the type of the current column.
    
    Returns:
    
    the type of the current column
  - getColumnType
```
public int getColumnType(java.lang.String columnName)
```
    Returns the type of the specified column.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the type of the column
  - getColumnType
```
public int getColumnType(java.lang.String columnName,
                         boolean informIfNotAvailable)
```
    Returns the type of the specified column.
    
    Parameters:
    
    columnName - the name of the column
    
    informIfNotAvailable - log information if type of the column isn't available
    
    Returns:
    
    the type of the column
  - isMemo
```
public boolean isMemo(java.lang.String columnName)
```
  - getColumnLength
```
public int getColumnLength(java.lang.String columnName)
```
    Returns the length of the specified column.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the length of the column
  - getColumnScale
```
public int getColumnScale()
```
    Returns the scale of the current column.
    
    Returns:
    
    the scale of the current column
  - getObject
```
public java.lang.Object getObject(java.lang.String columnName)
```
    Returns the value of a column as an object.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - setObject
```
public void setObject(java.lang.String columnName,
                      java.lang.Object newObject)
```
    Sets the value of a column.
    
    Parameters:
    
    columnName - the name of the column
    
    newObject - the new value of the column to set
  - getText
```
public java.lang.String getText(AbstractTextAttribute attribute)
```
    Gets the value of the specified column as text.
    
    Parameters:
    
    attribute - the attribute of the column
    
    Returns:
    
    the value of the column
  - isKnownAsBoolean
```
public boolean isKnownAsBoolean(java.lang.String columnName)
```
    Checks whether or not the specified column is of type boolean by evaluating the attributes of the data object if available. Relevant for old MySQL "booleans" Y/N
    
    Parameters:
    
    columnName - the name of the column to be checked as boolean type
    
    Returns:
    
    true if the specified column is of type boolean
  - getText
```
public java.lang.String getText(java.lang.String columnName)
```
    Gets the value of the specified column as text.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - getTextNoMatterWhatTypeOfColumn
```
public java.lang.String getTextNoMatterWhatTypeOfColumn(java.lang.String columnName)
```
    Gets the value of the specified column as text. There will be no warning shown if the object type is not text castable.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - getWorkedOnText
```
public java.lang.String getWorkedOnText(AbstractTextAttribute attribute)
```
    Gets the value of the specified column as text in a worked on state - it might already been modified and differ from the original value.
    
    Parameters:
    
    attribute - the attribute of the column
    
    Returns:
    
    the value of the column
  - getWorkedOnText
```
public java.lang.String getWorkedOnText(java.lang.String columnName)
```
    Gets the value of the specified column as text in a worked on state - it might already been modified and differ from the original value.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - setText
```
public void setText(AbstractTextAttribute attribute,
                    java.lang.String text)
```
    Sets the text of the specified column.
    
    Parameters:
    
    attribute - the attribute representing the column
    
    text - the new value of the column
  - setText
```
public void setText(java.lang.String columnName,
                    java.lang.String text)
```
    Sets the text of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    text - the new value of the column
  - getFloat
```
public float getFloat(java.lang.String columnName)
```
    Gets the value of the specified column as float.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - setFloat
```
public void setFloat(java.lang.String columnName,
                     float floatValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    floatValue - the new value of the column
  - getDouble
```
public double getDouble(NumericAttribute attribute)
```
    Gets the value of the specified column as double.
    
    Parameters:
    
    attribute - the attribute of the column
    
    Returns:
    
    the value of the column
  - getDouble
```
public double getDouble(java.lang.String columnName)
```
    Gets the value of the specified column as double.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - getWorkedOnDouble
```
public double getWorkedOnDouble(java.lang.String columnName)
```
    Gets the value of the specified column as double in a worked on state - it might already been modified and differ from the original value.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - setDouble
```
public void setDouble(NumericAttribute attribute,
                      double doubleValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    attribute - the attribute of the column
    
    doubleValue - the new value of the column
  - setDouble
```
public void setDouble(java.lang.String columnName,
                      double doubleValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    doubleValue - the new value of the column
  - setDouble
```
public void setDouble(java.lang.String columnName,
                      java.lang.Double doubleValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    doubleValue - the new value of the column
  - getInt
```
public int getInt(NumericAttribute attribute)
```
    Gets the value of the specified column as integer.
    
    Parameters:
    
    attribute - the attribute of the column
    
    Returns:
    
    the value of the column
  - getInt
```
public int getInt(java.lang.String columnName)
```
    Gets the value of the specified column as integer.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - getIntAsStringZeroSuppressed
```
public java.lang.String getIntAsStringZeroSuppressed(java.lang.String columnName)
```
    Gets the value of the specified Integer containing column as String with zero suppression.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - getWorkedOnInt
```
public int getWorkedOnInt(java.lang.String columnName)
```
    Gets the value of the specified column as int in a worked on state - it might already been modified and differ from the original value.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - setInt
```
public void setInt(NumericAttribute attr,
                   int intValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    attr - the attribute specifying the column
    
    intValue - the new value of the column
  - setInt
```
public void setInt(java.lang.String columnName,
                   int intValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    intValue - the new value of the column
  - getLong
```
public long getLong(java.lang.String columnName)
```
    Gets the value of the specified column as long.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - setLong
```
public void setLong(java.lang.String columnName,
                    long longValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    longValue - the new value of the column
  - getDateFormattedWithShortYear
```
public java.lang.String getDateFormattedWithShortYear(java.lang.String columnName)
```
  - getDate
```
public java.sql.Date getDate(DateAttribute attribute)
```
    Gets the value of the specified column as date.
    
    Parameters:
    
    attribute - the attribute of the column
    
    Returns:
    
    the value of the column
  - getDate
```
public java.sql.Date getDate(java.lang.String columnName)
```
    Gets the value of the specified column as date.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - getDate
```
protected java.sql.Date getDate(java.lang.Integer intDate)
```
  - getWorkedOnDate
```
public java.sql.Date getWorkedOnDate(java.lang.String columnName)
```
    Gets the value of the specified column as date in a worked on state - it might already been modified and differ from the original value.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - setDate
```
public void setDate(DateAttribute attribute,
                    java.sql.Date dateValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    attribute - the attribute of the column
    
    dateValue - the new value of the column
  - setDate
```
public void setDate(java.lang.String columnName,
                    java.util.Date dateValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    dateValue - the new value of the column
  - setDate
```
public void setDate(java.lang.String columnName,
                    java.sql.Date dateValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    dateValue - the new value of the column
  - getTime
```
public java.sql.Time getTime(java.lang.String columnName)
```
    Returns the value of the specified column as time.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - getWorkedOnTime
```
public java.sql.Time getWorkedOnTime(java.lang.String columnName)
```
    Gets the value of the specified column as time in a worked on state - it might already been modified and differ from the original value.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - setTime
```
public void setTime(java.lang.String columnName,
                    java.sql.Time timeValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    dateValue - the new value of the column
  - getTimestamp
```
public java.sql.Timestamp getTimestamp(java.lang.String columnName)
```
    Returns the value of the specified column as Timestamp.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - getWorkedOnTimestamp
```
public java.sql.Timestamp getWorkedOnTimestamp(java.lang.String columnName)
```
    Gets the value of the specified column as Timestamp in a worked on state - it might already been modified and differ from the original value.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - setTimestamp
```
public void setTimestamp(java.lang.String columnName,
                         java.sql.Timestamp timestampValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    dateValue - the new value of the column
  - getBoolean
```
public boolean getBoolean(BooleanAttribute attribute)
```
    Gets the value of the specified column as boolean.
    
    Parameters:
    
    attribute - the attribute of the column
    
    Returns:
    
    the value of the column
  - getBoolean
```
public boolean getBoolean(java.lang.String columnName)
```
    Gets the value of the specified column as boolean.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - getWorkedOnBoolean
```
protected boolean getWorkedOnBoolean(java.lang.String columnName)
```
    Gets the value of the specified column as boolean in a worked on state - it might already been modified and differ from the original value.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the value of the column
  - setBoolean
```
public void setBoolean(java.lang.String columnName,
                       boolean boolValue)
```
    Sets the value of the specified column.
    
    Parameters:
    
    columnName - the name of the column to be modified
    
    boolValue - the new value of the column
  - getBytes
```
public byte[] getBytes(java.lang.String columnName)
```
    Return the bytes of the specified column. Because binary values are not buffered in DataObhect and ResultSet is closed after buffering, the select statement is executed again.
    
    Parameters:
    
    columnName - the name of the column
    
    Returns:
    
    the bytes of the column
  - isDeletionAllowed
```
public boolean isDeletionAllowed(Identifier identifier)
```
    Checks of deletion of a row is allowed. Meant to be overridden by subclasses to keep data consistent.
    
    Parameters:
    
    identifyValueString - the primary key of the row to be checked
    
    Returns:
    
    false if deletion should be rejected
  - getDeletionHindrance
```
public HintContainer getDeletionHindrance(Identifier identifier)
```
    Returns a hint container with hints why an item cannot be deleted - if the container's getHint() method returns null there is no hindrance to delete an item.
    
    Parameters:
    
    identifier - the identifier of the item to check for hindrances
    
    Returns:
    
    a hint container with hints why an item cannot be deleted
  - delete
```
public boolean delete(Identifier identifier)
```
    Deletes a row by primary key.
    
    Parameters:
    
    newIdentifyValueInt - the primary key of the row to be deleted
    
    Returns:
    
    true if no error occurred
  - delete
```
public boolean delete()
```
    Deletes the currently accessed row, e.g. a row found by nextRow().
    
    Returns:
    
    true if no error occurred
  - deleteFreeConditioned
```
protected boolean deleteFreeConditioned(WhereCondition whereCondition)
```
    Deletes rows by a free formulated condition. Handle with care! It should stay protected and be secured by responsible subclass methods.
    
    Parameters:
    
    whereCondition - the condition to select the rows to delete
    
    Returns:
    
    true if no error occurred
  - deleteFreeConditioned
```
protected boolean deleteFreeConditioned(java.lang.String whereCondition)
```
    Deletes rows by a free formulated condition. Handle with care! It should stay protected and be secured by responsible subclass methods.
    
    Parameters:
    
    whereCondition - the condition to select the rows to delete
    
    Returns:
    
    true if no error occurred
  - deleteFreeConditionedAndCount
```
protected int deleteFreeConditionedAndCount(java.lang.String whereCondition)
```
    Deletes rows by a free formulated condition. Handle with care! It should stay protected and be secured by responsible subclass methods.
    
    Parameters:
    
    whereCondition - the condition to select the rows to delete
    
    Returns:
    
    the number of deleted records or -1 if an error occurred
  - getmaxRow
```
public int getmaxRow(int licenceType)
```
    Returns the maximum allowed rows to insert.
    
    Parameters:
    
    licenceType - the license type
    
    Returns:
    
    the number of rows that may be inserted
  - getUniqueKeyName
```
public java.lang.String getUniqueKeyName()
```
    Returns the name of the primary key.
    
    Returns:
    
    the name of the primary key
  - getColumnCount
```
public int getColumnCount()
```
    Returns the number of available columns.
    
    Returns:
    
    the number of available columns
  - getColumnName
```
public java.lang.String getColumnName(int columnPointer)
```
    Returns the column name of the indicated array position.
    
    Parameters:
    
    columnPointer - the array index
    
    Returns:
    
    the name of the column
  - getColumnType
```
public int getColumnType(int columnPointer)
```
    Returns the column type of the indicated array position.
    
    Parameters:
    
    columnPointer - the array index
    
    Returns:
    
    the type of the column
  - getIdentifyTemplate
```
public IdentifyTemplate getIdentifyTemplate()
```
    Returns the identify template.
    
    Returns:
    
    the identify template
  - getIdentifyValueInt
```
public int getIdentifyValueInt()
```
    Returns the int primary key of the current row.
    
    Returns:
    
    the int primary key of the current row
  - getIdentifier
```
public Identifier getIdentifier()
```
    Returns the identifier (primary key) of the current row.
    
    Returns:
    
    the identifier (primary key) of the current row
  - getMode
```
public int getMode()
```
    Returns the mode.
    
    Returns:
    
    the mode
    
    See Also:
    
    INSERTMODE, UPDATEMODE
  - isColumnContained
```
public boolean isColumnContained(java.lang.String columnName)
```
    Checks if the specified column is in the currently watched result set.
    
    Parameters:
    
    columnName - the name of the column to be checked
    
    Returns:
    
    true if the specified column is in the currently watched result set
  - isModified
```
public boolean isModified()
```
    Checks if there have been any modifications made on the current row.
    
    Returns:
    
    true if there have been any modifications made on the current row
  - isModifiedColumn
```
public boolean isModifiedColumn(java.lang.String columnName)
```
    Checks if there have been any modifications made on the current row.
    
    Returns:
    
    true if there have been any modifications made on the current row
  - getOriginalOf
```
protected java.lang.Object getOriginalOf(java.lang.String columnName)
```
  - getWorkedOnOf
```
protected java.lang.Object getWorkedOnOf(java.lang.String columnName)
```
  - addDataChangeListener
```
public void addDataChangeListener(DataChangeListener listener)
```
    Adds the specified ThreadDoneListener to receive data changed events from any entity.
    
    See Also:
    
    DataChangedEvent
  - removeDataChangeListener
```
public void removeDataChangeListener(DataChangeListener listener)
```
    Removes the specified DataChangeListener to receive data changed events from any entity.
    
    Parameters:
    
    listener - the DataChangeListener to be removed
    
    See Also:
    
    DataChangedEvent
  - fireDataChanged
```
public void fireDataChanged(DataChangedEvent e)
```
    Notifies all listeners that have registered interest for notification on this event type. The specified data changed event is passed.
    
    See Also:
    
    addDataChangeListener(de.must.dataobj.DataChangeListener), DataChangedEvent
  - addDataSelectionListener
```
public void addDataSelectionListener(DataSelectionListener l)
```
    Adds the specified DataSelectionListener to receive data selection events from this entity.
    
    See Also:
    
    DataSelectionEvent
  - removeDataSelectionListener
```
public void removeDataSelectionListener(DataSelectionListener l)
```
    Removes the specified DataSelectionListener to receive data selection events from this entity.
    
    See Also:
    
    DataSelectionEvent
  - register
```
protected DataObject register(DataObject dataObject)
```
    Registers a DataObject as Co-DataObject
    
    Parameters:
    
    dataObject - the Co-DataObject
    
    Returns:
    
    the passed DataObject for easy declaration
  - select
```
public boolean select(WhereConditionForPrepStmts wc)
```
    Invokes a database query for following record requests via nextRow() loading all available columns. Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    whereCondition - the condition to reduce the result set
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    closeQuery(), closePreparedStatementsForWhereCondition()
  - select
```
public boolean select(WhereConditionForPrepStmts wc,
                      java.lang.String orderByFields)
```
    Invokes a database query for following record requests via nextRow() loading all available columns. Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    whereCondition - the condition to reduce the result set
    
    orderByFields - the fields to be used for the order by clause
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    closeQuery(), closePreparedStatementsForWhereCondition()
  - select
```
public boolean select(java.lang.String fieldSelection,
                      WhereConditionForPrepStmts wc)
```
    Invokes a database query for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    fieldSelection - a sequence of field names to be accessed, separated by comma
    
    wc - the where condition to reduce the result set
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    closeQuery(), closePreparedStatementsForWhereCondition()
  - select
```
public boolean select(java.lang.String fieldSelection,
                      WhereConditionForPrepStmts wc,
                      java.lang.String orderByFields)
```
    Invokes a database query for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    fieldSelection - a sequence of field names to be accessed, separated by comma
    
    wc - the condition to reduce the result set
    
    orderByFields - the fields to be used for the order by clause
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    closeQuery(), closePreparedStatementsForWhereCondition()
  - select
```
public boolean select(java.lang.String fieldSelection,
                      java.lang.String joinedTables,
                      WhereConditionForPrepStmts wc,
                      java.lang.String orderByFields)
```
    Invokes a database query with multiple joined tables for following record requests via nextRow(). Always invoke closeQuery() to release table handle in the end.
    
    Parameters:
    
    fieldSelection - a sequence of field names to be accessed, separated by comma
    
    joinedTables - joined tables
    
    wc - the condition to reduce the result set
    
    orderByFields - the fields to be used for the order by clause
    
    Returns:
    
    true if no exception occurred
    
    See Also:
    
    closeQuery(), closePreparedStatementsForWhereCondition()
  - count
```
public int count(WhereConditionForPrepStmts wc)
```
    Counts the rows fitting the where condition using the first column of the identify template.
    
    Parameters:
    
    wc - the where condition to fit
    
    Returns:
    
    the number of rows fitting the condition
  - count
```
public int count(java.lang.String field,
                 WhereConditionForPrepStmts wc)
```
    Counts the rows fitting the where condition.
    
    Parameters:
    
    field - the field to be counted
    
    wc - the where condition to fit
    
    Returns:
    
    the number of rows fitting the condition
  - checkRecoverConnection
```
protected boolean checkRecoverConnection()
```
    Checks the DB connection, if it has not been used for a while to prevent Exception "No operations allowed after connection closed"
    
    Returns:
    
    true if connection has been recovered
  - sqlExceptionConsequences
```
protected void sqlExceptionConsequences()
```
  - logDebug
```
protected void logDebug(java.lang.String text)
```
    Logs a message as a debug information.
    
    Parameters:
    
    text - the message to log
  - logInfo
```
protected void logInfo(java.lang.String text)
```
    Logs a message as information.
    
    Parameters:
    
    text - the message to log
  - logError
```
protected void logError(java.lang.Throwable throwable)
```
    Logs a message as an error.
    
    Parameters:
    
    throwable - the exception to log
  - logError
```
protected void logError(java.lang.String text)
```
    Logs a message as an error.
    
    Parameters:
    
    text - the message to log
  - logError
```
protected void logError(java.lang.String text,
                        java.lang.Throwable throwable)
```
    Logs a message as an error.
    
    Parameters:
    
    text - the message to log
    
    throwable - the exception to log
  - getLastException
```
public java.lang.Exception getLastException()
```
    Return the last exception occurring in update().
    
    Returns:
    
    the last exception occurring in update()
  - free
```
public void free()
```
    Description copied from interface: Exemptible
    
    Releases external resources. May be called manually without waiting for garbage collection to occur.
    
    Specified by:
    
    free in interface Exemptible
  - discardStatements
```
protected void discardStatements()
```
    Discard prepared statements, e.g. to force new creation due to underlying connection has been closed.
  - closeIfExists
```
protected void closeIfExists(java.sql.Statement statement)
```
  - finalize
```
protected void finalize()
                 throws java.lang.Throwable
```
    Overrides:
    
    finalize in class java.lang.Object
    
    Throws:
    
    java.lang.Throwable

Class DataObject

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface de.must.dataobj.EntityInfo

Field Detail

changeLogger

INSERTMODE

UPDATEMODE

columnNames

columnType

htColumnType

maxFieldSize

original

Constructor Detail

DataObject

DataObject

DataObject

DataObject

DataObject

DataObject

Method Detail

setChangeLog

setChangeLogger

getRecordingDate

setConnection

setSilentUpdate

setNoLogging

setReadBigDecimalAsInt

setColumnNameOfRecordingDate

setRecordingUser

setRecordingUser

getConnection

getIdManager

getRecordingUser

getDescription

getDescription

contains

contains

contains

contains

contains

contains

count

count

countThrowException

count

count

getSqlCompareString

getSqlCompareString

isAvailable

isAvailable

isAvailable

isQueryFindingRecords

isQueryFindingRecords

getRowCount

getNbrOfFittingItems

getNbrOfFittingItems

getNbrOfFittingItems

getNbrOfFittingItems

getNbrOfFittingItems

getNbrOfFittingItems

select

selectForStreaming

select

select

select

select

select

select

select

select

getKeyExtendedFieldSelection

searchGlobal

searchGlobal

getGlobalWhereCondition

getGlobalWhereCondition

isColumnToUseForGlobalSearch

openQuery