RealmSwift Swift Swift Library

Yêu cầu bài viết

  • Đã sử dụng qua realm swift.
  • Có kiến thức căn bản về lập trình iOS

Micro-service là gì?

Với những ai đang làm các dự án Backend thì khái niệm micro-service sẽ không còn xa lạ nữa.

Micro-service nghĩa là chia nhỏ các service của ứng dụng thành những phần riêng biệt, độc lập với nhau để dễ dàng cho việc quản lý, release sản phẩm. Lấy 1 ví dụ, khi backend có các nghiệp vụ: đăng nhập, đăng ký tài khoản, lưu giỏ hàng, thanh toán.. thì chúng ta sẽ có thể chia các cụm micro-service như sau:

  • Cụm authentication: đăng nhập, đăng ký nơi các nghiệp vụ xác nhận người dùng.
  • Cụm payment: gồm lưu giỏ hàng, thanh toán chứa nghiệp vụ về mua bán sản phẩm.

Khi 1 API nào ở cụm payment bị lỗi thì nó hoàn toàn không ảnh hưởng tới cụm authentication. Đó là lợi ích của việc chia để trị trong micro-service.

Ở trong các ứng dụng iOS, nghiệp vụ về database cũng tương tự. Lấy ví dụ, khi bạn lưu data cho phần authentication, bao gồm các bảng bảng user, token… và nghiệp vụ payment gồm các bảng về product, wishList thì chúng ta cũng có thể chia để trị như trên.

Realm swift cho phép chúng ta sử dụng nhiều file realm riêng biệt, mỗi file realm gồm 1 số bảng liên quan tới nhau trong đó. Mỗi file realm như vậy chúng ta gọi là database.

Ví dụ về 1 database pets, nơi chứa nghiệp vụ về pets, gồm nhiều bảng

Như hình trên, chúng ta có thể thấy nghiệp vụ pets trong 1 ứng dụng về quản lý chó mèo, chúng ta chia nhỏ các bảng ra thành 1 database có tên là PetSchema như hình:

Vậy là chúng ta đã có thể hình dung rằng thay vì dùng 1 file realm Default.realm mặc định thì giờ đây chúng ta có rất nhiều file realm trong ứng dụng.

Vậy lợi ích của việc này là gì?

  • Khi gọi các bảng từ các file .realm này thì tốc độ sẽ nhanh hơn thay vì load 1 file lớn vào memory của ứng dụng.
  • Dễ dàng migration khi có thay đổi trường trong bảng.
  • Tránh conflict khi làm team với nhiều người.
  • Dễ dàng cho việc testing

OK, vậy là các bạn đã hiểu được nguyên lý micro-service rồi. Tiếp theo để xây dựng realm manager thì chúng ta cần triển khai những gì?

Các yêu cầu của Realm manager

Yêu cầu của realm manager cần xử lý các nghiệp vụ sau:

  • Quản lý thêm, sửa, xóa, update cũng như query bảng.
  • Tăng sự tiện lợi khi sử dụng.
  • Dễ dàng truy cập, dễ dàng sửa đổi.
  • Kết nối với lớp database.

Các loại lưu trữ của Realm

Thật tuyệt vời, giờ đây Realm sẽ cho phép bạn có 2 cách để lưu trữ:

  • Lưu trữ trên memory
  • Lưu trữ vào ổ đĩa(các file realm).

Lưu trữ trên ổ đĩa

Mặc định anh em làm iOS sẽ hay dùng phương pháp lưu trữ vào 1 file .realm. Toàn bộ bảng sẽ lưu vào file realm và tồn tại trên ổ đĩa của ứng dụng.

Lưu trữ trên memory

Hàm init của Realm bản 10.28.2 như sau:

Như chúng ta thấy tham số inMemoryIdentifier nhằm định danh memory theo 1 string để lưu trữ.

Mục đích lưu trữ trên memory giúp chúng ta có thể thực hiện các nghiệp vụ về unit-test hoặc Short live data.

Version Management & Migration Management

Việc đánh số version cho realm của chúng ta nhằm mục đích migration. Khi có bất kỳ 1 sự thay đổi nào trong các bảng dữ liệu, realm cho phép bạn chuyển đổi nó 1 cách đơn giản thông qua MigrationBlock. Con số này sẽ tăng lên sau mỗi phiên bản. Đây là yêu cầu bắt buộc của realm. Các bạn có thể xem tại đây.

Increment Versions Monotonically

Migrations must update a realm to a higher schema version. Realm Database will throw an error if a client application opens a realm with a schema version that is lower than the realm’s current version or if the specified schema version is the same as the realm’s current version but includes different object schemas.

Nói cách khác, nếu khi bạn thay đổi bảng của realm nhưng không tăng version, thì ứng dụng của bạn sẽ crash.

Khi các bạn đã xác định được các thành phần của 1 realm manager thì chúng ta sẽ tiến hành triển khai nó.

Triển khai realm manager

Các thành phần cần thiết của nó như sau:

Trong đó:

  • realmMemoryType sẽ gồm 2 loại: lưu vào ổ đĩa và lưu vào memory
  • schemaName: Tên của micro-realm schema mà bạn muốn.
  • schemaVersion: số phiên bản realm schema. Đánh số từ 0.
  • objectTypes: 1 list các Object realm mà bạn muốn lưu trữ ở file realm này. Nó có thể nhiều bảng liên quan tới nhau, ví dụ:
  • embeddedObjectTypes: tương tự objectTypes, realm giờ đây đã cung cấp cho chúng ta những Object embedded vào các object khác. Nghĩa là khi bạn xóa 1 Object, thì các object embedded của nó sẽ bị xóa tự động. Xem thêm tại đây.
  • migrationBlock: Thành phần không thể thiếu khi bạn muốn migrate data của bạn. Ví dụ:

Tôi đã triển khai thư viện để implement toàn bộ các thành phần trên. Các bạn có thể sử dụng vào project của mình bằng 2 cách như sau:

Sử dụng pod:

Sử dụng Swift package:

Trong thư viện, tôi đã sử dụng hàm writeAsync nhằm đảm bảo quá trình xử lý realm luôn luôn ở background thread. Các bạn có thể xem thêm ở đây.

Perform a Background Write

New in version 10.26.0.
You can add, modify, or delete objects in the background using writeAsync.

Cách sử dụng

Đầu tiên, tất nhiên rồi bạn cần có các object của realm. Theo chuẩn mới nhất realm sẽ sử dụng Persisted vừa ngắn gọn, vừa đơn giản và chúng ta có thể dùng các high function của swift để query 1 cách dễ dàng.

Tiếp theo chúng ta sẽ tạo lớp Repository để implement lại các cài đặt của realm manager:

Sau đó bạn sẽ dùng repository đó để thao tác với các Object trong file realm của bạn 1 cách dễ dàng:

Để lưu entity:

Để lưu nhiều entities:

Thậm chí bạn còn có thể lưu JSON data:

Để query, realm nói say goodbye với predicate, mà sử dụng luôn các high function swift, quá tiện lợi đúng không?

Xem thêm say goodbye ở đây.

Kết luận

Giờ đây, với realm manager, bạn đã có thể quản lý dễ dàng các file realm của mình.

Nếu có bất kỳ câu hỏi nào xin vui lòng để lại comment ở bài viết này.

Nếu yêu thích bài viết hãy tặng 1 sao vào repository sau:

https://github.com/lexuanquynh/QRealmManager

Xin cảm ơn.

Code Toàn Bug

Code nhiều bug nhiều!

Leave a Reply

Your email address will not be published.