Git Product home page Git Product logo

case-study-moya-realm-objectmapper's Introduction

case-study-Moya-Realm-ObjectMapper

A little case study about a project using Moya + Realm + ObjectMapper combined together

What

Talk about how i used these tree awesome technologies to build an iOS project:

I'm not going too much deep with the code, my goal is to describe principally how i combined these three elements together and which difficulties or benefits i encountered using them.

Platform and programming language

iOS 9.2 - XCode 7.2.1 - Swift

Glance to the project

An enterprise iOS app for internal use in our company. Back-end previously done with REST API. Data received and sent in JSON format. Necessity to store all new downloaded data on device. Possibility to edit model's entities information and send them to the back-end. I used CocoaPods to install all the packages.

Initialization

Realm

My first impression after just 10 minutes is: AWSOME! Realm really replace SQLite and Core Data Mobile, easy to set and easy to use. Basic setup in AppDelegate

//Realm BASIC migration setup
   let config = Realm.Configuration(
     // Set the new schema version. This must be greater than the previously used
     // version (if you've never set a schema version before, the version is 0).
     schemaVersion: 4,

     // Set the block which will be called automatically when opening a Realm with
     // a schema version lower than the one set above
     migrationBlock: { migration, oldSchemaVersion in
       // We haven’t migrated anything yet, so oldSchemaVersion == 0
       if (oldSchemaVersion < 3) {
         // Nothing to do!
         // Realm will automatically detect new properties and removed properties
         // And will update the schema on disk automatically
       }
   })

   // Tell Realm to use this new configuration object for the default Realm
   Realm.Configuration.defaultConfiguration = config

   // Now that we've told Realm how to handle the schema change, opening the file
   // will automatically perform the migration
   let realm = try! Realm()
   print(realm.path)

"And it works like a charm", now you can go and start using and modify your model where and when you want. Just remember to switch the schemaVersion and oldSchemaVersion each time you do a change in your model. I suggest you to always print realm.path(): it is useful to quickly identify Realm's database location in Finder and open it with Realm Browser. Ok, so here there's a little snippet about one of the classes implemented with Realm model.


class User: Object {

//MARK - Properties
  dynamic var id:Int = 0
  dynamic var email:String = ""
  ...
  var skills = List<Skill>()

  override static func primaryKey() -> String? {
    return "id"
  }
...  

More information and settings can be found obviously in Realm's docs. I spend some more time on the correct setting of skills: since it is a List it can't be a dynamic var, so i resolved omitting its type.

ObjectMapper

This framework is helping you converting model objects contained in your project to and from JSON. Also in this case i didn't find much real difficulties. Below another code snippet.

import Foundation
import RealmSwift
import ObjectMapper

class User: Object, Mappable {

//MARK - Properties
  dynamic var id:Int = 0
  dynamic var email:String = ""
  ...
  var skills = List<Skill>()

  override static func primaryKey() -> String? {
    return "id"
  }

//MARK - Initializers
  required convenience init?(_ map: Map) {
    self.init()
  }

//MARK - Mapping
  func mapping(map: Map) {
    id <- map["id"]
    email <- map["email"]
    ...
    let realm = try! Realm()    
    var skillIdsArray = [Int]()
    skillIdsArray <- map["skill_ids"]
    for skillId in skillIdsArray {
      ...//Here there are some other instructions to verify if the skill was effectively in Realm database
      skills.append(skill)
    }
  }

}

As you can see not much code has been added to User class: it just to implement Mappable protocol and be careful with required convenience init?(_ map: Map) and with func mapping(map: Map). ObjectMapper will automatically be able to to generate your Realm model. The only thing i point out is about the model generation of skills: as you can see and as i told you before, it is a List of Skill entities. In my case i wanted to persist also these kind of objects but to do so you must iterate over the Array obtained from JSON and then append it to the List.

Moya

So, here game become harder or anyway it took me a while to understand the Moya's pattern but once i got it everything works great! I had to look and search very hard in all open and close issues in the GitHub project, because there are not so much tutorials or guides out there which could help me. What i noticed is: for simple examples everybody gives you information but when and if you need something with an higher complexity you must get your hans dirty! What i understand:

  • Targets: the way how you represent and define your API
  • Provider: entity which makes all API requests
  • Endpoints: provider map targets to endpoints and with them they do real network requests

Then i go on with this logic:

