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
|
// -*- 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:
/**
* 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_ */
|
