$q 实例分析 Angular 中的 Promise

摘要：回调函数有两个参数，，分别代表执行成功与失败。有两个回调函数，分别表示执行成功和执行失败的回调，回调函数的参数为在第一步逻辑中标记方法传入的字符串。链式操作如果中逻辑的执行需要时间等待，那么，中回调函数的返回值为对象时，才能够按顺序执行。

相信有一些开发经验的朋友就应该知道，对于JavaScript而言，promise十分重要，在开发中总能用到。因此掌握好它是一件必须做的事情。

我之前写过一篇文章，工作总结：jQuery高级应用之Deferred对象，介绍jquery中的promise，因此关于promise的基础介绍就不再详细讲解，这篇文章会重点关注angular中promise的实现。

我们首先有一个简单的html标签，下面的例子都会基于这个标签来书写

</>复制代码 

在angular中，$q是一个非常重要的service。通过$q，angular有两种比较常用的方式来实现promise，分别是ES6风格与jquery风格。

我们直接来看看js代码

</>复制代码 
angular.module("app", [])
.controller("demoController", function($q, $timeout) {
    var a = 1;
    $q(function(resolve, reject) {
        $timeout(function() {
            if(a == 1) {
                console.log("resolve");
                resolve("hello, JAKE");    
            } else {
                console.log("reject");
                reject("JAKE is not here!")
            }
        }, 2000)
    })
    .then(function(greeting) {
        console.log("success, " + greeting);
    }, function(reason) {
        console.log("failed, " + reason);
    })
})

当a==1，输出结果为

</>复制代码 
"resolve"
"success, hello, JAKE"

当a!=1，输出结果为

</>复制代码 
"reject"
"failed, JAKE is not here!"

点我查看实例地址

上例中，我直接将第一步逻辑在$q()中处理。回调函数有两个参数，resolve, reject，分别代表执行成功与失败。

然后在对应的逻辑里面，使用resolve/reject标记逻辑的执行状态。then方法中的代码会在第一步的逻辑执行完了才执行，为了证明这一点，我在第一步的逻辑中设置了2秒的延迟。then会等待第一步执行完毕。

then有两个回调函数，分别表示执行成功和执行失败的回调，回调函数的参数为在第一步逻辑中标记方法传入的字符串。如果第一步逻辑执行成功，则会执行then第一个回调函数，如果失败，则会执行第二个回调。

与jquery实现类似，我们需要定义个defer对象，并在第一步逻辑中手动返回promise

</>复制代码 
angular.module("app", [])
.controller("demoController", function($q, $timeout) {
    var a = 1;
    
    $q.when(function() {
        var defer = $q.defer();
        $timeout(function() {
            defer.notify("notify jake.");
            
            if(a == 1) {
                console.log("rsolve");
                defer.resolve("hello, jake");
            }
            else {
                console.log("reject");
                defer.reject("jake is not here.")
            }
        }, 2000);
        return defer.promise;
    }())
    .then(function(greeting) {
        console.log("success, " + greeting);
    }, function(reason) {
        console.log("fail, " + reason);
    }, function(update) {
        console.log("notify, " + update);
    })
})

当a==1，输出结果为

</>复制代码 
"rsolve"
"notify, notify jake."
"success, hello, jake"

当a!=1 输出结果为

</>复制代码 
"reject"
"notify, notify jake."
"fail, jake is not here."

点击我查看实例

Angular 中 Promise 的一些方法，其实从上面的实例就已经能够知道promise的大概用法，不算复杂。

1. then(successCallback, errorCallback, notifyCallback)
从字面上我们就能够看出then三个回调的含义，第二个参数与第三个参数为可选。

2. catch(errorCallback)
相当于 then(null, errorCallback)

3. finally(callback, notifyCallback)
无论promise的返回状态是上面，该方法总是会执行。

如果then中逻辑的执行需要时间等待，那么，then中回调函数的返回值为promise对象时，才能够按顺序执行。因此需要我们手动返回一个promise对象，例子如下

</>复制代码 
var app = angular.module("app", []);
app.controller("demoController", function($q, $timeout) {
    $q.when(function() {
        var defer = $q.defer();
        $timeout(function() {
            console.log("first");
            defer.resolve();
        }, 2000);
        return defer.promise;
    }())
    .then(function() {
        var defer = $q.defer();
        $timeout(function() {
            defer.resolve();
            console.log("second");
        }, 1000);
        return defer.promise;
    })
    .then(function() {
        console.log("third");    
    })
});

</>复制代码 
"first"
"second"
"third"

点我查看实例地址
官方文档中，认为then方法中只需要有返回值

但是如果then的执行不需要时间等待，then中的回调函数的第一个参数，会获取到上一个then的返回值，然后按顺序执行，如下例。

</>复制代码 
var app = angular.module("app", []);
app.controller("demoController", function($q, $timeout) {
    
    function first() {
        var a = 1;
        var defer = $q.defer();
        $timeout(function() {
            if(a == 1) {
                console.log("first resolve");
                defer.resolve("resolve result");    
            } else {
                console.log("first reject");
                defer.reject();
            }
        }, 2000)
        return defer.promise;
    }
    
    var promiseA = first();
    
    promiseA.then(function(result) {
        // $timeout(function() {
        console.log("second, " + result);
        return "document";
        // }, 1000)
        
    })
    .then(function(result) {
        console.log("third, " + result);
    })
    
});

输出结果为

</>复制代码 
"first resolve"
"second, resolve result"
"third, document"

点我查看实例地址

因为表述起来并不是那么容易，因此建议大家通过实例慢慢理解。

$http是对promise的最佳实践。由于controller生命周期会在controller消亡的时候结束，其中的数据也会销毁，因此我们常常会将获取数据的操作放在自定义的服务中。因此我们的实例如下

</>复制代码 
angular.module("app", [])
.controller("demoController", function(data) {
    data.getData().then(function(resp) {
        console.log(resp);
    })
})
.factory("data", function($http) {
    return {
        getData: function() {
            var url = "https://hq.tigerbrokers.com/fundamental/finance_calendar/get_day/2016-06-26";
            return $http.get(url);    
        }
    }
})

我们将then中回调函数的参数打印出来，发现格式如下

</>复制代码 
Object {
    config: Object {},
    data: Object {},
    headers: function(d) {},
    status: 200,
    statusText: "OK"
}

这一点与jquery的返回值略有不同，他们分别表示的意思为

config： 请求的配置信息
data： 返回的数据
headers: 请求的头部信息
status: 返回的状态码

点击查看实例地址