AngularJS:在哪里使用承诺?

时间:2013-03-24 21:24:48

标签: angularjs deferred promise

我看到了一些使用承诺访问FB Graph API的Facebook登录服务示例。

示例#1

this.api = function(item) {
  var deferred = $q.defer();
  if (item) {
    facebook.FB.api('/' + item, function (result) {
      $rootScope.$apply(function () {
        if (angular.isUndefined(result.error)) {
          deferred.resolve(result);
        } else {
          deferred.reject(result.error);
        }
      });
    });
  }
  return deferred.promise;
}

获得响应时使用"$scope.$digest() // Manual scope evaluation"的服务

示例#2

angular.module('HomePageModule', []).factory('facebookConnect', function() {
    return new function() {
        this.askFacebookForAuthentication = function(fail, success) {
            FB.login(function(response) {
                if (response.authResponse) {
                    FB.api('/me', success);
                } else {
                    fail('User cancelled login or did not fully authorize.');
                }
            });
        }
    }
});

function ConnectCtrl(facebookConnect, $scope, $resource) {

    $scope.user = {}
    $scope.error = null;

    $scope.registerWithFacebook = function() {
        facebookConnect.askFacebookForAuthentication(
        function(reason) { // fail
            $scope.error = reason;
        }, function(user) { // success
            $scope.user = user
            $scope.$digest() // Manual scope evaluation
        });
    }
}

JSFiddle

问题是:

  • 上述示例中的差异是什么?
  • 使用 $ q 服务的原因个案是什么?
  • 如何工作

4 个答案:

答案 0 :(得分:401)

这不是对您的问题的完整答案,但希望当您尝试阅读$q服务上的文档时,这将有助于您和其他人。我花了一段时间来理解它。

让我们暂时搁置AngularJS并考虑Facebook API调用。两个API调用都使用回调机制来通知来自Facebook的响应可用时调用者:

  facebook.FB.api('/' + item, function (result) {
    if (result.error) {
      // handle error
    } else {
      // handle success
    }
  });
  // program continues while request is pending
  ...

这是用JavaScript和其他语言处理异步操作的标准模式。

当您需要执行一系列异步操作时,会出现此模式的一个大问题,其中每个连续操作都取决于上一个操作的结果。这就是这段代码的作用:

  FB.login(function(response) {
      if (response.authResponse) {
          FB.api('/me', success);
      } else {
          fail('User cancelled login or did not fully authorize.');
      }
  });

首先它尝试登录,然后只有在验证登录成功后才向Graph API发出请求。

即使在这种只将两个操作链接在一起的情况下,事情也开始变得混乱。方法askFacebookForAuthentication接受失败和成功的回调,但当FB.login成功但FB.api失败时会发生什么?无论success方法的结果如何,此方法始终调用FB.api回调。

现在想象一下,您正在尝试编写一个包含三个或更多异步操作的强大序列,以便在每个步骤中正确处理错误,并且在几周之后对任何其他人甚至是您都是清晰的。可能,但是很容易就是在这些回调中嵌套这些回调并且在这个过程中忘记错误。

现在,让我们暂时搁置Facebook API,并考虑由$q服务实现的Angular Promises API。该服务实现的模式是尝试将异步编程转换为类似线性系列简单语句的东西,能够在任何一步“抛出”错误并在最后处理它,在语义上类似于熟悉的try/catch阻止。

考虑这个人为的例子。假设我们有两个函数,第二个函数使用第一个函数的结果:

 var firstFn = function(param) {
    // do something with param
    return 'firstResult';
 };

 var secondFn = function(param) {
    // do something with param
    return 'secondResult';
 };

 secondFn(firstFn()); 

现在假设firstFn和secondFn都需要很长时间才能完成,所以我们想要异步处理这个序列。首先,我们创建一个新的deferred对象,它代表一系列操作:

 var deferred = $q.defer();
 var promise = deferred.promise;

promise属性表示链的最终结果。如果您在创建承诺后立即记录承诺,您将看到它只是一个空对象({})。什么都看不到,继续前进。

到目前为止,我们的承诺只代表了链条的起点。现在让我们添加两个操作:

 promise = promise.then(firstFn).then(secondFn);

then方法向链中添加一个步骤,然后返回一个表示扩展链最终结果的新promise。您可以根据需要添加任意数量的步骤。

到目前为止,我们已经建立了我们的功能链,但实际上并没有发生任何事情。您可以通过调用deferred.resolve来启动操作,指定要传递给链中第一个实际步骤的初始值:

 deferred.resolve('initial value');

然后......仍然没有任何反应。为确保正确观察模型更改,Angular实际上不会调用链中的第一步,直到下次调用$apply为止:

 deferred.resolve('initial value');
 $rootScope.$apply();

 // or     
 $rootScope.$apply(function() {
    deferred.resolve('initial value');
 });