  • MyProjectAPI -> the target file that contains your API definition with relatives endpoints; request type and cases they have to be used (i.e. .GET or .PUT); endpoint closure with which i'm doing requests; possible request passed parameters to use with a certain API; other stuff you like to personalize your requests. The base of MyProjectAPI is the targets definition, with an ENUM
public enum MyProjectAPI {
  case GetAllUsers
  case EditUser(user: AnyObject)
}

Each target has its base URL which is your API endpoint

public var path: String {
    switch self {
    case .GetAllUsers:
      return "/users"
    case .EditUser:
      return "/users/id"
    }
  }

On the back-end side, to let you understand better, this is one of my endpoints: http://my.site.com/api/users. Targets could have different requests type

//Request type
  public var method: Moya.Method {
    switch self{
    case .EditUser:
      return .PUT
    default:
      return .GET
    }
  }

Targets could have necessity to pass some parameters while sending the request, in my case EditUser(user: AnyObject)

//Possible passed parameters
  public var parameters: [String: AnyObject]? {
    switch self {
    case .EditUser(let user):
      let currentUser: User = user as! User
      //Closure for skills id array
      let skills_ids = {() -> [Int] in
        var skills_ids = [Int]()
        for skill in currentUser.skills {
          let skill_id = (skill as Skill).id
          skills_ids.append(skill_id)
        }
        return skills_ids
      }
      return [
        "user" : [
          "id" : currentUser.id,
          "email" : currentUser.email,
          ...
          "skill_ids" : skills_ids()
        ]
      ]
    default:
      return nil
    }
  }

Remember that every target must provide some non-nil data which represents a sample response.

public var sampleData: NSData {
    switch self {
    case .GetAllUsers:
      return sampleResponse("UserTest")
    }
}

Where func sampleResponse(filename: String) -> NSData! give me back a .json file where is defined a test response.

func sampleResponse(filename: String) -> NSData! {
  let bundle = NSBundle.mainBundle()
  let path = bundle.pathForResource(filename, ofType: "json")
  print("********* SAMPLE RESPONSE *********")
  return NSData(contentsOfFile: path!)
}

Now, following again Moya's documentation about Endpoints, when creating a provider we need to specify a mapping from Target to Endpoint or we may specify a mapping from Endpoint to NSURLRequest. The second use is very uncommon and Moya tries to prevent you from having to worry about low-level details. So let's take a look to the first case.

let endpointsClosure = { (target: MyAPI) -> Endpoint<MyAPI> in
  let endpoint: Endpoint<MyAPI> = Endpoint<MyAPI>(
    URL: url(target),
    sampleResponseClosure: {.NetworkResponse(200, target.sampleData)},
    method: target.method,
    parameters: target.parameters)
    return endpoint.endpointByAddingHTTPHeaderFields([
      "Accept" : Constants.acceptHTTPHeaderField,
      "Accept-Language" : Constants.acceptLanguageHTTPHeaderField,
      "Client-Version" : Constants.clientVersionHTTPHeaderField,
      "If-None-Match" : getETagOrLastModifiedParameter(target,true),
      "If-Modified-Since" : getETagOrLastModifiedParameter(target,false),
      "X-API-Username" : Constants.getCurrentUser().username,
      "X-API-Token" : UICKeyChainStore.stringForKey("token")])
}

As you can see, you can add parameters or HTTP header fields in this closure. In my case on the back-end side was used the conditions HTTP caching with Rails paradigm, so in this sense i need to set a specific header for If-None-Match and If-Modified-Since. getETagOrLastModifiedParameter closure returns the correct header as a String doing a research in Realm database on specifics objects. It's with endpointsClosure that we can now effectively initialize our provider

class MyProvider {

  private let provider:MoyaProvider<MyAPI>

  private init(){
    self.provider = MoyaProvider<MyAPI>(endpointClosure: endpointsClosure)
  }
  ...

Important: remember to retain your provider! I decided to set it as a property for MyProvider class. If you not retain your provider anywhere it will be deallocated. Finally MyProvider has to handle the request's result.

func getAllElementsOfType(type: MyAPI) {
    provider.request(type) { (result) -> () in
      switch result {
      case let .Success(response):
        do {
            if response.statusCode == 200 || response.statusCode == 304  {
            //Handle response with ObjectMapper
            let responseJSON:AnyObject = try response.mapJSON()
            var elementsFromJSON = []
            switch type {
            case .GetAllUsers:
              guard let usersFromJSON: Array<User> = Mapper<User>().mapArray(responseJSON["users"])! else {
                print("*********** NO getAllUsers DATA ***********")
                break
              }
              elementsFromJSON = usersFromJSON
              ...
            }
            try! self.realm.write({ () -> Void in
              for element in elementsFromJSON {
                switch type {
                case .GetAllUsers:
                  self.realm.add(element as! User, update: true)
                default:
                  break
                }
              }
            })
            ...

Here you can see the combination of Moya + ObjectMapper + Realm: response is simply handled with mapJSON() function with Moya; mapped JSON is mapped to an Array of Mappable objects; each object in the Array is saved in local store with Realm. Again, It works like a charm :]

Just one more thing: remember to configure the app transport security exceptions in your Info.plist. Here a little example.


Conclusions

Hope this consideration about how i used Moya, ObjectMapper and Realm may help you with your work or maybe this just could be a starting point for a discussion. Feel free to comment/share/integrate/ask.

Cheers! ;]

case-study-moya-realm-objectmapper's People

Contributors

matteogazzato avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.