AJRealmDB-Swift

Realm 数据库封装

数据Bean定义

所有Bean类需要继承自 AJDBBaseBean ，然后重写 primaryKey() 方法;
Bool\Int\Float\Double 类型参数定义，为 dynamic var，然后要加默认值；如果它是可选类型，这样定义 let value = RealmOptional<Bool\Int\Float\Double>()。
String\Data\Date 类型参数定义，为 dynamic var，然后加默认值；如果它是可选类型，则定义为 dynamic var value: String\Data\Date? = nil
对于继承自 AJDBBaseBean 类型参数，定义必须为可选类型 dynamic var value: ClassName?
对于数组，只能存放 AJDBBaseBean 类型变量，定义 let value = List<ClassName>()

所有的数据操作方法通过类 AJDBManager 类来调用.

数据插入

方法: class func write(_ objs:[T])
说明: T 为 AJDBBaseBean 类型，可以插入一条或多条数据。

数据查询

方法1 - 通过主键查询: class func query<K>(_ type:T.Type, withPrimaryKey key:K) -> T?
方法2 - 通用查询: class func query(_ type:T.Type, filter:NSPredicate? = nil, sort:SortOption? = nil) -> [T]
说明: 通用查询方法，返回结果可能有多个；可以通过 NSPredicate 来筛选查询；SortOption 可以对查询结果根据某个字段进行排序，升序或者降序。
示例:

数据更新

方法: class func update(_ session:(()->Void))
说明: 要更新数据Bean，直接对Bean的成员变量重新赋值，这个赋值过程在 update 闭包里面实现，这样既可更新到数据库。
示例:

        if let userModel = readUserInfo() {
          AJDBManager.update({
              
              // 刷新本地用户数据
              if let authToken = model.authToken {
                  userModel.authToken = authToken;
              }
              
              userModel.phone = model.mobilePhone;
          });
        }

数据删除

方法1 - 删除一个或多个: class func delete(_ objs:[T])
方法2 - 条件筛选删除: class func delete(_ type:T.Type, filter:NSPredicate? = nil)
方法3 - 根据主键删除： class func delete<K>(_ type:T.Type, withPrimaryKey key:K)
说明: 入参类型跟查询一样

清除数据库

方法: class func cleanDB()
说明: 这个方法会清理本地所有数据，谨慎使用。

数据库合并

数据库版本发生变化时，会发生数据库版本合并，这时可以对数据库的字段进行合并处理。

数据库合并的方法在类 AJDBConfig 的方法 func dbVersionMerge(_ m:Migration, newVer:UInt64, oldVer:UInt64) 里面。

示例:

 // 数据迁移
 m.enumerateObjects(ofType: GYUserModel.className(), { (oldObj, newObj) in
         
   if oldVer < newVer {
               
       if oldObj != nil && newObj != nil {
            let oldVal = oldObj!["phone_old"] as! String;
             newObj!["phone_new"] = Int64(oldVal);
        }
    }
 })

数据加密

数据库的加密配置也在类 AJDBConfig 里面定义。

更多可以查看Realm官网文档

AbooJan / AJRealmDB-Swift