Business Components

oracle.jbo
Class CSMessageBundle

java.lang.Object
  |
  +--java.util.ResourceBundle
        |
        +--java.util.ListResourceBundle
              |
              +--oracle.jbo.common.CheckedListResourceBundle
                    |
                    +--oracle.jbo.CSMessageBundle
Direct Known Subclasses:
CSMessageBundle_xx

public class CSMessageBundle
extends CheckedListResourceBundle

Defines the error codes and default error messages for operations on business objects.

These error codes may be localized by extending this class, and overriding getContents() to return a table in which the error codes are associated with other message strings. The subclass should be given a name of the form CSMessageBundle_locale, where Locale is the name of a language.

CSMessageBundle_xx is an example locale, for the toy language Xx.

Since:
JDeveloper 3.0
See Also:
CSMessageBundle_xx

Field Summary
static java.lang.String EXC_AFTER_COMMIT
          Cause
static java.lang.String EXC_AFTER_POST
          Cause
static java.lang.String EXC_AFTER_ROLLBACK
          Cause
static java.lang.String EXC_ALREADY_CONNECTED
          Cause
static java.lang.String EXC_ALREADY_LOCKED
          Cause
static java.lang.String EXC_AM_ACTIVATE
          Cause
static java.lang.String EXC_AM_PASSIVATE
          Cause
static java.lang.String EXC_APPMODULE_CREATE
          Cause
static java.lang.String EXC_ATTR_LOAD_DATUM_EXCEPTION
          Cause
static java.lang.String EXC_ATTR_LOAD_EXCEPTION
          Cause
static java.lang.String EXC_CANNOT_REMOVE_REFERENCED_OBJ
          Cause
static java.lang.String EXC_CANNOT_SET_USER_QUERY_WITH_VL
          Cause
static java.lang.String EXC_CHILD_AM_WITH_NO_PARENT
          Cause
static java.lang.String EXC_COMP_OBJ_WITH_NO_PARENT
          Cause
static java.lang.String EXC_CUSTOM_CLASS_NOT_ASSIGNABLE
          Cause
static java.lang.String EXC_CUSTOM_CLASS_NOT_FOUND
          Cause
static java.lang.String EXC_DATA_CREATION
          Cause
static java.lang.String EXC_DATA_CREATION_CLASS_NOT_FOUND
          Cause
static java.lang.String EXC_DATA_CREATION_FROM_VALUE
          Cause
static java.lang.String EXC_DATA_CREATION_WITH_MSG
          Cause
static java.lang.String EXC_DATABASE_STATE_EXISTS
          Cause
static java.lang.String EXC_DEAD_ENTITY_ACCESS
          Cause
static java.lang.String EXC_DEAD_VIEW_ROW_ACCESS
          Cause
static java.lang.String EXC_DML_GENERATE_PK_BASED_REF
          Cause
static java.lang.String EXC_DML_GENERATE_REF_AND_OID
          Cause
static java.lang.String EXC_DML_GET_EST_ROW_COUNT
          Cause
static java.lang.String EXC_DML_PK_BASED_REF_NOT_SUPPORTED
          ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Cause
static java.lang.String EXC_DML_POST_ENTITY
          Cause
static java.lang.String EXC_DML_REF_AND_OID_NOT_SUPPORTED
          Cause
static java.lang.String EXC_DOMAIN_OPERATION
          Cause
static java.lang.String EXC_ENTITIES_INV_IN_B4_COMMIT
          Cause
static java.lang.String EXC_ENTITY_ROW_CREATE
          Cause
static java.lang.String EXC_ENTITY_ROW_NOT_FOUND
          Cause
static java.lang.String EXC_ENTITY_SELECT
          Cause
static java.lang.String EXC_EO_NOT_PRIMARY_BASE
          Cause
static java.lang.String EXC_GENERIC_PERSISTENCE
          Cause
static java.lang.String EXC_IDENT_MISMATCH
          Cause
static java.lang.String EXC_INSERT_WITH_NO_ATTR_SET
          Cause
static java.lang.String EXC_INVALID_ATTRIBUTE_KIND
          Cause
static java.lang.String EXC_INVALID_DEFINITION_NAME
          Cause
static java.lang.String EXC_INVALID_ENTITY_ATTR_NAME
          Cause
static java.lang.String EXC_INVALID_ENTITYASSOC_DEFN
          Cause
static java.lang.String EXC_INVALID_FETCH_MODE
          Cause
static java.lang.String EXC_INVALID_FETCH_SIZE
          Cause
static java.lang.String EXC_INVALID_MAX_FETCH_SIZE
          Cause
static java.lang.String EXC_INVALID_METHOD_CALL
          Cause
static java.lang.String EXC_INVALID_OBJECT_NAME
          Cause
static java.lang.String EXC_INVALID_OPER_FORWARD_ROWSET
          Cause
static java.lang.String EXC_INVALID_OPER_SET_ROW_VALIDATION
          Cause
static java.lang.String EXC_INVALID_PARAMETER
          Cause
static java.lang.String EXC_INVALID_SER_FILE
          Cause
static java.lang.String EXC_INVALID_VIEWLINK_DEFN
          Cause
static java.lang.String EXC_JDBC_CLOSE_CONNECTION
          Cause
static java.lang.String EXC_JDBC_CLOSE_STATEMENT
          Cause
static java.lang.String EXC_JDBC_COLUMN_DEFN
          Cause
static java.lang.String EXC_JDBC_COMMIT
          Cause
static java.lang.String EXC_JDBC_GET_SQL_DATUM
          Cause
static java.lang.String EXC_JDBC_OPEN_CONNECTION
          Cause
static java.lang.String EXC_JDBC_REGISTER_DRIVER
          Cause
static java.lang.String EXC_JDBC_ROLLBACK
          Cause
static java.lang.String EXC_KEY_NOT_FOUND
          Cause
static java.lang.String EXC_LOCATING_XML_FILE
          Cause
static java.lang.String EXC_NAME_CLASH
          Cause
static java.lang.String EXC_NO_DEFINITION
          Cause
static java.lang.String EXC_NO_ENTITY_OWNER
          Cause
static java.lang.String EXC_NO_MATCHING_EO_BASE
          Cause
static java.lang.String EXC_NO_OBJECT
          Cause
static java.lang.String EXC_NOT_CONNECTED
          Cause
static java.lang.String EXC_OBSOLETE_METHOD
          Cause
static java.lang.String EXC_PARSING_XML_FILE
          Cause
static java.lang.String EXC_PCOLL_ACTIVATE
          Cause
static java.lang.String EXC_PCOLL_CHILD_ID_NOT_FOUND
          Cause
static java.lang.String EXC_PCOLL_CLOSE
          Cause
static java.lang.String EXC_PCOLL_COMMIT
          Cause
static java.lang.String EXC_PCOLL_CONNECT
          Cause
static java.lang.String EXC_PCOLL_CREATE_CONTROL_TAB
          Cause
static java.lang.String EXC_PCOLL_CREATE_TAB
          Cause
static java.lang.String EXC_PCOLL_DELETE_ALL
          Cause
static java.lang.String EXC_PCOLL_DELETE_ROW
          Cause
static java.lang.String EXC_PCOLL_GETCURTIME
          Cause
static java.lang.String EXC_PCOLL_INSERT_CONTROL_ROW
          Cause
static java.lang.String EXC_PCOLL_INSERT_ROW
          Cause
static java.lang.String EXC_PCOLL_INVALID_ID
          Cause
static java.lang.String EXC_PCOLL_INVALID_ROOT_NODE
          Cause
static java.lang.String EXC_PCOLL_LOCK_CONTROL_ROW
          Cause
static java.lang.String EXC_PCOLL_NO_PERSIST_MGR_CLASS
          Cause
static java.lang.String EXC_PCOLL_OBJ_ALREADY_ACTIVE
          Cause
static java.lang.String EXC_PCOLL_PASSIVATE
          Cause
static java.lang.String EXC_PCOLL_RETRIEVE_BY_ID
          Cause
static java.lang.String EXC_PCOLL_RETRIEVE_ROW
          Cause
static java.lang.String EXC_PCOLL_UPDATE_CONTROL_ROW
          Cause
static java.lang.String EXC_PCOLL_UPDATE_ROW
          Cause
static java.lang.String EXC_POST_THRESHOLD_REACHED
          Cause
static java.lang.String EXC_QUERY_COLLECTION_CLOSED
          Cause
static java.lang.String EXC_READ_ATTRIBUTE_XML
          Cause
static java.lang.String EXC_READ_ROW_XML
          Cause
