DODS 5.1 API

org.webdocwf.util.genericstore.data
Class StateTransitionDO

java.lang.Object
  |
  +--com.lutris.appserver.server.sql.CoreDO
        |
        +--com.lutris.appserver.server.sql.CloneableDO
              |
              +--com.lutris.dods.builder.generator.dataobject.GenericDO
                    |
                    +--org.webdocwf.dods.access.SecureDO
                          |
                          +--org.webdocwf.util.genericstore.GenericStoreDO
                                |
                                +--org.webdocwf.util.genericstore.data.StateTransitionDO
All Implemented Interfaces:
java.lang.Cloneable, java.io.Serializable, StateTransitionDOI, Transaction

public class StateTransitionDO
extends GenericStoreDO
implements StateTransitionDOI, java.io.Serializable

Data core class, used to set, retrieve the StateTransitionDO information.

Since:
org
Version:
$Revision: 1.2 $
Author:
administrator
See Also:
Serialized Form

Field Summary
static RDBColumn ENUMVALUEDEFINITIONFROMOID
           
static RDBColumn ENUMVALUEDEFINITIONTOOID
           
protected static boolean isView
           
static RDBColumn PrimaryKey
          static final RDBColumn PrimaryKey for use with QueryBuilder.
static RDBTable table
          static final data members name the table and columns for this DO.
 
Fields inherited from class com.lutris.dods.builder.generator.dataobject.GenericDO
dirty
 
Fields inherited from class com.lutris.appserver.server.sql.CoreDO
persistent, versioning
 
Constructor Summary
protected StateTransitionDO()
          Protected constructor.
protected StateTransitionDO(boolean is_view)
          Protected constructor.
protected StateTransitionDO(ObjectId id)
          Protected constructor used by createExisting(ObjectId) above.
protected StateTransitionDO(java.sql.ResultSet rs)
          Protected constructor.
 
Method Summary
static StateTransitionDO addToCache(StateTransitionDO newDO)
          Add DO to cache.
static void assertDOCreateAccess(User usr)
          Ensure that the given user is allowed to create new instances
 void assertDOGetAttrENUMVALUEDEFINITIONFROMOIDAccess(User usr)
          Ensure that the given user is allowed to read the attribute
 void assertDOGetAttrENUMVALUEDEFINITIONTOOIDAccess(User usr)
          Ensure that the given user is allowed to read the attribute
 void assertDOSetAttrENUMVALUEDEFINITIONFROMOIDAccess(EnumValueDefinitionDO ENUMVALUEDEFINITIONFROMOID, User usr)
          Ensure that the given user is allowed to update the attribute
 void assertDOSetAttrENUMVALUEDEFINITIONTOOIDAccess(EnumValueDefinitionDO ENUMVALUEDEFINITIONTOOID, User usr)
          Ensure that the given user is allowed to update the attribute
protected  void checkLoad()
          Load the actual DO data if necessary.
 void commit()
          Deprecated. Use save() instead.
 void commit(DBTransaction dbt)
          Deprecated. Use save() instead.
static StateTransitionDO createCopy(StateTransitionDataStruct data)
          createCopy() Creates a DO that has no ObjectId but has a copy of an existing DO's data.
static StateTransitionDO createCopy(StateTransitionDO orig)
          createCopy() Creates a DO that has no ObjectId but has a copy of an existing DO's data.
static StateTransitionDO createCopy(StateTransitionDO orig, User usr)
          createCopy() Creates a DO that has no ObjectId but has a copy of an existing DO's data.
static StateTransitionDO createExisting(java.math.BigDecimal bd)
          createExisting( BigDecimal ) Factory method creates a StateTransitionDO object by searching for it in the database using the passed BigDecimal value as the primary key.
static StateTransitionDO createExisting(java.math.BigDecimal bd, User usr)
          createExisting( BigDecimal ) Factory method creates a StateTransitionDO object by searching for it in the database using the passed BigDecimal value as the primary key.
protected static StateTransitionDO createExisting(ObjectId id)
          createExisting( ObjectId ) Factory method creates a StateTransitionDO object by searching for it in the database using the passed ObjectID value as the primary key.
protected static StateTransitionDO createExisting(RDBColumnValue pk)
          createExisting( RDBColumnValue ) Factory method creates a StateTransitionDO object by searching for it in the database using the passed StateTransitionDO.PrimaryKey.
protected static StateTransitionDO createExisting(RDBRow row)
          createExisting( RDBRow ) Factory method creates a StateTransitionDO object by searching for it in the database using the StateTransitionDO.PrimaryKey value in the passed RDBRow.
protected static StateTransitionDO createExisting(java.sql.ResultSet rs)
          createExisting( ResultSet ) Factory method used to create an instance of this class to represent a Data Object already existing in the database.
static StateTransitionDO createExisting(java.lang.String handle)
          The createExisting method is used to create a StateTransitionDO from a string handle.
static StateTransitionDO createExisting(java.lang.String handle, User usr)
          The createExisting method is used to create a StateTransitionDO from a string handle.
 GenericStoreDO createForExisting(java.math.BigDecimal bd)
          Create an instance for an existing row This is a strange hack for having an instance method Maybe there is a better solution ? WebDocWf extension
static StateTransitionDO createVirgin()
          createVirgin() Creates a DO that has no ObjectId or data.
static StateTransitionDO createVirgin(User usr)
          createVirgin() Creates a DO that has no ObjectId or data.
 void delete()
          Deletes the DO from its table.
 void delete(DBTransaction dbt)
          Deletes the DO from its table.
static StateTransitionDO findCachedObjectByHandle(java.lang.String handle)
          findCachedObjectByHandle
static StateTransitionDO findCachedObjectByHandle(java.lang.String handle, User usr)
          findCachedObjectByHandle
static java.util.Enumeration getCacheContents()
          Retrieve contents of cache as an enumeration of DO objects.
 java.sql.PreparedStatement getDeleteStatement(DBConnection conn)
          Prepares the statement used to delete this object from the database.
 EnumValueDefinitionDO getENUMVALUEDEFINITIONFROMOID()
          Get ENUMVALUEDEFINITIONFROMOID of the GENERICSTATETRANSITION
 EnumValueDefinitionDO getENUMVALUEDEFINITIONFROMOID(User usr)
          Get ENUMVALUEDEFINITIONFROMOID of the GENERICSTATETRANSITION
 EnumValueDefinitionDO getENUMVALUEDEFINITIONTOOID()
          Get ENUMVALUEDEFINITIONTOOID of the GENERICSTATETRANSITION
 EnumValueDefinitionDO getENUMVALUEDEFINITIONTOOID(User usr)
          Get ENUMVALUEDEFINITIONTOOID of the GENERICSTATETRANSITION
 java.lang.String getHandle()
          The methods getHandle hasMatchingHandle findCachedObjectByHandle are used by Presentation Objects that need to populate HTML select lists with Data Objects as options.
 java.sql.PreparedStatement getInsertStatement(DBConnection conn)
          Prepares the statement used to insert this object into the database.
 java.lang.String getTableName()
          Return GENERICSTATETRANSITION as the name of the table in the database which contains StateTransitionDO objects.
 java.sql.PreparedStatement getUpdateStatement(DBConnection conn)
          Prepares the statement used to update this object in the database.
