H Exceptions

The following sections describe the Oracle Multimedia object exceptions:

For information about the Oracle Multimedia error messages, see Oracle Database Error Messages.

H.1 ORDAudioExceptions Exceptions

The following exceptions are associated with the ORDAudio object:

ORDAudioExceptions.AUDIO_DURATION_IS_NULL
Cause: This exception is raised when calling the getAudioDuration method and the duration is NULL.
Action: Set the duration for the audio object to a known value.
ORDAudioExceptions.AUDIO_ENCODING_IS_NULL
Cause: This exception is raised when calling the getEncoding method and the encoding is NULL.
Action: Set the encoding for the audio object to a known value.
ORDAudioExceptions.AUDIO_FORMAT_IS_NULL
Cause: This exception is raised when calling the getFormat method and the format is NULL.
Action: Set the format for the audio object to a known format.
ORDAudioExceptions.AUDIO_NUM_CHANNELS_IS_NULL
Cause: This exception is raised when calling the getNumberOfChannels method and the number of channels is NULL.
Action: Set the number of channels for the audio object to a known value.
ORDAudioExceptions.AUDIO_PLUGIN_EXCEPTION
Cause: This exception is raised when the audio plug-in raises an exception.
Action: Refer to the Oracle Multimedia documentation for more information.
ORDAudioExceptions.AUDIO_SAMPLE_SIZE_IS_NULL
Cause: This exception is raised when calling the getSampleSize method and the sample size is NULL.
Action: Set the sample size for the audio object to a known value.
ORDAudioExceptions.AUDIO_SAMPLING_RATE_IS_NULL
Cause: This exception is raised when calling the getSamplingRate method and the sampling rate is NULL.
Action: Set the sampling rate for the audio object to a known value.
ORDAudioExceptions.DESCRIPTION_IS_NOT_SET
Cause: This exception is raised when calling the getDescription method and the description attribute is not set.
Action: Set the description attribute.
ORDAudioExceptions.INVALID_DESCRIPTION
Cause: This exception is raised when you call the setDescription method with a value that is not valid.
Action: Set the value of the user_description parameter to an acceptable value.
ORDAudioExceptions.INVALID_MIME_TYPE
Cause: This exception is raised if the mime parameter value of the setMimeType method is NULL.
Action: Set the MIME parameter value to a known value.
ORDAudioExceptions.LOCAL_DATA_SOURCE_REQUIRED
Cause: This exception is raised if the data source is external.
Action: Set the source information to a local source.
ORDAudioExceptions.METHOD_NOT_SUPPORTED
Cause: This exception is raised when the method called is not supported.
Action: Do not call this method.
ORDAudioExceptions.NULL_INPUT_VALUE
Cause: This exception is raised if you call one of the set methods and the parameter value is NULL.
Action: Set the parameter to a known value.
ORDAudioExceptions.NULL_LOCAL_DATA
Cause: This exception is raised when source.localData is NULL.
Action: Initialize source.localData using an init method.
ORDAudioExceptions.NULL_SOURCE
Cause: This exception is raised when the value of the ORDAudio.source attribute is NULL.
Action: Use an ORDAudio object that was created with the ORDAudio.init method (recommended). Or, set the ORDAudio.source attribute to an ORDSource object that you initialized.

H.2 ORDDocExceptions Exceptions

The following exceptions are associated with the ORDDoc object:

ORDDocExceptions.DOC_PLUGIN_EXCEPTION
Cause: This exception is raised when the document plug-in raises an exception.
Action: Refer to the Oracle Multimedia documentation for more information.
ORDDocExceptions.INVALID_FORMAT_TYPE
Cause: This exception is raised if the knownFormat parameter value of the setFormat method is NULL.
Action: Set the FORMAT parameter value to a known value.
ORDDocExceptions.INVALID_MIME_TYPE
Cause: This exception is raised if the mime parameter value of the setMimeType method is NULL.
Action: Set the MIME parameter value to a known value.
ORDDocExceptions.METHOD_NOT_SUPPORTED
Cause: This exception is raised when the method called is not supported.
Action: Do not call this method.
ORDDocExceptions.NULL_LOCAL_DATA
Cause: This exception is raised when source.localData is NULL.
Action: Initialize source.localData using an init method.
ORDDocExceptions.NULL_SOURCE
Cause: This exception is raised when the value of the ORDDoc.source attribute is NULL.
Action: Use an ORDDoc object that was created with the ORDDoc.init method (recommended). Or, set the ORDDoc.source attribute to an ORDSource object that you initialized.

H.3 ORDImageExceptions Exceptions

The following exceptions are associated with the ORDImage object:

