A framework for saving objects persistent on disk. Extended by a dictionary that saves seen objects for faster delivery on duplicate requests.

• Saving & retrieving objects with NSCoding protocol on disk
• Cache used objects in dictionary for usage on runtime
• Include GCD for async requests and saving to don't block the main thread
• Use singleton instance for usage outside the framework
• Secondary indices for categorization of objects
• Own protocol for object serialization Using new Codable for object serialization
• Own index class
• Reduce used disk space amount
• Caching algorithm for most used object and for reducing memory usage
• Auto save secondary indices on disk
• Tests for every important action

This table shows the peformance of the framework, including the number of shown objects and several ways of receiving the entire amount back:

You can initiate an MKCacheStorage instance via the singleton pattern, with the shared variable shown below:

let mkcstorage: MKCacheStorage = MKCacheStorage.shared

The save method stores objects in the framework; if desired, you can also give an array with labels for the object:

• save(object: NSObject, under identifier: String, result:@escaping (Bool) -> ())
• save(object:NSObject, under identifier: String, with labels: [String], result:@escaping (Bool) -> ())

//saving objects
let id = "User1"
let object = MyObject()

mkcstorage.save(object: object, under: id, result: { success in
    //do stuff
})

//saving objects with given labels
let labels = ["friends, "contacts"]

mkcstorage.save(object: object, under: id, with: [labels], result: { success in
    //do stuff
})

There are two methods for retrieving objects:

• get(identifier: String, result:@escaping (NSObject?) -> ())
• get(label: String, result:@escaping ([NSObject]) -> ())

Code example:

//get object by id
let id = "User1"

mkcstorage.get(identifier: id, result: { (object: MyObject?) in
    if let retrievedObj = object as? MyObject {
        //do stuff with object
    }
})

//get objects by label
let label = "contacts"

mkcstorage.get(label: label) { (objects: [MyObject]) in
    //do stuff with objects
}

To store an object in MKCacheStorage, you'll need to (auto)implement the Codable protocol:

class MyObject: Codable {
    var name: String
    var age: Int

    init(name: String, age: Int) {
        self.name = name
        self.age = age
    }
}