blob: c95024d3dd406a088a39beafcbfb202a54c36bfc (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
// -*- C++ -*-
//=============================================================================
/**
* @file XMLReader.h
*
* $Id$
*
* @author Nanbor Wang <nanbor@cs.wustl.edu>
*/
//=============================================================================
#ifndef _ACEXML_XMLREADER_H_
#define _ACEXML_XMLREADER_H_
#include /**/ "ace/pre.h"
#include "ACEXML/common/ACEXML_Export.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
#pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "ACEXML/common/ContentHandler.h"
#include "ACEXML/common/DTDHandler.h"
#include "ACEXML/common/EntityResolver.h"
#include "ACEXML/common/ErrorHandler.h"
/**
* @class ACEXML_XMLReader XMLReader.h "ACEXML/common/XMLReader.h"
*
* @brief ACEXML_XMLReader
*
* XMLReader is the interface that an XML parser's SAX2 driver must
* implement. This interface allows an application to set and query
* features and properties in the parser, to register event handlers
* for document processing, and to initiate a document parse.
*
* All SAX interfaces are assumed to be synchronous: the parse methods
* must not return until parsing is complete, and readers must wait
* for an event-handler callback to return before reporting the next
* event.
*/
class ACEXML_Export ACEXML_XMLReader
{
public:
virtual ~ACEXML_XMLReader (void);
/**
* Return the current content handler.
*/
virtual ACEXML_ContentHandler *getContentHandler (void) const = 0;
/**
* Return the current DTD handler.
*/
virtual ACEXML_DTDHandler *getDTDHandler (void) const = 0;
/**
* Return the current entity resolver.
*/
virtual ACEXML_EntityResolver *getEntityResolver (void) const = 0;
/**
* Return the current error handler.
*/
virtual ACEXML_ErrorHandler *getErrorHandler (void) const = 0;
/**
* Look up the value of a feature. This method allows
* programmers to check whether a specific feature has been
* activated in the parser.
*/
virtual int getFeature (const ACEXML_Char *name ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXNotRecognizedException,
ACEXML_SAXNotSupportedException)) = 0;
/**
* Look up the value of a property.
*/
virtual void * getProperty (const ACEXML_Char *name ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXNotRecognizedException,
ACEXML_SAXNotSupportedException)) = 0;
/**
* Parse an XML document.
*/
virtual void parse (ACEXML_InputSource *input ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* Parse an XML document from a system identifier (URI).
*/
virtual void parse (const ACEXML_Char *systemId ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* Allow an application to register a content event handler.
*/
virtual void setContentHandler (ACEXML_ContentHandler *handler) = 0;
/**
* Allow an application to register a DTD event handler.
*/
virtual void setDTDHandler (ACEXML_DTDHandler *handler) = 0;
/**
* Allow an application to register an entity resolver.
*/
virtual void setEntityResolver (ACEXML_EntityResolver *resolver) = 0;
/**
* Allow an application to register an error event handler.
*/
virtual void setErrorHandler (ACEXML_ErrorHandler *handler) = 0;
/**
* Activating or deactivating a feature.
*/
virtual void setFeature (const ACEXML_Char *name,
int boolean_value ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXNotRecognizedException,
ACEXML_SAXNotSupportedException)) = 0;
/**
* Set the value of a property.
*/
virtual void setProperty (const ACEXML_Char *name,
void *value ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXNotRecognizedException,
ACEXML_SAXNotSupportedException)) = 0;
};
#include /**/ "ace/post.h"
#endif /* _ACEXML_XMLREADER_H_ */
|