static java.lang.String EXC_READ_ROWSET_XML
          Cause
static java.lang.String EXC_READONLY_ASSOC_ATTR
          Cause
static java.lang.String EXC_RECURSIVE_BASE_DEF
          Cause
static java.lang.String EXC_REMOVE_WITH_DETAILS
          Cause
static java.lang.String EXC_ROOT_APPMOD_ALREADY_CREATED
          Cause
static java.lang.String EXC_ROW_INCONSISTENT
          Cause
static java.lang.String EXC_SQL_CREATE_STATEMENT
          Cause
static java.lang.String EXC_SQL_EXECUTE_COMMAND
          Cause
static java.lang.String EXC_SQL_EXECUTE_QUERY
          Cause
static java.lang.String EXC_SQL_PREPARE_CALL
          Cause
static java.lang.String EXC_SQL_PREPARE_STATEMENT
          Cause
static java.lang.String EXC_SQLTYPE_NOT_SPECIFIED
          Cause
static java.lang.String EXC_STRING_MISMATCH
          Cause
static java.lang.String EXC_TOO_MANY_LEFT_PARENS
          Cause
static java.lang.String EXC_TOO_MANY_OBJECTS
          Cause
static java.lang.String EXC_TOO_MANY_RIGHT_PARENS
          Cause
static java.lang.String EXC_TYP_UNKNOWN_SQL_TYPE
          Cause
static java.lang.String EXC_UNEXPECTED_EXCEPTION
          Cause
static java.lang.String EXC_UNKNOWN_FILE_ENCODING
          Cause
static java.lang.String EXC_UNRESOLVED_REFERENCE
          Cause
static java.lang.String EXC_VAL_APPMOD_VALIDATE_FAILED
          Cause
static java.lang.String EXC_VAL_ATTR_MANDATORY
          Cause
static java.lang.String EXC_VAL_ATTR_RESOLVEGET_FAILED
          Cause
static java.lang.String EXC_VAL_ATTR_RESOLVESET_FAILED
          Cause
static java.lang.String EXC_VAL_ATTR_SET_FAILED
          Cause
static java.lang.String EXC_VAL_ATTR_SET_TYPE_MISMATCH
          Cause
static java.lang.String EXC_VAL_ATTRIBUTE_NOT_FOUND
          Cause
static java.lang.String EXC_VAL_DOMAIN_FAILED
          Cause
static java.lang.String EXC_VAL_ENTITY_ATTR_SET_FAILED
          Cause
static java.lang.String EXC_VAL_ENTITY_VALIDATE_FAILED
          Cause
static java.lang.String EXC_VAL_INVALID_CONTAINED_ENTITIES
          Cause
static java.lang.String EXC_VAL_METHOD_ON_ATTR_SET_FAILED
          Cause
static java.lang.String EXC_VAL_METHOD_ON_ROW_FAILED
          Cause
static java.lang.String EXC_VAL_PRECISION_VALIDATOR
          Cause
static java.lang.String EXC_VAL_VO_VALIDATE_FAILED
          Cause
static java.lang.String EXC_VAL_VR_ATTR_SET_FAILED
          Cause
static java.lang.String EXC_VAL_VR_BATCH_ATTR_SET_FAILED
          Cause
static java.lang.String EXC_VAL_VR_VALIDATE_FAILED
          Cause
static java.lang.String EXC_VALIDATION_THRESHOLD_REACHED
          Cause
static java.lang.String EXC_VAR_INVALID_VARIANT_NAME
          Cause
static java.lang.String EXC_VAR_INVALID_VARIANT_TYPE
          Cause
static java.lang.String EXC_VAR_UNEXPECTED_TYPE
          Cause
static java.lang.String EXC_VIEW_LINK_ALREADY_EXISTS
          Cause
static java.lang.String EXC_VIEW_ROW_CREATE
          Cause
static java.lang.String EXC_VIEW_ROW_NOT_FOUND
          Cause
static java.lang.String EXC_VIEWOBJECT_READONLY
          Cause
static java.lang.String EXC_XML_CONTEXT_BIND
          Cause
static java.lang.String EXC_XML_CONTEXT_LOOKUP
          Cause
static java.lang.String EXC_XML_CREATE_INITIAL_CONTEXT
          Cause
static java.lang.String EXC_XML_MISSING_DTD
          Cause
static java.lang.String STR_APP_MODULE
           
static java.lang.String STR_ATTRIBUTE
           
static java.lang.String STR_DEF_APP_MODULE
           
static java.lang.String STR_DEF_ATTRIBUTE
           
static java.lang.String STR_DEF_DOMAIN
           
static java.lang.String STR_DEF_ENTITY_ASSOC
           
static java.lang.String STR_DEF_ENTITY_OBJECT
           
static java.lang.String STR_DEF_PACKAGE
           
static java.lang.String STR_DEF_VIEW_LINK
           
static java.lang.String STR_DEF_VIEW_OBJECT
           
static java.lang.String STR_DML_COMMIT
           
static java.lang.String STR_DML_DELETE
           
static java.lang.String STR_DML_INSERT
           
static java.lang.String STR_DML_ROLLBACK
           
static java.lang.String STR_DML_SAVEPOINT
           
static java.lang.String STR_DML_UPDATE
           
static java.lang.String STR_DOMAIN
           
static java.lang.String STR_ENTITY_ASSOC
           
static java.lang.String STR_ENTITY_OBJECT
           
static java.lang.String STR_ENTITY_ROW
           
static java.lang.String STR_ENTITY_ROW_SET
           
static java.lang.String STR_ENTITY_ROW_SET_ITERATOR
           
static java.lang.String STR_PACKAGE
           
static java.lang.String STR_VAL_DESC_COMPARE_VALIDATOR
           
static java.lang.String STR_VAL_DESC_GENERIC_VALIDATOR
           
static java.lang.String STR_VAL_DESC_LIST_VALIDATOR
           
static java.lang.String STR_VAL_DESC_MANDATORY_VALIDATOR
           
static java.lang.String STR_VAL_DESC_METHOD_VALIDATOR
           
static java.lang.String STR_VAL_DESC_PRECISION_VALIDATOR
           
static java.lang.String STR_VAL_DESC_RANGE_VALIDATOR
           
static java.lang.String STR_VAL_SCALE_DECIMAL_CHAR
           
static java.lang.String STR_VALIDATOR_TYPE
           
static java.lang.String STR_VIEW_LINK
           
static java.lang.String STR_VIEW_OBJECT
           
static java.lang.String STR_VIEW_ROW
           
static java.lang.String STR_VIEW_ROW_SET
           
static java.lang.String STR_VIEW_ROW_SET_ITERATOR
           
 
Fields inherited from class java.util.ResourceBundle
parent
 
Constructor Summary
CSMessageBundle()
           
 
Method Summary
 java.lang.Object[][] getContents()
          Gets the key-value association table.
 
Methods inherited from class java.util.ListResourceBundle
getKeys, handleGetObject
 
Methods inherited from class java.util.ResourceBundle
getBundle, getBundle, getBundle, getLocale, getObject, getString, getStringArray, setParent
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

STR_DEF_APP_MODULE

public static final java.lang.String STR_DEF_APP_MODULE

STR_DEF_VIEW_OBJECT

public static final java.lang.String STR_DEF_VIEW_OBJECT

STR_DEF_VIEW_LINK

public static final java.lang.String STR_DEF_VIEW_LINK

STR_DEF_ENTITY_OBJECT

public static final java.lang.String STR_DEF_ENTITY_OBJECT

STR_DEF_ENTITY_ASSOC

public static final java.lang.String STR_DEF_ENTITY_ASSOC

STR_DEF_ATTRIBUTE

public static final java.lang.String STR_DEF_ATTRIBUTE

STR_DEF_DOMAIN

public static final java.lang.String STR_DEF_DOMAIN

STR_DEF_PACKAGE

public static final java.lang.String STR_DEF_PACKAGE

STR_APP_MODULE

public static final java.lang.String STR_APP_MODULE

STR_VIEW_OBJECT

public static final java.lang.String STR_VIEW_OBJECT

STR_VIEW_ROW_SET

public static final java.lang.String STR_VIEW_ROW_SET

STR_VIEW_ROW_SET_ITERATOR

public static final java.lang.String STR_VIEW_ROW_SET_ITERATOR

STR_VIEW_ROW

public static final java.lang.String STR_VIEW_ROW

STR_VIEW_LINK

public static final java.lang.String STR_VIEW_LINK

STR_ENTITY_OBJECT

public static final java.lang.String STR_ENTITY_OBJECT

STR_ENTITY_ROW_SET

