You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tqt3/src/xml/ntqxml.h

532 lines
17 KiB

/****************************************************************************
**
** Definition of TQXmlSimpleReader and related classes.
**
** Created : 000518
**
** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved.
**
** This file is part of the xml module of the TQt GUI Toolkit.
**
** This file may be used under the terms of the GNU General
** Public License versions 2.0 or 3.0 as published by the Free
** Software Foundation and appearing in the files LICENSE.GPL2
** and LICENSE.GPL3 included in the packaging of this file.
** Alternatively you may (at your option) use any later version
** of the GNU General Public License if such license has been
** publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free TQt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.TQPL
** included in the packaging of this file. Licensees holding valid TQt
** Commercial licenses may use this file in accordance with the TQt
** Commercial License Agreement provided with the Software.
**
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/
#ifndef TQXML_H
#define TQXML_H
#ifndef QT_H
#include "ntqtextstream.h"
#include "ntqfile.h"
#include "ntqstring.h"
#include "ntqstringlist.h"
#include "ntqvaluevector.h"
#endif // QT_H
#if !defined(TQT_MODULE_XML) || defined( QT_LICENSE_PROFESSIONAL ) || defined( QT_INTERNAL_XML )
#define TQM_EXPORT_XML
#else
#define TQM_EXPORT_XML Q_EXPORT
#endif
#ifndef QT_NO_XML
class TQXmlNamespaceSupport;
class TQXmlAttributes;
class TQXmlContentHandler;
class TQXmlDefaultHandler;
class TQXmlDTDHandler;
class TQXmlEntityResolver;
class TQXmlErrorHandler;
class TQXmlLexicalHandler;
class TQXmlDeclHandler;
class TQXmlInputSource;
class TQXmlLocator;
class TQXmlNamespaceSupport;
class TQXmlParseException;
class TQXmlReader;
class TQXmlSimpleReader;
class TQXmlSimpleReaderPrivate;
class TQXmlNamespaceSupportPrivate;
class TQXmlAttributesPrivate;
class TQXmlInputSourcePrivate;
class TQXmlParseExceptionPrivate;
class TQXmlLocatorPrivate;
class TQXmlDefaultHandlerPrivate;
//
// SAX Namespace Support
//
class TQM_EXPORT_XML TQXmlNamespaceSupport
{
public:
TQXmlNamespaceSupport();
~TQXmlNamespaceSupport();
void setPrefix( const TQString&, const TQString& );
TQString prefix( const TQString& ) const;
TQString uri( const TQString& ) const;
void splitName( const TQString&, TQString&, TQString& ) const;
void processName( const TQString&, bool, TQString&, TQString& ) const;
TQStringList prefixes() const;
TQStringList prefixes( const TQString& ) const;
void pushContext();
void popContext();
void reset();
private:
TQXmlNamespaceSupportPrivate *d;
friend class TQXmlSimpleReader;
};
//
// SAX Attributes
//
class TQM_EXPORT_XML TQXmlAttributes
{
public:
TQXmlAttributes() {}
virtual ~TQXmlAttributes() {}
int index( const TQString& qName ) const;
int index( const TQString& uri, const TQString& localPart ) const;
int length() const;
int count() const;
TQString localName( int index ) const;
TQString qName( int index ) const;
TQString uri( int index ) const;
TQString type( int index ) const;
TQString type( const TQString& qName ) const;
TQString type( const TQString& uri, const TQString& localName ) const;
TQString value( int index ) const;
TQString value( const TQString& qName ) const;
TQString value( const TQString& uri, const TQString& localName ) const;
void clear();
void append( const TQString &qName, const TQString &uri, const TQString &localPart, const TQString &value );
private:
TQStringList qnameList;
TQStringList uriList;
TQStringList localnameList;
TQStringList valueList;
TQXmlAttributesPrivate *d;
};
//
// SAX Input Source
//
class TQM_EXPORT_XML TQXmlInputSource
{
public:
TQXmlInputSource();
TQXmlInputSource( TQIODevice *dev );
TQXmlInputSource( TQFile& file ); // obsolete
TQXmlInputSource( TQTextStream& stream ); // obsolete
virtual ~TQXmlInputSource();
virtual void setData( const TQString& dat );
virtual void setData( const TQByteArray& dat );
virtual void fetchData();
virtual TQString data();
virtual TQChar next();
virtual void reset();
static const TQChar EndOfData;
static const TQChar EndOfDocument;
protected:
virtual TQString fromRawData( const TQByteArray &data, bool beginning = FALSE );
private:
void init();
TQIODevice *inputDevice;
TQTextStream *inputStream;
TQString str;
const TQChar *unicode;
int pos;
int length;
bool nextReturnedEndOfData;
TQTextDecoder *encMapper;
TQXmlInputSourcePrivate *d;
};
//
// SAX Exception Classes
//
class TQM_EXPORT_XML TQXmlParseException
{
public:
TQXmlParseException( const TQString& name="", int c=-1, int l=-1, const TQString& p="", const TQString& s="" )
: msg( name ), column( c ), line( l ), pub( p ), sys( s )
{ }
int columnNumber() const;
int lineNumber() const;
TQString publicId() const;
TQString systemId() const;
TQString message() const;
private:
TQString msg;
int column;
int line;
TQString pub;
TQString sys;
TQXmlParseExceptionPrivate *d;
};
//
// XML Reader
//
class TQM_EXPORT_XML TQXmlReader
{
public:
virtual bool feature( const TQString& name, bool *ok = 0 ) const = 0;
virtual void setFeature( const TQString& name, bool value ) = 0;
virtual bool hasFeature( const TQString& name ) const = 0;
virtual void* property( const TQString& name, bool *ok = 0 ) const = 0;
virtual void setProperty( const TQString& name, void* value ) = 0;
virtual bool hasProperty( const TQString& name ) const = 0;
virtual void setEntityResolver( TQXmlEntityResolver* handler ) = 0;
virtual TQXmlEntityResolver* entityResolver() const = 0;
virtual void setDTDHandler( TQXmlDTDHandler* handler ) = 0;
virtual TQXmlDTDHandler* DTDHandler() const = 0;
virtual void setContentHandler( TQXmlContentHandler* handler ) = 0;
virtual TQXmlContentHandler* contentHandler() const = 0;
virtual void setErrorHandler( TQXmlErrorHandler* handler ) = 0;
virtual TQXmlErrorHandler* errorHandler() const = 0;
virtual void setLexicalHandler( TQXmlLexicalHandler* handler ) = 0;
virtual TQXmlLexicalHandler* lexicalHandler() const = 0;
virtual void setDeclHandler( TQXmlDeclHandler* handler ) = 0;
virtual TQXmlDeclHandler* declHandler() const = 0;
virtual bool parse( const TQXmlInputSource& input ) = 0;
virtual bool parse( const TQXmlInputSource* input ) = 0;
};
class TQM_EXPORT_XML TQXmlSimpleReader : public TQXmlReader
{
public:
TQXmlSimpleReader();
virtual ~TQXmlSimpleReader();
bool feature( const TQString& name, bool *ok = 0 ) const;
void setFeature( const TQString& name, bool value );
bool hasFeature( const TQString& name ) const;
void* property( const TQString& name, bool *ok = 0 ) const;
void setProperty( const TQString& name, void* value );
bool hasProperty( const TQString& name ) const;
void setEntityResolver( TQXmlEntityResolver* handler );
TQXmlEntityResolver* entityResolver() const;
void setDTDHandler( TQXmlDTDHandler* handler );
TQXmlDTDHandler* DTDHandler() const;
void setContentHandler( TQXmlContentHandler* handler );
TQXmlContentHandler* contentHandler() const;
void setErrorHandler( TQXmlErrorHandler* handler );
TQXmlErrorHandler* errorHandler() const;
void setLexicalHandler( TQXmlLexicalHandler* handler );
TQXmlLexicalHandler* lexicalHandler() const;
void setDeclHandler( TQXmlDeclHandler* handler );
TQXmlDeclHandler* declHandler() const;
bool parse( const TQXmlInputSource& input );
bool parse( const TQXmlInputSource* input );
virtual bool parse( const TQXmlInputSource* input, bool incremental );
virtual bool parseContinue();
private:
// variables
TQXmlContentHandler *contentHnd;
TQXmlErrorHandler *errorHnd;
TQXmlDTDHandler *dtdHnd;
TQXmlEntityResolver *entityRes;
TQXmlLexicalHandler *lexicalHnd;
TQXmlDeclHandler *declHnd;
TQXmlInputSource *inputSource;
TQChar c; // the character at reading position
int lineNr; // number of line
int columnNr; // position in line
int nameArrayPos;
TQChar nameArray[256]; // only used for names
TQString nameValue; // only used for names
int refArrayPos;
TQChar refArray[256]; // only used for references
TQString refValue; // only used for references
int stringArrayPos;
TQChar stringArray[256]; // used for any other strings that are parsed
TQString stringValue; // used for any other strings that are parsed
TQXmlSimpleReaderPrivate* d;
const TQString &string();
void stringClear();
inline void stringAddC() { stringAddC(c); }
void stringAddC(const TQChar&);
const TQString& name();
void nameClear();
inline void nameAddC() { nameAddC(c); }
void nameAddC(const TQChar&);
const TQString& ref();
void refClear();
inline void refAddC() { refAddC(c); }
void refAddC(const TQChar&);
// used by parseReference() and parsePEReference()
enum EntityRecognitionContext { InContent, InAttributeValue, InEntityValue, InDTD };
// private functions
bool eat_ws();
bool next_eat_ws();
void next();
bool atEnd();
void init( const TQXmlInputSource* i );
void initData();
bool entityExist( const TQString& ) const;
bool parseBeginOrContinue( int state, bool incremental );
bool parseProlog();
bool parseElement();
bool processElementEmptyTag();
bool processElementETagBegin2();
bool processElementAttribute();
bool parseMisc();
bool parseContent();
bool parsePI();
bool parseDoctype();
bool parseComment();
bool parseName();
bool parseNmtoken();
bool parseAttribute();
bool parseReference();
bool processReference();
bool parseExternalID();
bool parsePEReference();
bool parseMarkupdecl();
bool parseAttlistDecl();
bool parseAttType();
bool parseAttValue();
bool parseElementDecl();
bool parseNotationDecl();
bool parseChoiceSeq();
bool parseEntityDecl();
bool parseEntityValue();
bool parseString();
bool insertXmlRef( const TQString&, const TQString&, bool );
bool reportEndEntities();
void reportParseError( const TQString& error );
typedef bool (TQXmlSimpleReader::*ParseFunction) ();
void unexpectedEof( ParseFunction where, int state );
void parseFailed( ParseFunction where, int state );
void pushParseState( ParseFunction function, int state );
void setUndefEntityInAttrHack(bool b);
friend class TQXmlSimpleReaderPrivate;
friend class TQXmlSimpleReaderLocator;
friend class TQDomDocumentPrivate;
};
//
// SAX Locator
//
class TQM_EXPORT_XML TQXmlLocator
{
public:
TQXmlLocator();
virtual ~TQXmlLocator();
virtual int columnNumber() = 0;
virtual int lineNumber() = 0;
// TQString getPublicId()
// TQString getSystemId()
};
//
// SAX handler classes
//
class TQM_EXPORT_XML TQXmlContentHandler
{
public:
virtual void setDocumentLocator( TQXmlLocator* locator ) = 0;
virtual bool startDocument() = 0;
virtual bool endDocument() = 0;
virtual bool startPrefixMapping( const TQString& prefix, const TQString& uri ) = 0;
virtual bool endPrefixMapping( const TQString& prefix ) = 0;
virtual bool startElement( const TQString& namespaceURI, const TQString& localName, const TQString& qName, const TQXmlAttributes& atts ) = 0;
virtual bool endElement( const TQString& namespaceURI, const TQString& localName, const TQString& qName ) = 0;
virtual bool characters( const TQString& ch ) = 0;
virtual bool ignorableWhitespace( const TQString& ch ) = 0;
virtual bool processingInstruction( const TQString& target, const TQString& data ) = 0;
virtual bool skippedEntity( const TQString& name ) = 0;
virtual TQString errorString() = 0;
};
class TQM_EXPORT_XML TQXmlErrorHandler
{
public:
virtual bool warning( const TQXmlParseException& exception ) = 0;
virtual bool error( const TQXmlParseException& exception ) = 0;
virtual bool fatalError( const TQXmlParseException& exception ) = 0;
virtual TQString errorString() = 0;
};
class TQM_EXPORT_XML TQXmlDTDHandler
{
public:
virtual bool notationDecl( const TQString& name, const TQString& publicId, const TQString& systemId ) = 0;
virtual bool unparsedEntityDecl( const TQString& name, const TQString& publicId, const TQString& systemId, const TQString& notationName ) = 0;
virtual TQString errorString() = 0;
};
class TQM_EXPORT_XML TQXmlEntityResolver
{
public:
virtual bool resolveEntity( const TQString& publicId, const TQString& systemId, TQXmlInputSource*& ret ) = 0;
virtual TQString errorString() = 0;
};
class TQM_EXPORT_XML TQXmlLexicalHandler
{
public:
virtual bool startDTD( const TQString& name, const TQString& publicId, const TQString& systemId ) = 0;
virtual bool endDTD() = 0;
virtual bool startEntity( const TQString& name ) = 0;
virtual bool endEntity( const TQString& name ) = 0;
virtual bool startCDATA() = 0;
virtual bool endCDATA() = 0;
virtual bool comment( const TQString& ch ) = 0;
virtual TQString errorString() = 0;
};
class TQM_EXPORT_XML TQXmlDeclHandler
{
public:
virtual bool attributeDecl( const TQString& eName, const TQString& aName, const TQString& type, const TQString& valueDefault, const TQString& value ) = 0;
virtual bool internalEntityDecl( const TQString& name, const TQString& value ) = 0;
virtual bool externalEntityDecl( const TQString& name, const TQString& publicId, const TQString& systemId ) = 0;
virtual TQString errorString() = 0;
};
class TQM_EXPORT_XML TQXmlDefaultHandler : public TQXmlContentHandler, public TQXmlErrorHandler, public TQXmlDTDHandler, public TQXmlEntityResolver, public TQXmlLexicalHandler, public TQXmlDeclHandler
{
public:
TQXmlDefaultHandler() { }
virtual ~TQXmlDefaultHandler() { }
void setDocumentLocator( TQXmlLocator* locator );
bool startDocument();
bool endDocument();
bool startPrefixMapping( const TQString& prefix, const TQString& uri );
bool endPrefixMapping( const TQString& prefix );
bool startElement( const TQString& namespaceURI, const TQString& localName, const TQString& qName, const TQXmlAttributes& atts );
bool endElement( const TQString& namespaceURI, const TQString& localName, const TQString& qName );
bool characters( const TQString& ch );
bool ignorableWhitespace( const TQString& ch );
bool processingInstruction( const TQString& target, const TQString& data );
bool skippedEntity( const TQString& name );
bool warning( const TQXmlParseException& exception );
bool error( const TQXmlParseException& exception );
bool fatalError( const TQXmlParseException& exception );
bool notationDecl( const TQString& name, const TQString& publicId, const TQString& systemId );
bool unparsedEntityDecl( const TQString& name, const TQString& publicId, const TQString& systemId, const TQString& notationName );
bool resolveEntity( const TQString& publicId, const TQString& systemId, TQXmlInputSource*& ret );
bool startDTD( const TQString& name, const TQString& publicId, const TQString& systemId );
bool endDTD();
bool startEntity( const TQString& name );
bool endEntity( const TQString& name );
bool startCDATA();
bool endCDATA();
bool comment( const TQString& ch );
bool attributeDecl( const TQString& eName, const TQString& aName, const TQString& type, const TQString& valueDefault, const TQString& value );
bool internalEntityDecl( const TQString& name, const TQString& value );
bool externalEntityDecl( const TQString& name, const TQString& publicId, const TQString& systemId );
TQString errorString();
private:
TQXmlDefaultHandlerPrivate *d;
};
//
// inlines
//
inline bool TQXmlSimpleReader::atEnd()
{ return (c.unicode()|0x0001) == 0xffff; }
inline int TQXmlAttributes::count() const
{ return length(); }
#endif //QT_NO_XML
#endif