This repository was archived by the owner on Aug 27, 2022. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 6
/
Copy pathMPWMAXParser.h
182 lines (142 loc) · 7.84 KB
/
MPWMAXParser.h
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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
/* MPWMAXParser.h Copyright (c) Marcel P. Weiher 1999-2008, All Rights Reserved,
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in
the documentation and/or other materials provided with the distribution.
Neither the name Marcel Weiher nor the names of contributors may
be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
THE POSSIBILITY OF SUCH DAMAGE. */
#import <Foundation/Foundation.h>
#if MPWXMLINTEGRATED
#import "NSXMLParserMAX.h"
#else
#define MAX_ACTION_NONE 0
#define MAX_ACTION_PLIST 1
#define MAX_ACTION_CHILDREN 2
#define MAX_ACTION_DOM 3
extern NSString *MPWXMLCDataKey;
extern NSString *MPWXMLPCDataKey;
@protocol NSXMLAttributes <NSObject>
-(id)objectForKey:(id)aKey; // retrieve first value whose local name matches aKey
-(id)objectForUniqueKey:(id)aKey; // retrieve first value whose local name is identical to aKey
-(id)objectForUniqueKey:(id)aKey namespace:aNamespace; // retrieve first value whose local name is identical to aKey
-(id)objectsForKey:(id)aKey; // retrieve all values whose local name matches aKey
//-(id)objectsForUniqueKey:(id)aKey; // retrieve all values whose assigned tag (see MAX configuration messages) is aTag
-(id)objectForCaseInsensitiveKey:(id)aKey; // retrieve first value whose local name matches aKey ignoring case
-(id)objectAtIndex:(NSUInteger)anIndex; // get value by position
-(NSUInteger)count;
-(NSString*)combinedText;
-(void)copyValueOfKey:(NSString*)xmlkey toObject:targetObject usingKey:(NSString*)targetKey;
-(void)copyValueOfKey:xmlkey toObject:targetObject;
-lastObject;
@end
@class MPWXMLAttributes,MPWObjectCache;
typedef id (*XMLIMP0)(id, SEL);
typedef id (*XMLIMP1)(id, SEL, id);
typedef id (*XMLIMP2)(id, SEL, id,id);
typedef id (*XMLIMPCHARPLONG)(id, SEL, char *,long);
typedef id (*XMLIMP3)(id, SEL, id,id,id);
typedef id (*XMLIMP1CharP1L1)(id, SEL, id,const char*,long);
typedef id (*XMLIMP4)(id, SEL, id,id,id,id);
typedef id (*XMLIMP5)(id, SEL, id,id,id,id,id);
typedef id (*XMLIMP6)(id, SEL, id,id,id,id,id,id);
#endif
@interface MPWMAXParser : NSObject {
id data;
id scanner;
id documentHandler;
id dataCache;
MPWObjectCache *attributeCache;
XMLIMP0 getData;
XMLIMP1CharP1L1 initDataBytesLength;
void *_elementStack;
NSInteger tagStackLen,tagStackCapacity,maxDepthAllowed;
XMLIMP5 beginElement;
XMLIMP4 endElement;
XMLIMP1 characterDataAllowed;
XMLIMP2 characters,cdata;
XMLIMP3 uniqueTagForCString;
XMLIMPCHARPLONG tagHandlerForPrefix;
XMLIMPCHARPLONG prefixMapObjectForCString;
MPWXMLAttributes* _attributes;
NSMutableDictionary* namespacePrefixToURIMap;
id characterHandler;
MPWXMLAttributes* emptyDict;
id defaultNamespaceHandler,namespaceHandlers;
id prefix2HandlerMap;
id parseResult;
NSInteger numSpacesOnStack;
BOOL ignoreSpace,shouldProcessNamespaces;
BOOL shouldReportNamespacePrefixes, autotranslateUTF8,ignoreCase;
BOOL enforceTagNesting,lastTagWasOpen;
BOOL reportIgnoreableWhitespace,charactersAreSpace;
long dataEncoding,cfDataEncoding;
NSString* version;
const char* lastGoodPosition;
NSMutableData *buffer;
BOOL isReceivingData;
NSURL *url;
int undefinedTagAction;
}
+parser; // returns a non-configured parser
@property(assign) BOOL reportIgnoreableWhitespace; // default is NO (whether to report whitespace in mixed content)
@property(assign) BOOL enforceTagNesting; // default is YES (NO allows HTML or slightly bad XML to be parsed)
@property(assign) BOOL ignoreCase; // default is NO (YES makes it easier to deal with HTML)
@property(assign) BOOL shouldProcessNamespaces; //
@property(assign) int undefinedTagAction;
@property (nonatomic, strong) NSError *parserError;
-(BOOL)parse:(NSData*)xmlData; // process the XML data passed, start sending element(1) or tag(2)
// messages to the configured handlers according to the
// NSMAXParserDelegate 'protocol' and message patterns.
-(instancetype)initWithData:(NSData*)data;
-(BOOL)parse;
-(id)parsedData:(NSData*)someData;
-(NSInteger)currentElementNestingLevel; // nesting level of the element currently being processed
-(NSString*)elementNameAtNestingLevel:(NSInteger)depth; // the tag names at different nesting levels
-(id <NSXMLAttributes>)elementAttributesAtNestingLevel:(NSInteger)depth; // the tag attributes at different nesting levels
-bytesForCurrentElement;
-(void)setStringEncodingFromIANACharset:(NSString*)charSetName;
-(void)setMaxDepthAllowed:(NSInteger)maxDepth;
-(BOOL)isCurrentElementIncomplete;
-(void)abortParsing;
-(id)parseResult; // root of the parse-tree constructed (valid after parse is complete)
-(void)setDelegate:handler;
//--- Configure element(1) messages to be sent for specific elements in a specific namespace (nil for the default namespace)
//--- Messages will be sent to a specific handler object. Element names will be assigned numeric tags starting sequentially
//--- from the tagBase paramater. The map dictionary allows XML tag names that are not compatible with Objective-C syntax
//--- rules for message names to be mapped to ones that are.
-(id )setHandler:(id)handler forElements:(NSArray*)elementNames inNamespace:(NSString*)namespaceString
prefix:(NSString*)prefix map:(NSDictionary*)map;
-(id)setHandler:handler forElements:(NSArray*)elementNames;
//--- Configure tag(1) messages to be sent for specific tags in a specific namespace (nil for the default namespace)
//--- Messages will be sent to a specific handler object. The map dictionary allows XML tag names that are not
//--- compatible with Objective-C syntax rules for message names to be mapped to ones that are.
-(id )setHandler:(id)handler forTags:(NSArray*)tagNamespace inNamespace:(NSString*)namespaceString
prefix:(NSString*)prefix map:(NSDictionary*)map;
-(id)setHandler:handler forTags:(NSArray*)tags;
//--- Declare attributes we expect to handle for a specific namespace and assign them sequentially numbered integer
//--- tags for easy and efficient retrieval. (Tags are also required to disambiguate potentially overlapping
//--- names)
-(id )declareAttributes:(NSArray*)attributes inNamespace:(NSString*)namespaceString;
//--- utility construction methods
-buildPlistWithChildren:(MPWXMLAttributes*)children attributes:(MPWXMLAttributes*)attributes parser:(MPWMAXParser*)parser;
#if NS_BLOCKS_AVAILABLE
typedef id (^xmlElementBlock)(id elements, id attributes, id parser );
-(void)handleElement:(NSString*)elementName withBlock:(xmlElementBlock)aBlock;
#endif
@end