class Cat: MappableObject {
    
    dynamic var name: String = ""
    
    override func mapping(map: Map) {
        super.mapping(map: map)
        
        name <- map["name"]
    }
}

class Dog: MappableObject {
    
    dynamic var name: String = ""
    dynamic var age: Int = 0
    
    override class func primaryKey() -> String? {
        return "name"
    }
    
    override func mappingPrimaryKey(map: Map) {
        name <- map["name"]
    }
    
    override func mapping(map: Map) {
        super.mapping(map: map)
        
        age <- map["age"]
    }
}

class Person: MappableObject {
    
    dynamic var name: String = ""
    let dogs = List<Dog>()
    
    override class func primaryKey() -> String? {
        return "name"
    }
    
    override class func jsonPrimaryKey() -> String? {
        return "full_name"
    }
    
    override func mappingPrimaryKey(map: Map) {
        name <- map["full_name"]
    }
    
    override func mapping(map: Map) {
        super.mapping(map: map)
        
        dogs <- map["dogs"]
    }
}

class CustomContext: RealmMapContext {
    
    var customValue: String
    
    init(customValue: String) {
        self.customValue = customValue
        super.init()
    }
}

let person = Mapper<Person>().map(JSON: ["full_name": "Arnaud Dorgans"])

let person = Mapper<Person>(options: .sync).map(JSON: ["full_name": "Arnaud Dorgans"])
//get or create Person in DB with 'Arnaud Dorgans' primary key

let person = Mapper<Person>(options: [.sync, .copy]).map(JSON: ["full_name": "Arnaud Dorgans"]) 
//get Person from DB with 'Arnaud Dorgans' primary key, or create Person from JSON detached from Realm
//and then update detached object from JSON

let mapper = Mapper<Person>(options: .sync)
try! Realm().write{
   var person = mapper.map(JSON: ["full_name": "Arnaud Dorgans", "dogs": [["name": "Sansa", "age": 1]]])!
   // get or create Person in DB with 'Arnaud Dorgans' primary key & update 'dogs' property
   person = mapper.map(JSON: ["full_name": "Arnaud Dorgans"], toObject: person)
   //dogs won't be updated  cause 'dogs' key isn't provided
   person = mapper.map(JSON: ["full_name": "Arnaud Dorgans", "dogs": []], toObject: person)
   //dogs will be updated cause 'dogs' key is provided
}

let realm = try! Realm()
try! realm.write{
   var person = mapper.map(JSON: ["full_name": "Arnaud Dorgans", "dogs": [["name": "Sansa", "age": 1]]])!
   // get or create Person in DB with 'Arnaud Dorgans' primary key & update 'dogs' property

   person = Mapper<Person>(options: [.sync, .override]).map(JSON: ["full_name": "Arnaud Dorgans"])! 
   //dogs will be reset to default value [] cause 'dogs' key isn't provided
}