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
Factory Interface
FactoryException Interface

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 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 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