static boolean hasDOCreateAccess(User usr)
          Check whether the given user is allowed to create new instances
static boolean hasDOGetAccess(java.math.BigDecimal bd, User usr)
          Check whether the given user is allowed to read the DO existance Static function to be called without having the object
static boolean hasDOGetAccess(java.lang.String handle, User usr)
          Check whether the given user is allowed to read the DO existance Static function to be called without having the object
 boolean hasDOGetAttrENUMVALUEDEFINITIONFROMOIDAccess(User usr)
          Check whether the given user is allowed to read the attribute
 boolean hasDOGetAttrENUMVALUEDEFINITIONTOOIDAccess(User usr)
          Check whether the given user is allowed to read the attribute
 boolean hasDOGetDOValueENUMVALUEDEFINITIONFROMOIDAccess(User usr)
          Check whether the given user is allowed to read object in a pointer attribute
 boolean hasDOGetDOValueENUMVALUEDEFINITIONTOOIDAccess(User usr)
          Check whether the given user is allowed to read object in a pointer attribute
 boolean hasDOSetAttrENUMVALUEDEFINITIONFROMOIDAccess(EnumValueDefinitionDO ENUMVALUEDEFINITIONFROMOID, User usr)
          Check whether the given user is allowed to update the attribute
 boolean hasDOSetAttrENUMVALUEDEFINITIONTOOIDAccess(EnumValueDefinitionDO ENUMVALUEDEFINITIONTOOID, User usr)
          Check whether the given user is allowed to update the attribute
 boolean hasMatchingHandle(java.lang.String handle)
          hasMatchingHandle
 boolean isLoaded()
          isLoaded() Returns true if the data for this objects has been retrieved from the database.
 boolean isReadOnly()
          isReadOnly() Returns true if the data for this object has been marked read-only.
 void loadData()
          loadData() Load the fields for the DO from the database.
protected  void makeIdentical(StateTransitionDO orig)
          makeIdentical() Assigns the DataStruct of an existing DO to this DO.
 void makeReadOnly()
          makeReadOnly() Mark the object as readonly WebDocWf extension
 void makeReadWrite()
          makeReadWrite()
protected  void modifyDO(DBTransaction dbt, boolean delete)
          Modifies the DO within its table.
protected  void modifyDO(DBTransaction dbt, boolean delete, boolean references)
          Modifies the DO within its table.
protected  void okToCommit()
          A stub method for implementing pre-commit assertions for this StateTransitionDO.
protected  void okToCommitENUMVALUEDEFINITIONFROMOID(EnumValueDefinitionDO member)
          A stub method for implementing pre-commit assertions for the ENUMVALUEDEFINITIONFROMOID data member.
protected  void okToCommitENUMVALUEDEFINITIONTOOID(EnumValueDefinitionDO member)
          A stub method for implementing pre-commit assertions for the ENUMVALUEDEFINITIONTOOID data member.
protected  void okToDelete()
          A stub method for implementing pre-delete assertions for this StateTransitionDO.
protected  void okToDeleteENUMVALUEDEFINITIONFROMOID(EnumValueDefinitionDO member)
          A stub method for implementing pre-delete assertions for the ENUMVALUEDEFINITIONFROMOID data member.
protected  void okToDeleteENUMVALUEDEFINITIONTOOID(EnumValueDefinitionDO member)
          A stub method for implementing pre-delete assertions for the ENUMVALUEDEFINITIONTOOID data member.
static void refreshCache()
          Queries all rows in table, and for each row creates a DO instance in the cache.
 void reload()
          reload() Causes the DO to refresh itself from the database the next time a set or get method is called.
 void save()
          Inserts/Updates the DO into its table.
 void save(boolean references)
          Inserts/Updates the DO into its table.
 void save(DBTransaction dbt)
          Inserts/Updates the DO into its table.
 void save(DBTransaction dbt, boolean references)
          Inserts/Updates the DO into its table.
 void setENUMVALUEDEFINITIONFROMOID(EnumValueDefinitionDO ENUMVALUEDEFINITIONFROMOID)
          Set ENUMVALUEDEFINITIONFROMOID of the GENERICSTATETRANSITION
 void setENUMVALUEDEFINITIONFROMOID(EnumValueDefinitionDO ENUMVALUEDEFINITIONFROMOID, User usr)
          Set ENUMVALUEDEFINITIONFROMOID of the GENERICSTATETRANSITION
 void setENUMVALUEDEFINITIONTOOID(EnumValueDefinitionDO ENUMVALUEDEFINITIONTOOID)
          Set ENUMVALUEDEFINITIONTOOID of the GENERICSTATETRANSITION
 void setENUMVALUEDEFINITIONTOOID(EnumValueDefinitionDO ENUMVALUEDEFINITIONTOOID, User usr)
          Set ENUMVALUEDEFINITIONTOOID of the GENERICSTATETRANSITION
 java.lang.String toString()
           
 java.lang.String toString(int indentCount)
           
 
