root / Classes / SBJSON.m @ 72744ed1
History | View | Annotate | Download (6.7 kB)
1 |
/* |
---|---|
2 |
Copyright (C) 2007-2009 Stig Brautaset. All rights reserved. |
3 |
|
4 |
Redistribution and use in source and binary forms, with or without |
5 |
modification, are permitted provided that the following conditions are met: |
6 |
|
7 |
* Redistributions of source code must retain the above copyright notice, this |
8 |
list of conditions and the following disclaimer. |
9 |
|
10 |
* Redistributions in binary form must reproduce the above copyright notice, |
11 |
this list of conditions and the following disclaimer in the documentation |
12 |
and/or other materials provided with the distribution. |
13 |
|
14 |
* Neither the name of the author nor the names of its contributors may be used |
15 |
to endorse or promote products derived from this software without specific |
16 |
prior written permission. |
17 |
|
18 |
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
19 |
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
20 |
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
21 |
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE |
22 |
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
23 |
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR |
24 |
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER |
25 |
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
26 |
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
27 |
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
28 |
*/ |
29 |
|
30 |
#import "SBJSON.h" |
31 |
|
32 |
@implementation SBJSON |
33 |
|
34 |
- (id)init { |
35 |
self = [super init]; |
36 |
if (self) { |
37 |
jsonWriter = [SBJsonWriter new]; |
38 |
jsonParser = [SBJsonParser new]; |
39 |
[self setMaxDepth:512]; |
40 |
|
41 |
} |
42 |
return self; |
43 |
} |
44 |
|
45 |
- (void)dealloc { |
46 |
[jsonWriter release]; |
47 |
[jsonParser release]; |
48 |
[super dealloc]; |
49 |
} |
50 |
|
51 |
#pragma mark Writer |
52 |
|
53 |
|
54 |
- (NSString *)stringWithObject:(id)obj { |
55 |
NSString *repr = [jsonWriter stringWithObject:obj]; |
56 |
if (repr) |
57 |
return repr; |
58 |
|
59 |
[errorTrace release]; |
60 |
errorTrace = [[jsonWriter errorTrace] mutableCopy]; |
61 |
return nil; |
62 |
} |
63 |
|
64 |
/** |
65 |
Returns a string containing JSON representation of the passed in value, or nil on error. |
66 |
If nil is returned and @p error is not NULL, @p *error can be interrogated to find the cause of the error. |
67 |
|
68 |
@param value any instance that can be represented as a JSON fragment |
69 |
@param allowScalar wether to return json fragments for scalar objects |
70 |
@param error used to return an error by reference (pass NULL if this is not desired) |
71 |
|
72 |
@deprecated Given we bill ourselves as a "strict" JSON library, this method should be removed. |
73 |
*/ |
74 |
- (NSString*)stringWithObject:(id)value allowScalar:(BOOL)allowScalar error:(NSError**)error { |
75 |
|
76 |
NSString *json = allowScalar ? [jsonWriter stringWithFragment:value] : [jsonWriter stringWithObject:value]; |
77 |
if (json) |
78 |
return json; |
79 |
|
80 |
[errorTrace release]; |
81 |
errorTrace = [[jsonWriter errorTrace] mutableCopy]; |
82 |
|
83 |
if (error) |
84 |
*error = [errorTrace lastObject]; |
85 |
return nil; |
86 |
} |
87 |
|
88 |
/** |
89 |
Returns a string containing JSON representation of the passed in value, or nil on error. |
90 |
If nil is returned and @p error is not NULL, @p error can be interrogated to find the cause of the error. |
91 |
|
92 |
@param value any instance that can be represented as a JSON fragment |
93 |
@param error used to return an error by reference (pass NULL if this is not desired) |
94 |
|
95 |
@deprecated Given we bill ourselves as a "strict" JSON library, this method should be removed. |
96 |
*/ |
97 |
- (NSString*)stringWithFragment:(id)value error:(NSError**)error { |
98 |
return [self stringWithObject:value |
99 |
allowScalar:YES |
100 |
error:error]; |
101 |
} |
102 |
|
103 |
/** |
104 |
Returns a string containing JSON representation of the passed in value, or nil on error. |
105 |
If nil is returned and @p error is not NULL, @p error can be interrogated to find the cause of the error. |
106 |
|
107 |
@param value a NSDictionary or NSArray instance |
108 |
@param error used to return an error by reference (pass NULL if this is not desired) |
109 |
*/ |
110 |
- (NSString*)stringWithObject:(id)value error:(NSError**)error { |
111 |
return [self stringWithObject:value |
112 |
allowScalar:NO |
113 |
error:error]; |
114 |
} |
115 |
|
116 |
#pragma mark Parsing |
117 |
|
118 |
- (id)objectWithString:(NSString *)repr { |
119 |
id obj = [jsonParser objectWithString:repr]; |
120 |
if (obj) |
121 |
return obj; |
122 |
|
123 |
[errorTrace release]; |
124 |
errorTrace = [[jsonParser errorTrace] mutableCopy]; |
125 |
|
126 |
return nil; |
127 |
} |
128 |
|
129 |
/** |
130 |
Returns the object represented by the passed-in string or nil on error. The returned object can be |
131 |
a string, number, boolean, null, array or dictionary. |
132 |
|
133 |
@param value the json string to parse |
134 |
@param allowScalar whether to return objects for JSON fragments |
135 |
@param error used to return an error by reference (pass NULL if this is not desired) |
136 |
|
137 |
@deprecated Given we bill ourselves as a "strict" JSON library, this method should be removed. |
138 |
*/ |
139 |
- (id)objectWithString:(id)value allowScalar:(BOOL)allowScalar error:(NSError**)error { |
140 |
|
141 |
id obj = allowScalar ? [jsonParser fragmentWithString:value] : [jsonParser objectWithString:value]; |
142 |
if (obj) |
143 |
return obj; |
144 |
|
145 |
[errorTrace release]; |
146 |
errorTrace = [[jsonParser errorTrace] mutableCopy]; |
147 |
|
148 |
if (error) |
149 |
*error = [errorTrace lastObject]; |
150 |
return nil; |
151 |
} |
152 |
|
153 |
/** |
154 |
Returns the object represented by the passed-in string or nil on error. The returned object can be |
155 |
a string, number, boolean, null, array or dictionary. |
156 |
|
157 |
@param repr the json string to parse |
158 |
@param error used to return an error by reference (pass NULL if this is not desired) |
159 |
|
160 |
@deprecated Given we bill ourselves as a "strict" JSON library, this method should be removed. |
161 |
*/ |
162 |
- (id)fragmentWithString:(NSString*)repr error:(NSError**)error { |
163 |
return [self objectWithString:repr |
164 |
allowScalar:YES |
165 |
error:error]; |
166 |
} |
167 |
|
168 |
/** |
169 |
Returns the object represented by the passed-in string or nil on error. The returned object |
170 |
will be either a dictionary or an array. |
171 |
|
172 |
@param repr the json string to parse |
173 |
@param error used to return an error by reference (pass NULL if this is not desired) |
174 |
*/ |
175 |
- (id)objectWithString:(NSString*)repr error:(NSError**)error { |
176 |
return [self objectWithString:repr |
177 |
allowScalar:NO |
178 |
error:error]; |
179 |
} |
180 |
|
181 |
|
182 |
|
183 |
#pragma mark Properties - parsing |
184 |
|
185 |
- (NSUInteger)maxDepth { |
186 |
return jsonParser.maxDepth; |
187 |
} |
188 |
|
189 |
- (void)setMaxDepth:(NSUInteger)d { |
190 |
jsonWriter.maxDepth = jsonParser.maxDepth = d; |
191 |
} |
192 |
|
193 |
|
194 |
#pragma mark Properties - writing |
195 |
|
196 |
- (BOOL)humanReadable { |
197 |
return jsonWriter.humanReadable; |
198 |
} |
199 |
|
200 |
- (void)setHumanReadable:(BOOL)x { |
201 |
jsonWriter.humanReadable = x; |
202 |
} |
203 |
|
204 |
- (BOOL)sortKeys { |
205 |
return jsonWriter.sortKeys; |
206 |
} |
207 |
|
208 |
- (void)setSortKeys:(BOOL)x { |
209 |
jsonWriter.sortKeys = x; |
210 |
} |
211 |
|
212 |
@end |