uk.org.ogsadai.exception
Class DAIException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--uk.org.ogsadai.exception.DAIException
All Implemented Interfaces:
DAIExceptionInformation, java.io.Serializable
Direct Known Subclasses:
ActivityConfigurationException, ActivityConfigurationPropertyException, ActivityCreationException, ActivityExecutionException, ActivitySpecificationException, ActivityStreamNotFoundException, ActivityTypesCreationException, AssemblePerformDocumentException, AuthorisationException, AuthorizationExecutionException, AuthorizationInitialisationException, BlockAggregatorSizeException, BlockMakerException, BufferDataForResponseException, CoGUtilAccessException, CreateResourceConfigDirectoryException, CreateResourceConfigFileException, CSVConfigurationException, CSVParseException, CustomiseResourceConfigFileException, DAIAuthorizationException, DAIClassCreateException, DAIClassMissingInterfaceException, DAIClassMissingMethodException, DAIClassNotFoundException, DAIClassSecurityException, DAIConfigDirectoryException, DAICredentialException, DAIEPRConstructionException, DAIFileException, DAIIOException, DAIMalformedURLException, DAIMDSRegistrationException, DAIMDSRegistrationFailureException, DAIMethodInvocationException, DAINumberFormatException, DAIOutOfBoundsException, DAIProjectionException, DAIResourceContextException, DAIResourceException, DAIResourceReadIOException, DAIUnknownHostException, DAIUnsupportedURLProtocolException, DAIURLContentException, DAIURLReadIOException, DataFormatException, DataResourceAccessorConfigException, DataResourceAccessorCreationException, DataResourceAccessorMetaDataException, DataResourceAccessorSetupException, DataResourceUseException, DataStoreXMLTextException, DeploymentParamParseException, DocumentValidationException, DuplicateActivityPropertyKeyException, DuplicatePipeException, DynamicDataServiceResourceCreationException, DynamicDataServiceResourceRemovalException, DynamicPropertyCreationException, FileMatchExpressionException, GridCredentialAccessException, GTResourcePropertySetUpdateException, IllegalConcurrencySettingException, IllegalDelimiterException, IllegalIndexedFileQueryException, InvalidActivityClassException, JDBCCloseConnectionException, JDBCConnectionAccessException, MalformedRegexpPatternException, MalformedReplacementStringException, MaxRequestTimeoutException, MaxSessionParticipantsException, MessageContextException, MetaDataExtractionException, MissingDeploymentParamException, MissingKeyClassException, MissingParametersException, MissingPerformDocException, MissingXSLTException, NoActivityOutputException, NoAnalyzerException, NoGridCredentialException, NoIndexerException, NonIncreasingSequenceException, NoSuchResourceIDException, ParameterAccessException, ParameterDuplicationException, ParameterSetupException, ParametersUnsupportedException, PersistResourceNameFileException, PropertyValueException, ReaderClosedException, RelationalSchemaParseException, RemoveResourceNameFileException, RequestCreationException, RequestException, RequestExecutionException, RequestMaximumReachedException, RequestSpecificationException, RequestStatusException, ResourceBusyException, ResourceCreationException, ResourceFactoryUtilCreateException, ResourceFileException, ResourceIDAlreadyAssignedException, ResourceKeyInvalidException, ResourceRequestExecutionException, ResourceRequestSpecificationException, ResourceUnknownException, ResourceUnknownException, ResultSetHandlerColumnException, ResultSetHandlerException, ResultSetTableMetaDataException, RoleMapCannotAuthorizeException, RoleMapConfigurationException, RoleMapperCreationException, ServerException, ServerException, ServiceCommsException, ServiceGroupRegistrationConfigException, ServiceGroupRegistrationException, ServletStreamAccessException, SessionAttrCreationException, SessionAttrValueCreationException, SessionCoordinatorCreationException, SessionCreationException, SessionJoinDeniedException, SessionJoinException, SessionLookupException, SessionManagerCreationException, SessionManagerFactoryCreationException, SessionNotFoundException, SessionReleaseException, SessionRequestException, SessionStreamClosedException, SessionStreamDuplicateException, SessionStreamIOException, SessionStreamNotFoundException, SessionStreamRequestNotProcessingException, SessionTerminationException, SessionViewCreationException, SOAPAttachmentException, StaticSessionAttrException, StreamDataException, UnknownRequestStatusException, UnknownSMTPHostException, UnsupportedActivityException, UnsupportedBlockException, UnsupportedRegexpPatternFormatException, WebRowSetParseException, WebRowSetResultSetParseException, XMLDBCloseCollectionException, XMLDBCollectionAccessException, XMLDBCommandCreationException, XMLDBCommandExecutionException, XMLDBCommandSpecificationException, XMLDBCreateCollectionException, XMLDBCreateResourceException, XMLDBListCollectionsException, XMLDBListResourcesException, XMLDBRegistrationException, XMLDBRemoveCollectionException, XMLDBRemoveResourceException, XMLDBResourceException, XMLDBStreamNotFoundException, XMLDBUnknownCollectionException, XMLDBUnsupportedCommandException, XMLEmptyAttributeException, XMLEmptyElementException, XMLFileException, XMLMissingAttributeException, XMLMissingElementException, XMLParseException, ZIPArchiveCommentLengthException

