A single input source for an XML entity
A single input source for an XML entity.This class encapsulates information about an input source in a single object, which may include a public identifier or a system identifier
There are two places that the application will deliver this input source to the parser: as the argument to the Parser::parse method, or as the return value of the EntityResolver::resolveEntity method.
InputSource is never used directly, but is the base class for a number of derived classes for particular types of input sources. Derivatives are provided (in the internal/ directory) for URL input sources, memory buffer input sources, and so on.
When it is time to parse the input described by an input source, it will be asked to create a binary stream for that source. That stream will be used to input the data of the source. The derived class provides the implementation of the makeStream() method, and provides a type of stream of the correct type for the input source it represents.
An InputSource object belongs to the application: the parser never modifies them in any way. They are always passed by const reference so the parser will make a copy of any input sources that it must keep around beyond the call.
The derived class must create and return a binary input stream of an appropriate type for its kind of data source. The returned stream must be dynamically allocated and becomes the parser's property.
If the system ID is a URL, it will be fully resolved. const XMLCh* getPublicId() const
const XMLCh* getSystemId() const
This is usually not set, allowing the encoding to be sensed in the usual XML way. However, in some cases, the encoding in the file is known to be incorrect because of intermediate transcoding, for instance encapsulation within a MIME document.
The public identifier is always optional: if the application writer
includes one, it will be provided as part of the location information.
Set the system identifier for this input source.
If the system ID is a URL, it must be fully resolved. void setPublicId(const XMLCh* const publicId)
getPublicId
getPublicId void setSystemId(const XMLCh* const systemId)
getSystemId
getSystemId
InputSource(const XMLCh* const systemId)
InputSource( const XMLCh* const systemId, const XMLCh* const publicId )
publicId - The public identifier as in the entity definition. InputSource(const char* const systemId)
InputSource( const char* const systemId, const char* const publicId )
publicId - The public identifier as in the entity definition.
alphabetic index hierarchy of classes
Xerces-C XML Parser for C++ Version 1.1 |
|
generated by doc++