public static final java.lang.String STR_ENTITY_ROW_SET

STR_ENTITY_ROW_SET_ITERATOR

public static final java.lang.String STR_ENTITY_ROW_SET_ITERATOR

STR_ENTITY_ROW

public static final java.lang.String STR_ENTITY_ROW

STR_ENTITY_ASSOC

public static final java.lang.String STR_ENTITY_ASSOC

STR_ATTRIBUTE

public static final java.lang.String STR_ATTRIBUTE

STR_DOMAIN

public static final java.lang.String STR_DOMAIN

STR_PACKAGE

public static final java.lang.String STR_PACKAGE

STR_VALIDATOR_TYPE

public static final java.lang.String STR_VALIDATOR_TYPE

STR_DML_INSERT

public static final java.lang.String STR_DML_INSERT

STR_DML_UPDATE

public static final java.lang.String STR_DML_UPDATE

STR_DML_DELETE

public static final java.lang.String STR_DML_DELETE

STR_DML_ROLLBACK

public static final java.lang.String STR_DML_ROLLBACK

STR_DML_COMMIT

public static final java.lang.String STR_DML_COMMIT

STR_DML_SAVEPOINT

public static final java.lang.String STR_DML_SAVEPOINT

STR_VAL_DESC_RANGE_VALIDATOR

public static final java.lang.String STR_VAL_DESC_RANGE_VALIDATOR

STR_VAL_DESC_COMPARE_VALIDATOR

public static final java.lang.String STR_VAL_DESC_COMPARE_VALIDATOR

STR_VAL_DESC_LIST_VALIDATOR

public static final java.lang.String STR_VAL_DESC_LIST_VALIDATOR

STR_VAL_DESC_METHOD_VALIDATOR

public static final java.lang.String STR_VAL_DESC_METHOD_VALIDATOR

STR_VAL_DESC_GENERIC_VALIDATOR

public static final java.lang.String STR_VAL_DESC_GENERIC_VALIDATOR

STR_VAL_DESC_PRECISION_VALIDATOR

public static final java.lang.String STR_VAL_DESC_PRECISION_VALIDATOR

STR_VAL_DESC_MANDATORY_VALIDATOR

public static final java.lang.String STR_VAL_DESC_MANDATORY_VALIDATOR

STR_VAL_SCALE_DECIMAL_CHAR

public static final java.lang.String STR_VAL_SCALE_DECIMAL_CHAR

EXC_TYP_UNKNOWN_SQL_TYPE

public static final java.lang.String EXC_TYP_UNKNOWN_SQL_TYPE
Cause

Exception Message for UnknownSQLTypeException

SQLType name passed to NullValue constructor is invalid.

Action

Provide a valid SQLType name. See oracle.jbo.server.OracleTypeMapEntries for a list of valid SQLType names. Names are like "VARCHAR", "CHAR", "NUMBER", etc.


EXC_NAME_CLASH

public static final java.lang.String EXC_NAME_CLASH
Cause

Exception Message for NameClashException

A Business Component with the given name already exists in the Application Module.

Action

Provide a different name for the Business Component or provide null value or null string for the name, so that the framework creates a default unique name within the scope of the Application module


EXC_NO_DEFINITION

public static final java.lang.String EXC_NO_DEFINITION
Cause

Exception Message for NoDefException

No Business Component definition found with the given name in the project classpath.

Action

Provide a correct name of the Business Component definition, or include the path in which the definition resides to the classpath. Names are of the format myProjectPackage.BusinessPackage.BusinessComponent


EXC_NO_OBJECT

public static final java.lang.String EXC_NO_OBJECT
Cause

Exception Message for NoObjException

No Business Component Object found with the given name in an Application Module

Action Provide a different name for the Business Component Object or create a new Business Component with the given name.


EXC_INVALID_DEFINITION_NAME

public static final java.lang.String EXC_INVALID_DEFINITION_NAME
Cause

Exception Message for InvalidDefNameException

Indicates that an attempt has been made to associate a definition name with a type for which it is not valid.

Action The name should be a valid java-identifier with no spaces or punctuations. Names are of the format myProjectPackage.BusinessPackage.BusinessComponent


EXC_INVALID_OBJECT_NAME

public static final java.lang.String EXC_INVALID_OBJECT_NAME
Cause

Exception Message for InvalidObjNameException

Indicates that an attempt has been made to associate a Business Component name with an object for which it is not valid.

Action The name should be a valid java-identifier with no spaces or punctuations. Names are of the format myProjectPackage.BusinessPackage.BusinessComponent


EXC_INVALID_PARAMETER

public static final java.lang.String EXC_INVALID_PARAMETER
Cause

Exception Message for InvalidParamException

The parameters passed to a Business Component method are invalid

Action See javadoc for the method that throws this Exception (by expanding the call-stack) for correct parameters. e.g., DBTransactionImpl.executeCommand() throws this exception when command parameter is null or an empty String.


EXC_INVALID_OPER_SET_ROW_VALIDATION

public static final java.lang.String EXC_INVALID_OPER_SET_ROW_VALIDATION
Cause

Exception Message for InvalidOperException

Resetting row validation for a default RowIterator of a ViewObject or a RowSet is not permitted.

Action Create another iterator for the RowSet or ViewObject to navigate to another row without validating, by reseting the RowValidation flag of that iterator.


EXC_CANNOT_REMOVE_REFERENCED_OBJ

public static final java.lang.String EXC_CANNOT_REMOVE_REFERENCED_OBJ
Cause

Exception Message for InvalidOperException

An attempt has been made to remove a ViewObject that is participating in a ViewLink.

Action Remove the ViewLink before removing the ViewObject.


EXC_DATA_CREATION_FROM_VALUE

public static final java.lang.String EXC_DATA_CREATION_FROM_VALUE
Cause

Exception Message for oracle.jbo.domain.DataCreationException

A domain object could not be created with the given value. Either a domain-constructor that accepts the given value does not exist or there is no conversion method in the domain object for the given value type or the domain's constructor threw an unexpected exception

Action Validate that the value being passed, is valid with respect to the domain-type being created e.g., passing a String value like "One" to oracle.jbo.domain.Number constructor will throw this exception.


EXC_VAL_DOMAIN_FAILED

public static final java.lang.String EXC_VAL_DOMAIN_FAILED
Cause

Exception Message for oracle.jbo.domain.DomainValidationException

Validation failed with the given value in a domain constructor. This exception is thrown in the validate() method of a domain type.

Action Provide a valid value for the domain type.


EXC_INVALID_OPER_FORWARD_ROWSET

public static final java.lang.String EXC_INVALID_OPER_FORWARD_ROWSET
Cause

Exception Message for InvalidOperException

An attempt has been made to invoke an invalid navigation method for a forward-only ViewObject or RowSet.

Action Either remove the forward-only setting for the ViewObject or RowSet, or do not invoke navigation methods other than next() on the forward-only RowSet or ViewObject.


EXC_EO_NOT_PRIMARY_BASE

public static final java.lang.String EXC_EO_NOT_PRIMARY_BASE
Cause

Exception Message for InvalidOperException

Attempting to find a ViewRow by an entity type which is not the primary entity type for that ViewObject.

Action Provide a valid entity handle.


EXC_TOO_MANY_OBJECTS

public static final java.lang.String EXC_TOO_MANY_OBJECTS
Cause

Exception Message for TooManyObjectsException

Attempting to add a new entity to the cache with the primary key same as an existing entity. This exception is thrown when uniquing a newly fetched/created entity with the cached set of entities.

Action The primary key value may not be unique for this entity-type. Fix by adding more attributes to the Key defintion for this entity type, so that each row for this entity is uniquely identifiable. Or fix the primary key value so that this entity has a unique key identifier.


EXC_ROW_INCONSISTENT

public static final java.lang.String EXC_ROW_INCONSISTENT
Cause

Exception Message for RowInconsistentException

Comparision of the cached entity failed with the values in the database for that entity. This could happen when another user or operation has committed modifications to the same entity-row in the database. This exception can also be thrown if equals() method on one of the domain-type attributes in the entity fails.

Action Verify that another user or operation has not modified the same row in the database. If this entity has attributes of a domain type verify that the equals() method on these domains do not fail when comparing the existing cache'd value with the newly fetched value.


EXC_QUERY_COLLECTION_CLOSED

public static final java.lang.String EXC_QUERY_COLLECTION_CLOSED
Cause

Exception Message for InvalidOperException

Attempting to execute query for a ViewObject or RowSet after closing or removing the ViewObject or RowSet.

Action Verify that the ViewObject or RowSet is not removed/closed.