Methods inherited from class org.webdocwf.util.genericstore.GenericStoreDO
assertDOGenericGetBinaryAttrAccess, assertDOGenericGetBoolAttrAccess, assertDOGenericGetDateAttrAccess, assertDOGenericGetDOValueAccess, assertDOGenericGetEnumAttrAccess, assertDOGenericGetNumberAttrAccess, assertDOGenericGetObjectAttrAccess, assertDOGenericGetStringAttrAccess, assertDOGenericSetBinaryAttrAccess, assertDOGenericSetBoolAttrAccess, assertDOGenericSetDateAttrAccess, assertDOGenericSetEnumAttrAccess, assertDOGenericSetEnumAttrAccess, assertDOGenericSetNumberAttrAccess, assertDOGenericSetObjectAttrAccess, assertDOGenericSetStringAttrAccess, checkAttrDefinition, checkEnumTypeDefinition, checkEnumValueDefinition, checkTypeDefinition, findAllowedTargetStates, findAttrDef, findBeginStates, findEndStates, findEnumTypeDef, findEnumValueDef, findStateTransition, findTypeDef, genericGetAllBinaryAttrs, genericGetAllBoolAttrs, genericGetAllBoolAttrs, genericGetAllByteAttrs, genericGetAllDateAttrs, genericGetAllDateAttrs, genericGetAllEnumAttrs, genericGetAllEnumAttrs, genericGetAllEnumTypeAttrs, genericGetAllEnumTypeAttrs, genericGetAllNumberAttrs, genericGetAllNumberAttrs, genericGetAllObjectAttrs, genericGetAllObjectAttrs, genericGetAllowedTargetStates, genericGetAllStringAttrs, genericGetAllStringAttrs, genericGetBinaryAttr, genericGetBinaryAttr, genericGetBoolAttr, genericGetBoolAttr, genericGetDateAttr, genericGetDateAttr, genericGetEnumAttr, genericGetEnumAttr, genericGetEnumTypeAttr, genericGetEnumTypeAttr, genericGetNumberAttr, genericGetNumberAttr, genericGetObjectAttr, genericGetObjectAttr, genericGetStateTransition, genericGetStringAttr, genericGetStringAttr, genericGetTargetStateAllowed, genericIsBeginState, genericIsEndState, genericSetBinaryAttr, genericSetBinaryAttr, genericSetBoolAttr, genericSetBoolAttr, genericSetDateAttr, genericSetDateAttr, genericSetEnumAttr, genericSetEnumAttr, genericSetEnumAttr, genericSetEnumAttr, genericSetNumberAttr, genericSetNumberAttr, genericSetObjectAttr, genericSetObjectAttr, genericSetStartStateAttr, genericSetStartStateAttr, genericSetStateAttr, genericSetStateAttr, genericSetStringAttr, genericSetStringAttr, hasDOGenericGetAttrAccess, hasDOGenericGetAttrAccess, hasDOGenericGetBinaryAttrAccess, hasDOGenericGetBoolAttrAccess, hasDOGenericGetDateAttrAccess, hasDOGenericGetEnumAttrAccess, hasDOGenericGetNumberAttrAccess, hasDOGenericGetObjectAttrAccess, hasDOGenericGetStringAttrAccess, hasDOGenericSetAttrAccess, hasDOGenericSetAttrAccess, hasDOGenericSetBinaryAttrAccess, hasDOGenericSetBoolAttrAccess, hasDOGenericSetDateAttrAccess, hasDOGenericSetEnumAttrAccess, hasDOGenericSetNumberAttrAccess, hasDOGenericSetObjectAttrAccess, hasDOGenericSetStringAttrAccess, loadGenericBinaryData, loadGenericBoolData, loadGenericDateData, loadGenericEnumData, loadGenericNumberData, loadGenericObjectData, loadGenericObjectDO, loadGenericStringData
 
Methods inherited from class org.webdocwf.dods.access.SecureDO
assertDOCopyAccess, assertDODeleteAccess, assertDOGetAccess, assertDOGetDOValueAccess, assertDOGetDOValueAccess, assertDOGetDOValueAccess, assertDOGetDOValueAccess, assertDOGetDOValueAccess, assertDOGetDOValueAccess, assertDOGetDOValueAccess, assertDOGetDOValueAccess, assertDOGetDOValueAccess, assertDOGetDOValueAccess, assertDOGetVersionAccess, assertDOIsReadOnlyAccess, assertDOMakeReadOnlyAccess, assertDOMakeReadWriteAccess, delete, delete, getHandle, getVersion, getVersion, hasDOCopyAccess, hasDODeleteAccess, hasDOGetAccess, hasDOGetAttrAccess, hasDOGetAttrAccess, hasDOGetAttrAccess, hasDOGetAttrAccess, hasDOGetAttrAccess, hasDOGetAttrAccess, hasDOGetAttrAccess, hasDOGetAttrAccess, hasDOGetAttrAccess, hasDOGetDOValueAccess, hasDOGetDOValueAccess, hasDOGetDOValueAccess, hasDOGetDOValueAccess, hasDOGetDOValueAccess, hasDOGetDOValueAccess, hasDOGetDOValueAccess, hasDOGetDOValueAccess, hasDOGetDOValueAccess, hasDOGetDOValueAccess, hasDOGetVersionAccess, hasDOIsReadOnlyAccess, hasDOMakeReadOnlyAccess, hasDOMakeReadWriteAccess, hasDOSetAttrAccess, hasDOSetAttrAccess, hasDOSetAttrAccess, hasDOSetAttrAccess, hasDOSetAttrAccess, hasDOSetAttrAccess, hasDOSetAttrAccess, hasDOSetAttrAccess, hasDOSetAttrAccess, hasMatchingHandle, hasQueryFindAccess, isReadOnly, makeReadOnly, makeReadWrite
 
Methods inherited from class com.lutris.dods.builder.generator.dataobject.GenericDO
cloneUnique, compareCond, copyBigDecimal, copyByteArray, copyDate, copyString, copyTime, copyTimestamp, createDO, executeDelete, executeInsert, executeUpdate, finalizeInsert, finalizeUpdate, getCacheHandle, getData, getOriginDatabase, getPrimaryKeyName, isDirty, makeIdentical, markClean, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, markNewValue, printMsg, setData, setOId, setPrepStmtParam_BigDecimal, setPrepStmtParam_boolean, setPrepStmtParam_byte, setPrepStmtParam_bytes, setPrepStmtParam_DO, setPrepStmtParam_double, setPrepStmtParam_float, setPrepStmtParam_int, setPrepStmtParam_java_math_BigDecimal, setPrepStmtParam_java_sql_Date, setPrepStmtParam_java_sql_Time, setPrepStmtParam_java_sql_Timestamp, setPrepStmtParam_long, setPrepStmtParam_short, setPrepStmtParam_String
 
Methods inherited from class com.lutris.appserver.server.sql.CloneableDO
clone
 
Methods inherited from class com.lutris.appserver.server.sql.CoreDO
addToCache, deleteFromCache, disableVersioning, evict, finalizeDelete, getNewVersion, getOId, getOIdColumnName, getVersionColumnName, isPersistent, refresh, setNewVersion, setOIdColumnName, setPersistent, setVersion, setVersionColumnName, updateCache
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

table

public static final RDBTable table
static final data members name the table and columns for this DO. By using these members with an instance of the QueryBuilder class, an application can perform straight SQL queries while retaining compile-time checking of table and column usage. Example: List the Cities containing Persons named Bob: Using straight SQL with QueryBuilder: Pro: code runs faster because you create fewer objects Con: code is less clear Vector fields = new Vector(); fields.addElement( AddressDO.City ); QueryBuilder qb = new QueryBuilder( fields ); qb.addWhere( PersonDO.FirstName, "Bob" ); qb.addWhere( PersonDO.PrimaryKey, AddressDO.Person ); RDBRow row; while ( null != ( row = qb.getNextRow() ) ) { String city = row.get( AddressDO.City ).getString(); } Using Query/DO classes: Pro: code is (often) clearer Con: code runs slower because you create more objects PersonQuery pq = new PersonQuery(); pq.setQueryFirstName( "Bob" ); PersonDO[] bobs = pq.getDOArray(); for ( int i = 0; i < bobs.length; i++ ) { AddressQuery aq = new AddressQuery(); aq.setQueryPerson( bobs[i] ); AddressDO addr = aq.getNextDO(); String city = addr.getCity(); }


