这两个测试基本可以保证检查 URL 是否合法的逻辑和调用 Alamofire 的逻辑正确。
由于该方法中使用了parseResult方法,当然我也要测试这个方法的正确性:
let testKey = "testKey" let jsonDictWithError: [String: AnyObject] = ["code": 1] let jsonDictWithoutData: [String: AnyObject] = ["code": 0] let jsonDictWithData: [String: AnyObject] = ["testKey": "testValue"] let manager = NetworkManager.defaultManager let error = UMAError.errorWithCode(.Unknown) func makeResultForFailureCaseWithError(error: NSError) -> Result<AnyObject, NSError> { return Result<AnyObject, NSError>.Failure(error) } func makeResultForSuccessCaseWithValue(value: AnyObject) -> Result<AnyObject, NSError> { return Result<AnyObject, NSError>.Success(value) } func testParseResult_failureCase_returnFailureCase() { let result = makeResultForFailureCaseWithError(error) let formattedResult = manager.parseResult(result, responseKey: testKey) XCTAssertTrue(formattedResult.isFailure) } func testParseResult_successCaseWithCode1_returnFailureCaseWithCode1() { let result = makeResultForSuccessCaseWithValue(jsonDictWithError) let formattedResult = manager.parseResult(result, responseKey: testKey) XCTAssertEqual(formattedResult.error!.code, 1) } func testParseResult_successCaseWithoutData_returnFailureCaseWithTransformFailed() { let result = makeResultForSuccessCaseWithValue(jsonDictWithoutData) let formattedResult = manager.parseResult(result, responseKey: testKey) XCTAssertEqual(formattedResult.error!.code, ErrorCode.TransformFailed.rawValue) } func testParseResult_successCaseWithData_returnTestValue() { let result = makeResultForSuccessCaseWithValue(jsonDictWithData) let formattedResult = manager.parseResult(result, responseKey: testKey) XCTAssertEqual(String(formattedResult.value!), "testValue") } |
这个测试也是测试返回值,测试了几种可能发生的情况,基本可以保证parseResult方法的正确性。
工作单元可能有三种最终结果:返回值、改变系统状态和调用第三方对象。相应的单元测试一般可以分为三类:基于返回值的测试、基于状态的测试和交互测试。我上面几个测试都是在测试返回值,这种测试最简单直接也最好维护。要测试状态的改变一般需要先测试初始状态,然后调用改变状态的方法,再测试改变后的状态。而交互测试可能就需要用到 fake (伪对象),fake 分为 stub (存根)和 mock (模拟对象)两种。stub 和 mock 很类似,它们最大的区别是,你会对 mock 进行断言,但不会对 stub 进行断言。换句话说,一旦你对一个 fake 进行断言了,它就是个 mock,否则就是个 stub。
由于 Swift 的反射非常弱鸡,似乎并没有什么特别好用的 mock 框架,所以一般来说可以用面向协议的思想来减少对象间的耦合,然后手动构建一个 fake 用于测试,当然这需要一些依赖注入技术的配合。又因为 Alamofire 对外暴露的最常用函数request是个全局函数,而它又会返回一个Request对象,我们要在该对象上调用responseJSON方法,这样一来光用伪对象似乎不足以满足需求。
Swift 毕竟是一门对 FP 支持度很高的语言,所以工作单元还可能有第四种最终结果——调用第三方函数(这个说法好像怪怪的,领会精神啊哈哈)。那相对应的,我们当然可以使用一个 fake function(伪函数,同样领会精神即可……)来配合测试。依旧以我的 NetworkManager 为例,稍加改造,方便在测试时注入伪函数和伪对象:
typealias NetworkCompletionHandler = Result<AnyObject, NSError> -> Void typealias NetworkRequest = (Alamofire.Method, URLStringConvertible, [String : AnyObject]?, Alamofire.ParameterEncoding, [String : String]?) -> Responsable protocol Responsable: Cancellable { func responseJSON(queue queue: dispatch_queue_t?, options: NSJSONReadingOptions, completionHandler: Alamofire.Response<AnyObject, NSError> -> Void) -> Self } extension Alamofire.Request: Responsable {} class NetworkManager { // static 属性自带 lazy 效果,加上 let 可用作单例 static let defaultManager = NetworkManager(request: Alamofire.request) let request: NetworkRequest init(request: NetworkRequest) { self.request = request } /** Fetch raw object - parameter api: API address - parameter method: HTTP method, default = POST - parameter parameters: Request parameters, default = nil - parameter responseKey: Key of target value, use '.' to get nested objects, e.g. "data.vehicle_list" - parameter jsonArrayHandler: Handle result with raw object - returns: Optional request object which is cancellable. */ func fetchDataWithAPI(api: API, method: Alamofire.Method = .POST, parameters: [String: String]? = nil, responseKey: String, networkCompletionHandler: NetworkCompletionHandler) -> Cancellable? { guard let url = api.url else { printLog("URL Invalid: \\(api.rawValue)") return nil } return request(method, url, parameters, .URL, nil).responseJSON(queue: nil, options: .AllowFragments) { networkCompletionHandler(self.parseResult($0.result, responseKey: responseKey)) } } // ... } |
我声明了一个新的类型NetworkRequest,它其实是个函数,签名跟 Alamofire 中的全局函数request一致。用户使用时只需调用defaultManager即可,而测试时我们可以手动构建一个符合NetworkRequest签名的函数通过初始化方法注入到NetworkManager中。我还声明了一个Responsable的协议,然后用extension 显式声明 Alamofire 中的Request遵守该协议,这个协议可以让我们在测试时构建一个代替Request的 fake 对象。
好了,万事俱备,开始写测试用例:
func testFetchDataWithAPI_requestWithMock_resultWithErrorCode666() { struct MockResponse: Responsable { func responseJSON(queue queue: dispatch_queue_t?, options: NSJSONReadingOptions, completionHandler: Alamofire.Response<AnyObject, NSError> -> Void) -> MockResponse { let unknowError = UMAError.errorWithCode(666, description: "error for test") let result = Result<AnyObject, NSError>.Failure(unknowError) let response = Alamofire.Response(request: nil, response: nil, data: nil, result: result) completionHandler(response) return self } func cancel() {} } let request: NetworkRequest = {_, _, _, _, _ in return MockResponse() } let testableManager = NetworkManager(request: request) testableManager.fetchDataWithAPI(.PostCategory, responseKey: "data") { XCTAssertEqual($0.error!.code, 666) } } |