EXC_VIEWOBJECT_READONLY

public static final java.lang.String EXC_VIEWOBJECT_READONLY
Cause

Exception Message for ReadOnlyViewObjectException

Attempting to modify data for a ViewObject which is declared to be readonly. This includes creating a new row for this ViewObject, removing a Row or modifying attributes of a ViewRow for this ViewObject.

Action Create a ViewObject with ReadOnly flag set to false to modify the data.


EXC_ENTITY_ROW_CREATE

public static final java.lang.String EXC_ENTITY_ROW_CREATE
Cause

Exception Message for RowCreateException

An unexpected exception occured while creating a new Entity instance.

Action The entity may not have a public default constructor. Fix the cause for InstantiationException or IllegalAccessException that is contained as details in this exception.


EXC_VIEW_ROW_CREATE

public static final java.lang.String EXC_VIEW_ROW_CREATE
Cause

Exception Message for RowCreateException

An unexpected exception occured while creating a new ViewRow instance.

Action The ViewRow may not have a public default constructor. Fix the cause for InstantiationException or IllegalAccessException that is contained as details in this exception.


EXC_ENTITY_ROW_NOT_FOUND

public static final java.lang.String EXC_ENTITY_ROW_NOT_FOUND
Cause

Exception Message for RowNotFoundException

Attempting to lock a non-existing row in the database. This could occur when the cache has an Entity which was subsequently deleted from the database by another user or operation.

Action Remove the current entity from the entity-cache by calling remove(). or re-synchronize the cache with the database, by rolling-back the current transaction or committing the existing set of changes and then dropping the entity-cache.


EXC_VIEW_ROW_NOT_FOUND

public static final java.lang.String EXC_VIEW_ROW_NOT_FOUND
Cause

Exception Message for RowNotFoundException

Attempting to find a referenced entity in the ViewRow failed due to a change foreign-key value.

Action Provide a valid foreign key value or remove the current


EXC_DATA_CREATION

public static final java.lang.String EXC_DATA_CREATION
Cause

Exception Message for oracle.jbo.domain.DataCreationException

A domain object could not be created with the given value. Either a domain-constructor that accepts the given value does not exist or there is no conversion method in the domain object for the given value type or the domain's constructor threw an unexpected exception

Action Validate that the value being passed, is valid with respect to the domain-type being created e.g., passing a String value like "One" to oracle.jbo.domain.Number constructor will throw this exception.


EXC_VIEW_LINK_ALREADY_EXISTS

public static final java.lang.String EXC_VIEW_LINK_ALREADY_EXISTS
Cause

Exception Message for ViewLinkAlreadyExistsException

Attempting to set the Master RowSet for this RowSet more than once.

Action Do not invoke setMasterRowSetIterator more than once on a RowSet.


EXC_DOMAIN_OPERATION

public static final java.lang.String EXC_DOMAIN_OPERATION
Cause

Exception Message for oracle.jbo.domain.GenericDomainException

An expected domain exception occurred.

Action Contact BC4J Technical Support.


EXC_OBSOLETE_METHOD

public static final java.lang.String EXC_OBSOLETE_METHOD
Cause

Exception Message for JboException

Attempting to use Obsoleted TypeMap constructor.

Action Verify that the TypeMaps in use for this version of framework is compatible. See example TypeMaps in oracle.jbo.server.OracleTypeMapEntries


EXC_READ_ROWSET_XML

public static final java.lang.String EXC_READ_ROWSET_XML
Cause

Exception Message for ReadXMLException

An error occured during reading the XML data for a ViewObject. This exception may contain other ReadXMLExceptions.

Action Fix the contained Row or Attribute level exceptions in the details for this exception.


EXC_READ_ROW_XML

public static final java.lang.String EXC_READ_ROW_XML
Cause

Exception Message for RowReadXMLException

An error occured during reading the XML data for a ViewRow. This exception may contain other ReadXMLExceptions for contained RowSets or Attributes.

Action Fix the contained RowSet or Attribute level exceptions in the details for this exception.


EXC_READ_ATTRIBUTE_XML

public static final java.lang.String EXC_READ_ATTRIBUTE_XML
Cause

Exception Message for AttributeReadXMLException

An error occured during reading the XML data for an attribute of a ViewRow. This exception may contain other JboExceptions thrown from the set method for this attribute

Action Fix the contained JboException in the details for this exception.


EXC_DATA_CREATION_WITH_MSG

public static final java.lang.String EXC_DATA_CREATION_WITH_MSG
Cause

Exception Message for oracle.jbo.domain.DataCreationException

A domain object could not be created with the given value. Either a domain-constructor that accepts the given value does not exist or there is no conversion method in the domain object for the given value type or the domain's constructor threw an unexpected exception

Action Validate that the value being passed, is valid with respect to the domain-type being created e.g., passing a String value like "One" to oracle.jbo.domain.Number constructor will throw this exception.


EXC_DATA_CREATION_CLASS_NOT_FOUND

public static final java.lang.String EXC_DATA_CREATION_CLASS_NOT_FOUND
Cause

Exception Message for oracle.jbo.domain.DataCreationException

The named data class (may be a domain) could not be found.

Action Check to make sure that the data class is accessible from the CLASSPATH and is a valid data class.


EXC_NO_ENTITY_OWNER

public static final java.lang.String EXC_NO_ENTITY_OWNER
Cause

Exception Message for InvalidOwnerException

Could not find the container entity for this entity as this entity is a detail in case of a composition association. This could occur while creating a new Entity instance by passing a non-existing master key value or when updating the foreign-key value in this entity and there's no master entity with that foreign-key value.

Action Provide a valid foreign-key value to the create() method or setAttribute() method so that an appropriate master row is found for this entity.


EXC_AM_PASSIVATE

public static final java.lang.String EXC_AM_PASSIVATE
Cause

Exception Message for JboSerializationException

Trying to passivate the Application Module state or Transaction state failed.

Action The passivation target store (Database, File or Memory) may have reported an exception. See the details of this exception for errors from the target store.


EXC_AM_ACTIVATE

public static final java.lang.String EXC_AM_ACTIVATE
Cause

Exception Message for JboSerializationException

Trying to activate the Application Module state or Transaction state failed.

Action The passivation target store (Database, File or Memory) may have reported an exception. See the details of this exception for errors from the target store. The given ID (in case of activation) may be invalid/not found.


EXC_NOT_CONNECTED

public static final java.lang.String EXC_NOT_CONNECTED
Cause

Exception Message for NotConnectedException

The application module is not connected to the database.

Action Provide a valid set of connection credentials to connect to a database.


EXC_ALREADY_CONNECTED

public static final java.lang.String EXC_ALREADY_CONNECTED
Cause

Exception Message for AlreadyConnectedException

Trying to re-establish a database connection.

Action Disconnect the current database connection before trying to re-establish the jdbc-connection.


EXC_INVALID_METHOD_CALL

public static final java.lang.String EXC_INVALID_METHOD_CALL
Cause

Exception Message for JboException

Attempting to call a method that is either not implemented or not supported.

Action The called method is not available on the callee object. e.g. setAttribute() in oracle.jbo.Key class is not implemented and will throw this exception.


EXC_APPMODULE_CREATE

public static final java.lang.String EXC_APPMODULE_CREATE
Cause

Exception Message for

???

Action ???


EXC_ROOT_APPMOD_ALREADY_CREATED

public static final java.lang.String EXC_ROOT_APPMOD_ALREADY_CREATED
Cause

Exception Message for ApplicationModuleCreateException

When BC4J is running inside JServer, only one root application module may be created. This is because JServer (already) provides one transaction context.

Action It is illegal to attempt to create multiple root transactions when running inside JServer.


EXC_DATABASE_STATE_EXISTS

public static final java.lang.String EXC_DATABASE_STATE_EXISTS
Cause

Exception Message for JboException

Trying to retain the application module state during a tranaction disconnect failed.

Action The disconnect and retain application module state target requires that no database state exist before the transaction connection is closed. Examples of database state include open database cursors in non-forward only view objects, database locks, and uncommitted database changes. The client should clean up this state by fetching or resetting any open view objects and committing any uncommited changes.


EXC_CHILD_AM_WITH_NO_PARENT

public static final java.lang.String EXC_CHILD_AM_WITH_NO_PARENT
Cause

Exception Message for InvalidOwnerException

While traversing the parenthood chain for application modules, a child application module was found with no container (parent) appolication module.

Action If this application has added custom Business Component classes, it may be that the application code is attempting to access a child application module before it is fully initialized. If this is not the case, this error probably represents some internal error in BC4J framework. Contact BC4J Technical Support.