PrimaryKey

public static final RDBColumn PrimaryKey
static final RDBColumn PrimaryKey for use with QueryBuilder. See example above.


isView

protected static final boolean isView
See Also:
Constant Field Values

ENUMVALUEDEFINITIONFROMOID

public static final RDBColumn ENUMVALUEDEFINITIONFROMOID

ENUMVALUEDEFINITIONTOOID

public static final RDBColumn ENUMVALUEDEFINITIONTOOID
Constructor Detail

StateTransitionDO

protected StateTransitionDO(boolean is_view)
                     throws ObjectIdException,
                            DatabaseManagerException
Protected constructor. Only derived classes should call it.

Throws:
DatabaseManagerException - If a connection to the database cannot be established, etc.
ObjectIdException - If an object id can't be allocated for this object.

StateTransitionDO

protected StateTransitionDO()
                     throws ObjectIdException,
                            DatabaseManagerException
Protected constructor. Only derived classes should call it.

Throws:
DatabaseManagerException - If a connection to the database cannot be established, etc.
ObjectIdException - If an object id can't be allocated for this object.

StateTransitionDO

protected StateTransitionDO(ObjectId id)
                     throws java.sql.SQLException,
                            ObjectIdException,
                            DataObjectException,
                            DatabaseManagerException
Protected constructor used by createExisting(ObjectId) above.

Parameters:
id - The ObjectId for the object.
Throws:
DataObjectException - If the object is not found in the database.
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
java.sql.SQLException - Should never see this exception since GenericDO.ctor(ObjectId) never accesses the database.

StateTransitionDO

protected StateTransitionDO(java.sql.ResultSet rs)
                     throws java.sql.SQLException,
                            ObjectIdException,
                            DataObjectException,
                            DatabaseManagerException
Protected constructor.

Parameters:
rs - Result set from which to obtain product data.
Throws:
DataObjectException - If the object is not found in the database.
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
java.sql.SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.
Method Detail

getTableName

public java.lang.String getTableName()
Return GENERICSTATETRANSITION as the name of the table in the database which contains StateTransitionDO objects. This method overrides CoreDO.getTableName() and is used by CoreDO.executeUpdate() during error handling.

Overrides:
getTableName in class CoreDO
Returns:
the database table name
See Also:
CoreDO

isReadOnly

public boolean isReadOnly()
isReadOnly() Returns true if the data for this object has been marked read-only.

Specified by:
isReadOnly in class SecureDO

isLoaded

public boolean isLoaded()
isLoaded() Returns true if the data for this objects has been retrieved from the database.


loadData

public void loadData()
              throws java.sql.SQLException,
                     ObjectIdException,
                     DataObjectException
loadData() Load the fields for the DO from the database.

Throws:
ObjectIdException - If an object id can't be allocated for this object.
DataObjectException - If the object is not found in the database.
java.sql.SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

checkLoad

protected void checkLoad()
                  throws DataObjectException
Load the actual DO data if necessary. Called by get/set methods.

Specified by:
checkLoad in class SecureDO
Throws:
DataObjectException - If a data access error occurs.

refreshCache

public static void refreshCache()
                         throws java.sql.SQLException,
                                DatabaseManagerException,
                                ObjectIdException,
                                DataObjectException
Queries all rows in table, and for each row creates a DO instance in the cache. For these DOs, data.readOnly = true, which causes set methods to throw an exception.

Throws:
DataObjectException - If the object is not found in the database.
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
java.sql.SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

addToCache

public static StateTransitionDO addToCache(StateTransitionDO newDO)
Add DO to cache. If DO already exists in cache, just the data member is replaced, so that application references to the DO remain valid.


getCacheContents

public static java.util.Enumeration getCacheContents()
Retrieve contents of cache as an enumeration of DO objects.


createVirgin

public static StateTransitionDO createVirgin()
                                      throws DatabaseManagerException,
                                             ObjectIdException
createVirgin() Creates a DO that has no ObjectId or data. Such a DO is used to insert a new database entry after its data has been set.

Throws:
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.

createVirgin

public static StateTransitionDO createVirgin(User usr)
                                      throws DatabaseManagerException,
                                             ObjectIdException,
                                             AccessException
createVirgin() Creates a DO that has no ObjectId or data. Such a DO is used to insert a new database entry after its data has been set.

Parameters:
usr - The user for security check
Throws:
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
AccessException - The user is not allowed to create new instances WebDocWf extension

assertDOCreateAccess

public static void assertDOCreateAccess(User usr)
                                 throws AccessException
Ensure that the given user is allowed to create new instances

Parameters:
usr - The user for security check
Throws:
AccessException - The user is not allowed to create new instances WebDocWf extension

hasDOCreateAccess

public static boolean hasDOCreateAccess(User usr)
                                 throws AccessEvalException
Check whether the given user is allowed to create new instances

Parameters:
usr - The user for security check
Returns:
Whether the given user is allowed to create new instances WebDocWf extension
AccessEvalException

createForExisting

public GenericStoreDO createForExisting(java.math.BigDecimal bd)
                                 throws java.sql.SQLException,
                                        ObjectIdException,
                                        DataObjectException,
                                        DatabaseManagerException
Create an instance for an existing row This is a strange hack for having an instance method Maybe there is a better solution ? WebDocWf extension

Specified by:
createForExisting in class GenericStoreDO
Parameters:
bd - ObjectID as BigDecimal of the object which must be read from the DB
Returns:
The object which was read from the DB
java.sql.SQLException
ObjectIdException
DataObjectException
DatabaseManagerException

createExisting

public static StateTransitionDO createExisting(java.math.BigDecimal bd)
                                        throws java.sql.SQLException,
                                               ObjectIdException,
                                               DataObjectException,
                                               DatabaseManagerException
createExisting( BigDecimal ) Factory method creates a StateTransitionDO object by searching for it in the database using the passed BigDecimal value as the primary key. Creates a DO that represents an existing entry in the database. Such a DO is used to examine and possibly update such an entry. createExisting() is called only from the code that retrieves an ObjectId from a ResultSet (database query result). createExisting() is protected because no other DO or BO should ever need to call it. FIX unfortunately the createExisting(BigDecimal) form *does* need to be public because it is called by the public ctors of other DOs. For example, AaaDO contains a ref to a BbbDO, so there is a method AaaDO.setBbb(BbbDO). In the ctor AaaDO(ResultSet), we have the call setBbb( BbbDO.createExisting( rs.getBigDecimal( "bbb", 0 ))); Since AaaDO is not in the same package as BbbDO, BbbDO.createExisting(BigDecimal) must be public, not protected. Java needs the C++ 'friend' idea.

