原版地址:http://docs.angularjs.org/guide/dev_guide.services.creating_services
雖然angular提供許多有用的service,在一些特別的應用中,我們會發現編寫自定義service是很有用的。如果我們想做這件事,我們首先要在module中注冊一個service工廠方法,可以通過Module.factory api(http://docs.angularjs.org/api/angular.module)或者在module配置方法中直接通過$provide api(http://docs.angularjs.org/api/AUTO.$provide)。
所有angular service都參與到DI(http://www.cnblogs.com/lcllao/archive/2012/09/23/2699401.html)中,既可以通過angular DI系統(injector)中使用名稱(id)注冊自己,也可以通過在其他工廠方法中聲明對已存在的service的依賴。
一、Registering Services
為了注冊一個service,我們必須擁有一個module,並且使這個server成為這個module的一部分。然后,我們可以通過Module api或者在module配置函數中注冊service。下面的偽代碼將展示這兩種注冊方式。
使用angular.module api:
var myModule = angular.module(‘myModule’,[]); myModule.factory(‘serviceId’,function() { var someService; //工廠方法體,構建someService return someService; });
使用$provide service:
angular.module(‘myModule’,[],function($provide) { $provide.factory(‘serviceId’,function() { var someService; //工廠方法體,構建someService return someService; }); });
注意,我們無須注冊一個服務實例,相反地,工廠方法會在它被調用的時候被實例化。
二、Dependencies
service不僅僅可以被依賴,更可以擁有自己的依賴。可以在工廠方法的參數中指定依賴。閱讀(http://www.cnblogs.com/lcllao/archive/2012/09/23/2699401.html)更多關於angular中的DI、數組標記的用途和$inject屬性,讓DI聲明更加簡潔。(Read more about the DI in Angular and the use of array notation and $inject property to make DI annotation minification-proof……)
下面是一個非常簡單的service例子。這個服務依賴$window service(通過工廠方法參數傳遞),而且只有一個方法。這個service簡單地儲存所有通知,在第三個之后,這個service會通過window.alert顯示所有通知。
<!DOCTYPE HTML> <html lang="zh-cn" ng-app="MainApp"> <head> <meta charset="UTF-8"> <title>services</title> </head> <body> <div ng-controller="MyController"> <input type="text" ng-model="msg"/> <button ng-click="saveMsg()">save msg</button> <ul> <li ng-repeat="msg in msgs">{{msg}}</li> </ul> </div> <script src="../angular-1.0.1.js" type="text/javascript"></script> <script type="text/javascript"> var app = angular.module("MainApp",[],function($provide) { $provide.factory("notify",["$window","$timeout",function(win,timeout) { var msgs = []; return function(msg) { msgs.push(msg); if(msgs.length==3) { timeout(function() { win.alert(msgs.join("\n")); msgs = []; },10); } } }]) }); app.controller("MyController",function($scope,notify) { $scope.msgs = []; $scope.saveMsg = function() { this.msgs.push(this.msg); notify(this.msg); this.msg = ""; }; }); </script> </body> </html>
三、Instantiating Angular Services
所有在angular中的service都是延遲實例化的(lazily)。這意味着service僅僅在其他依賴它的已實例化的service或者應用組件中被依賴時,才會創建。換句話說,angular直到服務被直接或者間接請求時候,才會實例化service。
四、Services as singletons
最后,我們必須意識到所有angular service都是一個單例應用。這意味着每一個injector中有且只有一個給定service的實例。由於angular是極其討厭破壞global state的,所以創建多個injector,使每一個都有指定service的實例是可行的,除了在測試中有強烈的需求外,一般很少有這樣的需要。
By Lcllao.