te::xerces::Reader Class Reference

A class that models a XML reader object built on top of Xerces-C++. More...

#include <Reader.h>

Inheritance diagram for te::xerces::Reader:

Public Member Functions
std::string	getAttr (const std::string &name) const
	It returns the attribute value in the case of an element node with valid attributes. More...
std::string	getAttr (std::size_t i) const
	It returns the attribute value in the case of an element node with valid attributes. More...
virtual double	getAttrAsDouble (const std::string &name) const
	It returns the attribute value in the case of an element node with valid attributes. More...
virtual double	getAttrAsDouble (std::size_t i) const
	It returns the attribute value in the case of an element node with valid attributes. More...
virtual boost::int32_t	getAttrAsInt32 (const std::string &name) const
	It returns the attribute value in the case of an element node with valid attributes. More...
virtual boost::int32_t	getAttrAsInt32 (std::size_t i) const
	It returns the attribute value in the case of an element node with valid attributes. More...
virtual boost::uint32_t	getAttrAsUInt32 (std::size_t i) const
	It returns the attribute value in the case of an element node with valid attributes. More...
virtual boost::uint32_t	getAttrAsUInt32 (const std::string name) const
	It returns the attribute value in the case of an element node with valid attributes. More...
std::string	getAttrLocalName (std::size_t i) const
	It returns the local part of the attribute name for the i-th attribute. More...
std::size_t	getAttrPosition (const std::string &name) const
	It returns the attribute position. More...
std::string	getAttrQName (std::size_t i) const
	It returns the qualified name for the i-th attribute. More...
std::string	getAttrURI (std::size_t i) const
	It returns the attribute URI of the associated namespace in the case of an element node. More...
std::size_t	getElementDataLen () const
	It returns the element data value in the case of VALUE node. More...
std::string	getElementLocalName () const
	It returns the local part of the element name in the case of an element node. More...
std::string	getElementQName () const
	It returns the qualified name in the case of an element node. More...
std::string	getElementURI () const
	It returns the URI of the associated namespace in the case of an element node. More...
std::string	getElementValue () const
	It returns the element data value in the case of VALUE node. More...
virtual bool	getElementValueAsBoolean () const
	It returns the element data value in the case of VALUE node. More...
virtual double	getElementValueAsDouble () const
	It returns the element data value in the case of VALUE node. More...
virtual boost::int32_t	getElementValueAsInt32 () const
	It returns the element data value in the case of VALUE node. More...
void	getNamespace (std::size_t i, std::pair< std::string, std::string > &ns) const
te::xml::NodeType	getNodeType () const
	It return the type of node read. More...
std::size_t	getNumberOfAttrs () const
	It returns the number of attributes in the case of an element node. More...
std::size_t	getNumberOfNamespaces () const
bool	hasAttrs () const
	It tells if the element has attributes in the case of an element node. More...
bool	next ()
	It gets the next event to be read. More...
void	read (const std::string &fileURI)
	It prepare the given file to be read. More...
	Reader ()
	Default constructor. More...
void	reset ()
	It resets the parser. More...
void	setCacheGrammarFromParse (bool d)
	If true it caches the grammar in the pool for re-use in subsequent parses. More...
void	setDoNamespaces (bool d)
	It enables or disables the parser namespace processing. More...
void	setDoSchema (bool d)
	It enables or disables the parser schema processing. More...
void	setIgnoreWhiteSpaces (bool d)
	If true the parser will ignore the white space characters. More...
void	setInternalBufferSize (const std::size_t size)
	It sets the maximal allowed buffer size used for parsing. More...
void	setUseCachedGrammarInParse (bool d)
	If true the reader will use cached grammar if it exists in the pool. More...
void	setValidationScheme (bool d)
	If true the parser will perform a validation scheme. More...
	~Reader ()
	Destructor. More...

Private Attributes
ErrorHandler *	m_errH
	A pointer to an error handler. More...
bool	m_ignoreWhiteSpaces
	A flag that indicates if the parser should ignore white spaces. More...
xercesc::SAX2XMLReader *	m_parser
	A pointer to the parser used by the reader. More...
ReaderHandler *	m_readerH
	A pointer to a content handler. More...
xercesc::XMLPScanToken *	m_token
	This keeps the parser state. More...

Detailed Description

A class that models a XML reader object built on top of Xerces-C++.

