22 Using the XSLT Processor for C++

This chapter contains these topics:

Accessing XSLT for C++
Xsl Namespace
XSLT for C++ DOM Interface Usage
Invoking XSLT for C++
Using the Sample Files Included with the Software

Note:

Use the new unified C++ API in xml.hpp for new XDK applications. The old C++ API in oraxml.hpp is deprecated and supported only for backward compatibility, but will not be enhanced. It will be removed in a future release.

Accessing XSLT for C++

XSLT for C++ is provided with Oracle Database. Sample files are located at xdk/demo/cpp/new.

readme.html in the root directory of the software archive contains release specific information including bug fixes and API additions.

Xsl Namespace

This is the namespace for XSLT compilers and transformers.

Xsl Interfaces

XslException Interface - Root interface for all XSLT-related exceptions.

Transformer Interface -Basic XSLT processor. This interface can be used to invoke all XSLT processors.

CompTransformer Interface - Extended XSLT processor. This interface can be used only with processors that create intermediate binary bytecode (currently XVM-based processor only).

Compiler Interface - XSLT compiler. It is used for compilers that compile XSLT into binary bytecode.

XSLT for C++ DOM Interface Usage

There are two inputs to XMLParser.xmlparse():
- The XML document
- The stylesheet to be applied to the XML document
Any XSLT processor is initiated by calling the tools factory to create a particular XSLT transformer or compiler.
The stylesheet is supplied to any transformer by calling setXSL() member functions.
The XML instance document is supplied as a parameter to the transform member functions.
The resultant document (XML, HTML, VML, and so on) is typically sent to an application for further processing. The document is sent as a DOM tree or as a sequence of SAX events. SAX events are produced if a SAX event handler is provided by the user.
The application terminates the XSLT processors by invoking their destructors.

Invoking XSLT for C++

XSLT for C++ can be invoked in two ways:

By invoking the executable on the command line
By writing C++ code and using the supplied APIs

Command Line Usage

XSLT for C++ can be called as an executable by invoking bin/xml.

Writing C++ Code to Use Supplied APIs

XSLT for C++ can also be invoked by writing code to use the supplied APIs. The code must be compiled using the headers in the public subdirectory and linked against the libraries in the lib subdirectory. Please see the Makefile or make.bat in xdk/demo/cpp/new for full details of how to build your program.

Using the Sample Files Included with the Software

The $ORACLE_HOME/xdk/demo/cpp/parser/ directory contains several XML applications to illustrate how to use the XSLT for C++.

Table 22-1 lists the sample files.

Table 22-1 XSLT for C++ Sample Files

Sample File Name	Description
XSLSampleMain.cpp XSLSampleGen.cpp XSLSampleGen.hpp	Sources for sample XSLT usage program. `XSLSample` takes two arguments, the XSLT stylesheet and the XML file. If you redirect `stdout` of this program to a file, you may have some output missing, depending on your environment.
XVMSampleMain.cpp XVMSampleGen.cpp XVMSampleGen.hpp	Sources for the sample XVM usage program.