H Exceptions

The following sections describe the Oracle Multimedia object exceptions:

ORDAudioExceptions Exceptions
ORDDocExceptions Exceptions
ORDImageExceptions Exceptions
ORDImageSIExceptions Exceptions
ORDSourceExceptions Exceptions
ORDVideoExceptions 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.