OBlob Method

Applies To

OBlob

Description

OBlob constructor

Usage

OBlob(void) throw (OException)

OBlob(ODatabase& odb, bool use_caching = false) throw(OException)

Arguments	Description
odb	An initialized ODatabase providing the connection to the database where the BLOB will be created.
use_caching	Specifies whether Oracle uses caching when accessing this LOB. The default value is false.

Remarks

This method constructs a new OBlob instance.

If an ODatabase is passed into the constructor, a Temporary BLOB is created in the database.

Temporary LOBs are LOBs which do not exist permanently in the database. OO4O programmers most commonly use them to pass into stored procedures and functions which have LOB arguments.

Temporary LOBs do not require or take part in transactions. (It is not necessary to acquire a lock prior to writes, and rollbacks have no effect on temporary LOBs.)

The use_caching argument directs Oracle to use caching when accessing the temporary LOB. This is suggested when multiple accesses are expected on a single LOB. Caching is not required in the typical case, where a LOB is created, filled with data, passed to a stored procedure, and then discarded.

Temporary LOBs exist on the server until no more references to the corresponding OBlob exist on the client. Please note that these references include any OParameter or OParamArray which contain a temporary OBlob.