mirror of
https://github.com/wu736139669/Ash_AWord.git
synced 2026-08-08 06:46:38 +00:00
base
This commit is contained in:
wu736139669
+210
@@ -0,0 +1,210 @@
|
||||
/*
|
||||
Copyright (c) 2010, Stig Brautaset.
|
||||
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 of the the author nor the names of its 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
|
||||
HOLDER 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>
|
||||
|
||||
/// Enable JSON writing for non-native objects
|
||||
@interface NSObject (SBProxyForJson)
|
||||
|
||||
/**
|
||||
Allows generation of JSON for otherwise unsupported classes.
|
||||
|
||||
If you have a custom class that you want to create a JSON representation
|
||||
for you can implement this method in your class. It should return a
|
||||
representation of your object defined in terms of objects that can be
|
||||
translated into JSON. For example, a Person object might implement it like this:
|
||||
|
||||
- (id)proxyForJson {
|
||||
return [NSDictionary dictionaryWithObjectsAndKeys:
|
||||
name, @"name",
|
||||
phone, @"phone",
|
||||
email, @"email",
|
||||
nil];
|
||||
}
|
||||
|
||||
*/
|
||||
- (id)proxyForJson;
|
||||
|
||||
@end
|
||||
|
||||
@class SBJson4StreamWriter;
|
||||
|
||||
@protocol SBJson4StreamWriterDelegate
|
||||
|
||||
- (void)writer:(SBJson4StreamWriter *)writer appendBytes:(const void *)bytes length:(NSUInteger)length;
|
||||
|
||||
@end
|
||||
|
||||
@class SBJson4StreamWriterState;
|
||||
|
||||
/**
|
||||
The Stream Writer class.
|
||||
|
||||
Accepts a stream of messages and writes JSON of these to its delegate object.
|
||||
|
||||
This class provides a range of high-, mid- and low-level methods. You can mix
|
||||
and match calls to these. For example, you may want to call -writeArrayOpen
|
||||
to start an array and then repeatedly call -writeObject: with various objects
|
||||
before finishing off with a -writeArrayClose call.
|
||||
|
||||
Objective-C types are mapped to JSON types in the following way:
|
||||
|
||||
- NSNull -> null
|
||||
- NSString -> string
|
||||
- NSArray -> array
|
||||
- NSDictionary -> object
|
||||
- NSNumber's -initWithBool:YES -> true
|
||||
- NSNumber's -initWithBool:NO -> false
|
||||
- NSNumber -> number
|
||||
|
||||
NSNumber instances created with the -numberWithBool: method are
|
||||
converted into the JSON boolean "true" and "false" values, and vice
|
||||
versa. Any other NSNumber instances are converted to a JSON number the
|
||||
way you would expect.
|
||||
|
||||
@warning: In JSON the keys of an object must be strings. NSDictionary
|
||||
keys need not be, but attempting to convert an NSDictionary with
|
||||
non-string keys into JSON will throw an exception.*
|
||||
|
||||
*/
|
||||
|
||||
@interface SBJson4StreamWriter : NSObject {
|
||||
NSMutableDictionary *cache;
|
||||
}
|
||||
|
||||
@property (nonatomic, weak) SBJson4StreamWriterState *state; // Internal
|
||||
@property (nonatomic, readonly, strong) NSMutableArray *stateStack; // Internal
|
||||
|
||||
/**
|
||||
delegate to receive JSON output
|
||||
Delegate that will receive messages with output.
|
||||
*/
|
||||
@property (nonatomic, weak) id<SBJson4StreamWriterDelegate> delegate;
|
||||
|
||||
/**
|
||||
The maximum recursing depth.
|
||||
|
||||
Defaults to 512. If the input is nested deeper than this the input will be deemed to be
|
||||
malicious and the parser returns nil, signalling an error. ("Nested too deep".) You can
|
||||
turn off this security feature by setting the maxDepth value to 0.
|
||||
*/
|
||||
@property(nonatomic) NSUInteger maxDepth;
|
||||
|
||||
/**
|
||||
Whether we are generating human-readable (multiline) JSON.
|
||||
|
||||
Set whether or not to generate human-readable JSON. The default is NO, which produces
|
||||
JSON without any whitespace between tokens. If set to YES, generates human-readable
|
||||
JSON with linebreaks after each array value and dictionary key/value pair, indented two
|
||||
spaces per nesting level.
|
||||
*/
|
||||
@property(nonatomic) BOOL humanReadable;
|
||||
|
||||
/**
|
||||
Whether or not to sort the dictionary keys in the output.
|
||||
|
||||
If this is set to YES, the dictionary keys in the JSON output will be in sorted order.
|
||||
(This is useful if you need to compare two structures, for example.) The default is NO.
|
||||
*/
|
||||
@property(nonatomic) BOOL sortKeys;
|
||||
|
||||
/**
|
||||
An optional comparator to be used if sortKeys is YES.
|
||||
|
||||
If this is nil, sorting will be done via @selector(compare:).
|
||||
*/
|
||||
@property (nonatomic, copy) NSComparator sortKeysComparator;
|
||||
|
||||
/// Contains the error description after an error has occured.
|
||||
@property (nonatomic, copy) NSString *error;
|
||||
|
||||
/**
|
||||
Write an NSDictionary to the JSON stream.
|
||||
@return YES if successful, or NO on failure
|
||||
*/
|
||||
- (BOOL)writeObject:(NSDictionary*)dict;
|
||||
|
||||
/**
|
||||
Write an NSArray to the JSON stream.
|
||||
@return YES if successful, or NO on failure
|
||||
*/
|
||||
- (BOOL)writeArray:(NSArray *)array;
|
||||
|
||||
/**
|
||||
Start writing an Object to the stream
|
||||
@return YES if successful, or NO on failure
|
||||
*/
|
||||
- (BOOL)writeObjectOpen;
|
||||
|
||||
/**
|
||||
Close the current object being written
|
||||
@return YES if successful, or NO on failure
|
||||
*/
|
||||
- (BOOL)writeObjectClose;
|
||||
|
||||
/** Start writing an Array to the stream
|
||||
@return YES if successful, or NO on failure
|
||||
*/
|
||||
- (BOOL)writeArrayOpen;
|
||||
|
||||
/** Close the current Array being written
|
||||
@return YES if successful, or NO on failure
|
||||
*/
|
||||
- (BOOL)writeArrayClose;
|
||||
|
||||
/** Write a null to the stream
|
||||
@return YES if successful, or NO on failure
|
||||
*/
|
||||
- (BOOL)writeNull;
|
||||
|
||||
/** Write a boolean to the stream
|
||||
@return YES if successful, or NO on failure
|
||||
*/
|
||||
- (BOOL)writeBool:(BOOL)x;
|
||||
|
||||
/** Write a Number to the stream
|
||||
@return YES if successful, or NO on failure
|
||||
*/
|
||||
- (BOOL)writeNumber:(NSNumber*)n;
|
||||
|
||||
/** Write a String to the stream
|
||||
@return YES if successful, or NO on failure
|
||||
*/
|
||||
- (BOOL)writeString:(NSString*)s;
|
||||
|
||||
@end
|
||||
|
||||
@interface SBJson4StreamWriter (Private)
|
||||
- (BOOL)writeValue:(id)v;
|
||||
- (void)appendBytes:(const void *)bytes length:(NSUInteger)length;
|
||||
@end
|
||||
|
||||
Reference in New Issue
Block a user