CollectionUtils 1.0.2

CollectionUtils 1.0.2

测试已测试
Lang语言 Obj-CObjective C
许可证 MIT
发布时间最新发布2015年9月

kishikawa katsumi 维护。



Objective-C 集合类有用的工具。

CollectionUtils/Compact

NSArray 和 NSDictionary 的子类,可以递归地自动删除所有 NSNull 值,而几乎没有性能损失。
对于来自 Web 服务的 JSON 非常有用。

使用方法

从数组中移除 NSNull 值

NSArray *array = @[@"0", @"1", [NSNull null], @"2", [NSNull null], @"3"];
NSArray *compactArray = [array cu_compactArray];
//=> ["0", "1", "2", "3"]

从字典中移除 NSNull 值

NSDictionary *dictionary = @{@"one": @"1",
                             @"null": [NSNull null],
                             @"two": @"2",
                             @"three": @"3"};
NSDictionary *compactDictionary = [dictionary cu_compactDictionary];
 //=> {"one": "1", "two": "2", "three": "3"}

默认递归移除所有 NSNull 值

NSArray *array = @[@"0",
                   @"1",
                   [NSNull null],
                   @"2",
                   @{@"one": @"1",
                     @"null": [NSNull null],
                     @"two": @"2",
                     @"three": @"3"},
                   @"4"];
NSMutableArray *compactArray = [array cu_compactArray];
//=> ["0", "1", "2", {"one": "1", "two": "2", "three": "3"}, "4"]

从来自 Web 服务的 JSON 中移除所有 NSNull 值

id object = [NSJSONSerialization JSONObjectWithData:data options:opt error:error];
id result =  [object cu_compactJSONObject];

CUJSONSerialization 是一个便利类,用于从 JSON 数据中移除所有 NSNull 值

id result = [CUJSONSerialization JSONObjectWithData:data options:kNilOptions error:nil];

AFNetworking 扩展

CUJSONResponseSerializer (用于 AFNetworking 2.x)

安装

pod "CollectionUtils-AFNetworking"

使用方法

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
manager.responseSerializer = [CUJSONResponseSerializer serializer];

[manager GET:@"http://example.com/resources.json" parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
    NSLog(@"JSON: %@", responseObject);
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
    NSLog(@"Error: %@", error);
}];

CUJSONRequestOperation (用于 AFNetworking 1.x)

安装

pod "CollectionUtils-AFNetworking-1.3"

使用方法

NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"http://example.com/resources.json"]];
CUJSONRequestOperation *operation = [CUJSONRequestOperation JSONRequestOperationWithRequest:request success:^(NSURLRequest *request, NSHTTPURLResponse *response, id JSON) {
    NSLog(@"JSON: %@", JSON);
} failure:^(NSURLRequest *request, NSHTTPURLResponse *response, NSError *error, id JSON) {
    NSLog(@"Error: %@", error);
}];
[operation start];
AFHTTPClient *client = [AFHTTPClient clientWithBaseURL:[NSURL URLWithString:@"http://example.com/"]];
[client registerHTTPOperationClass:[CUJSONRequestOperation class]];
[client setDefaultHeader:@"Accept" value:@"application/json"];

[client getPath:@"resouce.json" parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
    NSLog(@"JSON: %@", responseObject);
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
    NSLog(@"Error: %@", error);
}];

几乎无性能损耗

它的工作原理

CUCompactArrayCUCompactDictionary 只是封装了原始的数组/字典,使其表现得就像没有任何 NSNull 值一样。

为了移除嵌套集合并中的NSNull值,将该操作延迟到实际访问嵌套数组/字典时执行。
每次仅执行一个层级。

需求

  • iOS 4.3或以上
  • OS X 10.6或以上

安装

如果您想使用AFNetworking的功能,请添加以下行

pod "CollectionUtils-AFNetworking"

如果您使用的是较旧版本的AFNetworking,

pod "CollectionUtils-AFNetworking-1.3"

作者

kishikawa katsumi,[email protected]

许可证

CollectionUtils遵循MIT许可证。有关更多信息,请参阅LICENSE文件。