處理後端提供各種神奇 Json 資料，而做的解析保護
使用 Swift Package Manager：
- File > Swift Packages > Add Package Dependency
- Add https://github.com/Darktt/JsonProtection
- Select "Up to Next Major" with "1.2.1"
處理 json 資料應該為布林值，但是實際上並非布林值的問題
{
"true": true,
"false": "FALSE"
}將要解析成 Bool 型態的 property 套上 @BoolProtection 進行型態保護
struct BoolObject: Decodable
{
@BoolProtection
var `true`: Bool?
@BoolProtection
var `false`: Bool?
}支援型態（字串不分大小寫）：
- true: 1、“true”、“yes”
- false: 0、“false”、“no”
保護 json key 時有時無的情況
正常情況：
{
"data": {
"name": "Some one",
"age": 11
}
}
錯誤情況：
{
"error": "token is expired."
}將 key 可能消失的 property 加上 @MissingKeyProtection 進行保護
struct UserData: Decodable
{
@MissingKeyProtection
var data: UserInfo?
@MissingKeyProtection
var error: String?
}處理 json 資料應該為數字型態，但是實際上可能為字串型態的問題
包含 MissingKeyProtection 的功能
{
"city": "高雄市",
"lat": "22.78806",
"lng": "120.24257"
}將要解析成數字型態的 property 套上 @NumberProtection 進行型態保護
struct BikeLocation: Decodable
{
var city: String?
@NumberProtection
var lat: CLLocationDegrees?
@NumberProtection
var lng: CLLocationDegrees?
}支援的數字型態：
- Int
- Float
- Double
- Decimal
- 含以上型態的列舉 eg:
enum Type: Int(需套用 NumberType 這個 protocol)
處理 json 資料應該為數字陣列型態，但是實際上可能為字串陣列型態的問題
{
"index": ["10", "20", "50", "100"]
}將要解析成數字陣列型態的 property 套上 @NumbersProtection 進行型態保護
struct Library: Decodable
{
@NumbersProtection
var index: [Int]?
}支援的數字型態：
- 與 NumberProtection 相同
處理 json 裡應為數字內用的 jsonArray 資料，但實際上是 String 型態的問題
{
"dices": "[1, 5.2, 1.0]"
}將要解析成數字陣列型態的 property 套上 @NumberArrayProtection 進行型態保護
struct NumberArray: Decodable
{
@NumberArrayProtection
var dices: [Double]?
}支援的數字型態 (陣列內的數字型態必定要相同，不能混入字串)：
- 與 NumberProtection 相同
處理 json 裡應為 jsonObject 資料，但實際上是 String 型態的問題
{
"num": 1,
"sub": "{\"num\": 22}"
}將要解析成物件的 property 套上 @ObjectProtection 進行型態保護
struct Info: Decodable
{
var num: Int?
@ObjectProtection
var sub: Sub?
}
extension Info
{
struct Sub: Decodable
{
var num: Int?
}
}解決 json 資料裡的時間各式不統一的問題， 並且避免 json 資料型態不正確的問題
{
"updateTime": 1694102400,
"expiredDate": "202309080100"
}將要解析成日期陣列型態的 property 套上 @DateProtection 進行型態保護
struct DateObject: Decodable
{
let updateTime: Date?
@DateProtection(configuration: DateConfiguration.self)
private(set)
var expiredDate: Date?
}並且繼承 DateConfigurate 提供相關設定
extension DateObject
{
struct DateConfiguration: DateConfigurate
{
static var option: DateConfigurateOption {
.dateFormat("yyyyMMddhhss", timeZone: TimeZone(abbreviation: "GMT+0800"))
}
}
}設定選項：
- 時間格式 (yyyyMMdd 等格式) 與時區
- 時間戳（基本單位為秒（Second））
- 時間戳（基本單位為毫秒（millisecond））
- iso8601（是否有毫秒）
支援型態：
- 字串
- 任何數字型態
將 json 裡的字串解析成為 UIImage 型態
⚠️ ：專案內需有同名的圖片檔案
避免 json 裡的字串為空時，解析成 URL 型態會解析失敗的問題
{
"homePageUrl": "https://www.google.com",
"detailPageUrl": ""
}將要解析成 URL 的 property 套上 @URLProtection 進行型態保護
struct URLObject: Decodable
{
private(set)
var homePageUrl: URL?
@URLProtection
var detailPageUrl: URL?
}這是唯一不做保護的功能，僅做解析 Json 資料時同時做 AES256 解密
使用需繼承 AESAdopter 提供相關解密資訊
struct AESAdopting: AESAdopter
{
static var key: String {
"MnoewgUZrgt5Rk08MtESwHvgzY7ElaEq"
}
static var iv: String? {
"rtCG5mdgtlCtbyI4"
}
static var options: DTAES.Options {
[.pkc7Padding, .zeroPadding]
}
}然後在需解密的 property 時加上 @AESDecoder，即可在完成解析後並且做解密的動作
struct AESObject: Decodable
{
@AESDecoder(adopter: AESAdopting.self)
var url: String?
}支援型態：
- 字串
- 字串陣列
保護同變數在不同 json 資料情境下，有複數的 key 存在的問題
Created by Darktt.
This project is licensed under the MIT License.