OCI XML DB Functions

This section describes the XML DB functions.

Table 23-3 XML DB Functions  

Function/Page Purpose

OCIBinXmlCreateReposCtxFromConn()

Create metadata connection context.

OCIBinXmlCreateReposCtxFromCPool()

Create metadata connection context connection pool.

OCIBinXmlSetReposCtxForConn()

Associates data connection with the metadata connection.

OCIBinXmlSetFormatPref()

Specifies that images transferred are in Binary XML format.

OCIXmlDbFreeXmlCtx()

Free an XML context.

OCIXmlDbInitXmlCtx()

Initialize an XML context for XML data from the database.


OCIBinXmlCreateReposCtxFromConn()

Purpose

Creates a metadata connection context (OCIBinXmlReposCtx) from the specified OCIEnv/OCISvcCtx dedicated OCI connection. Note that this connection is dedicated to metadata use.

Syntax

sword OCIBinXmlCreateReposCtxFromConn (   OCIEnv             *env,                                           OCISvcCtx          *svcctx,
                                          OCIError           *err,
                                          OCIBinXmlReposCtx  **ctx);

Parameters

env (IN)

The environment handle.

svcctx (IN)

The handle to the connection to be used to access the metadata.

err (IN)

The error handle.

ctx (OUT)

The metadata context that is created and returned.

Comments

Returns -1 for error, 0 for success. err will contain more information about the error.

OCIBinXmlCreateReposCtxFromCPool()

Purpose

Creates a metadata connection context (OCIBinXmlReposCtx) from the specified connection pool. A connection from the connection pool will be used whenever any information from the token repository is needed.

Syntax

sword OCIBinXmlCreateReposCtxFromCPool (   OCIEnv             *env,                                            OCICPool           *cpool,
                                           OCIError           *err,
                                           OCIBinXmlReposCtx  **ctx);

Parameters

env (IN)

The environment handle.

svcctx (IN)

The handle to the connection to be used to access the metadata.

err (IN)

The error handle.

ctx (OUT)

The metadata context that is created and returned.

Comments

Returns -1 for error, 0 for success. err will contain more information about the error.

OCIBinXmlSetReposCtxForConn()

Purpose

Associates the data connection with the metadata connection. Note that in the case of a dedicated connection the environment handle must be the same for the data connection and for the metadata connection.

Syntax

sword OCIBinXmlSetReposCtxForConn (   OCISvcCtx          *dataconn,
                                      OCIBinXmlReposCtx  *reposctx);

Parameters

dataconn (IN)

The data connection handle.

reposctx (IN)

The pointer to the metadata connection.

Comments

Returns -1 for error, 0 for success. err will contain more information about the error.

Related Functions

OCIBinXmlSetFormatPref()

OCIBinXmlSetFormatPref()

Purpose

Specifies that the images being transferred between client and server for the XML document be in Binary XML format. In the future all communication will be in the Binary XML format. Currently, Binary XML-aware applications can set this.

Syntax

sword OCIBinXmlSetFormatPref (   xmldomdoc   *doc,
                                 ub4         formattype);

Parameters

doc (IN)

The pointer to the domdoc to which the preference is to be applied.

formattype (IN)

The type of format to be used for pickling. Currently the only values allowed are OCIXML_FORMATTYPE_TEXT and OCIXML_FORMATTYPE_BINXML.

Comments

Returns -1 for error, 0 for success.

Related Functions

OCIBinXmlSetReposCtxForConn()

OCIXmlDbFreeXmlCtx()

Purpose

Free any allocations made by the call to OCIXmlDbInitXmlCtx().

Syntax

void OCIXmlDbFreeXmlCtx ( xmlct   *xctx ); 

Parameters

xctx (IN)

The XML context to terminate.

Comments

Returns -1 for error, 0 for success.

See Also:

"Using OCI XML DB Functions" for a usage example.

Related Functions

OCIXmlDbInitXmlCtx()

OCIXmlDbInitXmlCtx()

Purpose

To initialize an XML context for XML data from the database.

Syntax

xmlctx *OCIXmlDbInitXmlCtx (   OCIEnv                *envhp,
                               OCISvcCtx             *svchp,
                               OCIError              *errhp,
                               ocixmldbparam         *params,
                               ub4                   num_params ); 

Parameters

envhp (IN)

The OCI environment handle.

svchp (IN)

The OCI service handle.

errhp (IN)

The OCI error handle.

params (IN)

The optional possible values in this array are pointers to:

The OCI duration. Default value is OCI_DURATION_SESSION.

An error handler which is a user-registered callback of prototype:

void (*err_handler) (sword errcode, (const OraText *) errmsg);

The two parameters of err_handler are:

errcode (OUT)

A numerical error value.

errmsg (OUT)

The error message text.

num_params (IN)

Number of parameters to be read from params. If the value of num_params exceeds the size of array params, unexpected behavior results.

Comments

See Also:

"Using OCI XML DB Functions" for a usage example.

Returns

Returns either:

  • A pointer to structure xmlctx, with error handler and callbacks populated with appropriate values. This is later used for all OCI calls.

  • NULL, if no database connection is available.

Related Functions

OCIXmlDbFreeXmlCtx()