This API is intend to simplify the task of reading XML files. We have tried to model it close to the Libxml2 API (see http://xmlsoft.org/xmlreader.html for more information) but keeping all Xerces-C++ support capabilities: schema validation and grammar cache.

If you prefer to use the SAX or DOM parsers, please, look the Xerces-C++ documentation available at http://xerces.apache.org/xerces-c.

Definition at line 66 of file xerces/Reader.h.

Constructor & Destructor Documentation

te::xerces::Reader::Reader

(

)

Default constructor.

Definition at line 46 of file xerces/Reader.cpp.

References m_errH, m_parser, m_readerH, and TE_XERCES_READER_MAX_BUFFSIZE.

te::xerces::Reader::~Reader ( )

virtual

Destructor.

Reimplemented from te::xml::Reader.

Definition at line 70 of file xerces/Reader.cpp.

References m_errH, m_parser, m_readerH, m_token, reset(), and TE_LOG_ERROR.

Member Function Documentation

std::string te::xerces::Reader::getAttr ( const std::string &  name ) const

virtual

It returns the attribute value in the case of an element node with valid attributes.

Parameters

name	The attribute name.

Returns

The attribute value in the case of an element node with valid attributes.

Implements te::xml::Reader.

Definition at line 260 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementAttrs(), m_readerH, and te::xerces::ToString().

std::string te::xerces::Reader::getAttr ( std::size_t  i ) const

virtual

It returns the attribute value in the case of an element node with valid attributes.

Parameters

i	The attribute position.

Returns

The attribute value in the case of an element node with valid attributes.

Implements te::xml::Reader.

Definition at line 269 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementAttrs(), m_readerH, and te::xerces::ToString().

double te::xml::Reader::getAttrAsDouble ( const std::string &  name ) const

virtualinherited

It returns the attribute value in the case of an element node with valid attributes.

Parameters

name	The attribute name.

Returns

The attribute value in the case of an element node with valid attributes.

Note

Just call this method if you know that the attribute value can be converted to a double.

Definition at line 69 of file xml/Reader.cpp.

References te::xml::Reader::getAttr().

Referenced by te::ws::ogc::wms::serialize::GetMapRequestReader(), te::serialize::xml::ReadBandProperty(), te::serialize::xml::ReadExtent(), and te::serialize::xml::ReadGeoTransform().

double te::xml::Reader::getAttrAsDouble ( std::size_t  i ) const

virtualinherited

It returns the attribute value in the case of an element node with valid attributes.

Parameters

i	The attribute position.

Returns

The attribute value in the case of an element node with valid attributes.

Note

Just call this method if you know that the attribute value can be converted to a double.

Definition at line 74 of file xml/Reader.cpp.

References te::xml::Reader::getAttr().

boost::int32_t te::xml::Reader::getAttrAsInt32 ( const std::string &  name ) const

virtualinherited

It returns the attribute value in the case of an element node with valid attributes.

Parameters

name	The attribute name.

Returns

The attribute value in the case of an element node with valid attributes.

Note

Just call this method if you know that the attribute value can be converted to a 32-bit integer.

Definition at line 49 of file xml/Reader.cpp.

References te::xml::Reader::getAttr().

Referenced by te::ws::ogc::wms::serialize::GetMapRequestReader(), te::serialize::xml::ReadBandProperty(), te::serialize::xml::ReadLiteral(), and te::xsd::serialize::ReadOccurs().

boost::int32_t te::xml::Reader::getAttrAsInt32 ( std::size_t  i ) const

virtualinherited

It returns the attribute value in the case of an element node with valid attributes.

Parameters

i	The attribute position.

Returns

The attribute value in the case of an element node with valid attributes.

Note

Just call this method if you know that the attribute value can be converted to a 32-bit integer.

Definition at line 54 of file xml/Reader.cpp.

References te::xml::Reader::getAttr().

boost::uint32_t te::xml::Reader::getAttrAsUInt32 ( std::size_t  i ) const

virtualinherited

It returns the attribute value in the case of an element node with valid attributes.

Parameters

i	The attribute position.

Returns

The attribute value in the case of an element node with valid attributes.

Note

Just call this method if you know that the attribute value can be converted to a 32-bit unsigned integer.

Definition at line 59 of file xml/Reader.cpp.

References te::xml::Reader::getAttr().

Referenced by te::serialize::xml::ReadDataSetType().

boost::uint32_t te::xml::Reader::getAttrAsUInt32 ( const std::string  name ) const

virtualinherited

It returns the attribute value in the case of an element node with valid attributes.

Parameters

name	The attribute name.

Returns

The attribute value in the case of an element node with valid attributes.

Note

Just call this method if you know that the attribute value can be converted to a 32-bit unsigned integer.

Definition at line 64 of file xml/Reader.cpp.

References te::xml::Reader::getAttr().

std::string te::xerces::Reader::getAttrLocalName ( std::size_t  i ) const

virtual

It returns the local part of the attribute name for the i-th attribute.

Parameters

i	The attribute position index.

Returns

The local part of the attribute name in the case of an element node.

Implements te::xml::Reader.

Definition at line 279 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementAttrs(), m_readerH, and te::xerces::ToString().

std::size_t te::xerces::Reader::getAttrPosition ( const std::string &  name ) const

virtual

It returns the attribute position.

Parameters

name	The attribute name.

Returns

The attribute position.

Implements te::xml::Reader.

Definition at line 309 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementAttrs(), and m_readerH.

std::string te::xerces::Reader::getAttrQName ( std::size_t  i ) const

virtual

It returns the qualified name for the i-th attribute.

Parameters

i	The attribute position index.

Returns

The qualified attribute name in the case of an element node.

Implements te::xml::Reader.

Definition at line 289 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementAttrs(), m_readerH, and te::xerces::ToString().

std::string te::xerces::Reader::getAttrURI ( std::size_t  i ) const

virtual

It returns the attribute URI of the associated namespace in the case of an element node.

Parameters

i	The attribute position index.

Returns

The attribute URI of the associated namespace in the case of an element node.

Implements te::xml::Reader.

Definition at line 299 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementAttrs(), m_readerH, and te::xerces::ToString().

std::size_t te::xerces::Reader::getElementDataLen ( ) const

virtual

It returns the element data value in the case of VALUE node.

Returns

The element data value in the case of VALUE node.

Note

Just call this method if you know that the element value can be converted to a bool.

It returns the element data value length in the case of VALUE or CDATA node.

Returns

The element data value in the case of VALUE or CDATA node.

Implements te::xml::Reader.

Definition at line 245 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getDataLen(), and m_readerH.

std::string te::xerces::Reader::getElementLocalName ( ) const

virtual

It returns the local part of the element name in the case of an element node.

Returns

The local part of the element name in the case of an element node.

Implements te::xml::Reader.

Definition at line 230 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementLocalName(), m_readerH, and te::xerces::ToString().

std::string te::xerces::Reader::getElementQName ( ) const

virtual

It returns the qualified name in the case of an element node.

Returns

The qualified name in the case of an element node.

Implements te::xml::Reader.

Definition at line 235 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementQName(), m_readerH, and te::xerces::ToString().

std::string te::xerces::Reader::getElementURI ( ) const

virtual

It returns the URI of the associated namespace in the case of an element node.

Returns

The URI of the associated namespace in the case of an element node.

Implements te::xml::Reader.

Definition at line 225 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementURI(), m_readerH, and te::xerces::ToString().

std::string te::xerces::Reader::getElementValue ( ) const

virtual

It returns the element data value in the case of VALUE node.

Returns

The element data value in the case of VALUE node.

Implements te::xml::Reader.

Definition at line 240 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementValue(), m_readerH, and te::xerces::ToString().

bool te::xml::Reader::getElementValueAsBoolean ( ) const

virtualinherited

It returns the element data value in the case of VALUE node.

Returns

The element data value in the case of VALUE node.

Note

Just call this method if you know that the element value can be converted to a boolean.

Definition at line 42 of file xml/Reader.cpp.

References te::xml::Reader::getElementValue().

Referenced by te::map::serialize::ReadLayerChart(), te::se::serialize::ReadLinePlacement(), and te::se::serialize::ReadShadedRelief().

double te::xml::Reader::getElementValueAsDouble ( ) const

virtualinherited

It returns the element data value in the case of VALUE node.

Returns

The element data value in the case of VALUE node.

Note

Just call this method if you know that the element value can be converted to a double.

Definition at line 37 of file xml/Reader.cpp.

References te::xml::Reader::getElementValue().

Referenced by te::se::serialize::ReadContrastEnhancement(), te::se::serialize::ReadInterpolationPoint(), te::map::serialize::ReadLayerChart(), te::map::serialize::ReadLayerGrouping(), te::map::serialize::ReadLayerRasterContrast(), te::se::serialize::ReadMapItem(), te::se::serialize::ReadRule(), and te::se::serialize::ReadShadedRelief().

boost::int32_t te::xml::Reader::getElementValueAsInt32 ( ) const

virtualinherited

It returns the element data value in the case of VALUE node.

Returns

The element data value in the case of VALUE node.

Note

Just call this method if you know that the element value can be converted to a 32-bit integer.

Definition at line 32 of file xml/Reader.cpp.

References te::xml::Reader::getElementValue().

Referenced by DataSetAdapterLayerReader(), DataSetLayerReader(), te::wms::serialize::LayerReader(), te::ws::ogc::wms::serialize::LayerReader(), QueryLayerReader(), RasterLayerReader(), te::serialize::xml::ReadGrid(), te::map::serialize::ReadLayerChart(), te::map::serialize::ReadLayerGrouping(), te::map::serialize::ReadLayerRasterContrast(), and te::map::serialize::ReadSRIDValue().

void te::xerces::Reader::getNamespace ( std::size_t  i, std::pair< std::string, std::string > &  ns  ) const

virtual

Implements te::xml::Reader.

Definition at line 321 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getNamespace(), m_readerH, and te::xerces::ToString().

te::xml::NodeType te::xerces::Reader::getNodeType ( ) const

virtual

It return the type of node read.

Returns

The type of node read.

Implements te::xml::Reader.

Definition at line 220 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getNodeType(), and m_readerH.

Referenced by next().

std::size_t te::xerces::Reader::getNumberOfAttrs ( ) const

virtual

It returns the number of attributes in the case of an element node.

Returns

The number of attributes in the case of an element node.

Implements te::xml::Reader.

Definition at line 255 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementAttrs(), hasAttrs(), and m_readerH.

std::size_t te::xerces::Reader::getNumberOfNamespaces ( ) const

virtual

Implements te::xml::Reader.

Definition at line 316 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getNumberOfNamespaces(), and m_readerH.

bool te::xerces::Reader::hasAttrs ( ) const

virtual

It tells if the element has attributes in the case of an element node.

Returns

True if the element has attributes in the case of an element node, otherwise, false.

Implements te::xml::Reader.

Definition at line 250 of file xerces/Reader.cpp.

References te::xerces::ReaderHandler::getElementAttrs(), and m_readerH.

Referenced by getNumberOfAttrs().

bool te::xerces::Reader::next ( )

virtual

It gets the next event to be read.

Returns

True if an event was read otherwise false.

Exceptions

Exception

It throws an exception if something goes wrong during the text read.

Implements te::xml::Reader.

Definition at line 162 of file xerces/Reader.cpp.

References te::xml::END_ELEMENT, te::xerces::ErrorHandler::getErrors(), getNodeType(), te::xerces::ReaderHandler::getNodeType(), te::xerces::ReaderHandler::isInContractedForm(), m_errH, m_ignoreWhiteSpaces, m_parser, m_readerH, m_token, te::xerces::ReaderHandler::reset(), te::xerces::ReaderHandler::setInContractedForm(), te::xerces::ReaderHandler::setNodeType(), te::xml::START_ELEMENT, TE_TR, te::xerces::ToString(), te::xml::UNKNOWN, and te::xml::WHITESPACE.

Referenced by read().

void te::xerces::Reader::read ( const std::string &  fileURI )

virtual

It prepare the given file to be read.

You must call read to start parsing the XML document.

Parameters

fileURI

A path to a XML file or any URI where it can be found.

Exceptions

Exception

It throws an exception if the file doesn't exist or if the internal parser can not read it.

Implements te::xml::Reader.

Definition at line 117 of file xerces/Reader.cpp.

References file(), te::core::CharEncoding::fromUTF8(), te::xerces::ErrorHandler::getErrors(), te::xerces::ReaderHandler::getNodeType(), m_parser, m_readerH, m_token, next(), reset(), TE_TR, te::xerces::ToString(), and te::xml::UNKNOWN.

void te::xerces::Reader::reset

(

)

It resets the parser.

Exceptions

Exception

It throws an exception if it is not possible to reset the parser.

Note

Xerces extended method.

Definition at line 334 of file xerces/Reader.cpp.

References m_parser, m_token, TE_TR, and te::xerces::ToString().

Referenced by read(), and ~Reader().

void te::xerces::Reader::setCacheGrammarFromParse ( bool  d )

virtual

If true it caches the grammar in the pool for re-use in subsequent parses.

Parameters

d	If If true it caches the grammar in the pool for re-use in subsequent parses.

Note

By default the reader is set to cache the grammar.

Implements te::xml::Reader.

Definition at line 107 of file xerces/Reader.cpp.

References m_parser.

void te::xerces::Reader::setDoNamespaces ( bool  d )

virtual

It enables or disables the parser namespace processing.

Parameters

d	If true the internal parser will perform the namespace processing otherwise this will not be done.

Note

By default the reader is set to do namespace processing.

Implements te::xml::Reader.

Definition at line 87 of file xerces/Reader.cpp.

References m_parser.

void te::xerces::Reader::setDoSchema ( bool  d )

virtual

It enables or disables the parser schema processing.

Parameters

d	If true the internal parser will perform the schema processing otherwise this will not be done.

Note

If set to true the namespace processing must also be turned on.

By default the reader is set to parser schema.

Implements te::xml::Reader.

Definition at line 92 of file xerces/Reader.cpp.

References m_parser.

void te::xerces::Reader::setIgnoreWhiteSpaces ( bool  d )

virtual

If true the parser will ignore the white space characters.

Parameters

d	If true the parser will ignore the white space characters.

Note

By default the reader is set to consider white spaces.

Implements te::xml::Reader.

Definition at line 112 of file xerces/Reader.cpp.

References d, and m_ignoreWhiteSpaces.

void te::xerces::Reader::setInternalBufferSize ( const std::size_t  size )

virtual

It sets the maximal allowed buffer size used for parsing.

Parameters

size	The maximal allowed buffer size used for parsing.

Note

Default: 65536 bytes (64 kbytes), see the macro TE_XML_READER_MAX_BUFFSIZE.

The default value may be implementation dependent!

Implements te::xml::Reader.

Definition at line 329 of file xerces/Reader.cpp.

References m_parser.

void te::xerces::Reader::setUseCachedGrammarInParse ( bool  d )

virtual

If true the reader will use cached grammar if it exists in the pool.

Parameters

d	If true the reader will use cached grammar if it exists in the pool.

Note

By default the reader is set to use cached grammar.

Implements te::xml::Reader.

Definition at line 102 of file xerces/Reader.cpp.

References m_parser.

void te::xerces::Reader::setValidationScheme ( bool  d )

virtual

If true the parser will perform a validation scheme.

Parameters

d	If true the parser will perform a validation scheme.

Note

By default the reader is set to validate the scheme.

Implements te::xml::Reader.

Definition at line 97 of file xerces/Reader.cpp.

References m_parser.

Member Data Documentation

ErrorHandler* te::xerces::Reader::m_errH

private

A pointer to an error handler.

Definition at line 139 of file xerces/Reader.h.

Referenced by next(), Reader(), and ~Reader().

bool te::xerces::Reader::m_ignoreWhiteSpaces

private

A flag that indicates if the parser should ignore white spaces.

Definition at line 141 of file xerces/Reader.h.

Referenced by next(), and setIgnoreWhiteSpaces().

xercesc::SAX2XMLReader* te::xerces::Reader::m_parser

private

A pointer to the parser used by the reader.

Definition at line 137 of file xerces/Reader.h.

Referenced by next(), read(), Reader(), reset(), setCacheGrammarFromParse(), setDoNamespaces(), setDoSchema(), setInternalBufferSize(), setUseCachedGrammarInParse(), setValidationScheme(), and ~Reader().

ReaderHandler* te::xerces::Reader::m_readerH

private

A pointer to a content handler.

Definition at line 138 of file xerces/Reader.h.

Referenced by getAttr(), getAttrLocalName(), getAttrPosition(), getAttrQName(), getAttrURI(), getElementDataLen(), getElementLocalName(), getElementQName(), getElementURI(), getElementValue(), getNamespace(), getNodeType(), getNumberOfAttrs(), getNumberOfNamespaces(), hasAttrs(), next(), read(), Reader(), and ~Reader().

xercesc::XMLPScanToken* te::xerces::Reader::m_token

private

This keeps the parser state.

Definition at line 140 of file xerces/Reader.h.

Referenced by next(), read(), reset(), and ~Reader().

---

The documentation for this class was generated from the following files:

• xerces/Reader.h
• xerces/Reader.cpp