How to Read in a JSON File Using Swift

Reading JSON files is a very common requirement in iOS development. In Swift, we typically use JSONDecoder to parse JSON files into instances of structs or classes. Below, I'll walk through an example to demonstrate this process in detail.

Assume we have a JSON file data.json with the following content:

json
{
    "name": "John Doe",
    "age": 30,
    "isStudent": false
}

First, we need to define a Swift struct that corresponds to the JSON data structure:

swift
struct Person: Codable {
    var name: String
    var age: Int
    var isStudent: Bool
}

Here, Codable is a type alias that includes both Decodable and Encodable protocols, allowing Person to be both decoded and encoded into JSON.

Next, we will write a function to read and parse the local JSON file:

swift
func loadJSONFromFile() {
    // Locate the JSON file
    guard let path = Bundle.main.path(forResource: "data", ofType: "json") else {
        print("JSON file not found")
        return
    }

    do {
        // Convert file content to Data
        let data = try Data(contentsOf: URL(fileURLWithPath: path), options: .mappedIfSafe)
      
        // Create JSONDecoder instance
        let decoder = JSONDecoder()
      
        // Parse the data
        let person = try decoder.decode(Person.self, from: data)
      
        // Use the parsed data
        print("Name: \(person.name)")
        print("Age: \(person.age)")
        print("IsStudent: \(person.isStudent)")
      
    } catch {
        print("Error during JSON serialization: \(error.localizedDescription)")
    }
}

In this function:

• We first locate the path to the JSON file.
• Then, we attempt to read the file content as Data.
• Next, we use JSONDecoder to parse the data.
• Finally, we utilize the parsed data.

This allows us to load and parse data from a JSON file. Of course, in real applications, JSON files may be more complex, containing arrays or nested objects, but the approach is similar; the key is to ensure that the Swift data model matches the JSON structure.

This is a basic example of reading and parsing JSON files using Swift.