uk.org.ogsadai.exception
Class DAIException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          uk.org.ogsadai.exception.DAIException

All Implemented Interfaces:

java.io.Serializable, DAIExceptionInformation

Direct Known Subclasses:

ActivityCleanupException, ActivityConstructionException, ActivityCreationException, ActivityExceptionWrapper, ActivityInitialisationException, ActivityIOIllegalStateException, ActivityProcessingException, ActivitySPARQLException, ActivityTaskProcessingException, ActivityTaskTerminatedException, ActivityTaskUserException, ActivityTerminatedException, ActivityUnknownException, ActivityUnspecifiedResourceException, ActivityUserException, ArraySizeInvalidException, AuthorizationException, BlockMakerException, ByteIteratorException, ClientException, ClientToolkitDAIException, CompilerConfigurationException, ConfigEditorException, ConfigEditorFileException, ConfigFileErrorException, ConfigurationException, ContextInitializationException, CSVConfigurationIllegalDelimeterException, CSVConfigurationIllegalLinebreakException, CSVConfigurationIllegalNullStringException, CSVParseMismatchedColumnSizeException, CSVParseUnexpectedDoubleQuotesException, CSVParseUnexpectedDoubleQuotesInEscapedTextException, DAIAuthorizationException, DAIClassCreateException, DAIClassMissingInterfaceException, DAIClassNotFoundException, DAICloneNotSupportedException, DAIIOException, DAIMalformedURLException, DAIUnsupportedURLProtocolException, DataException, DataResourceUseException, DuplicateResourceNameException, ExecutionException, ExpressionException, ExtensionProcessingException, ExtractLogicalSchemaException, ExtractPhysicalSchemaException, FileException, FileResourceUseException, GridCredentialAccessException, IllegalDataSinkStatusException, IllegalDataSourceStatusException, IllegalIndexedFileQueryException, IllegalRequestExecutionStatusException, InvalidSequenceNumberException, JDBCCloseConnectionException, JDBCConnectionAccessException, JDBCPoolAlreadyRegisteredException, KeyPatternNotExistException, KeyValueIllegalException, MalformedListBeginException, MalformedListEndException, MalformedListException, MetaDataInitializationException, MismatchedColumnCountException, MismatchedColumnNameException, MismatchedColumnTypeException, NestedSequencesUnsupportedException, NoFunctionException, NoFunctionRepositoryException, NoGridCredentialException, NonSerializableValueException, ParserRecognitionException, PipeClosedException, PipeIOException, PipeTerminatedException, PreProcessException, RDFModelUseException, RelationalSchemaParseException, RequestCreationException, RequestException, RequestException, RequestRejectedException, RequestResourceAlreadyExistsException, RequestUserException, ResourceActivityUnknownException, ResourceIDAlreadyAssignedException, ResourceNotDestroyedException, ResourcePropertyUnknownException, ResourcePropertyValueParseException, ResourceTypeException, ResourceTypeUnknownException, ResourceUnknownException, ResourceUnknownException, ResultSetHandlerColumnException, ResultSetHandlerException, ResultSetTableMetaDataException, SequenceEndMissingException, SequenceStartMissingException, ServerException, ServerMessageException, SessionResourceAlreadyExistsException, SPARQLActivityException, SQLParserException, SQLParserException, TerminationTimeChangeRejectedException, TimeoutException, TooManyTuplesException, TupleBinaryDataStreamParseException, TupleHandlerColumnException, TupleHandlerException, TupleTypeConversionException, UnableToSetTerminationTimeException, UnexpectedReplacementValuesException, UnknownSMTPHostException, UnknownSQLParameterModeException, UnmatchedColumnNamesException, UnsupportedActivityException, UnsupportedBlockException, UnsupportedTokenException, UnsupportedTupleTypeConversion, ViewResourceConfigurationException, ViewStatementErrorException, WebRowSetParseException, WebRowSetResultSetParseException, XMLDBCloseCollectionException, XMLDBRegistrationException, XMLDBUnknownCollectionException, XMLParseException, XMLSerialisationException

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

Constructor Summary

protected	DAIException() No-argument constructor used by sub-classes that need to perform work before the error ID and parameters are known.
protected	DAIException(DAIUniqueID uniqueID) No-argument constructor used by sub-classes that need to perform work before the error ID and parameters are known and which needs to have a given unique exception ID.
	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

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

protected DAIException(DAIUniqueID uniqueID)

No-argument constructor used by sub-classes that need to perform work before the error ID and parameters are known and which needs to have a given unique exception ID.

Parameters:

uniqueID - Unique exception ID.

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.