OrangeRealm 0.1.0

OrangeRealm 0.1.0

测试已测试
Lang语言 SwiftSwift
许可证 MIT
Released最后发布2017年4月
SwiftSwift 版本3.0
SPM支持 SPM

pisces 维护。



  • Steve Kim

  • OrangeRealm帮助您使用Realm进行安全的多线程和UI集成

特点

  • 线程安全
  • 简单接口
  • 易于UI集成
  • 支持查询限制、最大值、偏移量与过滤器、解链接
  • 对Realm生命周期的抽象

导入

import OrangeRealm

示例

第一 - 创建您的RealmManager

您的RealmManager将与一个Realm文件一一对应

import RealmSwift
import OrangeRealm

class SampleRealmManager: AbstractRealmManager {

    // MARK: - Overridden: AbstractRealmManager

    override class var shared: AbstractRealmManager {
        struct Static {
            static let instance = SampleRealmManager()
        }
        return Static.instance
    }
    
    override var schemaVersion: UInt64 {
        return 1
    }
    
    override var fileURL: URL {
        return URL(fileURLWithPath: "\(NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true).first!)/sample.realm", isDirectory: false)
    }
    
    override var objectTypes: [Object.Type]? {
        return [SampleObject.self]
    }
    
    override func deleteAll(_ realm: Realm) {
        realm.deleteAll()
    }
    
    override func process(forMigration migration: Migration, oldSchemaVersion: UInt64) {
    }
}

第二 - 创建您的Realm对象

这与Realm对象的简单实现相同

import RealmSwift

class SampleObject: Object {
    dynamic var name: String?
    dynamic var id: Int = 0
    
    convenience init(id: Int, name: String?) {
        self.init()
        
        self.id = id
        self.name = name
    }
    
    override class func primaryKey() -> String? {
        return "id"
    }
}

最后 - 集成您的UI

此示例与UITableView的集成

result = SampleRealmManager.shared.query("id > 0", sortProperty: "id", ascending: false)
	// Sync with section of UITableView
    .set(section: 1)
    // Update UITableView after add notification for realm
    .changed({ [weak self] (section, deletions, insertions, modifications) in
        guard let weakSelf = self else {return}
        
        weakSelf.tableView.beginUpdates()
        weakSelf.tableView.deleteRows(at: deletions, with: .none)
        weakSelf.tableView.insertRows(at: insertions, with: .none)
        weakSelf.tableView.reloadRows(at: modifications, with: .none)
        weakSelf.tableView.endUpdates()
    })

self.tableView.reloadData()

支持三种类型的查询结果 - RealmQueryResult、泛型数组、RealmResult

SampleRealmManager.shared.query()
SampleRealmManager.shared.objects()
SampleRealmManager.shared.results()

进行限制、最大值查询

let result = SampleRealmManager.shared.query("id > 0", sortProperty: "id", ascending: false, limit: 10, max: 10)

使用过滤器进行偏移查询

let offset = 2

let result = SampleRealmManager.shared.query("id > 0", sortProperty: "id", ascending: false) { (object) -> Bool in
    return object.id! > offset
}

从Realm获取未连接的对象

let result = SampleRealmManager.shared.query("id > 0", sortProperty: "id", ascending: false, unlink: true)

要求

iOS部署目标8.0以上

作者

Steve Kim,[email protected]

许可证

OrangeRealm可在MIT许可下使用。有关更多信息,请参阅LICENSE文件。