Reflection

Reflection 提供 Swift 反射，能从 Metatype 中获取类型的属性等信息，也提供用从 Metatype 获取的信息中直接构造实例的能力。原生 Mirror 需要实例才可反射相比，而 Reflection 可以直接直接通过类型反射。

该项目尚在早期阶段，请勿用于正式项目

核心功能

• 获取 Metatype 的 size / alignment / stride 信息
• 获取 Metatype 中的属性信息，包括属性名，属性类型，是否可修改以及偏移值
• 获取类 Metatype 中继承的信息，获取 Metatype 中的泛型信息
• 获取枚举 Metatype 所有 case 的名称，关联值类型
• 获取方法 Metatype 的入参类型和返回值类型
• 通过属性信息直接修改属性值，无论有任意访问修饰符和是否为 let
• 通过获取的 Metatype 信息，通过传入 Dictionary 构造实例，也支持使用默认值

用例

建议下载本项目使用 Playground 查看用例

假如有一个元祖 Pet，枚举 Gender ，以及包含了两者的结构体 User，可以是来自其他模块，属性可以有任何访问修饰符

typealias Pet = (name: String, age: Int)

enum Gender {
    case female, male
}

struct User {
    private let name: String
    private let gender: Gender
    private let pet: Pet
}

可以通过 Reflection 获取到 User 的信息

let reflection = try Reflection(reflecting: User.self)

for property in reflection.properties {
    print(property.name, property.type)
}

// outputs: 
// name String
// gender Gender
// pet (name: String, age: Int)

也可以通过下标找需要的属性信息

let property = reflection["pet"]

同时也可以通过 property 的 get / set 方法获取或修改实例中对应属性的值，可以有任意访问修饰符，var 也可以修改

try property?.get(from: user)
try property?.set(("Momo", 3) to: &user)

若不需要其他信息，也可以使用如下更便捷的修改方法（效果和上例相同）

try Reflection.get("pet", from: user)
try Reflection.set("pet", with: ("Momo", 3) to: &user)

如果一个类型需要频繁获取或修改属性值，还可以让该类继承自 Reflectable ，无需实现任何额外方法即可使用下例中的 API，效果同上例

extension User: Reflectable { }
user.rf.pet
user.rf.pet = ("Momo", 3)

Reflection 还提供传入 [String: Any] 构造实例的 API，嵌套结构也是支持的，这里支持结构体 / 元祖 / 类 / 枚举 （暂时只支持不包含关联值的枚举）

let user = try reflection.instance([
    "name": "Frain",
    "gender": 1, // use Gender.male is also ok
    "pet": [
        "name": "Momo",
        "age": 3
    ]
])

也可以不传使用默认值

let user = try reflection.instance()
print(user)
// output: User(name: "", gener: .female, pet: (name: "", age: 0))

安装

Carthage

将下面一行添加进 Cartfile 即可：

github "Alpensegler/Reflection"

Swift Package Manager

在 Xcode 中，点击 "Files -> Swift Package Manager -> Add Package Dependency..."，在搜索栏中输入 "https://github.com/Alpensegler/Reflection"