[swift] Swift ObjectMapper의 동작 원리는 어떻게 되는가?

27 Nov 2023

swift

Swift ObjectMapper는 JSON 데이터와 Swift 객체 간의 매핑을 쉽게 처리하기 위한 오픈소스 라이브러리입니다. 이 라이브러리는 JSON 데이터를 읽어와서 Swift 객체로 변환하거나, Swift 객체를 JSON 데이터로 변환하는 작업을 수행합니다. ObjectMapper는 매우 유용하며, 주로 네트워크를 통해 데이터를 주고받거나, 로컬 저장소에 데이터를 저장하고 불러올 때 많이 사용됩니다.

ObjectMapper의 동작 원리는 매우 간단합니다. JSON 데이터를 Swift 객체로 변환하려면, ObjectMapper는 JSON 데이터의 각 필드와 Swift 객체의 프로퍼티를 매핑해야 합니다. 이를 위해 ObjectMapper는 JSON 데이터를 분석하여 각 필드의 값을 추출하고, Swift 객체의 프로퍼티에 할당합니다. 이때, ObjectMapper는 JSON 데이터의 필드 이름과 Swift 객체의 프로퍼티 이름이 일치하는 경우에만 자동으로 매핑을 수행합니다.

예를 들어, 다음과 같은 JSON 데이터가 있다고 가정해봅시다.

{
  "name": "John",
  "age": 30,
  "email": "john@example.com"
}

Swift에서는 다음과 같은 객체를 정의할 수 있습니다.

class User: Mappable {
  var name: String?
  var age: Int?
  var email: String?

  required init?(map: Map) { }

  func mapping(map: Map) {
    name <- map["name"]
    age <- map["age"]
    email <- map["email"]
  }
}

이렇게 정의된 User 클래스는 ObjectMapper를 사용하여 JSON 데이터를 객체로 변환할 수 있습니다. 위 코드에서 mapping 함수는 ObjectMapper에게 JSON 데이터의 필드와 Swift 객체의 프로퍼티를 매핑하는 방법을 알려주는 역할을 합니다. <- 연산자를 사용하여 매핑을 수행하며, map 함수의 인자로는 JSON 데이터의 필드명을 전달합니다.

이제 ObjectMapper를 사용하여 JSON 데이터를 User 객체로 변환하는 예제를 살펴보겠습니다.

let jsonString = "{\"name\":\"John\",\"age\":30,\"email\":\"john@example.com\"}"
let user = Mapper<User>().map(JSONString: jsonString)

위의 코드에서는 JSON 문자열을 작성하고, Mapper의 map 함수를 사용하여 JSON 문자열을 User 객체로 변환합니다. 이때, ObjectMapper는 mapping 함수에 따라 JSON 데이터의 필드값을 User 객체의 프로퍼티에 자동으로 할당합니다.

이와 반대로, Swift 객체를 JSON 데이터로 변환할 때는 ObjectMapper의 toJSONString 함수를 사용합니다. 다음은 User 객체를 JSON 데이터로 변환하는 예제입니다.

let user = User()
user.name = "John"
user.age = 30
user.email = "john@example.com"

let jsonString = Mapper().toJSONString(user)

위 코드에서는 User 객체를 생성하고, ObjectMapper의 toJSONString 함수를 사용하여 객체를 JSON 문자열로 변환합니다. 이렇게 변환된 JSON 문자열은 네트워크를 통해 전송하거나 로컬 저장소에 저장할 수 있습니다.

Swift ObjectMapper는 매우 편리하게 JSON 데이터와 Swift 객체 간의 매핑 작업을 수행해주는 도구입니다. JSON 데이터를 Swift 객체로 변환하거나 Swift 객체를 JSON 데이터로 변환하는 작업을 간단하게 처리할 수 있는 ObjectMapper의 사용법을 익혀두면 개발 과정에서 큰 도움이 될 것입니다.

참고 자료

ObjectMapper GitHub 저장소