H init( ) Methods for Oracle Multimedia Object Types

The initialization of Oracle Multimedia object types ORDAudio, ORDDoc, ORDImage, and ORDVideo is accomplished through object constructors. The init( ) methods can also be used to initialize the Oracle Multimedia object types. References to ORDxxx objects represent these four Oracle Multimedia object types.

Note:

In Oracle Database 11g Release 2 (11.2), Oracle introduced new constructor functions to construct ORDxxx objects from BLOBs and other sources. The init( ) methods continue to be available in the current release. However, Oracle recommends writing new applications to use the new constructor functions. Oracle also recommends migrating existing applications from the init( ) methods to the new constructor functions at your earliest convenience.

This appendix describes these init( ) methods:

H.1 init( ) for ORDAudio

Format

init( ) RETURN ORDAudio;

Description

Initializes instances of the ORDAudio object type.

Parameters

None.

Pragmas

None.

Exceptions

None.

Usage Notes

This constructor is a static method that initializes all the ORDAudio attributes to NULL with these exceptions:

  • source.updateTime is set to SYSDATE

  • source.local is set to 1 (local)

  • source.localData is set to empty_blob

Examples

None.

H.2 init( ) for ORDDoc

Format

init( ) RETURN ORDDoc;

Description

Initializes instances of the ORDDoc object type.

Parameters

None.

Pragmas

None.

Exceptions

None.

Usage Notes

This constructor is a static method that initializes all the ORDDoc attributes to NULL with these exceptions:

  • source.updateTime is set to SYSDATE

  • source.local is set to 1 (local)

  • source.localData is set to empty_blob

Examples

None.

H.3 init( ) for ORDImage

Format

init( ) RETURN ORDImage;

Description

Initializes instances of the ORDImage object type.

Parameters

None.

Pragmas

None.

Exceptions

None.

Usage Notes

This constructor is a static method that initializes all the ORDImage attributes to NULL with these exceptions:

  • source.updateTime is set to SYSDATE

  • source.local is set to 1 (local)

  • source.localData is set to empty_blob

Examples

None.

H.4 init( ) for ORDVideo

Format

init( ) RETURN ORDVideo;

Description

Initializes instances of the ORDVideo object type.

Parameters

None.

Pragmas

None.

Exceptions

None.

Usage Notes

This constructor is a static method that initializes all the ORDVideo attributes to NULL with these exceptions:

  • source.updateTime is set to SYSDATE

  • source.local is set to 1 (local)

  • source.localData is set to empty_blob

Examples

None.

H.5 init(srcType,srcLocation,srcName) for ORDAudio

Format

init(srcType      IN VARCHAR2,
     srcLocation  IN VARCHAR2,
     srcName      IN VARCHAR2)  RETURN ORDAudio;

Description

Initializes instances of the ORDAudio object type.

Parameters

srcType

The source type of the audio data. (See Table 7-1.)

srcLocation

The source location of the audio data. (See Table 7-2.)

srcName

The source name of the audio data. (See Table 7-3.)

Pragmas

None.

Exceptions

None.

Usage Notes

This constructor is a static method that initializes all the ORDAudio attributes to NULL with these exceptions:

  • source.updateTime is set to SYSDATE

  • source.local is set to 0

  • source.localData is set to empty_blob

  • source.srcType is set to the input value

  • source.srcLocation is set to the input value

  • source.srcName is set to the input value

Examples

None.

H.6 init(srcType,srcLocation,srcName) for ORDDoc

Format

init(srcType      IN VARCHAR2,
     srcLocation  IN VARCHAR2,
     srcName      IN VARCHAR2) RETURN ORDDoc;

Description

Initializes instances of the ORDDoc object type.

Parameters

srcType

The source type of the media data. (See Table 7-1.)

srcLocation

The source location of the media data. (See Table 7-2.)

srcName

The source name of the media data. (See Table 7-3.)

Pragmas

None.

Exceptions

None.

Usage Notes

This constructor is a static method that initializes all the ORDDoc attributes to NULL with these exceptions:

  • source.updateTime is set to SYSDATE

  • source.local is set to 0

  • source.localData is set to empty_blob

  • source.srcType is set to the input value

  • source.srcLocation is set to the input value

  • source.srcName is set to the input value

Examples

None.

H.7 init(srcType,srcLocation,srcName) for ORDImage

Format

init(srcType      IN VARCHAR2,
     srcLocation  IN VARCHAR2,
     srcName      IN VARCHAR2) RETURN ORDImage;

Description

Initializes instances of the ORDImage object type.

Parameters

srcType

The source type of the image data. (See Table 7-1.)

srcLocation

The source location of the image data. (See Table 7-2.)

srcName

The source name of the image data. (See Table 7-3.)

Pragmas

None.

Exceptions

None.

Usage Notes

This constructor is a static method that initializes all the ORDImage attributes to NULL with these exceptions:

  • source.updateTime is set to SYSDATE

  • source.local is set to 0

  • source.localData is set to empty_blob

  • source.srcType is set to the input value

  • source.srcLocation is set to the input value

  • source.srcName is set to the input value

Examples

None.

H.8 init(srcType,srcLocation,srcName) for ORDVideo

Format

init(srcType      IN VARCHAR2,
     srcLocation  IN VARCHAR2,
     srcName      IN VARCHAR2)  RETURN ORDVideo;

Description

Initializes instances of the ORDVideo object type.

Parameters

srcType

The source type of the video data. (See Table 7-1.)

srcLocation

The source location of the video data. (See Table 7-2.)

srcName

The source name of the video data. (See Table 7-3.)

Pragmas

None.

Exceptions

None.

Usage Notes

This constructor is a static method that initializes all the ORDVideo attributes to NULL with these exceptions:

  • source.updateTime is set to SYSDATE

  • source.local is set to 0

  • source.localData is set to empty_blob

  • source.srcType is set to the input value

  • source.srcLocation is set to the input value

  • source.srcName is set to the input value

Examples

None.