[swift] ObjectMapper를 이용하여 JSON을 모델 객체로 변환하는 방법

15 Nov 2023

swift

많은 애플리케이션에서는 서버와의 통신을 위해 JSON 데이터 형식을 사용합니다. 이러한 JSON 데이터를 쉽게 모델 객체로 변환할 수 있는 방법이 필요한데, Swift에서는 ObjectMapper라는 라이브러리를 사용하여 이를 구현할 수 있습니다.

ObjectMapper란?

ObjectMapper는 Swift에서 JSON 데이터를 객체로 변환하고, 객체를 JSON 데이터로 변환하는 데 사용되는 라이브러리입니다. ObjectMapper는 JSON 데이터와 모델 객체 간의 매핑을 쉽게 처리해주며, 복잡한 코드를 작성하지 않고도 효율적으로 데이터를 처리할 수 있도록 도와줍니다.

ObjectMapper 설치

ObjectMapper를 사용하기 위해 먼저 프로젝트에 ObjectMapper를 설치해야 합니다. CocoaPods를 사용한다면 Podfile에 다음과 같은 내용을 추가합니다:

pod 'ObjectMapper', '~> 4.2'

설치가 완료되었다면, import ObjectMapper를 통해 ObjectMapper를 사용할 준비가 된 것입니다.

JSON 데이터를 모델 객체로 변환하기

ObjectMapper를 사용하여 JSON 데이터를 모델 객체로 변환하는 방법은 다음과 같습니다:

변환하고자 하는 모델 객체를 만듭니다. 이 객체는 ObjectMapper의 Mappable 프로토콜을 채택해야 합니다.

import ObjectMapper

struct User: Mappable {
    var name: String?
    var age: Int?
    
    init?(map: Map) {}
    
    mutating func mapping(map: Map) {
        name <- map["name"]
        age <- map["age"]
    }
}

JSON 데이터를 가져옵니다.

let jsonString = """
{
    "name": "John",
    "age": 30
}
"""

ObjectMapper를 사용하여 JSON 데이터를 모델 객체로 변환합니다.

if let user = Mapper<User>().map(jsonString) {
    print(user.name) // John
    print(user.age) // 30
}

위의 예시에서는 ObjectMapper의 map 메서드를 사용하여 JSON 데이터를 모델 객체로 변환하였습니다. 변환된 객체는 옵셔널 타입으로 반환되므로, nil 체크를 통해 변환이 제대로 이루어졌는지 확인할 수 있습니다.

모델 객체를 JSON 데이터로 변환하기

ObjectMapper를 사용하여 모델 객체를 JSON 데이터로 변환하는 방법은 다음과 같습니다:

JSON 데이터로 변환하고자 하는 모델 객체를 만듭니다.

import ObjectMapper

struct User: Mappable {
    var name: String?
    var age: Int?
    
    init?(map: Map) {}
    
    mutating func mapping(map: Map) {
        name <- map["name"]
        age <- map["age"]
    }
}

let user = User(name: "John", age: 30)

ObjectMapper를 사용하여 모델 객체를 JSON 데이터로 변환합니다.

if let jsonString = Mapper<User>().toJSONString(user) {
    print(jsonString) // {"name":"John","age":30}
}

위의 예시에서는 ObjectMapper의 toJSONString 메서드를 사용하여 모델 객체를 JSON 데이터로 변환하였습니다.

추가적인 기능과 사용법

ObjectMapper는 JSON 데이터와 모델 객체 간의 매핑에 대한 다양한 기능을 제공합니다. 필요에 따라 ObjectMapper의 기능들을 참고하여 개발에 활용할 수 있습니다.

변환 시 매핑되지 않은 필드를 무시하거나, 매핑 시 사용하는 키 이름을 커스터마이징할 수 있습니다.
JSON 데이터에 중첩된 객체나 배열을 처리할 수 있습니다.
기본적인 데이터 타입(Int, String, Bool 등)뿐만 아니라, 날짜, URL 등의 복잡한 데이터 타입을 매핑할 수 있습니다.

ObjectMapper의 더 자세한 사용법과 기능들은 ObjectMapper의 공식 문서에서 확인할 수 있습니다.

JSON 데이터와 모델 객체 간의 변환은 애플리케이션 개발에서 중요한 부분이며, ObjectMapper를 사용하면 이를 간단하고 효율적으로 구현할 수 있습니다.