ORDImageExceptions.DATA_NOT_LOCAL
Cause: This exception is raised when the data is not local (the source.local attribute is 0.)
Action: Reset the source attribute information to a local image source. Call the import or importFrom method to import the data into the source.local attribute and set the source.local attribute to 1.
ORDImageExceptions.INVALID_MIME_TYPE
Cause: This exception is raised if the mime parameter value of the setMimeType method is NULL.
Action: Set the MIME parameter value to a known value.
ORDImageExceptions.NULL_CONTENT
Cause: This exception is raised when the image is NULL.
Action: Do not specify a NULL image.
ORDImageExceptions.NULL_DESTINATION
Cause: This exception is raised when the destination image is NULL.
Action: Pass an initialized destination image.
ORDImageExceptions.NULL_LOCAL_DATA
Cause: This exception is raised when source.localData is NULL.
Action: Initialize source.localData using an init method.
ORDImageExceptions.NULL_PROPERTIES_DESCRIPTION
Cause: This exception is raised when the description parameter to setProperties is not set.
Action: Set the description parameter if you are using a foreign image. Otherwise, do not pass the description parameter.
ORDImageExceptions.NULL_SOURCE
Cause: This exception is raised when the value of the ORDImage.source attribute is NULL.
Action: Use an ORDImage object that was created with the ORDImage.init method (recommended). Or, set the ORDImage.source attribute to an ORDSource object that you initialized.

H.4 ORDImageSIExceptions Exceptions

The following exceptions are associated with the Still Image objects:

ORDImageSIExceptions.ILLEGAL_HEIGHT_WIDTH_SPEC
Cause: The height or width parameter is NULL or is a negative value.
Action: Specify a positive value for the input height and width parameters.
ORDImageSIExceptions.NULL_CONTENT
Cause: The BLOB parameter was NULL.
Action: Specify a BLOB parameter that is not NULL.
ORDImageSIExceptions.UNSUPPORTED_IMAGE_FORMAT
Cause: The specified image format is not supported
Action: Invoke the method using a supported image format. Refer to the SI_INFORMTN_SCHEMA views and the Oracle Multimedia documentation for more information.

H.5 ORDSourceExceptions Exceptions

The following exceptions are associated with the ORDSource object:

ORDSourceExceptions.EMPTY_SOURCE
Cause: This exception is raised when the value of the local attribute is 1 or NULL (TRUE), but the value of the localData attribute is NULL.
Action: Pass an initialized source.
ORDSourceExceptions.INCOMPLETE_SOURCE_INFORMATION
Cause: This exception is raised when the source information is incomplete or the value of the srcType attribute is NULL and the local attribute is neither 1 nor NULL.
Action: Check your source information and set srcType, srcLocation, or srcName attributes as needed.
ORDSourceExceptions.INCOMPLETE_SOURCE_LOCATION
Cause: This exception is raised when the value of srcLocation is NULL.
Action: Check your source location and set the srcLocation attribute.
ORDSourceExceptions.INCOMPLETE_SOURCE_NAME
Cause: This exception is raised when the value of srcName is NULL.
Action: Check your source name and set the srcName attribute.
ORDSourceExceptions.INVALID_SOURCE_TYPE
Cause: This exception is raised when you call a getBFile method and the value of the source.srcType attribute is other than file.
Action: Ensure that the source type is file.
ORDSourceExceptions.IO_ERROR
Cause: The Oracle Multimedia FILE source plug-in was unable to write the BLOB contents to the specified operating system file.
Action: Check that the file directory path exists and can be accessed by Oracle Database. Check that the correct Java file permissions have been granted to the Oracle user.
ORDSourceExceptions.METHOD_NOT_SUPPORTED
Cause: This exception is raised when the method called is not supported by the source plug-in being used.
Action: Call a supported method.
ORDSourceExceptions.NULL_SOURCE
Cause: This exception is raised when the value of the localData attribute is NULL.
Action: Pass an initialized source.
ORDSourceExceptions.SOURCE_PLUGIN_EXCEPTION
Cause: This exception is raised when the source plug-in raises an exception.
Action: Refer to the Oracle Multimedia documentation for more information.

H.6 ORDVideoExceptions Exceptions

The following exceptions are associated with the ORDVideo object:

ORDVideoExceptions.DESCRIPTION_IS_NOT_SET
Cause: This exception is raised when calling the getDescription method and the description attribute is not set.
Action: Set the description attribute.
ORDVideoExceptions.INVALID_MIME_TYPE
Cause: This exception is raised if the mime parameter value of the setMimeType method is NULL.
Action: Set the MIME parameter value to a known value.
ORDVideoExceptions.LOCAL_DATA_SOURCE_REQUIRED
Cause: This exception is raised if the data source is external.
Action: Set the source information to a local source.
ORDVideoExceptions.METHOD_NOT_SUPPORTED
Cause: This exception is raised when the method called is not supported.
Action: Do not call this method.
ORDVideoExceptions.NULL_INPUT_VALUE
Cause: This exception is raised if either the knownWidth or knownHeight parameter values of the setFrameSize method is NULL.
Action: Set these parameters to known values.
ORDVideoExceptions.NULL_LOCAL_DATA
Cause: This exception is raised when source.localData is NULL.
Action: Initialize source.localData using an init method.
ORDVideoExceptions.NULL_SOURCE
Cause: This exception is raised when the value of the ORDVideo.source attribute is NULL.
Action: Use an ORDVideo object that was created with the ORDVideo.init method (recommended). Or, set the ORDVideo.source attribute to an ORDSource object that you initialized.
ORDVideoExceptions.VIDEO_FORMAT_IS_NULL
Cause: This exception is raised when calling the getFormat method and the format is NULL.
Action: Set the format for the video object to a known format.
ORDVideoExceptions.VIDEO_PLUGIN_EXCEPTION
Cause: This exception is raised when the video plug-in raises an exception.
Action: Refer to the Oracle Multimedia documentation for more information.