Swift 메타타입 완벽 정리

1. 핵심 개념 한눈에 보기

2. self vs Self

class Dog {
    var name = "멍멍이"

    func printSelf() {
        print(self)       // 👈 소문자: 현재 "인스턴스"
        print(self.name)  // "멍멍이"
    }

    static func printSelfType() {
        print(Self.self)  // 👈 대문자: 현재 "타입" 자체
    }
}

let dog = Dog()
dog.printSelf()           // Dog 인스턴스 출력
Dog.printSelfType()       // "Dog" 타입 출력

3. .Type vs .self

// 일반적인 경우
let dog: Dog = Dog()                  // dog은 Dog의 "인스턴스"
let dogType: Dog.Type = Dog.self     // dogType은 Dog "타입 자체"를 담는 변수

print(type(of: dog))      // Dog
print(type(of: dogType))  // Dog.Type

비유로 이해하기

// 왼쪽은 타입, 오른쪽은 값
let instance: Dog      = Dog()      // ✅
let metatype: Dog.Type = Dog.self   // ✅

let wrong1: Dog      = Dog.self  // ❌ 값 타입 불일치
let wrong2: Dog.Type = Dog()     // ❌ 값 타입 불일치

4. 인스턴스에서 .self와 .Type

let a = Dog()

a.self   // ✅ 가능 - 그냥 a 자신을 반환 (의미 없음)
a.Type   // ❌ 불가능 - 문법 에러!

type(of: a)  // Dog.Type 값 반환 (= Dog.self와 동일)

5. 메타타입 비교

let a = Dog()

type(of: a) == Dog.self    // ✅ 비교 가능 → true
type(of: a) == Dog.Type    // ❌ 컴파일 에러!

// 비유:
"철수" == "철수"      // ✅ 값 == 값
"철수" == String      // ❌ 값 == 타입 (말이 안 됨)

6. 메타타입 실전 활용

6.1 타입을 파라미터로 전달

func createAnimal<T: Animal>(type: T.Type) -> T {
    return type.init()
}

let dog = createAnimal(type: Dog.self)   // ✅ Dog.self를 파라미터로 전달
let cat = createAnimal(type: Cat.self)

// ❌ 잘못된 호출
let wrong = createAnimal(type: Dog.Type)  // 컴파일 에러! 타입을 값으로 전달 불가

6.2 JSON 디코딩

func decode<T: Decodable>(_ type: T.Type, from data: Data) -> T? {
    return try? JSONDecoder().decode(type, from: data)
}

let user = decode(User.self, from: jsonData)

6.3 셀 등록 (UITableView)

tableView.register(MyCell.self, forCellReuseIdentifier: "cell")
//                 ^^^^^^^^^ 타입 자체를 전달

7. 실전 예제: 네임스페이스 패턴

카카오페이의 멀티 프레임워크 리소스 관리에서 사용한 패턴:

// 프로토콜 정의
public protocol PayResourceSupports {}

public struct PayResource<Base> {
    public let base: Base
    public init(_ base: Base) { self.base = base }
}

public extension PayResourceSupports {
    // 1번: 타입에서 호출 (static)
    static var pay: PayResource<Self>.Type { PayResource<Self>.self }

    // 2번: 인스턴스에서 호출
    var pay: PayResource<Self> { PayResource(self) }
}

왜 메타타입을 반환하나?

extension PayResource where Base == UIImage {
    // static 프로퍼티!
    public static var ic_core_message: UIImage {
        UIImage(named: "ic_core_message", in: .resourceBundle, compatibleWith: nil)!
    }
}

// 사용
imageView.image = .pay.ic_core_message

UIImage.pay
   │
   │  static var pay: PayResource<Self>.Type { PayResource<Self>.self }
   │                  ─────────────────────   ─────────────────────────
   │                  반환 타입: 메타타입       반환 값: 메타타입 값
   │
   ▼
PayResource<UIImage>.self  (= PayResource<UIImage> 타입 자체)
   │
   │  타입에서 static 프로퍼티 접근 가능!
   │
   ▼
.ic_core_message → UIImage 인스턴스 반환

// 인스턴스를 반환하면:
UIImage.pay  // → PayResource<UIImage>() 인스턴스
UIImage.pay.ic_core_message  // ❌ static 프로퍼티 접근 불가

// 메타타입을 반환하면:
UIImage.pay  // → PayResource<UIImage>.self (타입 자체)
UIImage.pay.ic_core_message  // ✅ static 프로퍼티 접근 가능!

8. Q&A

9. 최종 정리표