Swift國內社區: SwiftMic

Vapor 提供了一種機制來驗證數據的合法性。

基本用法

驗證 Employee 的 email 和 name 數據是否合法

class Employee {
    var email: Valid<Email>
    var name: Valid<Name>

    init(request: Request) throws {
        email = try request.data["email"].validated()
        name = try request.data["name"].validated()
    }
}

通過聲明 Valid<> 類型來保證數據的合法性，只有通過驗證的數據才能傳遞給 email 和 name 。

只需使用 .validated() 進行數據驗證， 而request.data 返回的數據類型均可調用 .validated() 。

這里， Email 是 Vapor 內置的 validator ，而 Name 不是。

• Vapor 內置的 validator

Valid<OnlyAlphanumeric>
Valid<Email>
Valid<Unique<T>>
Valid<Matches<T>>
Valid<In<T>>
Valid<Contains<T>>
Valid<Count<T>>

Name 實現

class Name: ValidationSuite {
    static func validate(input value: String) throws {
        let evaluation = OnlyAlphanumeric.self
            && Count.min(5)
            && Count.max(20)

        try evaluation.validate(input: value)
    }
}

只有純字母且字數介于 5~20 之間的名字才能通過驗證。

使用示例

drop.post("validation") { request in
    do {
        let employee = try Employee(request: request)
        
        print("employee name : \(employee.name.value)")
        print("employee email : \(employee.email.value)")
    } catch let error as ValidationError<Email> {
        return "Email is invalid"
    } catch let error as ValidationError<Name> {
        return "Name is invalid"
    }
    
    return "validation success"
}

只有傳入的 name 和 email 數據均合法才能通過驗證，不然將會拋出異常。

除了通過 validated ，還有其他兩種方式驗證

    let text = "test123"
    let result1 = text.passes(Count.min(5))
    let result2 = try text.tested(by: Count.min(5))
    
    print("result1 = \(result1)")
    print("result2 = \(result2)")

輸出

result1 = true
result2 = test123

passes 方法返回 Bool 類型， 而 tested 方法返回原始類型。

Go to Vapor系列教程 - 目錄