Parameters:
bd - The BigDecimal representation of the ObjectId for the object.
Throws:
DataObjectException - If the object is not found in the database.
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
java.sql.SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

createExisting

public static StateTransitionDO createExisting(java.math.BigDecimal bd,
                                               User usr)
                                        throws java.sql.SQLException,
                                               ObjectIdException,
                                               DataObjectException,
                                               DatabaseManagerException,
                                               AccessException
createExisting( BigDecimal ) Factory method creates a StateTransitionDO object by searching for it in the database using the passed BigDecimal value as the primary key.

Parameters:
bd - The BigDecimal representation of the ObjectId for the object.
usr - The user for security check
Throws:
DataObjectException - If the object is not found in the database.
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
java.sql.SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.
AccessException - The user is not allowed to read the instance existance WebDocWf extension

hasDOGetAccess

public static boolean hasDOGetAccess(java.math.BigDecimal bd,
                                     User usr)
                              throws AccessEvalException
Check whether the given user is allowed to read the DO existance Static function to be called without having the object

Parameters:
bd - The BigDecimal representation of the ObjectId for the object.
usr - The user for security check
Returns:
Whether the given user is allowed to read the DO existance WebDocWf extension
AccessEvalException

createExisting

public static StateTransitionDO createExisting(java.lang.String handle)
The createExisting method is used to create a StateTransitionDO from a string handle.


createExisting

public static StateTransitionDO createExisting(java.lang.String handle,
                                               User usr)
                                        throws AccessException
The createExisting method is used to create a StateTransitionDO from a string handle. WebDocWf extension

AccessException

hasDOGetAccess

public static boolean hasDOGetAccess(java.lang.String handle,
                                     User usr)
                              throws AccessEvalException
Check whether the given user is allowed to read the DO existance Static function to be called without having the object

Parameters:
handle - The string representation of the ObjectId for the object.
usr - The user for security check
Returns:
Whether the given user is allowed to read the DO existance WebDocWf extension
AccessEvalException

createExisting

protected static StateTransitionDO createExisting(ObjectId id)
                                           throws java.sql.SQLException,
                                                  ObjectIdException,
                                                  DataObjectException,
                                                  DatabaseManagerException
createExisting( ObjectId ) Factory method creates a StateTransitionDO object by searching for it in the database using the passed ObjectID value as the primary key.

Parameters:
id - The ObjectId for the object.
Throws:
DataObjectException - If the object is not found in the database.
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
java.sql.SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

createExisting

protected static StateTransitionDO createExisting(java.sql.ResultSet rs)
                                           throws java.sql.SQLException,
                                                  ObjectIdException,
                                                  DataObjectException,
                                                  DatabaseManagerException
createExisting( ResultSet ) Factory method used to create an instance of this class to represent a Data Object already existing in the database.

Parameters:
rs - The ResultSet returned by the Query class for an existing Data Object stored in the database.
Throws:
DataObjectException - If the object is not found in the database.
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
java.sql.SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

createExisting

protected static StateTransitionDO createExisting(RDBRow row)
                                           throws java.sql.SQLException,
                                                  ObjectIdException,
                                                  DataObjectException,
                                                  DatabaseManagerException
createExisting( RDBRow ) Factory method creates a StateTransitionDO object by searching for it in the database using the StateTransitionDO.PrimaryKey value in the passed RDBRow.

Throws:
DataObjectException - If the RDBRow does not contain a StateTransitionDO.PrimaryKey. If the object is not found in the database.
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
java.sql.SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

createExisting

protected static StateTransitionDO createExisting(RDBColumnValue pk)
                                           throws java.sql.SQLException,
                                                  ObjectIdException,
                                                  DataObjectException,
                                                  DatabaseManagerException
createExisting( RDBColumnValue ) Factory method creates a StateTransitionDO object by searching for it in the database using the passed StateTransitionDO.PrimaryKey.

Throws:
DataObjectException - If the RDBColumnValue does not contain a StateTransitionDO.PrimaryKey. If the object is not found in the database.
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
java.sql.SQLException - If the database rejects the SQL generated to retrieve data for this object, or if the table contains a bad foreign key, etc.

createCopy

public static StateTransitionDO createCopy(StateTransitionDataStruct data)
                                    throws DatabaseManagerException,
                                           ObjectIdException
createCopy() Creates a DO that has no ObjectId but has a copy of an existing DO's data. Such a DO is used to insert a new database entry that is largely similar to an existing entry.

Parameters:
data - The data struct to copy values from.
Throws:
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.

createCopy

public static StateTransitionDO createCopy(StateTransitionDO orig)
                                    throws DatabaseManagerException,
                                           ObjectIdException
createCopy() Creates a DO that has no ObjectId but has a copy of an existing DO's data. Such a DO is used to insert a new database entry that is largely similar to an existing entry.

Parameters:
orig - The original DO to copy.
Throws:
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.

createCopy

public static StateTransitionDO createCopy(StateTransitionDO orig,
                                           User usr)
                                    throws DatabaseManagerException,
                                           ObjectIdException,
                                           AccessException
createCopy() Creates a DO that has no ObjectId but has a copy of an existing DO's data. Such a DO is used to insert a new database entry that is largely similar to an existing entry.

Parameters:
orig - The original DO to copy.
usr - The user for security check
Throws:
ObjectIdException - If an object id can't be allocated for this object.
DatabaseManagerException - If a connection to the database cannot be established, etc.
AccessException - The user is not allowed to make a copy WebDocWf extension

reload

public void reload()
reload() Causes the DO to refresh itself from the database the next time a set or get method is called.


getHandle

public java.lang.String getHandle()
                           throws DatabaseManagerException
The methods getHandle hasMatchingHandle findCachedObjectByHandle are used by Presentation Objects that need to populate HTML select lists with Data Objects as options. The getHandle() method is used to set the value for each option, and the hasMatchingHandle() and findCachedObjectByHandle() methods are used to lookup the Data Object when the selection has been made.

Specified by:
getHandle in class SecureDO
Returns:
id of this DO as a string If an object id can't be allocated for this object.
Throws:
DatabaseManagerException - If a connection to the database cannot be established, etc.

hasMatchingHandle

public boolean hasMatchingHandle(java.lang.String handle)
hasMatchingHandle

Specified by:
hasMatchingHandle in class SecureDO
Parameters:
handle - String version of DO id
Returns:
boolean True if the string version of the id of this DO matches passed handle

findCachedObjectByHandle

public static StateTransitionDO findCachedObjectByHandle(java.lang.String handle)
findCachedObjectByHandle

Parameters:
handle - String version of DO id
Returns:
StateTransitionDO Object if one is found in cache, otherwise null.

