Skip to main content

Realm - Migrations trong lập trình ứng dụng iOS


Đã là lập trình viên iOS, hẳn ai trong chúng ta cũng đã từng sử dụng Core Data, Realm hay SQLite để lưu dữ liệu của App vào database.
SQLite là một cơ sở dữ liệu tốt để lưu trữ dữ liệu trong bộ nhớ trong. Để làm việc với SQLite, chúng ta phải thực hiện rất nhiều thao tác: xây dựng khung chương trình, mô hình, helper, truy vấn,... Điều này đòi hỏi rất nhiều thời gian trong quá trình phát triển phần mềm. Những người mới tìm hiểu SQLite sẽ bỏ ra khá nhiều thời gian trong việc khởi tạo, nhập xuất, tạo các truy vấn và đặc biệt là code sẽ dài và rất khó quản lý.
Core Data tương đối khó xử dụng ngay cả với những người đã có kinh nghiệm, code dài dòng, và việc quản lý dữ liệu rất khó khăn. Core Data lưu dữ liệu vào SQLite, và để nhìn thấy dữ liệu và quản lý dữ liệu trong SQLite một cách trực quan, chúng ta cần sử dụng các công cụ trả phí đắt tiền như SQLite Professional, Core Data Editor,…
Realm là một cơ sở dữ liệu nhẹ, có thể thay thế cả hai thư viện SQL và ORM. Realm không sử dụng SQLite làm engine của nó. Thay vào đó, nó dùng core C++ nhằm mục đích cung cấp một thư viện cơ sở dữ liệu thay thế SQLite
Realm có rất nhiều lợi thế:
  1. Dễ dàng sử dụng hơn
  2. Tốc độ query nhanh hơn
  3. Quản lý dữ liệu dễ dàng và trực quan hơn
  4. Open source và tài liệu tham khảo được viết rất tốt
  5. Cross platform Với rất nhiều lợi thế như trên, Realm ngày càng được sử dụng phổ biến hơn.
Dù dùng Realm, CoreData hay SQLite thì đôi lúc bạn có thể sẽ muốn có những thay đổi trong data model của bạn.

