OClob Method

Applies To

Description

OClob constructor

Usage

OClob(void) throw (OException)

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

Arguments	Description
odb	An initialized ODatabase providing the connection to the database where the CLOB 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 OClob instance.

If an ODatabase is passed into the constructor, a Temporary CLOB 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 OClob exist on the client. Please note that these references include any OParameter or OParamArray which contain a temporary OClob.