那么错误处理呢?到目前为止,我们只在链中的每个步骤中指定了成功处理程序then还接受错误处理程序作为可选的第二个参数。这是承诺链的另一个较长的例子,这次是错误处理:

 var firstFn = function(param) {
    // do something with param
    if (param == 'bad value') {
      return $q.reject('invalid value');
    } else {
      return 'firstResult';
    }
 };

 var secondFn = function(param) {
    // do something with param
    if (param == 'bad value') {
      return $q.reject('invalid value');
    } else {
      return 'secondResult';
    }
 };

 var thirdFn = function(param) {
    // do something with param
    return 'thirdResult';
 };

 var errorFn = function(message) {
   // handle error
 };

 var deferred = $q.defer();
 var promise = deferred.promise.then(firstFn).then(secondFn).then(thirdFn, errorFn);

正如您在此示例中所看到的,链中的每个处理程序都有机会将流量转移到下一个错误处理程序而不是下一个成功处理程序。在大多数情况下,您可以在链的末尾有一个错误处理程序,但您也可以使用中间错误处理程序来尝试恢复。

为了快速回到您的示例(以及您的问题),我只想说它们代表了两种不同的方式来使Facebook的面向回调的API适应Angular观察模型变化的方式。第一个示例将API调用包装在一个promise中,该promise可以添加到范围中,并由Angular的模板系统理解。第二种方法采用更强力的方法直接在作用域上设置回调结果,然后调用$scope.$digest()使Angular知道来自外部源的更改。

这两个例子不能直接比较,因为第一个例子是缺少登录步骤。但是,通常需要在单独的服务中封装与此类外部API的交互,并将结果作为承诺提供给控制器。这样,您可以将控制器与外部问题分开,并使用模拟服务更轻松地测试它们。

答案 1 :(得分:9)

  

我期待一个复杂的答案,它将涵盖两者:为什么使用它们   一般以及如何在Angular中使用它

这是角度承诺MVP (最低可行承诺)http://plnkr.co/edit/QBAB0usWXc96TnxqKhuA?p=preview

来源:

(对于那些懒得点击链接的人)

<强>的index.html          

  <head>
    <script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.1.5/angular.js"></script>
    <script src="app.js"></script>
  </head>

  <body ng-app="myModule" ng-controller="HelloCtrl">
    <h1>Messages</h1>
    <ul>
      <li ng-repeat="message in messages">{{ message }}</li>
    </ul>
  </body>

</html>

<强> app.js

angular.module('myModule', [])

  .factory('HelloWorld', function($q, $timeout) {

    var getMessages = function() {
      var deferred = $q.defer();

      $timeout(function() {
        deferred.resolve(['Hello', 'world']);
      }, 2000);

      return deferred.promise;
    };

    return {
      getMessages: getMessages
    };

  })

  .controller('HelloCtrl', function($scope, HelloWorld) {

    $scope.messages = HelloWorld.getMessages();

  });

(我知道它没有解决您的特定Facebook示例,但我发现以下代码段非常有用)

通过:http://markdalgleish.com/2013/06/using-promises-in-angularjs-views/


2014年2月28日更新: 从1.2.0开始,模板不再解析承诺。 http://www.benlesh.com/2013/02/angularjs-creating-service-with-http.html

(plunker示例使用1.1.5。)

答案 2 :(得分:1)

延迟表示异步操作的结果。它公开了一个接口,可用于发信号通知状态及其所代表的操作结果。它还提供了获取关联的promise实例的方法。

承诺提供了与其相关的延期交互的界面,因此,允许感兴趣的各方访问状态和延期操作的结果。

创建延迟时,它的状态处于暂挂状态,并且没有任何结果。当我们解决()或拒绝()延迟时,它会将其状态更改为已解决或拒绝。仍然,我们可以在创建延迟后立即获得相关的承诺,甚至可以分配与其未来结果的交互。这些交互只会在延期拒绝或解决之后发生。

答案 3 :(得分:1)

在控制器中使用promise并确保数据是否可用

 var app = angular.module("app",[]);
      
      app.controller("test",function($scope,$q){
        var deferred = $q.defer();
        deferred.resolve("Hi");
        deferred.promise.then(function(data){
        console.log(data);    
        })
      });
      angular.bootstrap(document,["app"]);
<!DOCTYPE html>
<html>

  <head>
    <script data-require="angular.js@*" data-semver="1.3.0-beta.5" src="https://code.angularjs.org/1.3.0-beta.5/angular.js"></script>
  </head>

  <body>
    <h1>Hello Angular</h1>
    <div ng-controller="test">
    </div>
  </body>

</html>