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
|
// -*- C++ -*-
//=============================================================================
/**
* @file ContentHandler.h
*
* $Id$
*
* @author Nanbor Wang <nanbor@cs.wustl.edu>
*/
//=============================================================================
#ifndef _ACEXML_CONTENTHANDLER_H_
#define _ACEXML_CONTENTHANDLER_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/Env.h"
#include "ACEXML/common/SAXExceptions.h"
#include "ACEXML/common/Locator.h"
#include "ACEXML/common/Attributes.h"
/**
* @class ACEXML_ContentHandler ContentHandler.h "ACEXML/common/ContentHandler.h"
*
* @brief ACEXML_ContentHandler
*
* This is the main interface that most SAX applications implement: if the
* application needs to be informed of basic parsing events, it implements
* this interface and registers an instance with the SAX parser using the
* setContentHandler method. The parser uses the instance to report basic
* document-related events like the start and end of elements and character
* data.
*
* The order of events in this interface is very important, and mirrors the
* order of information in the document itself. For example, all of an
* element's content (character data, processing instructions, and/or
* subelements) will appear, in order, between the startElement event and
* the corresponding endElement event.
*/
class ACEXML_Export ACEXML_ContentHandler
{
public:
virtual ~ACEXML_ContentHandler (void);
/**
* Receive notification of character data.
*/
virtual void characters (const ACEXML_Char *ch,
int start,
int length ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* Receive notification of the end of a document.
*/
virtual void endDocument (ACEXML_ENV_SINGLE_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* Receive notification of the end of an element.
*/
virtual void endElement (const ACEXML_Char *namespaceURI,
const ACEXML_Char *localName,
const ACEXML_Char *qName ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* End the scope of a prefix-URI mapping.
*/
virtual void endPrefixMapping (const ACEXML_Char *prefix ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* Receive notification of ignorable whitespace in element content.
*/
virtual void ignorableWhitespace (const ACEXML_Char *ch,
int start,
int length ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* Receive notification of a processing instruction.
*/
virtual void processingInstruction (const ACEXML_Char *target,
const ACEXML_Char *data ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* Receive an object for locating the origin of SAX document events.
*/
virtual void setDocumentLocator (ACEXML_Locator *locator) = 0;
/**
* Receive notification of a skipped entity.
*/
virtual void skippedEntity (const ACEXML_Char *name ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* Receive notification of the beginning of a document.
*/
virtual void startDocument (ACEXML_ENV_SINGLE_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* Receive notification of the beginning of an element.
*/
virtual void startElement (const ACEXML_Char *namespaceURI,
const ACEXML_Char *localName,
const ACEXML_Char *qName,
ACEXML_Attributes *atts ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
/**
* Begin the scope of a prefix-URI Namespace mapping.
*/
virtual void startPrefixMapping (const ACEXML_Char *prefix,
const ACEXML_Char *uri ACEXML_ENV_ARG_DECL)
ACE_THROW_SPEC ((ACEXML_SAXException)) = 0;
};
#include /**/ "ace/post.h"
#endif /* _ACEXML_CONTENTHANDLER_H_ */
|
