RealmManager

A threaded and easier way of persisting data using Realm Mobile Database

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

CocoaPods 1.1.0+ is required to build RealmManager 1.0.0+.

To integrate RealmManager into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'RealmManager', '~> 1.0.8'
end

Then, run the following command:

$ pod install

Manually

If you prefer not to use any of the aforementioned dependency managers, you can integrate RealmManager into your project manually.

Usage

Add or Update an object to existing model:

You can simply use this method to add or update an object to an existing model

Note: This repo assumes each object as unique, thus the model needs to have a primaryKey

    RealmManager.addOrUpdate(model: "MODEL_NAME", 
                                object: ["foo":"bar"], 
                                completionHandler: { (error) in
        //Code goes here
    })

or if you need to have a configuration for your Realm instance

    var config = Realm.Configuration()
    
    let directory: URL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier:  
    "group.com.directurl")!.appendingPathComponent("db.realm")
    
    config.fileURL = directory
    
    let foo = Foo(description:"Bar")

    RealmManager.addOrUpdate(configuration: config, 
                                model: "MODEL_NAME", 
                                object: foo, 
                                completionHandler: { (error) in
        //Code goes here
    })

object can be an instance of Object,Array,Dictionary<AnyHashable,AnyObject>, or AnyObject.

Fetching

Fetching an object from the Realm DB:

    let foo = Foo(description:"Bar")
            
    RealmManager.fetch(model: "MODEL_NAME", 
                       condition: "description == '\(foo.description)'", 
                       completionHandler: { (result) in
                       
        //Your code can do anything with 'result' >:)
    })

Deleting

Map and Delete an object by using predicate:

    RealmManager.delete(model: "MODEL_NAME",
                        condition: "description = \(foo.description)",
                        completionHandler: { (error) in

        //Code goes here
    })

or if you have the object and not need to map it:

    RealmManager.deleteObject(object: foo, 
                              completionHandler: { (error) in
        //Code goes here
    })

Author

markcdb , mark.buot1394@gmail.com

License

RealmManager is available under the MIT license. See the LICENSE file for more info.

shijiangkai / RealmManager