SBJson库解析（七）SBJsonStreamParser

json数据流解析器

1.定义了一个枚举值表示解析状态：

typedef enum {
    SBJsonStreamParserComplete,
    SBJsonStreamParserWaitingForData,
    SBJsonStreamParserError,
} SBJsonStreamParserStatus;

2.定义了一个json流解析代理协议：

/**
 由SBJsonStreamParserAdapter类实现
 */
@protocol SBJsonStreamParserDelegate

//当找到obj时调用
- (void)parserFoundObjectStart:(SBJsonStreamParser*)parser;

//当找到obj对象key时调用
- (void)parser:(SBJsonStreamParser*)parser foundObjectKey:(NSString*)key;

//当obj结束时调用
- (void)parserFoundObjectEnd:(SBJsonStreamParser*)parser;

//当找到array对象时调用
- (void)parserFoundArrayStart:(SBJsonStreamParser*)parser;

//当array对象结束时调用
- (void)parserFoundArrayEnd:(SBJsonStreamParser*)parser;

//当找到boolean值时调用
- (void)parser:(SBJsonStreamParser*)parser foundBoolean:(BOOL)x;

//当找到null时调用
- (void)parserFoundNull:(SBJsonStreamParser*)parser;

//当找到number时调用
- (void)parser:(SBJsonStreamParser*)parser foundNumber:(NSNumber*)num;

//当找到字符串对象时调用
- (void)parser:(SBJsonStreamParser*)parser foundString:(NSString*)string;

@end

3.属性和声明的方法：

/**
 @json数据流解析器
 把json数据流解析成NSArray或NSDictionary对象
 使用这个类，可以边下载边解析（在整个文件被全部下载之前进行解析）
 用这个类对磁盘上的大文件解析也有好处，不用全部加载到内存
 具体实现可查看SBJsonStreamParserAdapter类
 */
@interface SBJsonStreamParser : NSObject {
@private
    SBJsonTokeniser *tokeniser;
}

@property (nonatomic, unsafe_unretained) SBJsonStreamParserState *state; // Private
@property (nonatomic, readonly, strong) NSMutableArray *stateStack; // Private

/**
 是否用空格隔开多个文件
 当设置为YES,解析器就不会返回SBJsonStreamParserComplete
 默认为NO，一但返回SBJsonStreamParserComplete，解析器不会解析更多数据
 */
@property BOOL supportMultipleDocuments;

/**
 @流解析代理对象
 通常是指SBJsonStreamParserAdapter
 也可以是实现了SBJsonStreamParserDelegate解析代理协议的任何对象
 */
@property (unsafe_unretained) id<SBJsonStreamParserDelegate> delegate;

/**
 @最大递归深度，默认为32
 如果嵌套的太深，大于32被视为恶意解析，返回nil，并发送一个错误信号
 */
@property NSUInteger maxDepth;

//保存BJsonStreamParserError后返回的错误信息
@property (copy) NSString *error;

/**
 解析json数据
 参数是UTF8编码的json数据（NSData）
 返回一个枚举值，流解析状态：
 SBJsonStreamParserComplete表示：解析了全部数据
 SBJsonStreamParserWaitingForData表示：等待获得更多数据
 SBJsonStreamParserError表示：解析出错
 */
- (SBJsonStreamParserStatus)parse:(NSData*)data;

@end