Nếu ứng dụng của bạn đang trong quá trình lập trình ở bước đầu thì việc này là khá đơn giản tuy nhiên nếu ứng dụng của bạn đã chạy, bạn có thể sẽ không muốn phải làm gián đoạn quá trình sử dụng của người dùng bở việc ddos có thể sẽ khiến bạn mất đi một số lượng người dùng lớn và đó là lí do chúng ta phải sử dụng migration. Trong bài này mình sẽ nói về Migration trong trong Realm. Nếu các bạn muốn biết cách migration trong coredata các bạn có thể tham khảo bài sau https://viblo.asia/p/migrations-voi-core-data-trong-lap-trinh-ung-dung-ios-l0rvmmxavyqA
Nào! giờ chúng ta sẽ đi vào Migration trong Realm thông qua một ví dụ. ban đầu chúng ta có 1 class object
class Person: Object {
    @objc dynamic var firstName = ""
    @objc dynamic var lastName = ""
    @objc dynamic var age = 0
}
sau khi publish app thì mong muốn có một số thay đổi trong đó như sau:
class Person: Object {
    @objc dynamic var fullName = ""
    @objc dynamic var age = 0
}
trong application(application:didFinishLaunchingWithOptions:) chúng ta tiến hành như sau
func applicationDidFinishLaunching(_ application: UIApplication) {
let config = Realm.Configuration(
    // version (if you've never set a schema version before, the version is 0).
    schemaVersion: 1, migrationBlock: { migration, oldSchemaVersion in
        // We haven’t migrated anything yet, so oldSchemaVersion == 0
        if (oldSchemaVersion < 1) {
                migration.enumerateObjects(ofType: Person.className()) { oldObject, newObject in
                // combine name fields into a single field
                let firstName = oldObject!["firstName"] as! String
                let lastName = oldObject!["lastName"] as! String
                newObject!["fullName"] = "\(firstName) \(lastName)"
        }
    })
Realm.Configuration.defaultConfiguration = config
}
Giả sử model chúng ta muốn thay đổi trường age thành yearsSinceBirth chúng ta làm như sau.
func applicationDidFinishLaunching(_ application: UIApplication) {
let config = Realm.Configuration(
    // version (if you've never set a schema version before, the version is 0).
    schemaVersion: 2, migrationBlock: { migration, oldSchemaVersion in
        // We haven’t migrated anything yet, so oldSchemaVersion == 0
        if (oldSchemaVersion < 1) {
                migration.enumerateObjects(ofType: Person.className()) { oldObject, newObject in
                // combine name fields into a single field
                let firstName = oldObject!["firstName"] as! String
                let lastName = oldObject!["lastName"] as! String
                newObject!["fullName"] = "\(firstName) \(lastName)"
        }
        if (oldSchemaVersion < 2) {
            migration.renameProperty(onType: Person.className(), from: "age", to: "yearsSinceBirth")
        }
    })
Realm.Configuration.defaultConfiguration = config
}
và cứ như vậy nếu có bất cứ sự thay đổi nào trong model chúng ta sẽ tiến hành tăng schemaVersion sau đó thêm thay đổi vào bên dưới tăng dần theo schemaVersion.
Trên đây là hướng dẫn cơ bản về migration trong realm. hi vọng nó có thể giúp ích được ho mọi người khi cần. Xin cảm ơn.
tài liệu tham khảo: https://realm.io/docs/swift/latest/

Comments

Popular posts from this blog

Swift GCD part 1: Thread safe singletons

Preview Singletons are entities, referenced to the same instance of a class from everywhere in your code. It doesn't matter if you like them or not, you will definitely meet them, so it's better to understand how they work. Constructing and handling a set of data doesn't seem to be a big challenge at first glance. The problems appear when you try to optimise the user experience with background work and your app starts acting weird. ??‍♂️ After decades of watching your display mostly with a blank face, you finally realize that your data isn't handled consistently by the manager because you're accessing it (running tasks on it) from multiple threads at the same time. So you really do have to deal with making your singletons thread safe. This article series is dedicated to thread handling using Swift. In the first part below you will get a comprehensive insight into som...

Thread safe singleton’s in Swift

What are singletons? — Singleton is design patterns which says that there should be only one instance of the class for the lifetime of the application. One the best example of Singleton is AppDelegate . How to write a singleton class ? class DefaultDict{ private var dict:[String:Any] = [:] public static let sharedManager = DefaultDict() private init(){ } public func set(value:Any,key:String){ dict[key] = value } public func object(key:String) -> Any?{ dict[key] } public func reset(){ dict.removeAll() } }   Testing singleton class under concurrent circumstances. We are going to write an example where we will set values in dict from various threads and even try to access some with different threads. When we do this we will encounter a crash. If you look closely it will be because of race condition and the crash will be on line set(value:Any,key:String) . class ViewController: UIViewController { ...

Frame vs Bounds in iOS

This article is a repost of an answer I wrote on Stack Overflow . Short description frame = a view’s location and size using the parent view’s coordinate system ( important for placing the view in the parent) bounds = a view’s location and size using its own coordinate system (important for placing the view’s content or subviews within itself) Details To help me remember frame , I think of a picture frame on a wall . The picture frame is like the border of a view. I can hang the picture anywhere I want on the wall. In the same way, I can put a view anywhere I want inside a parent view (also called a superview). The parent view is like the wall. The origin of the coordinate system in iOS is the top left. We can put our view at the origin of the superview by setting the view frame’s x-y coordinates to (0, 0), which is like hanging our picture in the very top left corner of the wall. To move it right, increase x, to move it down increase y. To help me remember bound...