findCachedObjectByHandle

public static StateTransitionDO findCachedObjectByHandle(java.lang.String handle,
                                                         User usr)
                                                  throws AccessException
findCachedObjectByHandle

Parameters:
handle - String version of DO id
usr - The user for security check
Returns:
StateTransitionDO Object if one is found in cache, otherwise null.
Throws:
AccessException - The user is not allowed to read the object existance WebDocWf extension

makeIdentical

protected void makeIdentical(StateTransitionDO orig)
makeIdentical() Assigns the DataStruct of an existing DO to this DO. Does not duplicate data. Just assigns the reference.

Parameters:
orig - The original DO.

makeReadOnly

public void makeReadOnly()
makeReadOnly() Mark the object as readonly WebDocWf extension

Specified by:
makeReadOnly in class SecureDO

makeReadWrite

public void makeReadWrite()
makeReadWrite()

Specified by:
makeReadWrite in class SecureDO

getENUMVALUEDEFINITIONFROMOID

public EnumValueDefinitionDO getENUMVALUEDEFINITIONFROMOID()
                                                    throws DataObjectException
Get ENUMVALUEDEFINITIONFROMOID of the GENERICSTATETRANSITION

Specified by:
getENUMVALUEDEFINITIONFROMOID in interface StateTransitionDOI
Returns:
ENUMVALUEDEFINITIONFROMOID of the GENERICSTATETRANSITION
Throws:
DataObjectException - If the object is not found in the database.

getENUMVALUEDEFINITIONFROMOID

public EnumValueDefinitionDO getENUMVALUEDEFINITIONFROMOID(User usr)
                                                    throws DataObjectException,
                                                           AccessException
Get ENUMVALUEDEFINITIONFROMOID of the GENERICSTATETRANSITION

Parameters:
usr - The user for security check
Returns:
ENUMVALUEDEFINITIONFROMOID of the GENERICSTATETRANSITION
Throws:
DataObjectException - If the object is not found in the database.
AccessException - The user is not allowed to read the attribute(value) WebDocWf extension

assertDOGetAttrENUMVALUEDEFINITIONFROMOIDAccess

public void assertDOGetAttrENUMVALUEDEFINITIONFROMOIDAccess(User usr)
                                                     throws AccessException
Ensure that the given user is allowed to read the attribute

Parameters:
usr - The user for security check
Throws:
AccessException - The user is not allowed to read the attribute(value) WebDocWf extension

hasDOGetAttrENUMVALUEDEFINITIONFROMOIDAccess

public boolean hasDOGetAttrENUMVALUEDEFINITIONFROMOIDAccess(User usr)
                                                     throws AccessEvalException
Check whether the given user is allowed to read the attribute

Parameters:
usr - The user for security check
Returns:
Whether the given user is allowed to read the attribute WebDocWf extension
AccessEvalException

hasDOGetDOValueENUMVALUEDEFINITIONFROMOIDAccess

public boolean hasDOGetDOValueENUMVALUEDEFINITIONFROMOIDAccess(User usr)
                                                        throws AccessEvalException
Check whether the given user is allowed to read object in a pointer attribute

Parameters:
usr - The user for security check
Returns:
Whether the given user is allowed to read the attribute WebDocWf extension
AccessEvalException

setENUMVALUEDEFINITIONFROMOID

public void setENUMVALUEDEFINITIONFROMOID(EnumValueDefinitionDO ENUMVALUEDEFINITIONFROMOID)
                                   throws DataObjectException
Set ENUMVALUEDEFINITIONFROMOID of the GENERICSTATETRANSITION

Specified by:
setENUMVALUEDEFINITIONFROMOID in interface StateTransitionDOI
Parameters:
ENUMVALUEDEFINITIONFROMOID - of the GENERICSTATETRANSITION
Throws:
DataObjectException - If the object is not found in the database.

setENUMVALUEDEFINITIONFROMOID

public void setENUMVALUEDEFINITIONFROMOID(EnumValueDefinitionDO ENUMVALUEDEFINITIONFROMOID,
                                          User usr)
                                   throws DataObjectException,
                                          AccessException
Set ENUMVALUEDEFINITIONFROMOID of the GENERICSTATETRANSITION

Parameters:
ENUMVALUEDEFINITIONFROMOID - of the GENERICSTATETRANSITION
usr - The user for security check
Throws:
DataObjectException - If the object is not found in the database.
AccessException - The user is not allowed to read the attribute(value) WebDocWf extension

assertDOSetAttrENUMVALUEDEFINITIONFROMOIDAccess

public void assertDOSetAttrENUMVALUEDEFINITIONFROMOIDAccess(EnumValueDefinitionDO ENUMVALUEDEFINITIONFROMOID,
                                                            User usr)
                                                     throws AccessException
Ensure that the given user is allowed to update the attribute

Parameters:
ENUMVALUEDEFINITIONFROMOID - of the GENERICSTATETRANSITION
usr - The user for security check
Throws:
AccessException - The user is not allowed to read the attribute(value) WebDocWf extension

hasDOSetAttrENUMVALUEDEFINITIONFROMOIDAccess

public boolean hasDOSetAttrENUMVALUEDEFINITIONFROMOIDAccess(EnumValueDefinitionDO ENUMVALUEDEFINITIONFROMOID,
                                                            User usr)
                                                     throws AccessEvalException
Check whether the given user is allowed to update the attribute

Parameters:
ENUMVALUEDEFINITIONFROMOID - of the GENERICSTATETRANSITION
usr - The user for security check
Returns:
Whether the given user is allowed to update the attribute WebDocWf extension
AccessEvalException

getENUMVALUEDEFINITIONTOOID

public EnumValueDefinitionDO getENUMVALUEDEFINITIONTOOID()
                                                  throws DataObjectException
Get ENUMVALUEDEFINITIONTOOID of the GENERICSTATETRANSITION

Specified by:
getENUMVALUEDEFINITIONTOOID in interface StateTransitionDOI
Returns:
ENUMVALUEDEFINITIONTOOID of the GENERICSTATETRANSITION
Throws:
DataObjectException - If the object is not found in the database.

getENUMVALUEDEFINITIONTOOID

public EnumValueDefinitionDO getENUMVALUEDEFINITIONTOOID(User usr)
                                                  throws DataObjectException,
                                                         AccessException
Get ENUMVALUEDEFINITIONTOOID of the GENERICSTATETRANSITION

Parameters:
usr - The user for security check
Returns:
ENUMVALUEDEFINITIONTOOID of the GENERICSTATETRANSITION
Throws:
DataObjectException - If the object is not found in the database.
AccessException - The user is not allowed to read the attribute(value) WebDocWf extension

assertDOGetAttrENUMVALUEDEFINITIONTOOIDAccess

