Need help with EasyMapping?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

lucasmedeirosleite
409 Stars 77 Forks MIT License 406 Commits 0 Opened issues

Description

The easiest way to marshall and unmarshall Dictionary representations such as JSON representation

Services available

!
?

Need anything else?

Contributors list

# 39,540
Swift
Objecti...
datasou...
delegat...
184 commits
# 355,504
Objecti...
Swift
Elixir
spotify
64 commits
# 78,117
iOS
Objecti...
C++
uiview
15 commits
# 22,109
Swift
Shell
iOS
trigono...
7 commits
# 51,806
Objecti...
Swift
cocoapo...
mac
6 commits
# 14,617
Swift
metapro...
codegen...
carthag...
5 commits
# 203,118
Objecti...
Swift
hud
progres...
4 commits
# 624,105
Objecti...
Swift
Shell
4 commits
# 50,746
Objecti...
Groovy
coregra...
messeng...
3 commits
# 647,314
Objecti...
Swift
Shell
3 commits
# 124,592
iOS
archite...
mobile-...
viper
2 commits
# 681,353
Objecti...
Swift
Shell
2 commits
# 167,436
Objecti...
Swift
ios-ani...
iOS
2 commits
# 685,573
Objecti...
Swift
Shell
2 commits
# 162,801
React N...
swift-3
maskedi...
TypeScr...
2 commits
# 724,898
Objecti...
Swift
Shell
1 commit
# 346,597
Shell
C++
C
1 commit
# 731,211
Objecti...
Swift
Shell
1 commit
# 74,360
Objecti...
Swift
mac
clang-f...
1 commit
# 100,097
Swift
Objecti...
Shell
command...
1 commit

CI codecov.io CocoaPod platform   CocoaPod version   Swift Package Manager compatible License MIT

EasyMapping

An easy way to unmarshall a Dictionary of attributes (which came from JSON, XML or just a NSDictionary) into a Class and vice versa.

Contact:

Developed by Lucas Medeiros and Denys Telezhkin

E-mail: [email protected]

Requirements

  • Xcode 11 and higher
  • iOS 9 / tvOS 9 and higher
  • Mac OS X 10.10 and higher
  • watchOS 2.0 and higher
  • ARC

Installation

Swift Package Manager(requires Xcode 11)

Add package into Project settings -> Swift Packages

CocoaPods:

pod 'EasyMapping', '~> 0.20'

Carthage:

github "EasyMapping/EasyMapping"

Usage

  • Suppose you have these classes:
typedef enum {
    GenderMale,
    GenderFemale
} Gender;

@interface Person : NSObject

@property (nonatomic, copy) NSString *name; @property (nonatomic, copy) NSString *email; @property (nonatomic, assign) Gender gender; @property (nonatomic, strong) Car *car; @property (nonatomic, strong) NSArray *phones; @property (nonatomic, strong) NSURL * socialURL; @end

@interface Car : NSObject

@property (nonatomic, copy) NSString *model; @property (nonatomic, copy) NSString *year; @property (nonatomic, strong) NSDate *createdAt;

@end

@interface Phone : NSObject

@property (nonatomic, copy) NSString *DDI; @property (nonatomic, copy) NSString *DDD; @property (nonatomic, copy) NSString *number;

@end

@interface Native : NSObject

@property (nonatomic, readwrite) NSInteger integerProperty; @property (nonatomic, readwrite) NSUInteger unsignedIntegerProperty; @property (nonatomic, readwrite) CGFloat cgFloatProperty; @property (nonatomic, readwrite) double doubleProperty; @property (nonatomic, readwrite) BOOL boolProperty;

@end

  • Mapping becomes as simple as implementing single method
@implementation Person

+(EKObjectMapping *)objectMapping { return [EKObjectMapping mappingForClass:self withBlock:^(EKObjectMapping *mapping) { NSDictionary *genders = @{ @"male": @(GenderMale), @"female": @(GenderFemale) }; [mapping mapPropertiesFromArray:@[@"name", @"email"]]; [mapping mapKeyPath:@"gender" toProperty:@"gender" withValueBlock:^(NSString *key, id value) { return genders[value]; } reverseBlock:^id(id value) { return [genders allKeysForObject:value].lastObject; }]; [mapping mapKeyPath:@"socialURL" toProperty:@"socialURL" withValueBlock:[EKMappingBlocks urlMappingBlock] reverseBlock:[EKMappingBlocks urlReverseMappingBlock]]; [mapping hasOne:[Car class] forKeyPath:@"car"]; [mapping hasMany:[Phone class] forKeyPath:@"phones"]; }]; }

