Keine Beschreibung

ibireme 0518178810 version 0.9.0 vor 9 Jahren
Benchmark cb5598f620 version 0.9.0 vor 9 Jahren
Framework cb5598f620 version 0.9.0 vor 9 Jahren
YYModel cb5598f620 version 0.9.0 vor 9 Jahren
.gitignore fe56bfcf0d Initial commit vor 9 Jahren
LICENSE cb5598f620 version 0.9.0 vor 9 Jahren
README.md cb5598f620 version 0.9.0 vor 9 Jahren
YYModel.podspec cb5598f620 version 0.9.0 vor 9 Jahren

README.md

YYModel

License MIT  Carthage compatible  Cocoapods  Cocoapods  Support

High performance model framework for iOS.

Performance

Process GithubUser 10000 times on iPhone 6:

DemoImage

See Benchmark/ModelBenchmark.xcodeproj for more benchmark case.

Usage

###Simple model json convert

// JSON:
{
    "uid":123456,
    "name":"Harry",
    "created":"1965-07-31T00:00:00+0000"
}

// Model:
@interface User : NSObject
@property UInt64 uid;
@property NSString *name;
@property NSDate *created;
@end
@implementation User
@end


// Convert json to model:
User *user = [User yy_modelWithJSON:json];

// Convert model to json:
NSDictionary *json = [user yy_modelToJSONObject];

If the type of an object in JSON/Dictionary cannot be matched to the property of the model, the following automatic conversion is performed:

<tr>
  <th>JSON/Dictionary</th>
  <th>Model</th>
</tr>

<tr>
  <td>NSString</td>
  <td>NSURL,SEL,Class</td>
</tr>
<tr>
  <td>NSString</td>
  <td>NSDate parsed with these formats:<br/>
  yyyy-MM-dd<br/>

yyyy-MM-dd HH:mm:ss
yyyy-MM-dd'T'HH:mm:ss
yyyy-MM-dd'T'HH:mm:ssZ
EEE MMM dd HH:mm:ss Z yyyy

  </td>
</tr>
<tr>
  <td>NSString/NSNumber</td>
  <td>C number (BOOL,int,float,NSUInteger,UInt64,...)<br/>
  NaN and Inf will be ignored</td>
</tr>
<tr>
  <td>NSValue</td>
  <td>struct (CGRect,CGSize,...)</td>
</tr>

###Match model's property to different JSON value

// JSON:
{
    "n":"Harry Pottery",
    "p": 256,
    "ext" : {
        "desc" : "A book written by J.K.Rowing."
    }
}

// Model:
@interface Book : NSObject
@property NSString *name;
@property NSInteger page;
@property NSString *desc;
@end
@implementation Book
+ (NSDictionary *)modelCustomPropertyMapper {
    return @{@"name" : @"n",
             @"page" : @"p",
             @"desc" : @"ext.desc"};
}
@end

###Nested model

// JSON
{
    "author":{
        "name":"J.K.Rowling",
        "birthday":"1965-07-31T00:00:00+0000"
    },
    "name":"Harry Potter",
    "pages":256
}

// Model: (no need to do anything)
@interface Author : NSObject
@property NSString *name;
@property NSDate *birthday;
@end
@implementation Author
@end

@interface Book : NSObject
@property NSString *name;
@property NSUInteger pages;
@property Author *author;
@end
@implementation Book
@end

Container property

@class Shadow, Border, Attachment;

@interface Attributes
@property NSString *name;
@property NSArray *shadows; //Array<Shadow>
@property NSSet *borders; //Array<Border>
@property NSMutableDictionary *attachments; //Array<Attachment>
@end

@implementation Attributes
+ (NSDictionary *)modelContainerPropertyGenericClass {
    return @{@"shadows" : [Shadow class],
             @"borders" : Border.class,
             @"attachments" : @"Attachment" };
}
@end

Whitelist and blacklist

@interface User
@property NSString *name;
@property NSUInteger age;
@end

@implementation Attributes
+ (NSArray *)modelPropertyBlacklist {
    return @{@"test1", @"test2"};
}
+ (NSArray *)modelPropertyWhitelist {
    return @{@"name"};
}
@end

###Data validate and custom transform

// JSON:
{
    "name":"Harry",
    "timestamp" : 1445534567
}

// Model:
@interface User
@property NSString *name;
@property NSDate *createdAt;
@end

@implementation User
- (BOOL))modelCustomTransformFromDictionary:(NSDictionary *)dic {
    NSNumber *timestamp = dic[@"timestamp"];
    if (![timestamp isKindOfClass:[NSNumber class]]) return NO;
    _createdAt = [NSDate dateWithTimeIntervalSince1970:timestamp.floatValue];
    return YES;
}
- (BOOL)modelCustomTransformToDictionary:(NSMutableDictionary *)dic {
    if (!_createdAt) return NO;
    dic[@"timestamp"] = @(n.timeIntervalSince1970);
    return YES;
}
@end

###Coding/Copying/hash/equal

@interface YYShadow :NSObject <NSCoding, NSCopying>
@property (nonatomic, copy) NSString *name;
@property (nonatomic, assign) CGSize size;
@end

@implementation YYShadow
- (void)encodeWithCoder:(NSCoder *)aCoder { [self yy_modelEncodeWithCoder:aCoder]; }
- (id)initWithCoder:(NSCoder *)aDecoder { return [self yy_modelInitWithCoder:aDecoder]; }
- (id)copyWithZone:(NSZone *)zone { return [self yy_modelCopy]; }
- (NSUInteger)hash { return [self yy_modelHash]; }
- (BOOL)isEqual:(id)object { return [self yy_modelIsEqual:object]; }
@end

Installation

Cocoapods

  1. Add pod "YYModel" to your Podfile.
  2. Run pod install or pod update.
  3. Import <YYModel/YYModel.h>

Carthage

  1. Add github "ibireme/YYModel" to your Cartfile.
  2. Run carthage update and add the framework to your project.
  3. Import <YYModel/YYModel.h>

Manually

  1. Download all the files in the YYModel subdirectory.
  2. Add the source files to your Xcode project.
  3. Import YYModel.h.

About

This library supports iOS 6.0 and later.

License

YYModel is provided under the MIT license. See LICENSE file for details.