XMLException interface—This is the root interface for all XML exceptions.

OracleXML data types are described.

encoding—a particular supported encoding. The following kinds of encodings (or encoding names) are supported:

• data_encoding

• default_input_encoding

• input_encoding—overwrites the previous one

• error_language—gets overwritten by the language of the error handler, if specified

encodings—array of encodings.

Ctx interfaces ErrorHandler, MemAllocator, and Tctx are described.

ErrorHandler Interface — This is the root error handler class. It deals with local processing of errors, mainly from the underlying C implementation. In some implementations, it might throw XmlException. To accommodate the needs of all implementations, this behavior is not specified in its signature. However, it can create exception objects. The error handler is passed to the TCtx constructor when TCtx is initialized. Implementations of this interface are provided by the user.

MemAllocator Interface—This is a simple root interface to make the TCtx interface reasonably generic so that different allocator approaches can be used in the future. It is passed to the TCtx constructor when TCtx is initialized. It is a low level allocator that does not know the type of an object being allocated. The allocators with this interface can also be used directly. In this case the user is responsible for the explicit deallocation of objects (with dealloc).

If the MemAllocator interface is passed as a parameter to the TCtx constructor, it often makes sense to overwrite the operator new. In this case, all memory allocations in both C and C++ can be done by the same allocator.

Tctx Interface—This is an implicit interface to XML context implementations. It is primarily used for memory allocation, error (not exception) handling, and different encodings handling. The context interface is an implicit interface that is supposed to be used as type parameter. The name TCtx is used as a corresponding type parameter name. Its actual substitutions are instantiations of implementations parameterized (templatized) by real context implementations. In the case of errors XmlException might be thrown.All constructors create and initialize context implementations. In a multithreaded environment a separate context implementation must be initialized for each thread.

Data type InputSourceType specifies the kinds of input sources that are supported.

• ISRC_URI—Input is to be read from the specified Universal Resource Identifier (URI).

• ISRC_FILE—Input is to be read from a file.

• ISRC_BUFFER—Input is to be read from a buffer.

• ISRC_DOM—Input is a DOM tree.

• ISRC_CSTREAM—Input is a C level stream.

The interfaces to inputs are described.

URISource—This is an interface to inputs from specified URIs.

FileSource—This is an interface to inputs from a file.

BufferSource—This is an interface to inputs from a buffer.

DOMSource—This is an interface to inputs from a DOM tree.

CStreamSource—This is an interface to inputs from a C level stream.

Interfaces for XML tools are described.

FactoryException—Specifies tools factory exceptions. It is derived from XMLExceptions.

Factory—XML tools factory. Hides implementations of all XML tools and provides methods to create objects representing these tools based on their identifier (ID) values.