public void assertDOGetAttrENUMVALUEDEFINITIONTOOIDAccess(User usr)
                                                   throws AccessException
Ensure that the given user is allowed to read the attribute

Parameters:
usr - The user for security check
Throws:
AccessException - The user is not allowed to read the attribute(value) WebDocWf extension

hasDOGetAttrENUMVALUEDEFINITIONTOOIDAccess

public boolean hasDOGetAttrENUMVALUEDEFINITIONTOOIDAccess(User usr)
                                                   throws AccessEvalException
Check whether the given user is allowed to read the attribute

Parameters:
usr - The user for security check
Returns:
Whether the given user is allowed to read the attribute WebDocWf extension
AccessEvalException

hasDOGetDOValueENUMVALUEDEFINITIONTOOIDAccess

public boolean hasDOGetDOValueENUMVALUEDEFINITIONTOOIDAccess(User usr)
                                                      throws AccessEvalException
Check whether the given user is allowed to read object in a pointer attribute

Parameters:
usr - The user for security check
Returns:
Whether the given user is allowed to read the attribute WebDocWf extension
AccessEvalException

setENUMVALUEDEFINITIONTOOID

public void setENUMVALUEDEFINITIONTOOID(EnumValueDefinitionDO ENUMVALUEDEFINITIONTOOID)
                                 throws DataObjectException
Set ENUMVALUEDEFINITIONTOOID of the GENERICSTATETRANSITION

Specified by:
setENUMVALUEDEFINITIONTOOID in interface StateTransitionDOI
Parameters:
ENUMVALUEDEFINITIONTOOID - of the GENERICSTATETRANSITION
Throws:
DataObjectException - If the object is not found in the database.

setENUMVALUEDEFINITIONTOOID

public void setENUMVALUEDEFINITIONTOOID(EnumValueDefinitionDO ENUMVALUEDEFINITIONTOOID,
                                        User usr)
                                 throws DataObjectException,
                                        AccessException
Set ENUMVALUEDEFINITIONTOOID of the GENERICSTATETRANSITION

Parameters:
ENUMVALUEDEFINITIONTOOID - of the GENERICSTATETRANSITION
usr - The user for security check
Throws:
DataObjectException - If the object is not found in the database.
AccessException - The user is not allowed to read the attribute(value) WebDocWf extension

assertDOSetAttrENUMVALUEDEFINITIONTOOIDAccess

public void assertDOSetAttrENUMVALUEDEFINITIONTOOIDAccess(EnumValueDefinitionDO ENUMVALUEDEFINITIONTOOID,
                                                          User usr)
                                                   throws AccessException
Ensure that the given user is allowed to update the attribute

Parameters:
ENUMVALUEDEFINITIONTOOID - of the GENERICSTATETRANSITION
usr - The user for security check
Throws:
AccessException - The user is not allowed to read the attribute(value) WebDocWf extension

hasDOSetAttrENUMVALUEDEFINITIONTOOIDAccess

public boolean hasDOSetAttrENUMVALUEDEFINITIONTOOIDAccess(EnumValueDefinitionDO ENUMVALUEDEFINITIONTOOID,
                                                          User usr)
                                                   throws AccessEvalException
Check whether the given user is allowed to update the attribute

Parameters:
ENUMVALUEDEFINITIONTOOID - of the GENERICSTATETRANSITION
usr - The user for security check
Returns:
Whether the given user is allowed to update the attribute WebDocWf extension
AccessEvalException

getInsertStatement

public java.sql.PreparedStatement getInsertStatement(DBConnection conn)
                                              throws java.sql.SQLException
Prepares the statement used to insert this object into the database.

Specified by:
getInsertStatement in class CoreDO
Parameters:
conn - the database connection.
Returns:
the insert statement.
Throws:
java.sql.SQLException - if an error occurs.

getUpdateStatement

public java.sql.PreparedStatement getUpdateStatement(DBConnection conn)
                                              throws java.sql.SQLException
Prepares the statement used to update this object in the database.

Specified by:
getUpdateStatement in class CoreDO
Parameters:
conn - the database connection
Returns:
the update statement.
Throws:
java.sql.SQLException - if an error occurs.

getDeleteStatement

public java.sql.PreparedStatement getDeleteStatement(DBConnection conn)
                                              throws java.sql.SQLException
Prepares the statement used to delete this object from the database.

Specified by:
getDeleteStatement in class CoreDO
Parameters:
conn - the database connection
Returns:
the delete statement.
Throws:
java.sql.SQLException - if an error occurs.

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object

toString

public java.lang.String toString(int indentCount)
Overrides:
toString in class GenericDO

okToCommit

protected void okToCommit()
                   throws RefAssertionException
A stub method for implementing pre-commit assertions for this StateTransitionDO. Implement this stub to throw an RefAssertionException for cases where this object is not valid for writing to the database.

RefAssertionException

okToDelete

protected void okToDelete()
                   throws RefAssertionException
A stub method for implementing pre-delete assertions for this StateTransitionDO. Implement this stub to throw an RefAssertionException for cases where this object is not valid for deletion from the database.

RefAssertionException

commit

public void commit()
            throws java.sql.SQLException,
                   DatabaseManagerException,
                   DataObjectException,
                   RefAssertionException,
                   DBRowUpdateException,
                   QueryException
Deprecated. Use save() instead.

Inserts/Updates the DO into its table.

Specified by:
commit in interface StateTransitionDOI
Throws:
DatabaseManagerException - if a Transaction can not be created.
RefAssertionException - thrown by okTo method.
java.sql.SQLException - if any SQL errors occur.
DataObjectException
DBRowUpdateException
QueryException

save

public void save()
          throws java.sql.SQLException,
                 DatabaseManagerException,
                 DataObjectException,
                 RefAssertionException,
                 DBRowUpdateException,
                 QueryException
Inserts/Updates the DO into its table.

Specified by:
save in interface StateTransitionDOI
Overrides:
save in class GenericStoreDO
Throws:
DatabaseManagerException - if a Transaction can not be created.
RefAssertionException - thrown by okTo method.
java.sql.SQLException - if any SQL errors occur. WebDocWf extension
DataObjectException
DBRowUpdateException
QueryException

save

public void save(boolean references)
          throws java.sql.SQLException,
                 DatabaseManagerException,
                 DataObjectException,
                 RefAssertionException,
                 DBRowUpdateException,
                 QueryException
Inserts/Updates the DO into its table.

Parameters:
references - True if references should be saved with this DO
Throws:
DatabaseManagerException - if a Transaction can not be created.
RefAssertionException - thrown by okTo method.
java.sql.SQLException - if any SQL errors occur. WebDocWf extension
DataObjectException
DBRowUpdateException
QueryException

commit

