Skip Headers
Oracle® Database XML C++ API Reference
10g Release 2 (10.2)

Part Number B16206-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Feedback

Go to previous page
Previous
Go to next page
Next
View PDF

7 Package Tools APIs for C++

Tools packages contains types and interfaces related to the creation and instantiation of Oracle XML tools.

This chapter contains this section:


Tools Datatypes

Table 7-1 summarizes the datatypes of the Tools package.

Table 7-1 Summary of Datatypes; Tools Package

Datatype Description
FactoryExceptionCode
Tool Factory exceptions.


FactoryExceptionCode

Tool Factory exceptions.

Definition

typedef enum FactoryExceptionCode {
   FACTORY_UNDEFINED_ERR = 0,
   FACTORY_OTHER_ERR = 1 
} FactoryExceptionCode;


Factory Interface

Table 7-2 summarizes the methods of available through the Factory interface.

Table 7-2 Summary of Factory Methods; Tools Package

Function Summary
Factory()
Constructor.
createDOMParser()
Create DOM Parser.
createSAXParser()
Create SAX Parser.
createSchemaValidator()
Create schema validator.
createXPathCompProcessor()
Create extended XPath processor.
createXPathCompiler()
Create XPath compiler.
createXPathProcessor()
Create XPath processor.
createXPointerProcessor()
Create XPointer processor.
createXslCompiler()
Create Xsl compiler.
createXslExtendedTransformer()
Create XSL extended transformer.
createXslTransformer()
Create XSL transformer.
getContext()
Get factory's context.
~Factory()
Default destructor.


Factory()

Class constructor.

Syntax Description
Factory() 
throw (FactoryException);
Default constructor
Factory(
   Context* ctx_ptr) 
throw (FactoryException);
Creates factory object given a Context object.

Parameter Description
ctx_ptr
pointer to a context object

Returns

(Factory) object


createDOMParser()

Creates DOM parser.

Syntax

DOMParser< Context, Node>* createDOMParser (
   DOMParserIdType id_type, 
   Context* ctx_ptr = NULL)
throw (FactoryException);

Parameter Description
id_type
parser id type
ctx_ptr
pointer to a Context object

Returns

(DOMParser*) pointer to the parser object


createSAXParser()

Creates SAX parser.

Syntax

SAXParser< Context>* createSAXParser (
   SAXParserIdType id_type,
   Context* ctx_ptr = NULL)
throw (FactoryException);

Parameter Description
id_type
parser id type
ctx_ptr
pointer to a Context object

Returns

(SAXParser*) pointer to the parser object


createSchemaValidator()

Creates schema validator.

Syntax

SchemaValidator< Node>* createSchemaValidator (
   SchValidatorIdType id_type,
   Context* ctx_ptr = NULL)
throw (FactoryException);

Parameter Description
id_type
validator id type
ctx_ptr
pointer to a Context object

Returns

(SchemaValidator*) pointer to the validator object


createXPathCompProcessor()

Creates extended XPath processor; takes XvmPrCXml value only.

Syntax

CompProcessor< Context, Node>* createXPathCompProcessor (
   XPathPrIdType id_type,
   Context* ctx_ptr = NULL)
throw (FactoryException);

Parameter Description
id_type
processor id type
ctx_ptr
pointer to a Context object

Returns

(CompProcessor*) pointer to the processor object


createXPathCompiler()

Creates XPath compiler.

Syntax

XPath::Compiler< Context, Node>* createXPathCompiler (
   XPathCompIdType id_type,
   Context* ctx_ptr = NULL)
throw (FactoryException);

Parameter Description
id_type
compiler id type
ctx_ptr
pointer to a Context object

Returns

(XPathCompiler*) pointer to the compiler object


createXPathProcessor()

Creates XPath processor.

Syntax

XPath::Processor< Context, Node>* createXPathProcessor (
   XPathPrIdType id_type, 
   Context* ctx_ptr = NULL)
throw (FactoryException);

Parameter Description
id_type
processor id type
ctx_ptr
pointer to a Context object

Returns

(Processor*) pointer to the processor object


createXPointerProcessor()

Creates XPointer processor.

Syntax

XPointer::Processor< Context, Node>* createXPointerProcessor (
   XppPrIdType id_type,
   Context* ctx_ptr = NULL)
throw (FactoryException);

Parameter Description
id_type
processor id type
ctx_ptr
pointer to a Context object

Returns

(Processor*) pointer to the processor object


createXslCompiler()

Creates Xsl compiler.

Syntax

Xsl::Compiler< Context, Node>* createXslCompiler (
   XslCompIdType id_type,
   Context* ctx_ptr = NULL)
throw (FactoryException);

Parameter Description
id_type
compiler id type
ctx_ptr
pointer to a Context object

Returns

(Compiler*) pointer to the compiler object


createXslExtendedTransformer()

Creates XSL extended trnasformer; takes XvmTrCXml value only.

Syntax

CompTransformer< Context, Node>* createXslExtendedTransformer (
   XslTrIdType id_type,
   Context* ctx_ptr = NULL)
throw (FactoryException);

Parameter Description
id_type
transformer id type
ctx_ptr
pointer to a Context object

Returns

(CompTrasformer*) pointer to the transformer object


createXslTransformer()

Creates XSL trnasformer.

Syntax

Transformer< Context, Node>* createXslTransformer (
   XslTrIdType id_type, 
   Context* ctx_ptr = NULL)
throw (FactoryException);

Parameter Description
id_type
transformer id type
ctx_ptr
pointer to a Context object

Returns

(Trasformer*) pointer to the transformer object


getContext()

Returns factory's context.

Syntax

Context* getContext() const;

Returns

(Context*) pointer to the context object


~Factory()

Default destructor.

Syntax

~Factory();

FactoryException Interface

Table 7-3 summarizes the methods of available through the FactoryException interface.

Table 7-3 Summary of FactoryException Methods; Tools Package

Function Summary
getCode()
Get Oracle XML error code embedded in the exception.
getFactoryCode()
Get FactoryException code embedded in the exception.
getMesLang()
Get current language (encoding) of error messages.
getMessage()
Get Oracle XML error message.


getCode()

Gets Oracle XML error code embedded in the exception. Virtual member function inherited from XmlException.

Syntax

virtual unsigned getCode() const = 0;

Returns

(unsigned) numeric error code (0 on success)


getFactoryCode()

This is a virtual member function that defines a prototype for implementation defined member functions returning exception codes specific to the Tools namespace, defined in FactoryExceptionCode, of the exceptional situations during execution

Syntax

virtual FactoryExceptionCode getFactoryCode() const = 0;

Returns

(FactoryExceptionCode) exception code


getMesLang()

Virtual member function inherited from XmlException.

Syntax

virtual oratext* getMesLang() const = 0;

Returns

(oratext*) Current language (encoding) of error messages


getMessage()

Virtual member function inherited from XmlException.

Syntax

virtual oratext* getMessage() const = 0;

Returns

(oratext *) Error message