EXC_COMP_OBJ_WITH_NO_PARENT

public static final java.lang.String EXC_COMP_OBJ_WITH_NO_PARENT
Cause

Exception Message for InvalidOwnerException

A Business Component is found without a container (parent) application module.

Action If this application has added custom Business Component classes, it may be that the application code is attempting to access a Business Component before it is fully initialized. If this is not the case, this error probably represents some internal error in BC4J framework. Contact BC4J Technical Support.


EXC_UNKNOWN_FILE_ENCODING

public static final java.lang.String EXC_UNKNOWN_FILE_ENCODING
Cause

Exception Message for

???

Action ???


EXC_GENERIC_PERSISTENCE

public static final java.lang.String EXC_GENERIC_PERSISTENCE
Cause

Exception Message for JboException

Attempting to load metadata objects failed. It may have un-expected data or the xml data may be corrupt.

Action Verify that the xml metadata for various components is valid.


EXC_LOCATING_XML_FILE

public static final java.lang.String EXC_LOCATING_XML_FILE
Cause

Exception Message for NoXMLFileException

Could not open the named XML file for read.

Action 1. Make sure that the file is present. In particular, if the file is to be found in a zip/jar file, make sure that the zip/jar file is included in the CLASSPATH.

2. This error is also reported if the name of the XML file does not match the object Name specified in the XML file. If the file system support case insenstive file names (e.g., Windows NT), make sure that the file name matches the object Name in the XML file in case-sensitive fashion.

3. For a .JPX file, this error is reported if the JPX file is missing the JboProject XML tag. Check the JPX file to make sure that the valid tag is in there.

4. One XML file may be extending another XML file (specified by the Extends element in this XML file). This error is reported if the base XML file is not found.

5. When loading the XML file for a package (JboPackage tag), this error is reported if some unexpected error occurs while loading a containee.

In all of the above cases, a more descriptive message may be printed on Diagnostic. If you are not seeing Diagnostic messages, you can run your application with Diagnostic turned on, as in "java -Djbo.debugoutput=console ...", to see Diagnostic messages.


EXC_PARSING_XML_FILE

public static final java.lang.String EXC_PARSING_XML_FILE
Cause

Exception Message for PersistenceException

Some XML parsing exception (oracle.xml.parser.v2.XMLParseException) was thrown.

Action The XMLParseException information is output to Diagnostic. If you are not seeing Diagnostic messages, you can run your application with Diagnostic turned on, as in "java -Djbo.debugoutput=console ...", to see Diagnostic messages.


EXC_RECURSIVE_BASE_DEF

public static final java.lang.String EXC_RECURSIVE_BASE_DEF
Cause

Exception Message for InvalidOperException

An attempt was made to set the base definition of another definition object, e.g., setting B's base def to A (i.e., B Extends A). However, A already extends B. Setting a recursive (circular) subclassing relationship among def objects is illegal.

Action Review your subclassing hierarchy of your def objects and correct errors.


EXC_INVALID_FETCH_MODE

public static final java.lang.String EXC_INVALID_FETCH_MODE
Cause

Exception Message for PersistenceException

The fetch mode specified in the view definition XML file is invalid.

Action Check the content of the XML file for the view definition. Look for an XML element named "FetchMode". Make sure that the value for that element is valid. Valid values are: "FETCH_AS_NEEDED", "FETCH_ALL", and "FETCH_DEFAULT".


EXC_INVALID_FETCH_SIZE

public static final java.lang.String EXC_INVALID_FETCH_SIZE
Cause

Exception Message for PersistenceException

The fetch size specified in the view definition XML file is invalid.

Action Check the content of the XML file for the view definition. Look for an XML element named "FetchSize". Make sure that the value for the element is a positive integer.


EXC_INVALID_MAX_FETCH_SIZE

public static final java.lang.String EXC_INVALID_MAX_FETCH_SIZE
Cause

Exception Message for PersistenceException

The maximum fetch size specified in the view definition XML file is invalid.

Action Check the content of the XML file for the view definition. Look for an XML element named "MaxFetchSize". Make sure that the value for the element is a non-negative integer, or "MAX_FETCH_UNLIMITED", or "MAX_FETCH_DEFAULT". A MaxFetchSize of 0 is same as MAX_FETCH_UNLIMITED.


EXC_UNRESOLVED_REFERENCE

public static final java.lang.String EXC_UNRESOLVED_REFERENCE
Cause

Exception Message for PersistenceException

A problem is found in resolving a view link definition or an assocation. In case of a view link, this error may be caused by the fact that the source or destination view object cannot found. Or, if the view link ends have attribute names, this error may indicate that the named attributes cannot be found. Similarly, for an association, this error indicates that either source or destination entity object or attributes involved in the association cannot be found.

Action Make sure the XML definition for the view link/association has correct view object/entity object/attribute names.


EXC_INVALID_SER_FILE

public static final java.lang.String EXC_INVALID_SER_FILE
Cause

Exception Message for PersistenceException

This error occurs if the application uses meta object serialization files (.ser files) instead of XML files. It indicates that after the .ser file is deserialized, the top level object returned from deserialization is not an instance of oracle.jbo.server.xml.JboElementImpl.

Action This probably means that the .ser file is corrupt.


EXC_INVALID_ENTITY_ATTR_NAME

public static final java.lang.String EXC_INVALID_ENTITY_ATTR_NAME
Cause

Exception Message for PersistenceException

Entity attribute name in the view definition XML file is invalid or is not found.

Action Make sure that the entity name is valid. Also, check to make sure that the named attribute does exist in the entity object. The entity object is identified by the EntityUsage element.


EXC_SQLTYPE_NOT_SPECIFIED

public static final java.lang.String EXC_SQLTYPE_NOT_SPECIFIED
Cause

Exception Message for PersistenceException

Attribute definition found in XML file is invalid. It is missing SQLType value.

Action Correct the error in the XML file.


EXC_INVALID_VIEWLINK_DEFN

public static final java.lang.String EXC_INVALID_VIEWLINK_DEFN
Cause

Exception Message for PersistenceException

The view link definition in the XML file is missing either the source or destination view link end. For a view link XML file, two elements named ViewLinkDefEnd should be found.

Action Crrect the error in the XML file.


EXC_XML_CONTEXT_LOOKUP

public static final java.lang.String EXC_XML_CONTEXT_LOOKUP
Cause

Exception Message for PersistenceException

Meta object name passed for lookup is invalid.

Action Normally, the meta object name is a dot-separated name of the meta object. For an entity object named Emp in package1.example, the correct name would be "package1.example.Emp". To correct, locate where the invalid name is coming from (could be meta object names mentioned in an XML file, or the name of the project, etc.) and change the name to a valid one.


EXC_XML_CONTEXT_BIND

public static final java.lang.String EXC_XML_CONTEXT_BIND
Cause

Exception Message for

???

Action ???


EXC_CANNOT_SET_USER_QUERY_WITH_VL

public static final java.lang.String EXC_CANNOT_SET_USER_QUERY_WITH_VL
Cause

Exception Message for InvalidOperException

It is invalid to try to set customer query (calling setQuery()) on a view object if it is the detail view object in a master detail view link.

Action Do not call setQuery() if the view object is a detail.


EXC_INVALID_ENTITYASSOC_DEFN

public static final java.lang.String EXC_INVALID_ENTITYASSOC_DEFN
Cause

Exception Message for PersistenceException

Entity association definition in an XML file is invalid. In particular, this error means that either of the two association ends ("AssociationEnd" elements in the XML file) are missing "Attributes", which lists source or destination attributes.

Action Correct the error(s) in the XML file.


EXC_INSERT_WITH_NO_ATTR_SET

public static final java.lang.String EXC_INSERT_WITH_NO_ATTR_SET
Cause

Exception Message for InvalidOperException

An attempt was made to post a row with no attribute set. Some database (in particular Oracle) does not allow an INSERT statement with no VALUE's.

Action Set some attributes on the row before attempting to insert it into the database.


EXC_REMOVE_WITH_DETAILS

public static final java.lang.String EXC_REMOVE_WITH_DETAILS
Cause

Exception Message for JboException

Attempting to remove a master which has detail entities. In case of composition, a master cannot be removed if it has details.

Action Remove all the details of this master by accessing the details via an association and removing all of them.


EXC_NO_MATCHING_EO_BASE

public static final java.lang.String EXC_NO_MATCHING_EO_BASE
Cause

Exception Message for InvalidOperException