@end

@implementation Car

+(EKObjectMapping *)objectMapping { return [EKObjectMapping mappingForClass:self withBlock:^(EKObjectMapping *mapping) { [mapping mapPropertiesFromArray:@[@"model", @"year"]]; [mapping mapKeyPath:@"created_at" toProperty:@"createdAt" withDateFormatter:[NSDateFormatter ek_formatterForCurrentThread]]; }]; }

@end

@implementation Phone

+(EKObjectMapping *)objectMapping { return [EKObjectMapping mappingForClass:self withBlock:^(EKObjectMapping *mapping) { [mapping mapPropertiesFromArray:@[@"number"]]; [mapping mapPropertiesFromDictionary:@{ @"ddi" : @"DDI", @"ddd" : @"DDD" }]; }]; }

@end

@implementation Native

+(EKObjectMapping *)objectMapping { return [EKObjectMapping mappingForClass:self withBlock:^(EKObjectMapping *mapping) { [mapping mapPropertiesFromArray:@[ @"integerProperty", @"unsignedIntegerProperty", @"cgFloatProperty", @"doubleProperty", @"boolProperty" ]]; }]; }

@end

  • Converting a NSDictionary or NSArray to a object class or collection now becomes easy:
Person *person = [EKMapper objectFromExternalRepresentation:personRepresentation
                                                withMapping:[Person objectMapping]];

NSArray *carsArray = [EKMapper arrayOfObjectsFromExternalRepresentation:carsRepresentation withMapping:[Car objectMapping]];

  • Converting an object/collection to NSDictionary/NSArray:
NSDictionary *representation = [EKSerializer serializeObject:car withMapping:[Car objectMapping]];
NSArray *collectionRepresentation = [EKSerializer serializeCollection:cars withMapping:[Car objectMapping]];
  • Filling an existent object:

Suppose you have something like this:

Person *person = [Person alloc] init]

To fill an already instantiated object you can do this:

[EKMapper fillObject:person fromExternalRepresentation:personRepresentation withMapping:[Person objectMapping]];

Swift

EasyMapping is partially compatible with Swift. Here's detailed look at EasyMapping usage in Swift and current limitations.

Convenience classes

EasyMapping provides two convenience base classes: EKObjectModel and EKManagedObjectModel, that implement EKMappingProtocol by default. If, for example, class Person would inherit from EKObjectModel, and implemented objectMapping method, all it would take to create Person instance from JSON representation would be:

NSDictionary * parsedPersonInfo = ...;
Person * person = [Person objectWithProperties:parsedPersonInfo];

And CoreData variant in case Person is EKManagedObjectModel subclass:

NSDictionary * parsedPersonInfo = ...;
Person * person = [Person objectWithProperties:parsedPersonInfo inContext:context];

Serializing to NSDictionary is even easier:

objective-c
NSDictionary * info = [person serializedObject];

CoreData

If you are using CoreData objects use

EKManagedObjectMapping
instead of
EKObjectMapping
. EasyMapping tries to speed up importing to database by scanning provided JSON and fetching all existing objects in batch. The more high level JSON will be provided, the more speed boost can be achieved.

Recursive mappings

Sometimes you can encounter situation, where your JSON will contain objects with links to objects of the same type. Good example would be comments, and replies to comments, that have tree-like structure. Starting with 0.7.0 recursive mappings are fully supported by EasyMapping.

Thanks

Thanks to:

  • basitali who added the fillObject functionality on EKMapper!
  • Alejandro who added CoreData support!
  • Philip Vasilchenko who added the ability to serialization/deserialization of scalar types!
  • Dany L'Hébreux who added the NSSet support!
  • Jack who added mapFieldsFromMappingObject and mapFieldsFromArrayToPascalCase functionality
  • Yuri Kotov and Dmitriy which added a lot of performance improvements
  • Moya organization for awesome automated release process.

The idea

The idea came from: * RestKit's mapping, its problem is that it doesn't transform custom values (such as a string value to an enum) * Mantle's mapping, but you don't need to inherit from any class

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.