public void commit(DBTransaction dbt)
            throws java.sql.SQLException,
                   DatabaseManagerException,
                   DataObjectException,
                   RefAssertionException,
                   DBRowUpdateException,
                   QueryException
Deprecated. Use save() instead.

Inserts/Updates the DO into its table. The transaction is likely provided by the commit() method of another DO which references this DO.

Specified by:
commit in interface StateTransitionDOI
Parameters:
dbt - The transaction object to use for this operation.
Throws:
DatabaseManagerException - if a Transaction can not be created.
DBRowUpdateException - if a version error occurs.
RefAssertionException - thrown by okTo method.
java.sql.SQLException - if any SQL errors occur.
DataObjectException
QueryException

save

public void save(DBTransaction dbt)
          throws java.sql.SQLException,
                 DatabaseManagerException,
                 DataObjectException,
                 RefAssertionException,
                 DBRowUpdateException,
                 QueryException
Inserts/Updates the DO into its table. The transaction is likely provided by the commit() method of another DO which references this DO.

Specified by:
save in interface StateTransitionDOI
Overrides:
save in class GenericStoreDO
Parameters:
dbt - The transaction object to use for this operation.
Throws:
DatabaseManagerException - if a Transaction can not be created.
DBRowUpdateException - if a version error occurs.
RefAssertionException - thrown by okTo method.
java.sql.SQLException - if any SQL errors occur. WebDocWf extension
DataObjectException
QueryException

save

public void save(DBTransaction dbt,
                 boolean references)
          throws java.sql.SQLException,
                 DatabaseManagerException,
                 DataObjectException,
                 RefAssertionException,
                 DBRowUpdateException,
                 QueryException
Inserts/Updates the DO into its table. The transaction is likely provided by the commit() method of another DO which references this DO.

Parameters:
dbt - The transaction object to use for this operation.
references - True if references of this DO should be saved
Throws:
DatabaseManagerException - if a Transaction can not be created.
DBRowUpdateException - if a version error occurs.
RefAssertionException - thrown by okTo method.
java.sql.SQLException - if any SQL errors occur. WebDocWf extension
DataObjectException
QueryException

delete

public void delete()
            throws java.sql.SQLException,
                   DatabaseManagerException,
                   DataObjectException,
                   RefAssertionException,
                   DBRowUpdateException,
                   QueryException
Deletes the DO from its table.

Specified by:
delete in interface StateTransitionDOI
Overrides:
delete in class GenericStoreDO
Throws:
DatabaseManagerException - if a Transaction can not be created.
RefAssertionException - thrown by okTo method.
java.sql.SQLException - if any SQL errors occur.
DataObjectException
DBRowUpdateException
QueryException

delete

public void delete(DBTransaction dbt)
            throws java.sql.SQLException,
                   DatabaseManagerException,
                   DataObjectException,
                   RefAssertionException,
                   DBRowUpdateException,
                   QueryException
Deletes the DO from its table. The transaction is likely provided by the delete() method of another DO which references this DO.

Specified by:
delete in interface StateTransitionDOI
Overrides:
delete in class GenericStoreDO
Parameters:
dbt - The transaction object to use for this operation.
Throws:
DatabaseManagerException - if a Transaction can not be created.
DBRowUpdateException - if a version error occurs.
RefAssertionException - thrown by okTo method.
java.sql.SQLException - if any SQL errors occur.
DataObjectException
QueryException

okToCommitENUMVALUEDEFINITIONFROMOID

protected void okToCommitENUMVALUEDEFINITIONFROMOID(EnumValueDefinitionDO member)
                                             throws RefAssertionException
A stub method for implementing pre-commit assertions for the ENUMVALUEDEFINITIONFROMOID data member. Implement this stub to throw an RefAssertionException for cases where ENUMVALUEDEFINITIONFROMOID is not valid for writing to the database.

RefAssertionException

okToDeleteENUMVALUEDEFINITIONFROMOID

protected void okToDeleteENUMVALUEDEFINITIONFROMOID(EnumValueDefinitionDO member)
                                             throws RefAssertionException
A stub method for implementing pre-delete assertions for the ENUMVALUEDEFINITIONFROMOID data member. Implement this stub to throw an RefAssertionException for cases where ENUMVALUEDEFINITIONFROMOID is not valid for deletion from the database.

RefAssertionException

okToCommitENUMVALUEDEFINITIONTOOID

protected void okToCommitENUMVALUEDEFINITIONTOOID(EnumValueDefinitionDO member)
                                           throws RefAssertionException
A stub method for implementing pre-commit assertions for the ENUMVALUEDEFINITIONTOOID data member. Implement this stub to throw an RefAssertionException for cases where ENUMVALUEDEFINITIONTOOID is not valid for writing to the database.

RefAssertionException

okToDeleteENUMVALUEDEFINITIONTOOID

protected void okToDeleteENUMVALUEDEFINITIONTOOID(EnumValueDefinitionDO member)
                                           throws RefAssertionException
A stub method for implementing pre-delete assertions for the ENUMVALUEDEFINITIONTOOID data member. Implement this stub to throw an RefAssertionException for cases where ENUMVALUEDEFINITIONTOOID is not valid for deletion from the database.

RefAssertionException

modifyDO

protected void modifyDO(DBTransaction dbt,
                        boolean delete)
                 throws java.sql.SQLException,
                        DatabaseManagerException,
                        DataObjectException,
                        RefAssertionException,
                        DBRowUpdateException,
                        QueryException
Modifies the DO within its table. Performs recursive commit/delete on referenced DOs; all operations occur within a single transaction to allow rollback in the event of error. Only the creator of the transaction releases it.

Parameters:
dbt - The transaction object to use for this operation.
delete - True if doing a delete, otherwise doing insert/update.
Throws:
DatabaseManagerException - if a Transaction can not be created.
DBRowUpdateException - if a version error occurs.
RefAssertionException - thrown by okTo method.
java.sql.SQLException - if any SQL errors occur. WebDocWf extension
DataObjectException
QueryException

modifyDO

protected void modifyDO(DBTransaction dbt,
                        boolean delete,
                        boolean references)
                 throws java.sql.SQLException,
                        DatabaseManagerException,
                        DataObjectException,
                        RefAssertionException,
                        DBRowUpdateException,
                        QueryException
Modifies the DO within its table. Performs recursive commit/delete on referenced DOs; all operations occur within a single transaction to allow rollback in the event of error. Only the creator of the transaction releases it.

Parameters:
dbt - The transaction object to use for this operation.
delete - True if doing a delete, otherwise doing insert/update.
references - True if references should be saved
Throws:
DatabaseManagerException - if a Transaction can not be created.
DBRowUpdateException - if a version error occurs.
RefAssertionException - thrown by okTo method.
java.sql.SQLException - if any SQL errors occur. WebDocWf extension
DataObjectException
QueryException

DODS 5.1 API