The application code tried to take a row from one row set (or view object) and insert it into another row set (view object). In response, BC4J will make a "copy" of the row in the new row set. This new row will share references to the underlying entity objects. However, if the source and destination row sets do not share any EO bases at all, this operation will fail as it does not find any entit rows to share.

Action When attempting to take a row from one row set and insert into another, make sure that they share at least one EO base.


EXC_XML_MISSING_DTD

public static final java.lang.String EXC_XML_MISSING_DTD
Cause

Exception Message for PersistenceException

A NullPointerException was thrown while parsing XML file. One possible cause for this is that the DTD file is missing (oracle.jbo.dtd.jbo*.dtd).

Action Make sure the appropriate DTD file is present.


EXC_CUSTOM_CLASS_NOT_FOUND

public static final java.lang.String EXC_CUSTOM_CLASS_NOT_FOUND
Cause

Exception Message for CustomClassNotFoundException

Custom class could not be found and loaded. The custom class may be for a component (e.g., view object), a definition (e.g., view definition), or a row (e.g., view row, entity row).

Action Make sure that the named class is reachable from the CLASSPATH. The detail exception (if present) will give you more specific reason why the attempt to locate and load the custom class failed.


EXC_CUSTOM_CLASS_NOT_ASSIGNABLE

public static final java.lang.String EXC_CUSTOM_CLASS_NOT_ASSIGNABLE
Cause

Exception Message for CustomClassNotFoundException

Custom class was found and loaded, but it is invalid in that it is not assignable to a framework (super) class.

Action Make sure that the custom class subclasses the appropriate framework (super) class.


EXC_XML_CREATE_INITIAL_CONTEXT

public static final java.lang.String EXC_XML_CREATE_INITIAL_CONTEXT
Cause

Exception Message for PersistenceException

An error occurred while creating initial context. This error usually carries a detail exception which will give further information on the cause of the error.

Action If BC4J is running inside JServer, make sure that the database user (schema) has the setContextClassLoader permission. To grant this, database system can invoke the following PL/SQL procedure: EXEC DBMS_JAVA.GRANT_PERMISSION('&&1', 'SYS:java.lang.RuntimePermission', 'setContextClassLoader', null);


EXC_ALREADY_LOCKED

public static final java.lang.String EXC_ALREADY_LOCKED
Cause

Exception Message for AlreadyLockedException

This row has already been locked by some other user or transaction.

Action Try locking the row again and the operation should succeed after the other user or transaction has released the lock.


EXC_DML_POST_ENTITY

public static final java.lang.String EXC_DML_POST_ENTITY
Cause

Exception Message for DMLException

Some database error occurred while posting (writing) an entity to the database. This error normally carries a detail exception from database, which will give further information about the database failure.

Action Take a look at the detail exception and address the database problem.


EXC_DML_GENERATE_REF_AND_OID

public static final java.lang.String EXC_DML_GENERATE_REF_AND_OID
Cause

Exception Message for DMLException

A database occurred while trying to generate an object id and object reference. When a new row is created on an entity which maps to a o8 object table, we generate an OID and REF for the new row, executing a SQL statement like "select a.oid, make_ref(, a.oid) ..." Somehow, this statement is failing.

Action To begin, check the following:

1. Are you using the right version of Oracle database?

2. Is the table in question an object table?

This error normally carries a detail exception from database, which will give further information about the database failure. Take a look at the detail exception and address the database problem.


EXC_DML_REF_AND_OID_NOT_SUPPORTED

public static final java.lang.String EXC_DML_REF_AND_OID_NOT_SUPPORTED
Cause

Exception Message for DMLException

An attempt was made to generate an OID and/or REF on a database system that does not support o8 objects.

Action Do not try to create OID or REF on a database system that does not support o8 objects.


EXC_DML_GET_EST_ROW_COUNT

public static final java.lang.String EXC_DML_GET_EST_ROW_COUNT
Cause

Exception Message for DMLException

The application tried to get estimated row count (getEstimatedRowCount()) on a row set. While building the appropriate query statement, executing it, and retrieving the estimated count, an error occurred. This error is accompanied by the SQL statement that caused the error. Also, it normally carries a detail exception from database, which will give further information about the database failure.

Action Take a look at the SQL statement and the detail exception and address the database problem.


EXC_DML_GENERATE_PK_BASED_REF

public static final java.lang.String EXC_DML_GENERATE_PK_BASED_REF
Cause

Exception Message for DMLException

A database occurred while trying to generate an object id from the primary key. This operation is valid only if the table in question is an object table and if the table specifies that the REF is PK based.

Action To begin, check the following:

1. Are you using the right version of Oracle database?

2. Is the table in question an object table?

3. Does this object table use PK-based REF?

This error normally carries a detail exception from database, which will give further information about the database failure. Take a look at the detail exception and address the database problem.


EXC_DML_PK_BASED_REF_NOT_SUPPORTED

public static final java.lang.String EXC_DML_PK_BASED_REF_NOT_SUPPORTED
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Cause

Exception Message for

Action


EXC_JDBC_REGISTER_DRIVER

public static final java.lang.String EXC_JDBC_REGISTER_DRIVER
Cause

Exception Message for DMLException

A SQLException occured while trying to register a jdbc driver.

Action Fix the underlying SQLException


EXC_JDBC_OPEN_CONNECTION

public static final java.lang.String EXC_JDBC_OPEN_CONNECTION
Cause

Exception Message for DMLException

A SQLException occured while trying to open a jdbc connection.

Action Fix the underlying SQLException


EXC_JDBC_CLOSE_CONNECTION

public static final java.lang.String EXC_JDBC_CLOSE_CONNECTION
Cause

Exception Message for DMLException

A SQLException occured while trying to close a jdbc connection.

Action Fix the underlying SQLException


EXC_JDBC_CLOSE_STATEMENT

public static final java.lang.String EXC_JDBC_CLOSE_STATEMENT
Cause

Exception Message for DMLException

A SQLException occured while trying to close a jdbc connection.

Action Fix the underlying SQLException


EXC_JDBC_COMMIT

public static final java.lang.String EXC_JDBC_COMMIT
Cause

Exception Message for

A SQLException occured during the commit phase of this transaction.

Action Fix the underlying SQLException


EXC_JDBC_ROLLBACK

public static final java.lang.String EXC_JDBC_ROLLBACK
Cause

Exception Message for DMLException

A SQLException occured during the rollback phase of this transaction.

Action Fix the underlying SQLException


EXC_JDBC_COLUMN_DEFN

public static final java.lang.String EXC_JDBC_COLUMN_DEFN
Cause

Exception Message for DMLException

A SQLException occured while setting up meta-data jdbc Statement.

Action Fix the underlying SQLException. There might be a data-type mismatch between the attributes of the ViewObject and columns in the SQL for it.


EXC_ENTITY_SELECT

public static final java.lang.String EXC_ENTITY_SELECT
Cause

Exception Message for DMLException

An unexpected exception occured while executing the SQL to fetch data for an entity instance or lock it.

Action Fix the cause for the SQLException in the details of this exception.


EXC_JDBC_GET_SQL_DATUM

public static final java.lang.String EXC_JDBC_GET_SQL_DATUM
Cause

Exception Message for SQLDatumException

A SQLException occured when converting data from jdbc to oracle.jbo.domain.Struct attributes.

Action Fix the conversion errors as suggested in SQLException.


EXC_AFTER_COMMIT

public static final java.lang.String EXC_AFTER_COMMIT
Cause

Exception Message for AfterCommitException

An exception occured in the afterCommit notification phase of the transaction

Action Verify the exception in the details of this exception and fix the failing afterCommit() overridden methods in the Entities or transient TransactionListener objects registered with the transaction to listen into the commit/rollback cycle.


EXC_AFTER_POST

public static final java.lang.String EXC_AFTER_POST
Cause

Exception Message for AfterPostException

An exception occured in the afterPost phase of the transaction

Action Verify the exception in the details of this exception and fix the failing afterPost() overridden methods in the Entities or transient TransactionPostListener objects registered with the transaction to listen into the post cycle.


EXC_AFTER_ROLLBACK

public static final java.lang.String EXC_AFTER_ROLLBACK
Cause

Exception Message for AfterRollbackException

An exception occured in afterRollback notification phase of the transaction

Action Verify the exception in the details of this exception and fix the failing afterCommit() overridden methods in the Entities or transient TransactionListener objects registered with the transaction to listen into the commit/rollback cycle.


EXC_READONLY_ASSOC_ATTR

public static final java.lang.String EXC_READONLY_ASSOC_ATTR
Cause

Exception Message for ReadOnlyAttrException

This association attribute is marked readonly

Action Cannot modify the value of the association attribute as it's marked readonly.