public abstract class DAIException
extends java.lang.Exception
implements DAIExceptionInformation

Base class for OGSA-DAI checked exceptions.

Author:
The OGSA-DAI Project Team
See Also:
Serialized Form

Field Summary
private static?java.lang.String COPYRIGHT_NOTICE
???????????
private ?ErrorID mErrorID
???????????
private ?java.lang.Object[] mParameters
???????????
private ?DAIUniqueID mUniqueID
???????????
?
Fields inherited from class java.lang.Exception
?
Fields inherited from class java.lang.Throwable
?
Constructor Summary
protected DAIException()
??????????No-argument constructor used by sub-classes that need to perform work before the error ID and parameters are known.
? DAIException(ErrorID?errorID)
??????????Constructs an exception corresponding to the given error ID.
? DAIException(ErrorID?errorID, java.lang.Object[]?parameters)
??????????Constructs an exception corresponding the given error ID and parameters.
?
Method Summary
?ErrorID getErrorID()
??????????Gets the error ID.
?DAIUniqueID getExceptionID()
??????????Gets the unique ID associated with this exception.
?java.lang.String getLocalizedMessage()
??????????Gets a localized message describing the error.
?java.lang.String getMessage()
??????????Gets a message describing the error.
?java.lang.Object[] getParameters()
??????????Gets the parameters associated with the error.
?boolean hasChild()
??????????Gets whether there is a child exception.
protected ?void setErrorID(ErrorID?errorID)
??????????Sets the error ID.
protected ?void setParameters(java.lang.Object[]?parameters)
??????????Sets the error parameters.
?
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
?
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
?

Field Detail

COPYRIGHT_NOTICE

private static final java.lang.String COPYRIGHT_NOTICE
See Also:
Constant Field Values

mErrorID

private ErrorID mErrorID

mParameters

private java.lang.Object[] mParameters

mUniqueID

private DAIUniqueID mUniqueID
Constructor Detail

DAIException

protected DAIException()
No-argument constructor used by sub-classes that need to perform work before the error ID and parameters are known. If this constuctor is used the caller must subsequently set the error ID and possibly the parameters.


DAIException

public DAIException(ErrorID?errorID)
Constructs an exception corresponding to the given error ID. This error ID is associated with no parameters.

Parameters:
errorID - Error ID identifying the error type.

DAIException

public DAIException(ErrorID?errorID,
                    java.lang.Object[]?parameters)
Constructs an exception corresponding the given error ID and parameters.

Parameters:
errorID - Error ID identifying the error type.
parameters - Parameters associated with the error.
Method Detail

getErrorID

public ErrorID getErrorID()
Gets the error ID.

Specified by:
getErrorID in interface DAIExceptionInformation
Returns:
the error ID.

getParameters

public java.lang.Object[] getParameters()
Gets the parameters associated with the error.

Specified by:
getParameters in interface DAIExceptionInformation
Returns:
the parameters accociated with the error. If there are no parameters associated with the error then the array length will be 0.
See Also:
DAIExceptionInformation.getParameters()

getExceptionID

public DAIUniqueID getExceptionID()
Gets the unique ID associated with this exception.

Specified by:
getExceptionID in interface DAIExceptionInformation
Returns:
the unique ID associated with the exception.
See Also:
DAIExceptionInformation.getExceptionID()

hasChild

public boolean hasChild()
Gets whether there is a child exception.

Specified by:
hasChild in interface DAIExceptionInformation
Returns:
true if there is a child exception, false otherwise.
See Also:
DAIExceptionInformation.hasChild()

getMessage

public java.lang.String getMessage()
Gets a message describing the error.

Specified by:
getMessage in interface DAIExceptionInformation
Overrides:
getMessage in class java.lang.Throwable
Returns:
the string describing the error of the form [uniqueID] key : param1 , param2 , ....
See Also:
Throwable.getMessage()

getLocalizedMessage

public java.lang.String getLocalizedMessage()
Gets a localized message describing the error.

Specified by:
getLocalizedMessage in interface DAIExceptionInformation
Overrides:
getLocalizedMessage in class java.lang.Throwable
Returns:
the string describing the error.
See Also:
Throwable.getLocalizedMessage()

setErrorID

protected void setErrorID(ErrorID?errorID)
Sets the error ID. Used by sub-classes that are unable to specify the error ID when the constructor was called.

Parameters:
errorID - Error ID identifying the error type.

setParameters

protected void setParameters(java.lang.Object[]?parameters)
Sets the error parameters. Used by sub-classes that are unable to specify the parameters when the constructor was called.

Parameters:
parameters - Parameters associated with the error.