Reflection

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

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

核心功能

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

用例

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

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

typealiasPet=(name:String, age:Int)enumGender{case female, male
}structUser{privateletname:Stringprivateletgender:Genderprivateletpet:Pet}

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

letreflection=tryReflection(reflecting:User.self)forpropertyin reflection.properties {print(property.name, property.type)}
// outputs: // name String
// gender Gender
// pet (name: String, age: Int)

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

letproperty=reflection["pet"]

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

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

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

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

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

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

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

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

也可以不传使用默认值

letuser=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"