EXC_VAL_ENTITY_VALIDATE_FAILED

public static final java.lang.String EXC_VAL_ENTITY_VALIDATE_FAILED
Cause

Exception Message for AttrSetValException

A custom validation rule failed to validate an attribute value.

Action Fix the attribute value so that it passes the custom validation rule.


EXC_VAL_VO_VALIDATE_FAILED

public static final java.lang.String EXC_VAL_VO_VALIDATE_FAILED
Cause

Exception Message for ValidationException

Modified or new entities in this ViewObject failed to validate.

Action Fix the failing entity values and revalidate the ViewObject.


EXC_VAL_ENTITY_ATTR_SET_FAILED

public static final java.lang.String EXC_VAL_ENTITY_ATTR_SET_FAILED
Cause

Exception Message for ReadOnlyAttrException

Attempting to modify a readOnly entity-attribute

Action DO not modify a readonly attribute value.


EXC_VAL_APPMOD_VALIDATE_FAILED

public static final java.lang.String EXC_VAL_APPMOD_VALIDATE_FAILED
Cause

Exception Message for ValidationException

Modified or new Entities within this application module or a nested application module failed to valide.

Action Fix the failing entities and then re-validate this application module.


EXC_VAL_ATTRIBUTE_NOT_FOUND

public static final java.lang.String EXC_VAL_ATTRIBUTE_NOT_FOUND
Cause

Exception Message for AttrValException

An attribute cannot be found by the given name during validation.

Action Entity meta-data could be corrupt as there's an attribute which is to be validated but no definition could be found for that attribute in the meta-data.


EXC_VAL_VR_VALIDATE_FAILED

public static final java.lang.String EXC_VAL_VR_VALIDATE_FAILED
Cause

Exception Message for ReadOnlyAttrException

Attempting to modify value for a read-only attribute.

Action Cannot modify the value for a read-only attribute. Reset the readonly flag for the failing attribute or do not modify the value for the failing attribute.


EXC_VAL_VR_ATTR_SET_FAILED

public static final java.lang.String EXC_VAL_VR_ATTR_SET_FAILED
Cause

Exception Message for

Action


EXC_VAL_VR_BATCH_ATTR_SET_FAILED

public static final java.lang.String EXC_VAL_VR_BATCH_ATTR_SET_FAILED
Cause

Exception Message for ValidationException

Attempting to validate entities and attributes failed during validation of buffered attributes in Deferred Validation mode (Not available in 3.x)

Action Fix the failure cases.


EXC_VAL_PRECISION_VALIDATOR

public static final java.lang.String EXC_VAL_PRECISION_VALIDATOR
Cause

Exception Message for ValidatonException

For strings, the length of the string value provided for an attribute is more than the max-length this attribute expects. For Numeric values, the length of the value (in string form) is more than what the attribute expects

Action Fix the attribute value with respect to the precision and scale information for the failing attribute.


EXC_VAL_ATTR_SET_FAILED

public static final java.lang.String EXC_VAL_ATTR_SET_FAILED
Cause

Exception Message for AttrSetValException

A validation rule for an attribute failed either due to an unexpected exception in validating the attribute with that rule or due to failure in evaluting the NOT operation on the rule.

Action Fix the attribute value so that it validates against the failing rule.


EXC_VAL_METHOD_ON_ROW_FAILED

public static final java.lang.String EXC_VAL_METHOD_ON_ROW_FAILED
Cause

Exception Message for ValidationException

The custom method validator attached to an entity returned false indicating a failure in the validation for that entity.

Action Fix the cause for failure in the custom validation method for this attribute.


EXC_VAL_METHOD_ON_ATTR_SET_FAILED

public static final java.lang.String EXC_VAL_METHOD_ON_ATTR_SET_FAILED
Cause

Exception Message for ValidationException

The custom method validator attached to an attribute returned 'false' indicating a failure in validation for that attribute in the custom method.

Action Fix the cause for failure in the custom validator method for this attribute.


EXC_VAL_ATTR_MANDATORY

public static final java.lang.String EXC_VAL_ATTR_MANDATORY
Cause

Exception Message for AttrValException

The attribute value could not be null as it's been marked mandatory.

Action Provide a non-null value for the mandatory attributes.


EXC_VAL_INVALID_CONTAINED_ENTITIES

public static final java.lang.String EXC_VAL_INVALID_CONTAINED_ENTITIES
Cause

Exception Message for ValidationException

In validating a master, found some children entities that could not be validated. This occurs only in the case when there's a composition association between the master and detail entities.

Action Fix the attribute values in the children entities so that they are valid when the children entities are validated by the master


EXC_INVALID_ATTRIBUTE_KIND

public static final java.lang.String EXC_INVALID_ATTRIBUTE_KIND
Cause

Exception Message for InvalidAttrKindException

An unexpected attribute kind found in the definition for a ViewObject.

Action Fix the attribute kind information in the xml-meta-data definition for attributes in this viewobject.


EXC_KEY_NOT_FOUND

public static final java.lang.String EXC_KEY_NOT_FOUND
Cause

Exception Message for KeyNotFoundException

While loading the meta-data definition for this Entity, there was no attribute marked to be primary key attribute.

Action Set atleast one attribute as primary key attribute for this entity type, so that entities of this type could be uniquely identified.


EXC_VAL_ATTR_SET_TYPE_MISMATCH

public static final java.lang.String EXC_VAL_ATTR_SET_TYPE_MISMATCH
Cause

Exception Message for AttrSetValException

The type of attribute value provided as argument to the set method for this attribute is not an instance of the java-type that this attribute expects.

Action Convert the argument to a proper java type such that it is an instance of the java-type that this attribute expects


EXC_VAL_ATTR_RESOLVEGET_FAILED

public static final java.lang.String EXC_VAL_ATTR_RESOLVEGET_FAILED
Cause

Exception Message for AttrGetValException

An unexpected exception occured in set method. Getter methods should throw a subclass of JboException so that custom exception messages are thrown/shown to the caller. This exception could also be thrown if the getter is not a public java method.

Action Do not throw any exception other than sub-classes of JboException from any business logic code in the getter method for an attribute. Also verify that the getter method is a public java method. Action


EXC_VAL_ATTR_RESOLVESET_FAILED

public static final java.lang.String EXC_VAL_ATTR_RESOLVESET_FAILED
Cause

Exception Message for

An unexpected exception occured in set method. Setter methods should throw a subclass of JboException so that custom exception messages are thrown/shown to the caller. This exception could also be thrown if the setter is not a public java method.

Action Do not throw any exception other than sub-classes of JboException from any business logic code in the setter method for an attribute. Also verify that the setter method is a public java method.


EXC_ATTR_LOAD_DATUM_EXCEPTION

public static final java.lang.String EXC_ATTR_LOAD_DATUM_EXCEPTION
Cause

Exception Message for AttributeLoadException

An unexpected exception occured during fetching values from a jdbc-resultset into an Attribute for a row object. There could be conversion errors between the return type from jdbc for the attribute and it's java type.

Action Verify that the jdbc-sql type and java type for the attribute are compatible. Fix any conversion errors or domain exceptions that are in the details of this exception.


EXC_ATTR_LOAD_EXCEPTION

public static final java.lang.String EXC_ATTR_LOAD_EXCEPTION
Cause

Exception Message for AttributeLoadException

An unexpected exception occured during fetching values from a jdbc-resultset into an Attribute for a row object. There could be conversion errors between the return type from jdbc for the attribute and it's java type.

Action Verify that the jdbc-sql type and java type for the attribute are compatible. Fix any conversion errors or domain exceptions that are in the details of this exception.


EXC_DEAD_ENTITY_ACCESS

public static final java.lang.String EXC_DEAD_ENTITY_ACCESS
Cause

Exception Message for DeadEntityAccessException

Trying to refer to an invalid/obsolete entity. This could occur if some business logic has held on to an entity reference which was removed and the transaction has been posted or committed. It could also occur if a reference entity has been removed from the cache and any ViewRow is attempting to access it.

Action Use findByPrimaryKey to find a valid entity of the desired key instead of holding on to a reference to an entity instance.


EXC_DEAD_VIEW_ROW_ACCESS

public static final java.lang.String EXC_DEAD_VIEW_ROW_ACCESS
Cause

Exception Message for DeadViewRowAccessException

Trying to access a ViewRow which is part of an obsolete/invalid collection. This could happen if a reference to the ViewRow is held by some business logic while the containing ViewObject was removed.

Action Find the referenced ViewRow either by re-querying or using findByKey methods to get a valid reference to the ViewRow.


