[Swift通天遁地]七、数据与安全-(14)使用单元测试进行邮箱格式的验证

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公众号：山青咏芝（shanqingyongzhi）
➤博客园地址：山青咏芝（https://www.cnblogs.com/strengthen/）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：https://www.cnblogs.com/strengthen/p/10341471.html 
➤如果链接不是山青咏芝的博客园地址，则可能是爬取作者的文章。
➤原文已修改更新！强烈建议点击原文地址阅读！支持作者！支持原创！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

目录：[Swift]通天遁地Swift

本文将演示使用单元测试进行邮箱格式的验证。

如果项目中没有引用单元格测试框架，

项目导航区点击选中项目名称，再点击中间列的【+】图标进行添加。

在弹出的模板窗口中，选择单元测试框架模板【iOS Unit Testing Bundle】

->【Next】->保持默认的选项设置->【Finish】

现在创建一个基于正则表达式的验证类。

在项目文件夹【DemoApp】上点击鼠标右键，弹出右键菜单。

【New File】->【Swift File】->【Next】->

【Save As】:EmailUtil.swift->【Create】

import UIKit

//为了使用正则表达式对字符串进行检测，
//添加一个用于正则表达式检测的结构体。
struct RegexHelper
{
    //此处使用Object-C正则表达式的类，进行表达式的检测。
    let regex: NSRegularExpression?
    
    //对结构体进行初始化，并传入一个字符串参数，用于检验邮箱格式的正则表达式。
    init(_ pattern: String)
    {
        //添加一个异常捕捉语句，用来执行正则表达式的匹配工作。
        do
        {
            //创建一个正则表达式，并且在检验格式时，不对大小写进行区分。
            regex = try NSRegularExpression(pattern: pattern,
                                            options: NSRegularExpression.Options.caseInsensitive)
        }
        catch
        {
            regex = nil
        }
    }
    
    //创建一个方法，用来执行正则表达式的检测工作，并且返回一个布尔结果。
    func match(_ input: String) -> Bool
    {
        //对字符串进行正则表达式的检测，
        //并且获得匹配的对象在字符串中的范围。
        if let matches = regex?.matches(in: input, 
                                        options: .reportProgress,
                                        range: NSMakeRange(0, input.lengthOfBytes(using: .utf8)))
        {
            //判断匹配正则表达式的位置，是否大于0，
            //以判断字符串与正则表达式是否匹配。
            //如果字符串不匹配正则表达式，则返回否。
            return matches.count > 0
        }
        else
        {
            return false
        }
    }
}

//添加一个验证邮箱格式的类
class EmailUtil
{
    //添加一个方法，拥有一个字符串类型的参数，用来检测字符串。
    func validateEmail(email:String) -> Bool
    {
        //通过正则表达式对该参数进行检测，
        //创建一个用于检测邮箱格式的正则表达式字符串。
        let pattern = "^([a-z0-9_\.-]+)@([\da-z\.-]+)\.([a-z\.]{2,6})$"
        //创建一个用于正则检验的结构体对象。
        let matcher = RegexHelper(pattern)
        
        //使用结构体的匹配方法，对字符串进行正则校验。
        if matcher.match(email)
        {
            //如果属于正确的邮箱格式则返回真。
            return true
        }
        //返回检测的结果
        return false
    }
}

点击各刚创建的文件夹【UnitTestProject_DemoTests】，

显示文件夹下的所有项目，创建一个单元测试类文件。

【New File】->【Cocoa Touch Class】->【Next】->

【Class】:EmailTester

【Subclass of】:XCTestCase

【Language】:Swift

->【Next】->【Create】

现在开始编写代码，创建一个自定义的测试用例。

//引入单元测试类库
import XCTest
//引入另一个目标中的类，
//这样可以在当前的类文件中，使用另一个目标的类文件。
@testable import UnitTestProject_ValidateEmail

class EmailTester: XCTestCase {
    
    //添加一个测试用例
    //点击方法名称左侧的菱形图标，执行该测试用例。
    func testEmail()
    {
        //初始化一个邮箱格式验证的实例
        let emailUtil = EmailUtil()
        //调用实例的验证方法，判断指定的邮箱格式是否正确。
        let result = emailUtil.validateEmail(email: "newsagency@163.com")
        //在方法的末尾，通过一个断言，检测执行正则校验后的结果。
        XCTAssert(result, "E-mail is incorrect.")
        //最后点击testEmail()方法名称左侧的菱形图标，执行该测试用例
    }
}