Swift 3.0 enum 的灵活使用

1. 前言

一晃半年了，从之前的顺丰优选跳槽到现在的闪银，都没有时间好好写文章，先进行自我批评，最近在忙开源项目，在造各种轮子的过程中，深深的体会到了Swift中enum的便利，直接上代码。

2. Objective-C 中的enum

typedef NS_ENUM(NSUInteger, UserType) {
    UserTypeStudent,
    UserTypeTeacher,
    UserTypeStaff,
    UserTypeAdministrator,
    UserTypeOther
};

这是一段标准的Objective-C风格的枚举定义，声明一个类型为NSUInteger的枚举UserType，它有什么用呢， 多数情况下枚举起的是解释的作用，何为解释?
来个实例:

    {
        "successful": true,
        "userType": 0  // 可能为其他的值
    }

后台返回一串json,userType可能为1~9,踩过坑的猿们都明白，若是直接使用后台返回的userType字段进行业务逻辑的处理，可能会出现牵一发而动全身的尴尬局面，这个既关乎代码规范，也少给自己挖坑。
推荐的做法是，将返回的userType映射成枚举，之后代码中其他地方也可以调用，后台如果userType对应关系改变，我们也只需改与之对应的枚举映射

3. Swift 中的enum

使用过Objective-C中的枚举，我们会发现，有时候我们不想用基础类型的枚举，比如NSUInteger等等，我们想将typedef NS_ENUM(NSUInteger, UserType)的NSUInteger改成NSString，但是系统不支持定义非基础类型的枚举，会报错is an invaild underlying type，那就导致了枚举使用不是那么灵活，我们来看看Swift中的枚举

enum CIBlurStyle: String{
    case extraLight = "extraLight"
    case light      = "light"
    case dark       = "dark"

这是Swift中最基础的枚举用法，我们可以指定枚举的类型，通过
CIBlurStyle.extraLight.rawValue
可以获取到枚举的原始值，此外我们还可以在枚举中传递参数，如：

enum CIBlurHUDType {
    case guide(Bool)
    case info(String)
    case error(Error)
    case other
}


func handleEnum(hudType: CIBlurHUDType) -> Void {
       switch hudType {
                case .guide(let isAutoHide):
                    // 
                case .info(let tip):
                    // 提示信息
                case .error(let error):
                    // 对 `error` 做处理
                default:
                    break
                }
}

// 如何使用
handleEnum(.info("这是一段提示文字~"))

let err = NSError.init(domain: "发生了一些不为人知的错误", code: 110, userInfo: nil)
handleEnum(.error(err))

4. Swift 中的enum如何灵活使用

4.1 利用enum精简代码

Swift中的enum使用非常方便，实例：

public enum CIImageOperation {
    case cornerRadius(CGFloat)
    case scale(CGSize)
    case zip(CGFloat)
    case other
}

我们想要造一个图片请求库，下载完可能会对图片进行上面枚举中的处理，不使用enum,我们可能会声明很多方法，如：

extensin UIImageView {
    func setImage(with url: URL, cornerRadius: CGFloat) -> Void {}
    func setImage(with url: URL, scaleTo: CGSize) -> Void {}
    func setImage(with url: URL, zip: (Bool, CGFLoat)) -> Void {}
}

来，我们换一种写法，看着更精简

extension UIImageView {
    func setImage(with url: URL, imageOperation: CIImageOperation) -> Void {
        // 下载完图片对图片进行处理
        switch imageOperation {
                case .cornerRadius(let cornerRadius):
                    // 切圆角
                case .scale(let size):
                    // 尺寸缩放
                case .zip(let zipValue):
                    // 图片清晰度的压缩比例
                default:
                    break
                }
    }
}

// 使用
imagView.setImage(with url: "www.codeinventor.club", imageOperation: .cornerRadius(3.0))

4.2 利用enum对网络请求结果等做简单的package操作

enum CIUrlResponse {
    case Result(Any)
    case error(NSError)
}

通常在一个网络请求完毕之后，会返回一系列response，利用enum可以传递参数的特性，我们可以使用enum对网络请求进行包装，使其更加直观易懂，如下面这个func：

func getData(with url: URL) -> CIUrlResponse {}

注：enum 使用时传参数，很方便，但还是不建议传太多参数，或者过于复杂的Closure
举个负面例子：

enum HUDStyle {
        case loading(Bool, CGFloat, CGFloat, String)
        case other(((Bool) -> ()))
    }

。。。不注释根本看不懂这堆参数什么意思
So. Swift中的enum适合传递少量参数，或者简单的Closure,与function相比，enum承担的更多的还是解释的作用

5. 后续

近期在弄一个比较大一点的开源App项目，包括地图、ForceTouch，和一些自己造的轮子(图片请求轮子，Blur效果的提示框)，也欢迎大家去我们的网站CodeInventor(正在建设中)拍拍砖…

推荐官方文档进行学习：

The Swift Programming Language (Swift 3.1)