EXC_SQL_EXECUTE_QUERY

public static final java.lang.String EXC_SQL_EXECUTE_QUERY
Cause

Exception Message for SQLStmtException

Failed to execute a query. This could occur when trying to execute a query for a SQLValue domain class or a Sequence domain.

Action Fix the cause for the SQLException thrown by JDBC found in the details of this exception.


EXC_SQL_EXECUTE_COMMAND

public static final java.lang.String EXC_SQL_EXECUTE_COMMAND
Cause

Exception Message for SQLStmtException

Failed to execute a SQL statement.

Action Fix the cause for the SQLException thrown by JDBC found in the details of this exception.


EXC_SQL_PREPARE_STATEMENT

public static final java.lang.String EXC_SQL_PREPARE_STATEMENT
Cause

Exception Message for SQLStmtException

Failed to prepare a JDBC PreparedStatement.

Action Fix the cause for the SQLException thrown by JDBC found in the details of this exception.


EXC_SQL_PREPARE_CALL

public static final java.lang.String EXC_SQL_PREPARE_CALL
Cause

Exception Message for SQLStmtException

Failed to prepare a JDBC CallableStatement.

Action Fix the cause for the SQLException thrown by JDBC found in the details of this exception.


EXC_SQL_CREATE_STATEMENT

public static final java.lang.String EXC_SQL_CREATE_STATEMENT
Cause

Exception Message for SQLStmtException

Failed to create a JDBC Statement object with the given set of parameters

Action Fix the cause for the SQLException thrown by JDBC found in the details of this exception.


EXC_PCOLL_NO_PERSIST_MGR_CLASS

public static final java.lang.String EXC_PCOLL_NO_PERSIST_MGR_CLASS
Cause

Exception Message for

Action


EXC_PCOLL_CONNECT

public static final java.lang.String EXC_PCOLL_CONNECT
Cause

Exception Message for

Action


EXC_PCOLL_CREATE_CONTROL_TAB

public static final java.lang.String EXC_PCOLL_CREATE_CONTROL_TAB
Cause

Exception Message for

Action


EXC_PCOLL_INSERT_CONTROL_ROW

public static final java.lang.String EXC_PCOLL_INSERT_CONTROL_ROW
Cause

Exception Message for

Action


EXC_PCOLL_LOCK_CONTROL_ROW

public static final java.lang.String EXC_PCOLL_LOCK_CONTROL_ROW
Cause

Exception Message for

Action


EXC_PCOLL_UPDATE_CONTROL_ROW

public static final java.lang.String EXC_PCOLL_UPDATE_CONTROL_ROW
Cause

Exception Message for

Action


EXC_PCOLL_CREATE_TAB

public static final java.lang.String EXC_PCOLL_CREATE_TAB
Cause

Exception Message for

Action


EXC_PCOLL_COMMIT

public static final java.lang.String EXC_PCOLL_COMMIT
Cause

Exception Message for

Action


EXC_PCOLL_CLOSE

public static final java.lang.String EXC_PCOLL_CLOSE
Cause

Exception Message for

Action


EXC_PCOLL_GETCURTIME

public static final java.lang.String EXC_PCOLL_GETCURTIME
Cause

Exception Message for

Action


EXC_PCOLL_PASSIVATE

public static final java.lang.String EXC_PCOLL_PASSIVATE
Cause

Exception Message for

Action


EXC_PCOLL_ACTIVATE

public static final java.lang.String EXC_PCOLL_ACTIVATE
Cause

Exception Message for

Action


EXC_PCOLL_INSERT_ROW

public static final java.lang.String EXC_PCOLL_INSERT_ROW
Cause

Exception Message for

Action


EXC_PCOLL_UPDATE_ROW

public static final java.lang.String EXC_PCOLL_UPDATE_ROW
Cause

Exception Message for

Action


EXC_PCOLL_DELETE_ROW

public static final java.lang.String EXC_PCOLL_DELETE_ROW
Cause

Exception Message for

Action


EXC_PCOLL_RETRIEVE_ROW

public static final java.lang.String EXC_PCOLL_RETRIEVE_ROW
Cause

Exception Message for

Action


EXC_PCOLL_RETRIEVE_BY_ID

public static final java.lang.String EXC_PCOLL_RETRIEVE_BY_ID
Cause

Exception Message for

Action


EXC_PCOLL_INVALID_ID

public static final java.lang.String EXC_PCOLL_INVALID_ID
Cause

Exception Message for

Action


EXC_PCOLL_OBJ_ALREADY_ACTIVE

public static final java.lang.String EXC_PCOLL_OBJ_ALREADY_ACTIVE
Cause

Exception Message for

Action


EXC_PCOLL_CHILD_ID_NOT_FOUND

public static final java.lang.String EXC_PCOLL_CHILD_ID_NOT_FOUND
Cause

Exception Message for

Action


EXC_PCOLL_DELETE_ALL

public static final java.lang.String EXC_PCOLL_DELETE_ALL
Cause

Exception Message for

Action


EXC_PCOLL_INVALID_ROOT_NODE

public static final java.lang.String EXC_PCOLL_INVALID_ROOT_NODE
Cause

Exception Message for

Action


EXC_VALIDATION_THRESHOLD_REACHED

public static final java.lang.String EXC_VALIDATION_THRESHOLD_REACHED
Cause

Exception Message for JboException

Invalid entities still found in the validation list of the transaction after attempting to validate all invalid entities for the VALIDATION_THRESHOLD (by default 10) times.

Action Fix any logic that invalidates Entity instances in the validaton cycle (perhaps in overridden validateEntity() methods) such that all entities are valid before the VALIDATION_THRESHOLD limit is reached.


EXC_POST_THRESHOLD_REACHED

public static final java.lang.String EXC_POST_THRESHOLD_REACHED
Cause

Exception Message for JboException

There are invalid entities or entities in the post list of the transaction after trying to post all changes for the POST_THRESHOLD (by default 10) times.

Action Fix any logic that places Entities in the transaction's list of entities to be validated or posted in the post cycle, such that all entites get posted before the POST_THRESHOLD is reached.


EXC_ENTITIES_INV_IN_B4_COMMIT

public static final java.lang.String EXC_ENTITIES_INV_IN_B4_COMMIT
Cause

Exception Message for JboException

Invalid entity instances found in the transaction in the beforeCommit phase.

Action Fix any business logic that invalides entity instances in postChanges() such that there are no more invalid entities after all changes are posted during the commit cycle.


EXC_UNEXPECTED_EXCEPTION

public static final java.lang.String EXC_UNEXPECTED_EXCEPTION
Cause

Exception Message for JboException

If an unexpected exception occurs during a framework operation, this exception is thrown, with the un-expected exception included in the details of this exception

Action Fix the cause for the exception in the details for this JboException.


EXC_STRING_MISMATCH

public static final java.lang.String EXC_STRING_MISMATCH
Cause

Exception Message for

Action


EXC_IDENT_MISMATCH

public static final java.lang.String EXC_IDENT_MISMATCH
Cause

Exception Message for

Action


EXC_TOO_MANY_RIGHT_PARENS

public static final java.lang.String EXC_TOO_MANY_RIGHT_PARENS
Cause

Exception Message for

Action


EXC_TOO_MANY_LEFT_PARENS

public static final java.lang.String EXC_TOO_MANY_LEFT_PARENS
Cause

Exception Message for

Action


EXC_VAR_UNEXPECTED_TYPE

public static final java.lang.String EXC_VAR_UNEXPECTED_TYPE
Cause

Exception Message for VariantException

Unexpected type was provided to Variant utility.

Action Provide an expected type as reported in the exception.


EXC_VAR_INVALID_VARIANT_TYPE

public static final java.lang.String EXC_VAR_INVALID_VARIANT_TYPE
Cause

Exception Message for VariantException

The data-type passed to the Variant utility from a Validation rule is invalid. This could be due to a corrupt xml-meta-data definition in the component's xml file.

Action Fix the component xml for the offending validation rule.


EXC_VAR_INVALID_VARIANT_NAME

public static final java.lang.String EXC_VAR_INVALID_VARIANT_NAME
Cause

Exception Message for VariantException

The name of the variant type passed to the Variant utility from a Validation rule is invalid. This could be due to a corrupt xml meta data definition in the component's xml file.

Action Fix the component xml for the offending validation rule.

Constructor Detail

CSMessageBundle

public CSMessageBundle()
Method Detail

getContents

public java.lang.Object[][] getContents()
Gets the key-value association table.
Overrides:
getContents in class CheckedListResourceBundle
Returns:
an array of key-value pairs.

Business Components