Exception subclasses

Within this CWException class are subclasses that identify particular exceptions possible in the methods of the Java connector library. Table 142 lists the subclassed exceptions.

Table 142. CWConnectorException subclasses

Exception subclass Definition
ArchiveFailedException
Thrown from the archiveEvent() method of the event-store class if the event record could not be archived into the archive store.
AttributeNotFoundException
Thrown when the specified position or name of an attribute does not match the attribute name or attribute position within the existing business object.
AttributeNullValueException
Thrown if the attribute value is null when some operations need to be performed on the attribute value.
AttributeValueException
Thrown if there is a NumberFormatException exception.
ConnectionFailureException
Thrown if the connector is unable to establish a connection with the application.
DataHandlerCreateException
Thrown when a data-handler method cannot instantiate a data handler for the specified MIME type.
DefaultSettingFailedException
Thrown when setting a default value fails.
DeleteFailedException
Thrown from the deleteEvent() method of the event-store class if the event record could not be deleted from the event store.
InProgressEventRecoveryFailedException
Thrown if the recovery of the In-Progress events fails.
InvalidAttributePropertyException
Thrown when any invalid property of the attribute is queried (such as calling getMaxLength() on an attribute that is an object).
InvalidStatusChangeException
Thrown if the requested change in event status is not valid.
InvalidVerbException
Thrown when the specified verb is not supported by the business object.
LogonFailedException
Thrown if the connector is not able to logon to the application with the user name and password provided.
NotSupportedException
Thrown if some feature is not supported by the current version of the produce.
ParseException
Thrown when the data handler (called from the connector) encounters some error during conversion between the business object and the specified MIME type.
PropertyNotSetException
Thrown if a required connector configuration property is not set.
SpecNameNotFoundException
Thrown when the business object definition for creating a business object cannot be found.
StatusChangeFailedException
Thrown if the connector is not able to set the status of an event in the application's event store.
VerbProcessingFailedException
Thrown from the doVerbFor() method if the operation specified by the verb fails.
WrongASIFormatException
Thrown if the application-specific information is not in the format: name=value
WrongAttributeException
Thrown when the data type of the specified attribute does not match the data type that the attribute is defined to hold.

Table 143. Methods that return exceptions

Java connector library exception Method that returns the exception
SpecNameNotFoundException
CWConnectorUtil


createBusObj()

CWConnectorBusObj


setBusObjValue()
AttributeNotFoundException
CWConnectorBusObj


getAttrIndex()


getbooleanValue()


getBusObjValue()


getCardinality()


getDefault()


getDefaultboolean()


getDefaultdouble()


getDefaultfloat()


getDefaultint()


getDefaultlong()


getDefaultString()


getdoubleValue()


getfloatValue()


getintValue()


getlongValue()


getMaxLength()


getObjectCount()


getStringValue()


getTypeName()


getTypeNum()


hasCardinality()


hasName()


hasType()


isForeignKeyAttr()


isKeyAttr()


isMultipleCard()


isObjectType()


isRequiredAttr()


isType()


removeAllObjects()


removeBusinessObjectAt()


setbooleanValue()


setBusObjValue()


setdoubleValue()


setfloatValue()


setintValue()


setStringValue()
WrongAttributeException
CWConnectorBusObj


getbooleanValue()


getBusObjValue()


getDefaultboolean()


getDefaultdouble()


getDefaultfloat()


getDefaultint()


getDefaultlong()


getDefaultString()


getdoubleValue()


getfloatValue()


getintValue()


getlongValue()


getStringValue()


setbooleanValue()


setBusObjValue()


setdoubleValue()


setfloatValue()


setintValue()


setStringValue()
AttributeNullValueException
CWConnectorBusObj


getbooleanValue()


getDefaultboolean()


getDefaultdouble()


getDefaultfloat()


getDefaultint()


getDefaultlong()


getdoubleValue()


getfloatValue()


getintValue()


getlongValue()


setBusObjValue()
AttributeValueException
CWConnectorBusObj


getDefaultdouble()


getDefaultfloat()


getDefaultint()


getDefaultlong()


getdoubleValue()


getfloatValue()


getintValue()


getlongValue()


setbooleanValue()


setBusObjValue()


setdoubleValue()


setfloatValue()


setintValue()


setStringValue()
InvalidAttributePropertyException
CWConnectorBusObj


getMaxLength()
InvalidVerbException
CWConnectorBusObj


setVerb()

Exception subclass constructor

Creates an exception subclass.

Syntax

public exception_subclass(CWConnectorExceptionObject excption)
 

where exception_subclass is the name of the exception subclass (as shown in Table 142).

Parameters

excption
is an exception object that contains information about the exception.

Return values

An object that represents a subclass of the CWException class.

Notes

Use methods of the CWConnectorExceptionObject class to obtain information about the exception.

Copyright IBM Corp. 1997, 2004