diff --git a/.gitignore b/.gitignore
index 0a0af45..af26d66 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,3 @@
-build/README.pdf
\ No newline at end of file
+build/
+node_modules/
+temp/
diff --git a/README.md b/README.md
index 27c992d..70b8952 100644
--- a/README.md
+++ b/README.md
@@ -7,14 +7,14 @@
* [Translations](#translations)
* [Abstract](#abstract)
* [Introduction](#introduction)
-* [AngularJS overview](#angularjs-overview)
+* [AngularJS overview](#angular-1-overview)
* [Partials](#partials)
* [Controllers](#controllers)
* [Scope](#scope)
* [Directives](#directives)
* [Filters](#filters)
* [Services](#services)
-* [AngularJS Patterns](#angularjs-patterns)
+* [AngularJS Patterns](#angular-1-patterns)
* [Services](#services-1)
* [Singleton](#singleton)
* [Factory Method](#factory-method)
@@ -25,7 +25,7 @@
* [Intercepting Filters](#intercepting-filters)
* [Directives](#directives-1)
* [Composite](#composite)
- * [Interpreter](#interpreter)
+ * [Interpreter](#interpreter)
* [Template View](#template-view)
* [Scope](#scope-1)
* [Observer](#observer)
@@ -43,8 +43,11 @@
## Translations
-- [Japanese Translation](https://github.com/mgechev/angularjs-in-patterns/blob/master/i18n/README-ja-jp.md) by [morizotter](https://twitter.com/morizotter)
-- [Russian Translation](http://habrahabr.ru/post/250149/)
+- [Japanese Translation](https://github.com/mgechev/angular-in-patterns/blob/master/i18n/README-ja-jp.md) by [morizotter](https://twitter.com/morizotter)
+- [Russian Translation 1](http://habrahabr.ru/post/250149/)
+- [Russian Translation 2](https://github.com/mgechev/angular-in-patterns/blob/master/i18n/README-ru-ru.md) by [l.s.kramarov](https://github.com/lskramarov)
+- [French Translation](https://github.com/mgechev/angular-in-patterns/blob/master/i18n/README-fr-fr.md) by [manekinekko](https://github.com/manekinekko)
+- [Chinese Translation](https://github.com/mgechev/angular-in-patterns/blob/master/i18n/README-zh-cn.md) by [carlosliu](https://github.com/carlosliu)
## Abstract
@@ -231,7 +234,7 @@ function MyCtrl(uppercaseFilter) {
### Services
-Every piece of logic, which doesn't belong to the components described above should be placed inside a service. Usually services encapsulate the domain specific logic, persistence logic, XHR, WebSockets, etc. When the controllers in the application became too "fat" the repetitive code should be placed inside a service.
+Every piece of logic, which doesn't belong to the components described above, should be placed inside a service. Usually services encapsulate the domain specific logic, persistence logic, XHR, WebSockets, etc. When the controllers in the application became too "fat" the repetitive code should be placed inside a service.
```JavaScript
myModule.service('Developer', function () {
@@ -268,7 +271,7 @@ In the last chapter we are going to take a look at some architectural patterns,
In the UML diagram bellow is illustrated the singleton design pattern.
-
+
When given dependency is required by any component, AngularJS resolves it using the following algorithm:
@@ -318,7 +321,7 @@ For further discussion on this topic Misko Hevery's [article](http://googletesti
>The factory method pattern is a creational pattern, which uses factory methods to deal with the problem of creating objects without specifying the exact class of object that will be created. This is done by creating objects via a factory method, which is either specified in an interface (abstract class) and implemented in implementing classes (concrete classes); or implemented in a base class, which can be overridden when inherited in derived classes; rather than by a constructor.
-
+
Lets consider the following snippet:
@@ -408,7 +411,7 @@ There are a few benefits of using the factory method pattern in this case, becau
>The decorator pattern (also known as Wrapper, an alternative naming shared with the Adapter pattern) is a design pattern that allows behavior to be added to an individual object, either statically or dynamically, without affecting the behavior of other objects from the same class.
-
+
AngularJS provides out-of-the-box way for extending and/or enhancing the functionality of already existing services. Using the method `decorator` of `$provide` you can create "wrapper" of any service you have previously defined or used by a third-party:
@@ -456,7 +459,7 @@ Using this pattern is especially useful when we need to modify the functionality
>4. wrap a poorly designed collection of APIs with a single well-designed API (as per task needs).
-
+
There are a few facades in AngularJS. Each time you want to provide higher level API to given functionality you practically create a facade.
@@ -507,7 +510,7 @@ Even higher level of abstraction is being created by `$resource`, which is build
>A proxy, in its most general form, is a class functioning as an interface to something else. The proxy could interface to anything: a network connection, a large object in memory, a file, or some other resource that is expensive or impossible to duplicate.
-
+
We can distinguish three different types of proxy:
@@ -545,7 +548,7 @@ Initially when the snippet above executes, the property `user` of the `$scope` o
>The Active Record object is an object, which carries both data and behavior. Usually most of the data in these objects is persistent, responsibility of the Active Record object is to take care of the communication with the database in order to create, update, retrieve or delete the data. It may delegate this responsibility to lower level objects but calls to instance or static methods of the active record object cause the database communication.
-
+
AngularJS defines a service called `$resource`. In the current version of AngularJS (1.2+) it is being distributed in module outside of the AngularJS' core.
@@ -580,7 +583,7 @@ You can find more details for `$resource` [The magic of $resource](http://blog.m
Since Martin Fowler states that
-> responsibility of the Active Record object is to take care of the communication with the databse in order to create...
+> responsibility of the Active Record object is to take care of the communication with the database in order to create...
`$resource` does not implements exactly the Active Record pattern, since it communicates with RESTful service instead of the database. Anyway, we can consider it as "Active Record like RESTful communication".
@@ -588,7 +591,7 @@ Since Martin Fowler states that
>Create a chain of composable filters to implement common pre-processing and post-processing tasks during a Web page request.
-
+
In some cases you need to do some kind of pre and/or post processing of HTTP requests. In the case of the Intercepting Filters you pre/post process given HTTP request/response in order to include logging, security or any other concern, which is influenced by the request body or headers. Basically the Intercepting Filters pattern include a chain of filters, each of which process data in given order. The output of each filter is input of the next one.
@@ -617,7 +620,7 @@ $httpProvider.interceptors.push(function($q, dependency1, dependency2) {
>The composite pattern is a partitioning design pattern. The composite pattern describes that a group of objects are to be treated in the same way as a single instance of an object. The intent of a composite is to "compose" objects into tree structures to represent part-whole hierarchies.
-
+
According to the Gang of Four, MVC is nothing more than combination of:
@@ -662,11 +665,11 @@ From the first example we can note that the whole DOM tree is a composition of e
In the second, JavaScript, example we see that the `template` property of the directive, contains markup with `ng-transclude` directive inside it. So this means that inside the directive `zippy` we have another directive called `ng-transclude`, i.e. composition of directives. Theoretically we can nest the components infinitely until we reach a leaf node.
-### Interpreter
+#### Interpreter
>In computer programming, the interpreter pattern is a design pattern that specifies how to evaluate sentences in a language. The basic idea is to have a class for each symbol (terminal or nonterminal) in a specialized computer language. The syntax tree of a sentence in the language is an instance of the composite pattern and is used to evaluate (interpret) the sentence.
-
+
Behind its `$parse` service, AngularJS provides its own implementation of interpreter of a DSL (Domain Specific Language). The used DSL is simplified and modified version of JavaScript.
The main differences between the JavaScript expressions and AngularJS expressions that AngularJS expressions:
@@ -736,7 +739,7 @@ Few sample AngularJS expressions are:
> Renders information into HTML by embedding markers in an HTML page.
-
+
The dynamic page rendering is not that trivial thing. It is connected with a lot of string concatenations, manipulations and frustration. Far easier way to build your dynamic page is to write your markup and embed little expressions inside it, which are lately evaluated in given context and so the whole template is being compiled to its end format. In our case this format is going to be HTML (or even DOM). This is exactly what the template engines do - they take given DSL, evaluate it in the appropriate context and then turn it into its end format.
@@ -793,7 +796,7 @@ will produce the same result as the one above. The main difference here is that
>The observer pattern is a software design pattern in which an object, called the subject, maintains a list of its dependents, called observers, and notifies them automatically of any state changes, usually by calling one of their methods. It is mainly used to implement distributed event handling systems.
-
+
There are two basic ways of communication between the scopes in an AngularJS application. The first one is calling methods of parent scope by a child scope. This is possible since the child scope inherits prototypically by its parent, as mentioned above (see [Scope](#scope)). This allows communication in a single direction - child to parent. Some times it is necessary to call method of given child scope or notify it about a triggered event in the context of the parent scope. AngularJS provides built-in observer pattern, which allows this. Another possible use case, of the observer pattern, is when multiple scopes are interested in given event but the scope, in which context the event is triggered, is not aware of them. This allows decoupling between the different scopes, non of the scopes should be aware of the rest of the scopes.
@@ -831,7 +834,7 @@ For a best practice example see [Observer Pattern as an External Service](#obser
>The chain-of-responsibility pattern is a design pattern consisting of a source of command objects and a series of processing objects. Each processing object contains logic that defines the types of command objects that it can handle; the rest are passed to the next processing object in the chain. A mechanism also exists for adding new processing objects to the end of this chain.
-
+
As stated above the scopes in an AngularJS application form a hierarchy known as the scope chain. Some of the scopes are "isolated", which means that they don't inherit prototypically by their parent scope, but are connected to it via their `$parent` property.
@@ -868,7 +871,7 @@ The different handlers from the UML diagram above are the different scopes, inje
>In object-oriented programming, the command pattern is a behavioral design pattern in which an object is used to represent and encapsulate all the information needed to call a method at a later time. This information includes the method name, the object that owns the method and values for the method parameters.
-
+
Before continuing with the application of the command pattern lets describe how AngularJS implements data binding.
@@ -913,7 +916,7 @@ We can think of the `watcher` object as a command. The expression of the command
>An object that handles a request for a specific page or action on a Web site. Martin Fowler
-
+
According to [4](#references) the page controller:
@@ -1015,11 +1018,11 @@ app.factory('foo', function () {
Once we want to inject `foo` inside any other component we won't be able to use the private methods, but only the public ones. This solution is extremely powerful especially when one is building a reusable library.
-### Data Mapper
+#### Data Mapper
>A Data Mapper is a Data Access Layer that performs bidirectional transfer of data between a persistent data store (often a relational database) and an in memory data representation (the domain layer). The goal of the pattern is to keep the in memory representation and the persistent data store independent of each other and the data mapper itself.
-
+
As the description above states, the data mapper is used for bidirectional transfer of data between a persistent data store and an in memory data representation. Usually our AngularJS application communicates with API server, which is written in any server-side language (Ruby, PHP, Java, JavaScript, etc.).
@@ -1091,7 +1094,7 @@ And the following partial:
```
-### Observer Pattern as an External Service
+#### Observer Pattern as an External Service
##### About
@@ -1153,10 +1156,10 @@ function ObserverExample(ObserverService, $timeout, $scope) {
## References
-1. [Wikipedia](https://en.wikipedia.org/wiki). The source of all brief descriptions of the design patterns is wikipedia.
+1. [Wikipedia](https://en.wikipedia.org/wiki). The source of all brief descriptions of the design patterns is Wikipedia.
2. [AngularJS' documentation](https://docs.angularjs.org)
3. [AngularJS' git repository](https://github.com/angular/angular.js)
4. [Page Controller](http://msdn.microsoft.com/en-us/library/ff649595.aspx)
5. [Patterns of Enterprise Application Architecture (P of EAA)](http://martinfowler.com/books/eaa.html)
-6. [Using Dependancy Injection to Avoid Singletons](http://googletesting.blogspot.com/2008/05/tott-using-dependancy-injection-to.html)
+6. [Using Dependency Injection to Avoid Singletons](http://googletesting.blogspot.com/2008/05/tott-using-dependancy-injection-to.html)
7. [Why would one use the Publish/Subscribe pattern (in JS/jQuery)?](https://stackoverflow.com/questions/13512949/why-would-one-use-the-publish-subscribe-pattern-in-js-jquery)
diff --git a/build.sh b/build.sh
deleted file mode 100755
index aab1b7e..0000000
--- a/build.sh
+++ /dev/null
@@ -1,9 +0,0 @@
-#!/bin/sh
-
-mkdir temp && cp -r ./meta.json ./README.md ./images/* temp
-perl -i -0777 -pe 's/().*()/'"$"'$2/s' ./temp/README.md
-sed -i.bak 's|https://rawgit.com/mgechev/angularjs-in-patterns/master/images|.|g' ./temp/README.md
-rm -rf ./temp/*.bak
-mv ./temp/README.md ./temp/index.md
-./node_modules/.bin/generate-md --layout minko-book --input ./temp --output ../angularjs-in-patterns-gh-pages
-rm -rf temp
\ No newline at end of file
diff --git a/gulp/modules/generic-task.js b/gulp/modules/generic-task.js
new file mode 100644
index 0000000..e7f3519
--- /dev/null
+++ b/gulp/modules/generic-task.js
@@ -0,0 +1,38 @@
+module.exports = function (gulp, markdownpdf, path, log, chalk, rename, TITLE) {
+
+ function genericTask(lang){
+
+ gulp.task('generate:pdf:' + lang, function() {
+
+ var files = ['./temp/*.md'];
+ if (lang === 'eng'){
+ files = './temp/README.md';
+ }
+ else if(lang !== 'all'){
+ files = ['./temp/*-'+lang+'.md'];
+ }
+
+ return gulp.src(files)
+ .pipe(markdownpdf({
+ cwd: path.resolve('./temp/'),
+ layout: 'github'
+ }))
+ .on('error', function(err){
+ log(chalk.red('doc task failed'), err);
+ })
+ .pipe(rename(function (path) {
+ var lang = 'ENG';
+ if(path.basename.indexOf('-') >= 0){
+ lang = path.basename.replace('README-', '').toUpperCase();
+ }
+ path.basename = TITLE + ' ('+lang+')';
+ path.extname = '.pdf';
+ }))
+ .pipe(gulp.dest('./build/'));
+ });
+
+ }
+
+ return genericTask;
+
+};
\ No newline at end of file
diff --git a/gulp/tasks/clean.js b/gulp/tasks/clean.js
new file mode 100644
index 0000000..7c9b14c
--- /dev/null
+++ b/gulp/tasks/clean.js
@@ -0,0 +1,7 @@
+module.exports = function (gulp, rimraf) {
+
+ gulp.task('clean', function() {
+ return gulp.src('./temp/', { read: false }).pipe(rimraf());
+ });
+
+};
\ No newline at end of file
diff --git a/gulp/tasks/copy-images.js b/gulp/tasks/copy-images.js
new file mode 100644
index 0000000..113599d
--- /dev/null
+++ b/gulp/tasks/copy-images.js
@@ -0,0 +1,7 @@
+module.exports = function (gulp) {
+
+ gulp.task('copy:images', function(){
+ return gulp.src(['images/*.svg','meta.json']).pipe(gulp.dest('./temp'));
+ });
+
+};
diff --git a/gulp/tasks/copy-md.js b/gulp/tasks/copy-md.js
new file mode 100644
index 0000000..a87a0c5
--- /dev/null
+++ b/gulp/tasks/copy-md.js
@@ -0,0 +1,15 @@
+module.exports = function (gulp, replace) {
+
+ gulp.task('copy:md', function(){
+ return gulp.src(['README.md', 'i18n/README-*.md'])
+ // @todo I have no idea where should the TOC go?!
+ // for now, let's keep the TOC content and remove these markers
+ .pipe(replace('', ''))
+ .pipe(replace('', ''))
+
+ // preapre the image paths for the renderer
+ .pipe(replace(/https:\/\/rawgit.com\/mgechev\/angularjs-in-patterns\/master\/images/g, '.'))
+ .pipe(gulp.dest('./temp/'));
+ });
+
+};
\ No newline at end of file
diff --git a/gulp/tasks/default.js b/gulp/tasks/default.js
new file mode 100644
index 0000000..4480df4
--- /dev/null
+++ b/gulp/tasks/default.js
@@ -0,0 +1,5 @@
+module.exports = function (gulp, runSequence) {
+ gulp.task('default', function(cb){
+ runSequence('clean', ['copy:images', 'copy:md'], 'doc:pdf:all', cb);
+ });
+};
\ No newline at end of file
diff --git a/gulp/tasks/i18n.js b/gulp/tasks/i18n.js
new file mode 100644
index 0000000..1938476
--- /dev/null
+++ b/gulp/tasks/i18n.js
@@ -0,0 +1,13 @@
+module.exports = function (gulp, glob, genericTask, runSequence) {
+
+ // build custom tasks for i18n
+
+ glob.sync('./temp/README-*.md').map(function(file){
+ return file.replace(/.*README\-|\.md$/g, '');
+ }).concat(['all', 'eng']).forEach(function(lang){
+ genericTask(lang);
+ gulp.task('doc:pdf:'+lang, function(cb){
+ runSequence('clean', ['copy:images', 'copy:md'], 'generate:pdf:'+lang, cb);
+ });
+ });
+};
\ No newline at end of file
diff --git a/gulpfile.js b/gulpfile.js
new file mode 100644
index 0000000..94005fd
--- /dev/null
+++ b/gulpfile.js
@@ -0,0 +1,15 @@
+var GulpDI = require('gulp-di');
+var gulp = require('gulp');
+var di = GulpDI(require('gulp'), {
+ pattern : ['gulp-*', 'gulp.*', 'run-sequence', 'glob'],
+ rename : {
+ 'gulp-markdown-pdf' : 'markdownpdf'
+ }
+})
+.provide({
+ TITLE : 'AngularJS in Patterns',
+ path : require('path')
+})
+.modules('./gulp/modules')
+.tasks('./gulp/tasks')
+.resolve();
\ No newline at end of file
diff --git a/i18n/README-fr-fr.md b/i18n/README-fr-fr.md
new file mode 100644
index 0000000..a92bbbd
--- /dev/null
+++ b/i18n/README-fr-fr.md
@@ -0,0 +1,1180 @@
+# Les patrons de conception avec AngularJS
+
+## Table des matières
+
+
+
+
+
+
+
+* [Traductions](#traductions)
+* [Abstract](#abstract)
+* [Introduction](#introduction)
+* [Vue d'ensemble d'AngularJS](#vue-densemble-dangularjs)
+ * [Les vues partielles](#les-vues-partielles)
+ * [Les contrôleurs](#les-contr%C3%B4leurs)
+ * [Le scope](#le-scope)
+ * [Les directives](#les-directives)
+ * [Les filtres](#les-filtres)
+ * [Les services](#les-services)
+* [Les patrons de conception d'AngularJS](#les-patrons-de-conception-dangularjs)
+ * [Les services](#les-services-1)
+ * [Le patron Singleton](#le-patron-singleton)
+ * [Factory Method](#factory-method)
+ * [Decorator](#decorator)
+ * [Facade](#facade)
+ * [Proxy](#proxy)
+ * [Enregistrement Actif (Active Record)](#enregistrement-actif-active-record)
+ * [Intercepting Filters](#intercepting-filters)
+ * [Les directives](#les-directives-1)
+ * [Composite](#composite)
+ * [Interpreter](#interpreter)
+ * [Template View](#template-view)
+ * [Scope](#scope)
+ * [Observer](#observer)
+ * [Chaîne de responsabilité](#cha%C3%AEne-de-responsabilit%C3%A9)
+ * [Command](#command)
+ * [Controllers](#controllers)
+ * [Contrôleur de page](#contr%C3%B4leur-de-page)
+ * [Others](#others)
+ * [Module Pattern](#module-pattern)
+ * [Data Mapper](#data-mapper)
+ * [Le patron Observer grâce à un Service Commun](#le-patron-observer-gr%C3%A2ce-%C3%A0-un-service-commun)
+* [References](#references)
+
+
+
+
+
+## Traductions
+
+- [Version original](https://github.com/mgechev/angularjs-in-patterns/blob/master/README.md)
+- [Traduction japonaise](https://github.com/mgechev/angularjs-in-patterns/blob/master/i18n/README-ja-jp.md) par [morizotter](https://twitter.com/morizotter)
+- [Traduction russe](http://habrahabr.ru/post/250149/)
+
+## Abstract
+
+Parfois, le meilleur moyen d'apprendre une nouvelle technologie est d'essayer de retrouver des concepts que l'on connait déjà, et voir comment ils sont implémentés dans cette technologie.
+
+Ce document n'a pas pour vocation d'expliquer en détails les principes d'architecture logiciels ou de la POO.
+
+Le but de ce papier est de décrire comment les différents patrons de conception logiciel et aussi ceux d’architecture peuvent être implémentés par AngularJS ou n'importe quelle Single Page Application codée avec AngularJS.
+
+## Introduction
+
+Ce document commence par une vue d'ensemble du framework AngularJS. Dans cette vue d'ensemble, nous décrivons les différents composants du framework - les directives, filtres, contrôleurs, services et scope. La second section liste et décrit les différents patrons de conception qui sont implémentés par le framework. Ces patrons sont groupés par les composants AngularJS dans lesquels ils sont implémentés. Lorsqu'un patron est utilisé dans plusieurs composants, cela sera mentionné explicitement.
+
+La dernière section contient quelques patrons d'architecture souvent rencontrés dans la plupart des applications AngularJS.
+
+## Vue d'ensemble d'AngularJS
+
+AngularJS est un framework JavaScript développé par Google. Il propose de solides bases pour le développement d'application mono-page (Single-Page Application - SPA).
+
+Une SPA est une application qui une fois chargée, ne requiert pas un rechargement total de la page lorsque l'utilisateur interagit avec elle. Cela signifie que toutes les ressources de l'application (données, templates, scripts et styles) devrait être chargées lors de la première requête, voire mieux, à la demande.
+
+Le constat étant que les applications SPA de type CRUD ont des caractéristiques communes, AngularJS fournit de base tout un ensemble de mécanismes et fonctionnalités tels que :
+
+- le binding bi-directionnel
+- l'injection de dépendances
+- la séparation des préoccupations
+- les tests
+- une abstraction
+
+La séparation des préoccupations est rendue possible en divisant une application AngularJS en plusieurs composants, tels que :
+
+- les vues partielles
+- les contrôleurs
+- les directives
+- les services
+- les filtres
+
+Ces composants peuvent être groupés dans des modules, qui offre une abstraction supplémentaire pour mieux gérer la complexité des SPA. Chaque composant encapsule une partie bien spécifique et bien définit de la logique de l'application.
+
+### Les vues partielles
+
+Les vues partielles sont de l'HTML. Elles peuvent contenir des expressions AngularJS au sein des éléments HTML ou des attributs. L'une des différences majeures entre AngularJS et les autres frameworks réside dans le fait que les templates AngularJS ne sont pas un format intermédiaire qui devrait être transformé en HTML (ce qui est le cas de mustache.js ou handlebars, par exemple).
+
+Initialement, chaque SPA charge le fichier `index.html`. Dans le cas d'AngularJS, ce fichier contient du code HTML standard enrichit avec des éléments, attributs et commentaire dont le but est de configurer et de démarrer l'application. Chaque interaction de l'utilisateur avec l'application requiert simplement le chargement d'une vue partielle ou le chargement d'un état de l'application, à travers le biding de données fournit par AngularJS.
+
+**Exemple de vue partielle**
+
+``` HTML
+
+
+
+
+
+
+
+
+
+```
+
+Avec les expressions, les vues partielles définissent quelles actions doivent traiter les actions de l'utilisateur. Dans l'exemple précédent, la valeur de l'attribut `ng-click` précise que la méthode `changeFoo` du *scope* courant sera invoquée.
+
+### Les contrôleurs
+
+Les contrôleurs d'AngularJS sont des fonctions JavaScript qui gèrent les interactions de l'utilisateur avec l'application web (par exemple, les événements de la souris, des touches claviers...etc), en attachant des méthodes au *scope*. Toues les dépendances externes d'un contrôleur sont fournit via le mécanisme d'ID ou injection de dépendances d'AngularJS. Les contrôleurs ont également pour but de fournir le *modèle* à la vue en attachant des données dans le *scope*. Nous pouvons voir ces données comme des *modèle vue* (*view model*)
+
+``` JavaScript
+function MyController($scope) {
+ $scope.buttonText = 'Cliquer moi pour changer foo!';
+ $scope.foo = 42;
+
+ $scope.changeFoo = function () {
+ $scope.foo += 1;
+ alert('Foo a été changé');
+ };
+}
+```
+
+Par exemple, si nous associons le contrôleur de l'exemple ci-dessus avec la vue de l'exemple dans la section précédente, l'utilisateur va pouvoir interagir avec l'application de différentes manières :
+
+1. Changer la valeur de `foo` en saisissant une valeur dans le champ de saisie. Ceci va immédiatement refléter la valeur de `foo` grâce au mécanisme de biding bi-directionnel.
+2. Changer la valeur de `foo` en cliquant sur le bouton, qui aura le libellé `Cliquer moi pour changer foo!`.
+
+Tous les éléments, attributs, commentaires ou classes CSS personnalisés permettant d'enrichir l'HTML sont appelés des *directives* AngularJS.
+
+### Le scope
+
+Dans AngularJS, le scope est un objet JavaScript qui est exposé au vues partielles. Le scope peut contenir plusieurs propriétés - primitives, objets ou méthodes. Toutes les méthodes attachées au scope peuvent être invoquées en évaluant l'expression AngularJS à l'intérieur de la vue associée au scope en question, ou simplement via un appel direct à la méthode par un composant donné. En utilisant les *directives* adéquates, les données attachées au scope peuvent être attachées (data-bound) de telle sorte que chaque changement dans la vue met à jour - immédiatement et automatiquement - une propriété du scope ; ainsi que chaque changement d'une propriété du scope est immédiatement reflété dans la vue.
+
+Une autre caractéristique très importante des scopes réside dans le fait que les scopes sont hiérarchisés en suivant le modèle de la chaîne des prototypes de JavaScript (excepté les scopes *isolés*). De cette manière, chaque scope fils a la possibilité d'invoquer des méthodes de ses parents, puisque ces derniers sont des propriétés directes ou indirectes de son prototype.
+
+L'héritage des scopes est illustré dans l'exemple suivant :
+
+``` HTML
+
+
+
+
+
+
+```
+
+``` javascript
+function BaseCtrl($scope) {
+ $scope.foo = function () {
+ alert('Base foo');
+ };
+}
+
+function ChildCtrl($scope) {
+ $scope.bar = function () {
+ alert('Child bar');
+ };
+}
+```
+
+Le contrôleur `ChildCtrl` est associé à l'élément `div#child`, mais puisque le scope injecté par `ChildCtrl` hérite le prototype du scope de son parent (celui injecté par le contrôleur `BaseCtrl`). Ceci fait que la méthode `foo` est accessible par `button#parent-method`.
+
+### Les directives
+
+Dans AngularJS, les directives sont l'endroit où toutes les manipulations du DOM doivent être implémentées. Lorsque vous devez manipuler le DOM, vous devez créer une directive ou réutiliser celles qui existent.
+
+Chaque directive possède un nom et une logique associée. Dans le cas le plus simple, une directive contient seulement un nom et une définition de la fonction *postLink*, qui encapsule toute la logique requise pour la directive. Pour les cas les plus complexes, une directive peut contenir d'autres propriétés tels que :
+
+- un template
+- une fonction `compile`
+- une fonction `link`
+- etc...
+
+Pour utiliser une directive dans une vue, il suffit de référencer son nom. Par exemple :
+
+``` JavaScript
+myModule.directive('alertButton', function () {
+ return {
+ template: '',
+ scope: {
+ content: '@'
+ },
+ replace: true,
+ restrict: 'E',
+ transclude: true,
+ link: function (scope, el) {
+ el.click(function () {
+ alert(scope.content);
+ });
+ }
+ };
+});
+```
+
+``` HTML
+Cliquer moi
+```
+
+Dans cet exemple, la balise `` sera remplacé par la balise `button`. Lorsque l'utilisateur cliquera sur ce bouton, le message `42` sera affiché.
+
+Nous n'irons pas plus loin dans les explications des directives. Ce n'est pas le but de ce papier.
+
+### Les filtres
+
+Dans AngularJS, les filtres sont responsables d'encapsuler toute la logique nécessaire pour formater des données. Souvent, les filtres sont utilisés au sein des vues, mais il est également possible de les appeler dans des contrôleurs, directives, services ainsi que d'autres filtres grâce à l'injection de dépendances.
+
+Voici une définition d'un filtre dont le rôle est de transformer une chaîne de caractères en majuscule :
+
+``` JavaScript
+myModule.filter('uppercase', function () {
+ return function (str) {
+ return (str || '').toUpperCase();
+ };
+});
+```
+
+Ce filtre peut être utilisé au sein d'une vue en utilisant le symbole `|` d'UNIX :
+
+``` HTML
+
{{ name | uppercase }}
+```
+
+Au sein d'un contrôleur, le filtre peut être utilisé de cette façon :
+
+``` javascript
+function MyCtrl(uppercaseFilter) {
+ $scope.name = uppercaseFilter('foo'); //FOO
+}
+```
+
+### Les services
+
+Dans AngularJS, les services sont responsables d'accueillir la logique métier des composants, la logique de persistance, les appels XHR, WebSockets, etc. Lorsque le contrôleur devient trop `gros`, le code superflu et répétitif devrait être déplacé dans un service.
+
+``` javascript
+myModule.service('Developer', function () {
+ this.name = 'Foo';
+ this.motherLanguage = 'JavaScript';
+ this.live = function () {
+ while (true) {
+ this.code();
+ }
+ };
+});
+```
+
+Le service peut être injecté dans n'importe quel composant, supportant l'injection de dépendances (les contrôleurs, d'autres services, les filtres, les directives).
+
+``` JavaScript
+function MyCtrl(Developer) {
+ var developer = new Developer();
+ developer.live();
+}
+```
+
+## Les patrons de conception d'AngularJS
+
+Dans les sections suivantes, nous allons voir comment les patrons de conception traditionnels sont utilisés dans les composants d'AngularJS.
+
+Ensuite, dans le dernier chapitre, nous verrons quels sont les différents patrons d'architecture fréquemment rencontrés dans les Single-Page Application développés avec AngularJS, mais pas seulement.
+
+### Les services
+
+#### Le patron Singleton
+
+> Le patron Singleton vise à assurer qu'il n'y a toujours qu'une seule instance d'un objet en fournissant une interface pour la manipuler. C'est un des patrons les plus simples. L'objet qui ne doit exister qu'en une seule instance comporte une méthode pour obtenir cette unique instance et un mécanisme pour empêcher la création d'autres instances.
+
+Ce patron est illustré dans le diagramme UML ci-dessous :
+
+
+
+Lorsqu'une dépendance doit être injectée par AngularJS dans un composant, voici l'algorithme utilisé par le framework :
+
+- Prendre le nom de la dépendance et le rechercher dans une `hash map`, qui est définit au sein de sa portée lexical (ainsi elle reste privée).
+- Si la dépendance existe, AngularJS la passe en tant que paramètre au composant qui l'a demandé.
+- Si la dépendance n'existe pas :
+ - AngularJS créé une nouvelle instance de cette dépendance en invoquant la `factory method` de son provider: la méthode `$get`. A noter qu'au moment de l'instanciation, cette dépendance peut éventuellement déclencher un appel récursive de cet algorithme, afin de résoudre toutes les dépendances requises par cette dépendance. Ce qui peut conduire à un souci de dépendances circulaires.
+ - AngularJS met en cache cette instance, dans la hash map mentionnée précédemment.
+ - AngularJS transmet cette instance en tant que paramètre au composant qui a demandé cette dépendance.
+
+Voici un aperçu du code source d'AngularJS, de la méthode `getService` :
+
+``` JavaScript
+function getService(serviceName) {
+ if (cache.hasOwnProperty(serviceName)) {
+ if (cache[serviceName] === INSTANTIATING) {
+ throw $injectorMinErr('cdep', 'Circular dependency found: {0}', path.join(' <- '));
+ }
+ return cache[serviceName];
+ } else {
+ try {
+ path.unshift(serviceName);
+ cache[serviceName] = INSTANTIATING;
+ return cache[serviceName] = factory(serviceName);
+ } catch (err) {
+ if (cache[serviceName] === INSTANTIATING) {
+ delete cache[serviceName];
+ }
+ throw err;
+ } finally {
+ path.shift();
+ }
+ }
+}
+```
+
+Nous pouvons dire que chaque service est un singleton car chaque service est instancié qu'une seule fois. Nous pouvons également considérer le cache comme un manageur de singletons. Il existe une légère variation du diagramme UML illustré ci-dessus parce qu'au lieu de garder une référence statique, au sein de son constructeur, nous conservons cette référence au sein du manager de singleton (illustré dans le bout de code ci-dessus en tant que `cache`).
+
+De cette manière, les services sont réellement des singletons mais ne sont pas implémentés à travers le patron Singleton, ce qui offre quelques avantages par rapport à l'implémentation classique :
+
+- améliore la testabilité de votre code source
+- vous pouvez contrôler la création des objets singletons (dans notre cas, le conteneur IoC (Inversion de Contrôle) le contrôle pour nous, en instanciant le singleton).
+
+Si vous voulez en savoir plus, je vous invite à lire l'[article](http://googletesting.blogspot.com/2008/05/tott-using-dependancy-injection-to.html) de Misko Hevery.
+
+#### Factory Method
+
+> Le patron Factory Method fournit une interface pour créer un objet qui laisse la possibilité aux sous-classes de décider quel type d'objet créer. Ce patron est utilisé lorsque la classe d'un objet n'est pas connue au moment de la compilation. Une méthode pour créer un objet factory method est définie dans une classe abstraite, et implémentée dans les différentes sous-classes. La factory method peut également comporter une implémentation par défaut.
+
+
+
+Considérons le code suivant :
+
+``` JavaScript
+myModule.config(function ($provide) {
+ $provide.provider('foo', function () {
+ var baz = 42;
+ return {
+ //Factory method
+ $get: function (bar) {
+ var baz = bar.baz();
+ return {
+ baz: baz
+ };
+ }
+ };
+ });
+});
+
+```
+
+Dans le code ci-dessus, nous utilisons la callback `config` dans le but de définir un nouveau "provider" ou un "fournisseur". Un "provider" est un objet qui possède une méthode `$get`. Puisque JavaScrit n'offre pas d'interface, la convention veut que l'on nomme cette méthode de telle sorte.
+
+Chaque service, filtre ou contrôleur possède un "provider" qui est responsable de créer une instance de ce composant.
+
+Jetons un oeil sur l'implémentation d'AngularJS :
+
+``` JavaScript
+//...
+
+createInternalInjector(instanceCache, function(servicename) {
+ var provider = providerInjector.get(servicename + providerSuffix);
+ return instanceInjector.invoke(provider.$get, provider, undefined, servicename);
+}, strictDi));
+
+//...
+
+function invoke(fn, self, locals, serviceName){
+ if (typeof locals === 'string') {
+ serviceName = locals;
+ locals = null;
+ }
+
+ var args = [],
+ $inject = annotate(fn, strictDi, serviceName),
+ length, i,
+ key;
+
+ for(i = 0, length = $inject.length; i < length; i++) {
+ key = $inject[i];
+ if (typeof key !== 'string') {
+ throw $injectorMinErr('itkn',
+ 'Incorrect injection token! Expected service name as string, got {0}', key);
+ }
+ args.push(
+ locals && locals.hasOwnProperty(key)
+ ? locals[key]
+ : getService(key)
+ );
+ }
+ if (!fn.$inject) {
+ // this means that we must be an array.
+ fn = fn[length];
+ }
+
+ return fn.apply(self, args);
+}
+```
+
+D'après ce code, nous remarquons que la méthode `$get` est utilisé à ce niveau :
+
+``` JavaScript
+instanceInjector.invoke(provider.$get, provider, undefined, servicename)
+```
+
+Dans ce bout de code, la méthode `invoke` de l'objet `instanceInjector` est invoquée avec la "factory method" `$get` en premier paramètre. Dans le corps de la fonction `invoke` la fonction `annotate` est appelée avec en premier paramètre la "factory method". Cette fonction `annotate` permet de résoudre toutes les dépendances à travers le mécanisme d'injection de dépendance d'AngularJS, vu précédemment. Lorsque toutes les dépendances sont résolues, la "factory metho" est invoquée : `fn.apply(self, args)`.
+
+Si nous faisons le lien avec le diagramme UML précédent (en figure 2), nous pouvons associer le "provider" à "ConcreteCreator" et le composant créé, un "Product".
+
+Utiliser le patron Factory Method offre des avantages dans notre cas grâce à l'indirection qu'il introduit. Cela permet au framework de d'avoir le contrôle de la création des nouveaux composants, comme par exemple :
+
+- Le moment approprié d'instancier un composant.
+- La résolution de toutes les dépendances requises par un composant.
+- Le nombre d'instance autorisé par composant : une seule pour les filtres et les services, et plusieurs instances pour les contrôleurs.
+
+#### Decorator
+
+> Ce patron permet d'attacher dynamiquement des responsabilités à un objet. Une alternative à l'héritage. Ce patron est inspiré des poupées russes. Un objet peut être caché à l'intérieur d'un autre objet décorateur qui lui rajoutera des fonctionnalités, l'ensemble peut être décoré avec un autre objet qui lui ajoute des fonctionnalités et ainsi de suite. Cette technique nécessite que l'objet décoré et ses décorateurs implémentent la même interface, qui est typiquement définie par une classe abstraite.
+
+
+
+AngularJS fournit de base un moyen d'étendre et d'enrichir les fonctionnalités des services existants. En utilisant la méthode `decorator` de l'objet `$provider`, il est possible de créer des "wrapper" de n'importe quel service définit ou fournit par un module tiers :
+
+``` JavaScript
+myModule.controller('MainCtrl', function (foo) {
+ foo.bar();
+});
+
+myModule.factory('foo', function () {
+ return {
+ bar: function () {
+ console.log('I\'m bar');
+ },
+ baz: function () {
+ console.log('I\'m baz');
+ }
+ };
+});
+
+myModule.config(function ($provide) {
+ $provide.decorator('foo', function ($delegate) {
+ var barBackup = $delegate.bar;
+ $delegate.bar = function () {
+ console.log('Decorated');
+ barBackup.apply($delegate, arguments);
+ };
+ return $delegate;
+ });
+});
+```
+
+L'exemple ci-dessus définit un nouveau service appelé `foo`. Dans la phase de configuration, la méthode `$provider.decorator` est invoquée avec l'argument `"foo"`, qui est le nom du service que nous souhaitons décorer, ainsi qu'un second paramètre qui est l'implémentation de la décoration souhaitée. `$delegate` garde une référence du service original `foo`. En utilisant l'injection de dépendances d'AngularJS, nous récupérant cette référence dans le décorateur. Nous décorons ensuite le service en surchargeant sa méthode `bar`, en invoquant une instruction supplémentaire : `console.log('Decorated');`. Puis nous donnons la main au service original.
+
+Ce patron est utile si nous souhaitons modifier le comportement des services tiers. Dans certains cas où plusieurs décorations "similaires" sont nécessaires (mesure de performance, gestion des droits, gestion des logs, etc.), nous risquons d'introduire beaucoup de duplication de code et violer ainsi le principe DRY. Dans ces cas précis, il est recommandé de se recourir aux principe de la [Programmation Orienté Aspects (AOP)](http://en.wikipedia.org/wiki/Aspect-oriented_programming). Il existe un framework AOP pour AngularJS, vous pouvez le trouver à [cette adresse](https://github.com/mgechev/angular-aop).
+
+#### Facade
+
+> Ce patron fournit une interface unifiée sur un ensemble d'interfaces d'un système. Il est utilisé pour réaliser des interfaces de programmation. Si un sous-système comporte plusieurs composants qui doivent être utilisés dans un ordre précis, une classe façade sera mise à disposition, et permettra de contrôler l'ordre des opérations et de cacher les détails techniques des sous-systèmes. Une façade peut :
+>
+> 1. rendre une librairie plus simple à utiliser et à tester.
+> 2. rendre une librairie plus simple à comprendre.
+> 3. offrir une meilleure flexibilité dans le développement de la librairie.
+> 4. englober une collection d'API mal conçues en une seule API bien conçue (en foncton des tâches).
+
+
+
+Il existe peut de façades dans AngularJS. A chaque fois que vous voulez fournir une API de haut niveau pour une certaine fonctionnalité, vous finissez par créer une façade.
+
+Par exemple, regardons comment créer une requête POST avec `XMLHttpRequest` :
+
+``` JavaScript
+var http = new XMLHttpRequest(),
+
+url = '/example/new',
+params = encodeURIComponent(data);
+http.open("POST", url, true);
+
+http.setRequestHeader("Content-type", "application/x-www-form-urlencoded");
+http.setRequestHeader("Content-length", params.length);
+http.setRequestHeader("Connection", "close");
+http.onreadystatechange = function () {
+ if(http.readyState == 4 && http.status == 200) {
+ alert(http.responseText);
+ }
+}
+
+http.send(params);
+```
+
+Voici la même chose en utilisant le service `$http` d'AngularJS :
+
+``` javascript
+$http({
+ method: 'POST',
+ url: '/example/new',
+ data: data
+})
+.then(function (response) {
+ alert(response);
+});
+```
+
+ou encore :
+
+``` JavaScript
+$http.post('/someUrl', data)
+.then(function (response) {
+ alert(response);
+});
+```
+
+La seconde option offre une version pre-configurée qui créé une requête POST vers une URL donnée.
+
+Le service `$resource` d'AngularJS est un service construit autour de `$http` et apporte une abstraction supplémentaire. Nous verrons ce nouveau dans les sections [Enregistrement Actif (Active Record)](#active-record) et [Proxy](#proxy).
+
+#### Proxy
+
+> Ce patron est un substitut d'un objet, qui permet de contrôler l'utilisation de ce dernier. Un proxy est un objet destiné à protéger un autre objet. Le proxy a la même interface que l'objet à protéger. Il peut être créé par exemple pour permettre d’accéder à distance à un objet (via un middleware). Un proxy, dans sa forme la plus simple, ne protège rien du tout et transmet tous les appels de méthode à l'objet cible.
+
+
+
+Nous pouvons différencier trois types de proxy :
+
+- Proxy virtuel
+- Proxy distant
+- Proxy de protection
+
+Dans cette section, nous allons parler de l'implémentation du proxy virtuel dans AngularJS.
+
+Dans le code suivant, il y a un appel vers la méthode `get` de l'instance `$resource` référencée par `User` :
+
+``` JavaScript
+var User = $resource('/users/:id'),
+ user = User.get({ id: 42 });
+console.log(user); // {}
+```
+
+L'appel de `console.log` affiche un objet vide. La requête AJAX, qui est émise lors de l'appel de la méthode `User.get`, est une requête asynchrone, nous n'avons pas vraiment l'objet `user` lorsque `console.log` est invoquée. Juste après que `User.get` déclenche la requête GET, elle retourne un objet vide et garde une référence vers ce dernier. Cet objet représente donc un proxy virtuel, qui sera mis à jour avec les données récupérées du serveur lors de la réception de la réponse.
+
+Comment cela fonctionne dans AngularJS? Considérons le code suivant :
+
+``` JavaScript
+function MainCtrl($scope, $resource) {
+ var User = $resource('/users/:id'),
+ $scope.user = User.get({ id: 42 });
+}
+```
+
+``` html
+
+```
+
+> **Pro tip** : Il n'est pas conseillé d'utiliser `$resource` directement dans un contrôleur. Préférez le mettre dans une factory ou un service !
+
+Lorsque ce code s'exécute, la propriété `user` de l'objet `$scope` est initialement vide (`{}`), ce qui signifie que `user.name` sera `undefined` et rien ne sera rendu dans la vue. En interne, AngularJS garde une référence de cet objet vide. Lorsque le serveur répond à la requête GET, AngularJS met à jour l'objet avec les données reçues. Lors de l'itération suivante de la boucle du `$digest`, AngularJS détecte des changements dans l'objet `$scope.user`, ce qui déclenche le rafraichissement de la vue.
+
+#### Enregistrement Actif (Active Record)
+
+> Active Record est une approche pour lire les données d'une base de données. Les attributs d'une table ou d'une vue sont encapsulés dans une classe. Ainsi l'objet, instance de la classe, est lié à un tuple de la base. L'objet Active Record encapsule donc les données ainsi que le comportement.
+
+
+
+AngularJS définit un service nommé `$resource` distribué dans un module additionnel. D'après la [documentation](https://docs.angularjs.org/api/ngResource/service/$resource) d'AngularJS du service `$resource` :
+
+> Une factory pour la création d'objet permettant une interaction avec les données des sources RESTful.
+>
+> L'objet retourné possède des méthodes d'action offrant une abstraction très haut niveau et ne nécessitant pas une interaction avec le service `$http`.
+
+Voici comment le service `$resource` peut être utilisé :
+
+``` JavaScript
+var User = $resource('/users/:id'),
+ user = new User({
+ name: 'foo',
+ age : 42
+ });
+
+user.$save();
+```
+
+l'appel à `$resource` retourne un constructeur permettant d'instancier des objets de notre modèle `User`. Chaque instance possède des méthodes correspondantes à des opérations de CRUD.
+
+Le constructeur possède également des méthodes statiques équivalentes aux méthodes d'instances :
+
+``` JavaScript
+var user = User.get({ userid: userid });
+```
+
+Ce code retourne un [proxy virtuel](#proxy).
+
+Les puristes dirons de suite que le service `$resource` n'implémente pas le parton Active Record, puisque ce dernier stipule que la responsabilité d'un tel patron de conception est de prendre en charge la communication avec la base de données. Or `$resource` communique lui avec des Web Services RESTful. A vrai dire, tout dépend de quel point de vue nous nous situons, pour une application SPA, une resource RESTful est considérée comme une source de données. Voilà ! problème résolue.
+
+Vous pouvez trouver plus de détails concernant les pouvoirs du service `$resource` [ici](http://blog.mgechev.com/2014/02/05/angularjs-resource-active-record-http/).
+
+#### Intercepting Filters
+
+> Créé une chaîne de filtres composables afin d'implémenter des tâches de pré-processing et post-processing récurrentes lors de l'émission des requêtes.
+
+
+
+Dans certains cas, il peut arriver que vous deviez traiter les requêtes HTTP sortantes et entrantes afin par exemple d'ajouter une gestion de logs, ajouter un mécanisme de sécurité, ou tout autre tâche concernée par le corps de la requête ou de ses entêtes. Les filtres d'interception inclus une chaîne de filtres pouvant chacun traiter des données dans un ordre définit. La sortie de chaque filtre est l'entrée du filtre suivant.
+
+Dans AngularJS, nous rencontrons ce patron dans le service `$httpProvider`. Ce service possède un tableau de propriétés appelé `interceptors` qui contient une liste d'objet. Chaque objet peut posséder une ou toutes les propriété suivantes : `request`, `response`, `requestError`, `responseError`.
+
+L'objet `requestError` est un intercepteur qui est appelé lorsque l'intercepteur `request` de la requête précédente jette une erreur ou un exception ou bien lorsqu'un promise a été rejetée. De même, `responseError` est appelé lorsque l'intercepteur `response` de la réponse précédente rencontre une erreur.
+
+Voici un exemple basique :
+
+``` JavaScript
+$httpProvider.interceptors.push(function($q, dependency1, dependency2) {
+ return {
+ 'request': function(config) {
+ // same as above
+ },
+ 'response': function(response) {
+ // same as above
+ }
+ };
+});
+```
+
+### Les directives
+
+#### Composite
+
+> Ce patron permet de composer une hiérarchie d'objets, et de manipuler de la même manière un élément unique, une branche, ou l'ensemble de l'arbre. Il permet en particulier de créer des objets complexes en reliant différents objets selon une structure en arbre.
+
+
+
+D'après le Gang of Four ([GoF](http://c2.com/cgi/wiki?GangOfFour)), le patron MVC n'est rien de plus que la combinaison de :
+
+- Strategy
+- Composite
+- Observer
+
+Ils explique que la vue est la composition de plusieurs composants. Dans AnguarlJS, nous sommes dans ce cas de figure. Les vues sont formées grâce à la composition des directives et les éléments DOM.
+
+Voyons cet exemple :
+
+``` HTML
+
+
+
+
+
+
+ Zippy!
+
+
+
+```
+
+``` JavaScript
+myModule.directive('zippy', function () {
+ return {
+ restrict: 'E',
+ template: '
',
+ link: function (scope, el) {
+ el.find('.header').click(function () {
+ el.find('.content').toggle();
+ });
+ }
+ }
+});
+```
+
+Dans cet exemple, nous avons définit une simple directive, qui se trouve être un composant de type UI. Ce composant appelé "zippy" possède un entête `div.header` et un contenu `div.content`.
+
+A partir du premier exemple, nous pouvons remarquer que tout l'arbre DOM est la composition de plusieurs éléments. L'élément racine est `html`, suivi juste après par `head`, ensuite `body`… etc.
+
+Dans le second exemple JavaScript, la propriété `template` de la directive contient une directive `ng-transclude` (sous forme d'attribut). Ceci signifie qu'à l'intérieur de la directive `zippy` nous avons une autre directive nommée `ng-transclude`. Autrement-dit, une composition de directive.
+
+### Interpreter
+
+> Le patron comporte deux composants centraux: le contexte et l'expression ainsi que des objets qui sont des représentations d'éléments de grammaire d'un langage de programmation. Le patron est utilisé pour transformer une expression écrite dans un certain langage programmation - un texte source - en quelque chose de manipulable par programmation: Le code source est écrit conformément à une ou plusieurs règles de grammaire, et un objet est créé pour chaque utilisation d'une règles de grammaire. L'objet interpreter est responsable de transformer le texte source en objets.
+
+
+
+Grâce au service `$parse`, AngularJS propose son propre implémentation d'une DSL (Domain Specific Language). Cette DSL est une version très simplifiée du langage JavaScript.
+
+Voici les spécificités des expressions AngularJS :
+
+- elles peuvent contenir des filtre via la syntaxe `pipe` (à la manière d'UNIX)
+- ne déclenche pas d'exceptions
+- ne contient aucune structure de contrôle (même s'il est possible d'utiliser l'opérateur ternaire)
+- sont évaluée dans le contexte du `$scope` de la vue
+
+Dans l'implémentation du service `$parse`, sont définis deux composants :
+
+``` JavaScript
+//Responsable de convertir des caractères en token
+var Lexer;
+//Responsable d'interpréter les token et d'évaluder les expressions
+var Parser;
+```
+
+Lorsqu'une expression a été transformée en `token`, elle est mise en cache pour des raisons de performance.
+
+Les symboles terminaux dans la DSL AngularJS sont définis comme ceci :
+
+``` JavaScript
+var OPERATORS = {
+ /* jshint bitwise : false */
+ 'null':function(){return null;},
+ 'true':function(){return true;},
+ 'false':function(){return false;},
+ undefined:noop,
+ '+':function(self, locals, a,b){
+ //...
+ },
+ '*':function(self, locals, a,b){return a(self, locals)*b(self, locals);},
+ '/':function(self, locals, a,b){return a(self, locals)/b(self, locals);},
+ '%':function(self, locals, a,b){return a(self, locals)%b(self, locals);},
+ '^':function(self, locals, a,b){return a(self, locals)^b(self, locals);},
+ '=':noop,
+ '===':function(self, locals, a, b){return a(self, locals)===b(self, locals);},
+ '!==':function(self, locals, a, b){return a(self, locals)!==b(self, locals);},
+ '==':function(self, locals, a,b){return a(self, locals)==b(self, locals);},
+ '!=':function(self, locals, a,b){return a(self, locals)!=b(self, locals);},
+ '<':function(self, locals, a,b){return a(self, locals)':function(self, locals, a,b){return a(self, locals)>b(self, locals);},
+ '<=':function(self, locals, a,b){return a(self, locals)<=b(self, locals);},
+ '>=':function(self, locals, a,b){return a(self, locals)>=b(self, locals);},
+ '&&':function(self, locals, a,b){return a(self, locals)&&b(self, locals);},
+ '||':function(self, locals, a,b){return a(self, locals)||b(self, locals);},
+ '&':function(self, locals, a,b){return a(self, locals)&b(self, locals);},
+ '|':function(self, locals, a,b){return b(self, locals)(self, locals, a(self, locals));},
+ '!':function(self, locals, a){return !a(self, locals);}
+};
+```
+
+Nous pouvons considérer chaque fonction associée à un symbole comme étant une implémentation de l'interface `AbstractExpression`.
+
+Chaque `Client` interprète une expression AngularJS donnée dans un contexte spécifique.
+
+Voici quelques exemples d'expressions AngularJS :
+
+``` JavaScript
+// le filtre toUpperCase est appliqué au résultat de l'expression :
+// (foo) ? bar : baz
+(foo) ? bar : baz | toUpperCase
+```
+
+#### Template View
+
+> Affiche un rendu dans l'HTML, basé sur des marqueurs dans le code HTML.
+
+
+
+La gestion du rendu dynamic d’une page n’est pas chose facile. Il est souvent question de beaucoup de manipulation de chaîne de caractères. Pour simplifier cette procédure, il est souvent plus simple d’incorporer des expressions dans notre HTML, ces expressions sont évaluées dans un contexte donné et tout le template est ensuite compilé vers le format final. Dans notre cas, ce format est HTML voire le DOM. C’est ce que font les moteurs de templating - ils prennent une DSL, l’évalue dans un contexte donné puis la transforme en un format souhaité.
+
+Les templates sont historiquement associés aux technologies back-end. Par exemple, vous pouvez embarquer du code PHP dans une page HTML pour créer une page dynamique, en utilisant un moteur de templating, tel que Smarty.
+
+En ce qui concerne JavaScript, il existe pléthore de moteurs de templating, les plus connus sont mustache.js et handlerbars. Ces moteurs manipulent souvent les templates sous format texte. Ces templates peuvent être mis directement dans la page statique, dans une balise `script` avec un type spécifique, récupéré depuis le serveur via `XHR` ou encore mis directement dans du JavaScript.
+
+Par exemple :
+
+``` html
+
+```
+
+Le moteur de templating transforme ce texte (le contenu de la balise `script`) en éléments DOM en les compilant dans un contexte donné. Par exemple, si ce contenu est évalué dans le contexte suivant : `{ names: ['foo', 'bar', 'baz'] }` nous obtenant ceci :
+
+``` html
+
Names
+ foo
+ bar
+ baz
+```
+
+En AngularJS, les templates n’ont pas besoin d’être compilés ; ils ne sont pas dans un format intermédiaire comme le template précédent. Ce que fait le compilateur AngularJS, il traverse l’arbre DOM à la recherche de directives connues (éléments, attributs, classes CSS ou encore des commentaires). Lorsqu’il rencontre l’une de ces directives, il invoque le code associé ce qui déclenche l’évaluation des différentes expressions dans le contexte courant.
+
+Par exemple :
+
+``` html
+
+
{{name}}
+
+```
+
+L’évaluation de la directive `ng-reapeat`dans le contexte suivant :
+
+``` javascript
+myCtrl.names = ['foo', 'bar', 'baz'];
+```
+
+produit le même résultat que précédemment :
+
+``` html
+
Names
+ foo
+ bar
+ baz
+```
+
+### Scope
+
+#### Observer
+
+> Ce patron établit une relation un à plusieurs entre des objets, où lorsqu'un objet change, plusieurs autres objets sont avisés du changement. Dans ce patron, un objet *le sujet* tient une liste des objets dépendants *les observateurs* qui seront avertis des modifications apportées au *sujet*. Quand une modification est apportée, le sujet emmet un message aux différents observateurs.
+
+
+
+Il existe deux façon pour communiquer entre les scopes (ou les contrôleurs) dans une application AngularJS. La première consiste à appeler les méthodes des parents depuis les scopes enfants. Ceci est rendu possible car le scope enfant hérite du prototype du scope parent, comme expliqué dans les sections précédentes (voir la section sur le [Scope](#scope)) ; Cette première façon de faire autorise un sens de communication : de l’enfant vers le parent. Cependant, il est souvent nécessaire d’appeler des méthodes d’un scope enfant, ou notifier un scope enfant suite à un événement déclenché dans le contexte du parent. AngularJS propose de base un patron Observer, qui permet ce genre de communication.
+
+Un autre cas d’usage de ce patron : lorsque plusieurs scopes sont concernés par un certain événement, qui est déclenché dans un autre contexte. Ceci permet en effet de découpler les scopes.
+
+Chaque `$scope` dans AngularJS possède trois méthodes : `$on`, `$emit`et `$broadcast`. La méthode `$on`accepte un topic et une fonction de callback. Cette callback peut être considérée comme un `observer`, un objet implémentant l’interface `Observer`:
+
+``` javascript
+function ExampleCtrl($scope) {
+ $scope.$on('event-name', function handler() {
+ //body
+ });
+}
+```
+
+De cette manière, le `$scope`courant souscrit à un événement de type `event-name`. Lorsque cet événement est déclenché à n’importe quel niveau du `$scope` courant, que ce soit au niveau de ses parents ou ses enfants, la fonction `handler sera invoquée.
+
+Les méthodes `$emit`et `$broadcast`sont utilisées pour déclencher et propager les événements, vers `$scope` parents pour `$emit`et `$scope`enfants pour `$broadcast`. Voici un exemple :
+
+``` javascript
+function ExampleCtrl($scope) {
+ $scope.$emit('event-name', { foo: 'bar' });
+}
+```
+
+Dans cet exemple, le `$scope`déclenche l’événement ` event-name`et le propage vers tous les `$scope`parents. Ce qui signifie que chaque `$scope`parent ayant souscrit à `event-name` sera notifié et sa fonction `handler` sera appelée. La méthode `$broadcast`fonctionne de la même manière, à la différence près qu’elle propage l’événement vers tous les `$scope`enfants.
+
+Chaque `$scope`a la possibilité de souscrire plusieurs actions à un même événement. Dit autrement, il peut associer plusieurs observer à un même événement.
+
+Ce patron est également connu sous le nom de publish/subscribe (ou producteur/consommateur).
+
+Pour les bonnes pratiques concernant ce patron, voir [Le patron Observer en tant que Service externe](#observer-pattern-as-an-external-service)
+
+#### Chaîne de responsabilité
+
+> le patron de conception Chaîne de responsabilité permet à un nombre quelconque de classes d'essayer de répondre à une requête sans connaître les possibilités des autres classes sur cette requête.
+
+
+
+Comme cité précédemment, les `$scopes`dans AngularJS forment une hiérarchie connue sous le nom de chaîne de scope. Certains d’entre eux peut être isolés, ce qui signifie qu’ils n’héritent pas des prototypes de leurs parents ; cependant, chaque `$scope`connait son parent direct grâce à la propriétés `$parent`qu'il contient.
+
+Lorsque les méthode `$emit`et `$broadcast`sont appelées, les `$scope`deviennent alors comme un bus d’événement, ou plus précisément, une chaine de responsabilité. Une fois l’événement est a été déclenché, que ce soit vers les parents ou les enfants, chaque `$scope`peut :
+
+- traiter l’événement et le passer au `$scope`suivant dans la chaîne.
+- traiter l’événement et stopper sa propagation.
+- passer directement l’événement au `$scope`suivant sans le traiter.
+- stopper directement la propagation de l’événement.
+
+Dans l’exemple suivant, nous pouvons constater que `ChildCtrl` déclenche un événement, qui est propager vers le haut de la chaîne. Chaque `$scope`parent - celui créé par `ParentCtrl` et l’autre créé par `MainCtrl`- traite l’événement en affichant dans la console `"foo received"`. Si un `$scope`considère qu’il doit stopper la propagation de cet événement, il doit appeler la méthode `stopPropagation()`sur l’événement en question.
+
+Voici l’exemple de code :
+
+``` JavaScript
+myModule.controller('MainCtrl', function ($scope) {
+ $scope.$on('foo', function () {
+ console.log('foo received');
+ });
+});
+
+myModule.controller('ParentCtrl', function ($scope) {
+ $scope.$on('foo', function (e) {
+ console.log('foo received');
+ });
+});
+
+myModule.controller('ChildCtrl', function ($scope) {
+ $scope.$emit('foo');
+});
+```
+
+Les ` Handler`figurant dans le diagramme UML correspondent aux différents `$scope`injectés dans les contrôleurs.
+
+#### Command
+
+> Ce patron emboîte une demande dans un objet, permettant de paramétrer, mettre en file d'attente, journaliser et annuler des demandes.
+
+
+
+
+
+Avant de rentrer dans les expliquation de ce patron de conception, étudions comment AngularJS implémente le ` data biding`(ou liaison de données).
+
+Pour associer un modèle à une vue, nous utilisons la directive `ng-bind`, pour une liaison uni-directionnelle, et `ng-model`pour une liaison bi-directionnelle. Par exemple, si nous souhaitons que tous les changements du modèle soient reflétés dans la vue automatiquement :
+
+``` html
+
+```
+
+A chaque fois que le modèle `foo` subit un changement, le contenu de la balise `span` sera mis à jour **automagiquement**. Voici un exemple avec une expression AngularJS :
+
+``` html
+
+```
+
+Dans cet exemple, le contenu de la balise `span` sera le résultat de la concaténation des valeurs des modèles `foo`et `bar`. Mais que ce passe-t-il sous le capot ? Que fait AngularJS réellement ?
+
+Chaque `$scope`possède une méthode `$watch`. Lorsque le compilateur d'AngularJS traverse le DOM est rencontre une directive `ng-bind`, il créé un observateur (`watcher`) basé sur l’expression rencontrée : ion `foo + ' ' + bar | uppercase` comme ceci :
+
+``` Javascript
+$scope.$watch("foo + ' ' + bar | uppercase", function update() { /* body */ });
+```
+
+La callback `update`sera déclenchée à chaque fois que la valeur de l’expression vient à changer. Dans notre exemple, la callback met à jour le contenu de la balise `span`.
+
+Voici un aperçu du début de l’implémentation de la méthode `$watch`:
+
+``` javascript
+$watch: function(watchExp, listener, objectEquality) {
+ var scope = this,
+ get = compileToFn(watchExp, 'watch'),
+ array = scope.$$watchers,
+ watcher = {
+ fn: listener,
+ last: initWatchVal,
+ get: get,
+ exp: watchExp,
+ eq: !!objectEquality
+ };
+//...
+```
+
+Nous pouvons considérer l’objet `watcher` comme une commande. L’expression de la commande est évaluée à chaque itération de la boucle de digestion ou [`"$digest"`](https://docs.angularjs.org/api/ng/type/$rootScope.Scope#$digest). Lorsque AngularJS détecte un changement dans l’expression, la fonction `listener` est invoquée. La commande `watcher `encapsule tout le nécessaire pour observer une expression donnée, et déléguer l’exécution de la commande à la fonction `listener`, le `receiver` dans le diagramme UML. Le `$scope`quant à lui est l’équivalent du `Client` et la boucle de `$digest`est le `Invoker`.
+
+### Controllers
+
+#### Contrôleur de page
+
+> Un objet qui traite la requête d’une page ou une action. — [Martin Fowler](https://en.wikipedia.org/wiki/Martin_Fowler)
+
+
+
+D’après le point [4](#references) un contrôleur de page est :
+
+> Le patron de conception Contrôleur de page, ou Page Controller, accepte une entrée depuis la requête, invoque l’action demandée d’un modèle, puis détermine la vue à utiliser pour la construction de la page finale.
+
+Il peut exister une certaine hiérarchie au sein des contrôleurs de page, puisqu’une page peut être construite en assemblant plusieurs blocs, tels que les headers, les footers, les blocs d’informations de session, etc. Dans AngularJS, nous avons des contrôleurs, mais avec beaucoup moins de responsabilités. Ils ne traitent pas les requêtes des utilisateurs, c’est la responsabilité des services `$router`ou `$state`et le rendu de la page est à la charge des directives `ng-view`ou `ui-view`.
+
+De la même manière que les Contrôleurs de page, les contrôleurs d’angulaires traite les interactions des utilisateurs, expose et mettent à jour les modèles. Le modèle est exposé à la vue, lorsqu’il est attaché au `$scope`; et toutes les méthodes invoquées dans les vues, en réponse aux interactions de l’utilisateur, sont également attachées au `$scope`. Une autre similitude avec les Contrôleurs de page, se situe au niveau de la hiérarchie qu’ils forment. Ces hiérarchie correspond à celle formée par la chaine des `$scope`. Ainsi, il est possible d’isoler des actions dans certains contrôleurs, ceux situés tout en haut de la chaîne.
+
+Voici un exemple illustrant cette hiérarchie :
+
+``` HTML
+
+
+
+
+
+
+ {{user.name}}
+
+
+
+
+```
+
+``` JavaScript
+function MainCtrl($scope, $location, User) {
+ if (!User.isAuthenticated()) {
+ $location.path('/unauthenticated');
+ }
+}
+
+function ChildCtrl($scope, User) {
+ $scope.click = function () {
+ alert('Cliqué !');
+ };
+ $scope.user = User.get('123abc');
+}
+```
+
+Cet exemple (à ne pas utiliser dans un code en production !) a pour but d’illustrer l’utilisation d’un contrôleur de base `MainCtrl` dans lequel nous isolons la logique qui sera utilisée par les sous-contrôleur. Le contrôleur `ChildCtrl` est responsable de gérer les actions de l’utilisateur tel que la gestion des cliques sur le bouton, ainsi que d’exposer le modèle `user`à la vue en l’attachant au `$scope`.
+
+### Others
+
+#### Module Pattern
+
+Ce patron de conception ne figure ni dans le catalogue des [Gang of Four](http://c2.com/cgi/wiki?CategoryPattern), ni dans celui du [P of EAA](http://www.martinfowler.com/eaaCatalog/index.html). Par contre, c’est un patron de conception classique en JavaScript, dont le rôle est d’apporter une certaine forme d’encapsulation.
+
+En se basant sur le patron Module, il est possible de tirer avantage de la puissance des fermetures ([`closure`](http://wassimchegham.com/blog/javascript-pour-les-jedis-episode-2-attaque-des-closures-ou-fermetures)) et de la portée lexicale qui limite la visibilité des variables aux fonctions dans lesquelles elle ont été déclarées.
+
+Chaque module peut avoir zéro ou plusieurs membres privés, accessible uniquement dans la portée locale de la function. Cette fonction retourne un objet qui expose une API publique du module en question. Voici un exemple :
+
+``` javascript
+var Page = (function () {
+
+ var title;
+
+ function setTitle(t) {
+ document.title = t;
+ title = t;
+ }
+
+ function getTitle() {
+ return title;
+ }
+
+ return {
+ setTitle: setTitle,
+ getTitle: getTitle
+ };
+
+}());
+```
+
+Dans cet exemple, nous avons déclaré une IIFE (Immediately-Invoked Function Expression), une fonction auto-invoquée qui, une fois invoquée retourne un objet avec deux méthodes : `setTitle()` et `getTitle()`. Cet objet est ensuite affecté à la variable `Page`.
+
+L’entité manipulant la variable `Page`n’a pas accès à la variable `title` par exemple, qui est définit dans la IIFE.
+
+Ce patron est également très intéressant lorsque nous devons définir des services en AngularJS. Nous pouvons rendre privée, une partie de la logique :
+
+``` javascript
+app.factory('foo', function () {
+
+ function privateMember() {
+ //body...
+ }
+
+ function publicMember() {
+ //body...
+ privateMember();
+ //body
+ }
+
+ return {
+ publicMember: publicMember
+ };
+});
+```
+
+Une fois le service `foo` injecté dans un composant, il ne nous sera pas possible d’utiliser directement les méthodes privées, mais uniquement celles exposées par l’objet retourné. Cette solution est extrêmement puissante surtout si nous développons une librairie.
+
+### Data Mapper
+
+> Un Data Mapper est une couche d’accès au données qui réalise un transfert bi-directionnel entre la persistence de données (souvent une base relationnelle) et une représentation des données en mémoire (la couche métier). Le but de ce patron est de garder ces deux couches indépendantes les unes des autres, ainsi que du Data Mapper lui-même.
+
+
+
+Comme cité dans la définition, le Data Mapper est utilisé pour le transfert bi-directionnel de données entre la couche de persistence et la couche métier. Dans AngularJS, l’application communique avec un serveur exposant une API RESTFul. AngularJS propose le service `$resource`qui permet de communiquer avec le serveur dans un style [Active Record](#active-record). Souvent, les entités retournées par l’API ne correspondent toujours pas formatées de la façon qui nous arrange pour être directement exploitées.
+
+Prenons par exemple ce cas de figure, supposons que l’on dispose d’un modèle `User` avec les attributs suivants :
+
+- un nom.
+- une adresse.
+- une luiste d'amis
+
+Voici l’API exposant les ressources suivantes :
+
+- `GET /users/:id` : retourne le nom et l’adresse d’un utilisateur.
+- `GET /friends/:id` : retourne la liste d’amis d’un utilisateur.
+
+Une première solution naïve consisterait à avoir deux services, un pour la première ressource et une autre pour la seconde. Mais ce serait mieux si nous avions qu’un seul et unique service, `User `par exemple :
+
+``` javascript
+app.factory('User', function ($q) {
+
+ function User(name, address, friends) {
+ this.name = name;
+ this.address = address;
+ this.friends = friends;
+ }
+
+ User.get = function (params) {
+ var user = $http.get('/users/' + params.id),
+ friends = $http.get('/friends/' + params.id);
+ $q.all([user, friends])
+ .then(function (user, friends) {
+ return new User(user.name, user.address, friends);
+ });
+ };
+ return User;
+});
+```
+
+Avec cette solution, nous avons crée un pseudo Data Mapper, qui a pour rôle d’adapter l’API en fonction des contraintes de notre SPA.
+
+Nous pouvons utiliser le service `User` comme ceci :
+
+``` javascript
+function MainCtrl($scope, User) {
+ User.get({ id: 1 }).then(function (data) {
+ $scope.user = data;
+ });
+}
+```
+
+Et la vue :
+
+``` html
+
+
+ Name: {{user.name}}
+
+
+ Address: {{user.address}}
+
+
+ Friends with ids:
+
+
{{friend}}
+
+
+
+```
+
+### Le patron Observer grâce à un Service Commun
+
+L’exemple de code a été récupéré depuis [ce projet](https://github.com/greglbd/angular-observer-pattern). Cet une factorie AngularJS qui créé un service implémentant le patron Observer. Ce patron fonctionne très bien avec la syntaxe `ControllerAs` et sert comme une alternative à `$scope.$watch()`ou encore `$scope.emit()`et `$scope.broadcast()`.
+
+Ce patron est utilisé pour faire communiquer plusieurs contrôleurs utilisant le même modèle.
+
+Voici un exemple démontrant comment attacher, notifier et détacher un événement grâce un Service Commun :
+
+``` javascript
+angular.module('app.controllers')
+ .controller('ObserverExample', ObserverExample);
+
+ObserverExample.$inject= ['ObserverService', '$timeout'];
+
+function ObserverExample(ObserverService, $timeout) {
+ var vm = this;
+ var id = 'vm1';
+
+ ObserverService.attach(callbackFunction, 'let_me_know', id)
+
+ function callbackFunction(params){
+ console.log('now i know');
+ ObserverService.detachByEvent('let_me_know')
+ }
+
+ $timeout(function(){
+ ObserverService.notify('let_me_know');
+ }, 5000);
+}
+```
+
+Alternative way to remove event
+
+``` javascript
+angular.module('app.controllers')
+ .controller('ObserverExample', ObserverExample);
+ObserverExample.$inject= ['ObserverService', '$timeout', '$scope'];
+
+function ObserverExample(ObserverService, $timeout, $scope) {
+ var vm = this;
+ var id = 'vm1';
+ ObserverService.attach(callbackFunction, 'let_me_know', id)
+
+ function callbackFunction(params){
+ console.log('now i know');
+ }
+
+ $timeout(function(){
+ ObserverService.notify('let_me_know');
+ }, 5000);
+
+ // Cleanup listeners when this controller is destroyed
+ $scope.$on('$destroy', function handler() {
+ ObserverService.detachByEvent('let_me_know')
+ });
+}
+```
+
+
+
+## References
+
+1. [Wikipedia](https://en.wikipedia.org/wiki). Toutes les définition des patrons de conception viennent de Wikipedia.
+2. [AngularJS' documentation](https://docs.angularjs.org)
+3. [AngularJS' git repository](https://github.com/angular/angular.js)
+4. [Page Controller](http://msdn.microsoft.com/en-us/library/ff649595.aspx)
+5. [Patterns of Enterprise Application Architecture (P of EAA)](http://martinfowler.com/books/eaa.html)
+6. [Using Dependancy Injection to Avoid Singletons](http://googletesting.blogspot.com/2008/05/tott-using-dependancy-injection-to.html)
+7. [Why would one use the Publish/Subscribe pattern (in JS/jQuery)?](https://stackoverflow.com/questions/13512949/why-would-one-use-the-publish-subscribe-pattern-in-js-jquery)
diff --git a/i18n/README-ru-ru.md b/i18n/README-ru-ru.md
new file mode 100644
index 0000000..933006f
--- /dev/null
+++ b/i18n/README-ru-ru.md
@@ -0,0 +1,1157 @@
+# Паттерны в AngularJS
+
+
+
+## Table of Contents
+
+* [Переводы](#переводы)
+* [Краткий обзор](#праткий-обзор)
+* [Введение](#Введение)
+* [Краткий обзор AngularJS](#краткий-обзор-AngularJS)
+ * [Partials](#partials)
+ * [Controllers](#controllers)
+ * [Scope](#scope)
+ * [Directives](#directives)
+ * [Filters](#filters)
+ * [Services](#services)
+* [AngularJS Patterns](#angularjs-patterns)
+ * [Services](#services-1)
+ * [Singleton](#singleton)
+ * [Factory Method](#factory-method)
+ * [Decorator](#decorator)
+ * [Facade](#facade)
+ * [Proxy](#proxy)
+ * [Active Record](#active-record)
+ * [Intercepting Filters](#intercepting-filters)
+ * [Directives](#directives-1)
+ * [Composite](#composite)
+ * [Interpreter](#interpreter)
+ * [Template View](#template-view)
+ * [Scope](#scope-1)
+ * [Observer](#observer)
+ * [Chain of Responsibilities](#chain-of-responsibilities)
+ * [Command](#command)
+ * [Controller](#controller-1)
+ * [Page Controller](#page-controller)
+ * [Others](#others)
+ * [Module Pattern](#module-pattern)
+ * [Data Mapper](#data-mapper)
+ * [Шаблон Observer как внешний сервис](#шаблон-observer-как-внешний-сервис)
+* [Ссылки](#Ссылки)
+
+
+
+## Переводы
+
+- [Japanese Translation](https://github.com/mgechev/angularjs-in-patterns/blob/master/i18n/README-ja-jp.md) by [morizotter](https://twitter.com/morizotter)
+- [Russian Translation](http://habrahabr.ru/post/250149/)
+- [French Translation](https://github.com/mgechev/angularjs-in-patterns/blob/master/i18n/README-fr-fr.md) by [manekinekko](https://github.com/manekinekko)
+- [Chinese Translation](https://github.com/mgechev/angularjs-in-patterns/blob/master/i18n/README-zh-cn.md) by [carlosliu](https://github.com/carlosliu)
+
+## Краткий обзор
+
+Один из лучших способов изучить, что то новое, это увидеть, как в нем используются уже знакомые нам вещи. Эта статья не намерена ознакомить читателей с проектированием или шаблонами проектирования. Она предлагает базовое понимание концепций ООП, шаблонов проектирования и архитектурных шаблонов. Цель статьи описать, как различные конструкции программного обеспечения и архитектурные шаблоны используются в AngularJS и написанных на нем SPA
+
+## Введение
+
+Статья начинается с краткого обзора фреймворка AngularJS. Обзор объясняет основные компоненты AngularJS: directives, filters, controllers, services, scope. Во втором разделе перечислены и описаны различные конструкции и архитектурные шаблоны, которые реализованы внутри фреймворка. Шаблоны сгруппированы по компонентам AngularJS, в которых они используются. Если некоторые шаблоны используются в нескольких компонентах, это будет указано.
+
+Последний раздел включает несколько архитектурных шаблонов, которые обычно используются в SPA построенных на AngularJS.
+
+## Краткий обзор AngularJS
+
+AngularJS это JavaScript веб фреймворк разработанный Google. Он намерен обеспечить прочную основу для разработки CRUD SPA . SPA загружается только один раз и не требует перезагрузки страницы при работе с ним. Это означает, что все ресурсы приложения (data, templates, scripts, styles) должны быть загружены при загрузке главной страницы или по требованию. Поскольку большинство CRUD приложений имеют общие характеристики и требования, AngularJS намерен предоставить их оптимальный набор из коробки. Вот несколько важных особенностей AngularJS:
+
+- two-way data binding (Двустороннее связывание данных)
+- dependency injection, DI (Внедрение зависимостей)
+- separation of concerns (Разделение ответственности)
+- testability
+- abstraction
+
+Разделение ответственности достигается путем деления каждого AngularJS приложения на отдельные компоненты, такие как:
+
+- partials
+- controllers
+- directives
+- services
+- filters
+
+Эти компоненты могут быть сгруппированы внутри различных модулей, которые помогают достичь более высокого уровня абстракции. Каждый компонент включает определенную часть логики приложения.
+
+### Partials
+
+Partials это HTML строки. Они могут содержать AngularJS выражения внутри элементов или их атрибутов. Одним из преимуществ AngularJS перед другими фреймворками, является то, что шаблоны AngularJS не находятся в промежуточном формате, который должен быть преобразован в HTML (как например в mustache.js)
+
+Вначале каждое SPA загружает файл Index.html. В случае с AngularJS этот файл содержит набор стандартных (и не очень) HTML атрибутов, элементов и комментариев, которые настраивают и запускают приложение. Каждое действие пользователя требует загрузки других partials (HTML строк или файлов с кусками HTML) или изменение состояния приложения, например через связывание данных (data binding) предоставленное фреймворком.
+
+
+**Пример partials:**
+
+```HTML
+
+
+
+
+
+
+
+
+
+```
+
+Вместе с выражениями AngularJS, partials определяют, какие действия должны быть выполнены для взаимодействия с пользователем. В примере выше значение атрибута ng-click означает, что метод changeFoo() будет вызван из текущего scope.
+
+### Controllers
+
+Контроллеры в AngularJS – это обычные функции, которые позволяют обрабатывать взаимодействие пользователя и приложения (например события мыши, клавиатуры и тд.) путем добавления методов в scope. Все внешние зависимости для контроллеров предоставляются при помощи механизма DI в AngularJS. Контроллеры также отвечают за взаимодействие моделей с partials путем добавления данных в scope. Это можно рассматривать как модель представления (view model).
+
+```JavaScript
+function MyController($scope) {
+ $scope.buttonText = 'Click me to change foo!';
+ $scope.foo = 42;
+
+ $scope.changeFoo = function () {
+ $scope.foo += 1;
+ alert('Foo changed');
+ };
+}
+```
+
+Например, если мы подключим контроллер представленный выше в предыдущую секцию, то пользователь будет иметь возможность взаимодействовать с приложением несколькими способами:
+
+1. Изменение "foo" путем ввода данных в поле ввода. Это немедленно отразится на значении "foo" из-за двустороннего связывания данных.
+2. Изменение значения "foo" нажатием на кнопку с названием Click me to change foo!»
+
+Все пользовательские элементы, атрибуты, комментарии или классы могут быть директивами AngularJS (если они предварительно определены).
+
+### Scope
+
+В AngularJS scope является JavaScript объектом, который доступен для partials. Scope может включать различные свойства – примитивы, объекты или методы. Все методы добавленные в scope, могут быть вызваны с помощью выражений AngularJS внутри partials, которые связанны с данным scope или прямым вызовом метода любым компонентом, у которого есть ссылка на scope. С помощью соответствующих директив, данные добавляются в scope, и могут быть связаны с представлением, таким образом, каждое изменение в свойстве scope будет отражено в представлении и каждое изменение в представлении будет отображено в scope.
+
+Еще одной важной характеристикой scope в любом AngularJS приложении является то, что они связаны через механизм наследования прототипа (за исключением изолированных scope). Таким образом любой дочерний scope может использовать методы его родителя, так как это свойства его прямого или косвенного прототипа.
+
+Наследование scope показано в следующем примере:
+
+```HTML
+
+
+
+
+
+
+```
+
+```JavaScript
+function BaseCtrl($scope) {
+ $scope.foo = function () {
+ alert('Base foo');
+ };
+}
+
+function ChildCtrl($scope) {
+ $scope.bar = function () {
+ alert('Child bar');
+ };
+}
+```
+
+С div#child связан scope ChildCtrl, но поскольку scope ChildCtrl является вложенным в BaseCtrl, то все методы из BaseCtrl доступны в ChildCtrl, при помощи наследования прототипа и поэтому метод foo будет доступен при нажатии на кнопку button#parent-method.
+
+### Directives
+
+Директивы в AngularJS – это место где должны выполняться все манипуляции с DOM. Как правило если у вас в контроллере происходят манипуляции с DOM, то необходимо создать новую директиву или провести рефакторинг, который устранит манипуляции с DOM в контроллере. В простейшем случае у директивы есть имя и определение функции postLink, которая включает логику директивы. В более сложных случаях директива может содержать множество свойств, таких как:
+
+- template
+- compile function
+- link function
+- etc...
+
+Директивы можно использовать в partials, например:
+
+```JavaScript
+myModule.directive('alertButton', function () {
+ return {
+ template: '',
+ scope: {
+ content: '@'
+ },
+ replace: true,
+ restrict: 'E',
+ transclude: true,
+ link: function (scope, el) {
+ el.click(function () {
+ alert(scope.content);
+ });
+ }
+ };
+});
+```
+
+```HTML
+Click me
+```
+
+В примере выше тег будет заменен элементом button и при нажатии на кнопку, появиться предупреждение с текстом 42.
+
+### Filters
+
+Фильтры в AngularJS отвечают за инкапсуляцию логики, необходимой для форматирования данных. Обычно фильтры используются внутри partials, но так же через DI они доступны в контроллерах, директивах, сервисах или других фильтрах.
+
+Здесь простой пример фильтра, который преобразует строку в верхний регистр:
+
+```JavaScript
+myModule.filter('uppercase', function () {
+ return function (str) {
+ return (str || '').toUpperCase();
+ };
+});
+```
+
+Внутри partials фильтры могут быть использованы с помощью синтаксиса Unix конвейеров (Unix's piping):
+
+```HTML
+
{{ name | uppercase }}
+```
+
+Внутри контроллера фильтр может быть использован следующим образом:
+
+```JavaScript
+function MyCtrl(uppercaseFilter) {
+ $scope.name = uppercaseFilter('foo'); //FOO
+}
+```
+
+### Services
+
+Любая часть логики, которая не относится к компонентам описанным выше, должна быть помещена в сервис. Обычно сервисы инкапсулируют специфическую область логики, неизменяемую логику, XHR, WebSockets и т. д. Когда контроллеры в приложении становятся слишком "толстыми", повторяющийся код должен быть вынесен в сервисы.
+
+```JavaScript
+myModule.service('Developer', function () {
+ this.name = 'Foo';
+ this.motherLanguage = 'JavaScript';
+ this.live = function () {
+ while (true) {
+ this.code();
+ }
+ };
+});
+```
+
+Сервисы могут быть добавлены в любой компонент, который поддерживает DI (контроллеры, фильтры, директивы, другие сервисы):
+
+```JavaScript
+function MyCtrl(Developer) {
+ var developer = new Developer();
+ developer.live();
+}
+```
+
+## Паттерны AngularJS
+
+В двух последующих разделах, мы рассмотрим как традиционное проектирование и архитектурные шаблоны используются в компонентах AngularJS.
+
+В последней главе мы рассмотрим некоторые архитектурные шаблоны, которые часто используются при разработке SPA (и не только) на AngularJS.
+
+### Services
+
+#### Singleton
+
+>Singleton (одиночка) - шаблон проектирования, который ограничивает создание экземпляра класса одним объектом. Это полезно когда необходимо координировать действия во всей системе. Концепция подходит для систем, которые функционируют более эффективно, когда существует только один объект или когда экземпляры ограничены некоторым количеством объектов.
+
+UML диаграмма иллюстрирует шаблон singleton:
+
+
+
+Когда какому любо компоненту требуется зависимость, AngularJS разрешает ее используя следующий алгоритм:
+
+- Берет имя зависимости и делает поиск в хеш-карте, которая определяется в лексическом замыкании. (поэтому она имеет приватную область видимости).
+- Если зависимость найдена AngularJS передает ее как параметр компонента.
+- >Если зависимость не найдена:
+ - AngularJS создает ее при помощи вызова фабричного метода или его провайдера (т. е. $get). Обратите внимание, что создание зависимости может потребовать рекурсивный вызов по тому же алгоритму для определения всех зависимостей данной зависимости. Этот процесс может привести к циклической зависимости.
+ - AngularJS кеширует ее внутри хеш-карты упомянутой выше.
+ - AngularJS передает ее в качестве параметра компонента, для которого она указана.
+
+Лучше взгляните на исходный код AngularJS, который реализует getService:
+
+```JavaScript
+function getService(serviceName) {
+ if (cache.hasOwnProperty(serviceName)) {
+ if (cache[serviceName] === INSTANTIATING) {
+ throw $injectorMinErr('cdep', 'Circular dependency found: {0}', path.join(' <- '));
+ }
+ return cache[serviceName];
+ } else {
+ try {
+ path.unshift(serviceName);
+ cache[serviceName] = INSTANTIATING;
+ return cache[serviceName] = factory(serviceName);
+ } catch (err) {
+ if (cache[serviceName] === INSTANTIATING) {
+ delete cache[serviceName];
+ }
+ throw err;
+ } finally {
+ path.shift();
+ }
+ }
+}
+```
+
+Представьте, что каждый service это singleton, потому что service создается только один раз. Кэш можно рассматривать, как менеджера singleton. Так же эта реализация немного отличается от той, что представлена в UML диаграмме, потому что вместо создания статической приватной ссылки на singleton внутри его конструктора, мы сохраняем ссылку внутри менеджера singleton.
+
+Таким образом, service это фактически singleton, но реализован не через шаблон singleton, тем самым обеспечивая некоторые преимущества по сравнению со стандартной реализацией:
+
+- улучшает тестируемость кода
+- можно управлять созданием объектов singleton (В данном случае IoC контейнер контролирует создание объектов используя ленивые вызовы.)
+
+Для более детального рассмотрения данной темы можете ознакомиться со статьей Misko Hevery's в блоге Google Testing.
+
+#### Factory Method
+
+>Factory Method (Фабричный метод так же известен как Виртуальный конструктор (англ. Virtual Constructor)) — порождающий шаблон проектирования, предоставляющий подклассам интерфейс для создания экземпляров некоторого класса. В момент создания наследники могут определить, какой класс создавать. Иными словами, Фабрика делегирует создание объектов наследникам родительского класса. Это позволяет использовать в коде программы не специфические классы, а манипулировать абстрактными объектами на более высоком уровне.
+
+
+
+Давайте рассмотрим следующий фрагмент:
+
+```JavaScript
+myModule.config(function ($provide) {
+ $provide.provider('foo', function () {
+ var baz = 42;
+ return {
+ //Factory method
+ $get: function (bar) {
+ var baz = bar.baz();
+ return {
+ baz: baz
+ };
+ }
+ };
+ });
+});
+
+```
+
+Здесь для определения нового "provider" используется функция обратного вызова config. "Provider" это объект с методом $get. Поскольку в JavaScript нет интерфейсов и язык использует "утиную" типизацию, то договорились фабричный метод в "provider" называть $get.
+
+Каждый service, filter, directive и controller имеют provider (т. е объект, который имеет фабричный метод $get), он отвечает за создание экземпляров компонента.
+
+Мы можем копнуть немного глубже в реализацию AngularJS:
+
+```JavaScript
+//...
+
+createInternalInjector(instanceCache, function(servicename) {
+ var provider = providerInjector.get(servicename + providerSuffix);
+ return instanceInjector.invoke(provider.$get, provider, undefined, servicename);
+}, strictDi));
+
+//...
+
+function invoke(fn, self, locals, serviceName){
+ if (typeof locals === 'string') {
+ serviceName = locals;
+ locals = null;
+ }
+
+ var args = [],
+ $inject = annotate(fn, strictDi, serviceName),
+ length, i,
+ key;
+
+ for(i = 0, length = $inject.length; i < length; i++) {
+ key = $inject[i];
+ if (typeof key !== 'string') {
+ throw $injectorMinErr('itkn',
+ 'Incorrect injection token! Expected service name as string, got {0}', key);
+ }
+ args.push(
+ locals && locals.hasOwnProperty(key)
+ ? locals[key]
+ : getService(key)
+ );
+ }
+ if (!fn.$inject) {
+ // this means that we must be an array.
+ fn = fn[length];
+ }
+
+ return fn.apply(self, args);
+}
+```
+
+В примере вы можете видеть как в действительности используется метод $get:
+
+```JavaScript
+instanceInjector.invoke(provider.$get, provider, undefined, servicename)
+```
+
+В фрагменте выше вызывается метод invoke и ему в качестве первого аргумента передается фабричным метод ($get) сервиса. Внутри метода invoke вызывается функция annotate, которой в качестве первого аргумента так же передается фабричный метод. Функция annotate разрешает все зависимости, через механизм DI AngularJS (рассматривался выше). После разрешения всех зависимостей, вызывается фабричный метод:
+
+Если рассуждать в терминах описанной выше UML диаграммы, то мы можем вызвать Creator, который через фабричный метод вызовет "ConcreteCreator" который создаст "Product".
+
+В данном случае мы получаем некоторые преимущества используя шаблон фабричный метод, потому что используется косвенное создание экземпляров. Таким образом фреймворк влияет на макеты/шаблоны создания новых компонентов, потому что:
+
+- это наиболее подходящий момент, когда нужно создать компонент
+- разрешить все зависимости компонента
+- управлять количеством разрешенных экземпляров компонента (для service и filter один, но много для controller)
+
+#### Decorator
+
+>Decorator (Декоратор) — структурный шаблон проектирования, предназначенный для динамического добавления дополнительного поведения к объекту. Шаблон Декоратор предоставляет гибкую альтернативу создания подклассов с целью расширения функциональности.
+
+
+
+AngularJS из коробки предоставляет возможности для расширения и/или повышения функциональности уже существующих service' ов. Используя метод decorator или $provide вы можете создать обертку для любого service, уже определенного вами или из сторонней библиотеки:
+
+```JavaScript
+myModule.controller('MainCtrl', function (foo) {
+ foo.bar();
+});
+
+myModule.factory('foo', function () {
+ return {
+ bar: function () {
+ console.log('I\'m bar');
+ },
+ baz: function () {
+ console.log('I\'m baz');
+ }
+ };
+});
+
+myModule.config(function ($provide) {
+ $provide.decorator('foo', function ($delegate) {
+ var barBackup = $delegate.bar;
+ $delegate.bar = function () {
+ console.log('Decorated');
+ barBackup.apply($delegate, arguments);
+ };
+ return $delegate;
+ });
+});
+```
+Приведенный выше пример определяет новый service с именем "foo". В функции обратного вызова "config" вызывается метод $provide.decorator и ему в качестве первого аргумента передается имя service, который мы хотим декорировать, вторым аргументом передается функция, она собственно и реализует декоратор. $delegate хранит ссылку на оригинальный service foo. Мы декорируем service переопределяя его метод bar. Фактически декорирование просто расширение bar, путем включения еще одного состояния console.log - console.log('Decorated') и после чего вызываем оригинальный метод bar в соответствующем контексте.
+
+Использование шаблона особенно полезно, когда нам нужно, изменить функциональность service созданных третьими лицами. В тех случаях, когда необходимы многочисленные декораторы (например, при измерении производительности методов, авторизации, регистрации и т.д.) может получиться много дублируемого кода и нарушение принципа DRY. В таких случаях целесообразно использовать аспектно-ориентированое программирование. АОП фреймворк для AngularJS можно найти на github.com/mgechev/angular-aop.
+
+#### Facade
+
+>Шаблон Facade (фасад) — структурный шаблон проектирования, позволяющий скрыть сложность системы путем сведения всех возможных внешних вызовов к одному объекту, делегирующему их соответствующим объектам системы.
+Facade может:
+
+>1. Сделать более легким использование библиотек, понимание и тестирование, так как facade имеет более подходящие методы для выполнения общих задач
+
+>2. Cделать библиотеку более читабельной, по той же причине
+
+>3. Уменьшить зависимость внутренних библиотек от внешнего кода, поскольку большая часть кода использует facade, это позволяет разрабатывать систему более гибко
+
+>4. Обернуть плохо спроектированную коллекцию API-интерфейсов, одной хорошо спроектированной (в соответствии с потребностями задачи)
+
+
+
+В AngularJS есть несколько facade' ов. Каждый раз когда вы хотите предоставить высокоуровневый API для некоторой функциональности, вы практически создаете фасад.
+
+К примеру, давайте посмотрим как мы можем создать XMLHttpRequest POST запрос:
+
+```JavaScript
+var http = new XMLHttpRequest(),
+ url = '/example/new',
+ params = encodeURIComponent(data);
+http.open("POST", url, true);
+
+http.setRequestHeader("Content-type", "application/x-www-form-urlencoded");
+http.setRequestHeader("Content-length", params.length);
+http.setRequestHeader("Connection", "close");
+
+http.onreadystatechange = function () {
+ if(http.readyState == 4 && http.status == 200) {
+ alert(http.responseText);
+ }
+}
+http.send(params);
+```
+Если мы хотим отправить данные используя AngularJS $http сервис, мы можем:
+
+```JavaScript
+$http({
+ method: 'POST',
+ url: '/example/new',
+ data: data
+})
+.then(function (response) {
+ alert(response);
+});
+```
+или даже:
+
+```JavaScript
+$http.post('/someUrl', data)
+.then(function (response) {
+ alert(response);
+});
+```
+Второй вариант представляет предварительно настроенную версию, которая создает HTTP POST запрос.
+
+Третий вариант, это высокоуровневая абстракция созданная с помощью $resource service и построена поверх $http service. Мы еще раз рассмотрим этот service в разделах Active Record и Proxy.
+
+#### Proxy
+
+>Proxy (Заместитель) — структурный шаблон проектирования, предоставляет объект, который контролирует доступ к другому объекту, перехватывая все вызовы (выполняет функцию контейнера). Proxy может взаимодействовать с чем угодно: сетевым соединением, большим объектом в памяти, файлом или другими ресурсами, которые дорого или невозможно копировать.
+
+
+
+Мы можем различать три типа прокси:
+
+- Virtual Proxy
+- Remote Proxy
+- Protection Proxy
+
+В этом подразделе мы рассмотрим реализованный в AngularJS Virtual Proxy.
+
+В фрагменте ниже, мы вызываем метод get объекта $resource с именем User:
+
+```JavaScript
+var User = $resource('/users/:id'),
+ user = User.get({ id: 42 });
+console.log(user); //{}
+```
+
+console.log выведет пустой объект. Так как AJAX запрос выполнится асинхронно после вызова User.get, и во время вызова console.log у нас не будет данных пользователя. Сразу после вызова User.get, выполняется GET запрос, он возвращает пустой объект и сохраняет ссылку на него. Мы можем представить себе этот объект как virtual proxy, он будет заполнен данными как только клиент получит ответ от сервера.
+
+Как это работает в AngularJS? Давайте рассмотрим следующий фрагмент:
+
+```JavaScript
+function MainCtrl($scope, $resource) {
+ var User = $resource('/users/:id'),
+ $scope.user = User.get({ id: 42 });
+}
+```
+
+```html
+
+```
+После выполнения фрагмента кода, показанного выше, свойство user объекта $scope будет пустым объектом ({}), это означает, что user.name будет undefined и не будет отображено. После того как сервер вернет ответ для GET запроса, AngularJS заполнит этот объект данными, полученными с сервера. В течении следующего $digest цикла, AngularJS обнаружит изменения в $scope.user и это приведет к обновлению представления.
+
+#### Active Record
+
+>Active Record – это объект, который хранит данные и поведение. Обычно большинство данных в этом объекте постоянны, обязанность объекта Active Record заботиться о связи с базой данных для создания, обновления, поиска и удаления данных. Он может делегировать эту ответственность на объекты более низкого уровня, но вызов объекта Active Record или его статических методов, приведет к взаимодействию с БД.
+
+
+
+В AngularJS определен service $resource. В текущей версии AngularJS (1,2+) он распространяется отдельным модулем и не включен в ядро.
+В соответствии с документацией $resource:
+
+>$resource - это фабрика для создания объектов $resource, которые позволяют взаимодействовать с RESTfull источниками данных на стороне сервера. Объект $resource имеет методы, которые предоставляют высокоуровневое поведение, без необходимости взаимодействовать с низкоуровневым service' ом $http.
+
+Здесь показано, как можно использовать $resource:
+
+```JavaScript
+var User = $resource('/users/:id'),
+ user = new User({
+ name: 'foo',
+ age : 42
+ });
+
+user.$save();
+```
+
+Вызов $resource создает конструктор для экземпляров нашей модели. Каждый из экземпляров модели будет иметь методы, которые могут быть использованы для различных операций CRUD.
+
+Таким образом мы можем использовать функцию конструктор и его статические методы:
+
+```JavaScript
+User.get({ userid: userid });
+```
+
+Код выше будет сразу возвращать пустой объект и сохранять ссылку на него. После того, как будет получен и проанализирован ответ, AngularJS заполнит объект полученными данными (см. proxy).
+Вы можете найти более детальную документацию по "магии" объекта $resource и AngularJS.
+Так Мартин Фаулер утверждает что:
+
+>Объект Active Record должен заботиться о связи с БД, для того что бы создавать…
+$resource не реализует полного шаблона Active Record, так как он взаимодействует с RESTful сервисом вместо БД. Во всяком случае мы можем рассматривать его как "Active Record для взаимодействия с RESTful".
+
+#### Intercepting Filters
+
+>Создает цепочку фильтров для выполнения простых задач пред/пост обработки запросов.
+
+
+
+В некоторых случаях вам нужно будет сделать какую либо пред/пост обработку HTTP запросов. В данном случае Intercepting Filters предназначены для пред/пост обработки HTTP запросов/ответов, для ведения журнала, безопасности или любой другой задачи, которой необходимо тело или заголовок запроса. Обычно шаблон Intercepting Filters включает цепочку фильтров, каждый из которых обрабатывает данные в определенном порядке. Выход каждого фильтра является входом для следующего.
+
+В AngularJS мы имеем представление о Intercepting Filters в $httpProvider. $httpProvider имеет свойство interceptors (перехватчики), оно включает список объектов. У каждого объекта есть свойства: request, response, requestError, responseError.
+
+requestError вызывается если в предыдущем перехватчике произошла ошибка или он был отклонен, соответственно responseError вызывается, когда предыдущий перехватчик ответа возбудил исключение.
+
+Ниже базовый пример, как вы можете добавить перехватчики используя литерал объекта:
+
+```JavaScript
+$httpProvider.interceptors.push(function($q, dependency1, dependency2) {
+ return {
+ 'request': function(config) {
+ // same as above
+ },
+ 'response': function(response) {
+ // same as above
+ }
+ };
+});
+```
+
+### Directives
+
+#### Composite
+
+>Шаблон composite (компоновщик) – структурный шаблон проектирования. Шаблон composite описывает, как группировать объекты, что бы к ним можно было обращаться, так же как к одному объекту. Цель composite составить объекты в древовидную структуру, для представления иерархии от частного к целому.
+
+
+
+Согласно "Банде четырех", MVC ни что иное как сочетание:
+
+- Strategy
+- Composite
+- Observer
+
+Они утверждают что представление является композицией компонентов. В AngularJS аналогичная ситуация. Представления формируются композицией директив и элементов DOM, на которых эти директивы построены.
+
+Давайте посмотрим на следующий пример:
+
+```HTML
+
+
+
+
+
+
+ Zippy!
+
+
+
+```
+
+```JavaScript
+myModule.directive('zippy', function () {
+ return {
+ restrict: 'E',
+ template: '
',
+ link: function (scope, el) {
+ el.find('.header').click(function () {
+ el.find('.content').toggle();
+ });
+ }
+ }
+});
+```
+
+В этом примере создается директива, которая является компонентом пользовательского интерфейса. Созданный компонент (с именем “zippy”) имеет заголовок и содержание. При нажатии на его заголовок переключается видимость его содержимого.
+
+Из первого примера мы можем заметить, что дерево DOM это композиция элементов. Корневой компонент это html, сразу же за ним следуют вложенные элементы head, body и так далее…
+
+Во втором примере, мы видим, что свойство директивы template содержит разметку с директивой ng-transclude. Это означает, что внутри директивы “zippy” может быть еще одна директива ng-transclude т. е. композиция директив. Теоретически мы можем делать бесконечную вложенность компонентов пока не достигнем конечного узла.
+
+#### Interpreter
+
+>Interpreter (интерпретатор) – поведенческий шаблон проектирования, указывает, как определять выражения в языке. Основная идея, классифицировать каждый символ (терминальный или не терминальный) в специализированном языке программирования. Синтаксическое дерево (пример шаблона композиция) выражений используется для анализа (интерпретирования) выражения.
+
+
+
+С помощью $parse, AngularJS предоставляет свою собственную реализацию интерпретатора DSL (Domain Specific Language). Использование DSL упрощает и изменяет JavaScript. Основная разница между AngularJS и JavaScript выражениях в том что AngularJS выражения:
+
+- могут включать фильтры с UNIX подобным синтаксисом
+- не возбуждают никаких исключений
+- не имеют никакого управления потоком состояния (исключения, циклы, условия так же могут использовать тернарный оператор)
+- выполняются в полученном контексте (контекст текущего $scope)
+
+Внутри $parse определены два основных компонента:
+
+```JavaScript
+//Responsible for converting given string into tokens
+var Lexer;
+//Responsible for parsing the tokens and evaluating the expression
+var Parser;
+```
+
+При получении выражения, оно разбивается на лексемы и кэшируется (из-за проблем с производительностью).
+
+Терминальные выражения в AngularJS DSL определены следующим образом:
+
+```JavaScript
+var OPERATORS = {
+ /* jshint bitwise : false */
+ 'null':function(){return null;},
+ 'true':function(){return true;},
+ 'false':function(){return false;},
+ undefined:noop,
+ '+':function(self, locals, a,b){
+ //...
+ },
+ '*':function(self, locals, a,b){return a(self, locals)*b(self, locals);},
+ '/':function(self, locals, a,b){return a(self, locals)/b(self, locals);},
+ '%':function(self, locals, a,b){return a(self, locals)%b(self, locals);},
+ '^':function(self, locals, a,b){return a(self, locals)^b(self, locals);},
+ '=':noop,
+ '===':function(self, locals, a, b){return a(self, locals)===b(self, locals);},
+ '!==':function(self, locals, a, b){return a(self, locals)!==b(self, locals);},
+ '==':function(self, locals, a,b){return a(self, locals)==b(self, locals);},
+ '!=':function(self, locals, a,b){return a(self, locals)!=b(self, locals);},
+ '<':function(self, locals, a,b){return a(self, locals)':function(self, locals, a,b){return a(self, locals)>b(self, locals);},
+ '<=':function(self, locals, a,b){return a(self, locals)<=b(self, locals);},
+ '>=':function(self, locals, a,b){return a(self, locals)>=b(self, locals);},
+ '&&':function(self, locals, a,b){return a(self, locals)&&b(self, locals);},
+ '||':function(self, locals, a,b){return a(self, locals)||b(self, locals);},
+ '&':function(self, locals, a,b){return a(self, locals)&b(self, locals);},
+ '|':function(self, locals, a,b){return b(self, locals)(self, locals, a(self, locals));},
+ '!':function(self, locals, a){return !a(self, locals);}
+};
+```
+
+Каждую функцию связанную с каждым терминальным символом, можно представить как реализацию интерфейса AbstractExpression (абстрактных выражений).
+
+Клиент интерпретирует полученное выражение в определенном контексте – определенного $scope.
+
+Несколько простых выражений AngularJS:
+
+```JavaScript
+// toUpperCase filter is applied to the result of the expression
+// (foo) ? bar : baz
+(foo) ? bar : baz | toUpperCase
+```
+
+#### Template View
+
+> Преобразует данные в HTML путем встраивания маркеров в HTML страницу.
+
+
+
+The dynamic page rendering is not that trivial thing. It is connected with a lot of string concatenations, manipulations and frustration. Far easier way to build your dynamic page is to write your markup and embed little expressions inside it, which are lately evaluated in given context and so the whole template is being compiled to its end format. In our case this format is going to be HTML (or even DOM). This is exactly what the template engines do - they take given DSL, evaluate it in the appropriate context and then turn it into its end format.
+
+Динамическое отображение страницы не такая простая задача. Это связано с большим количеством конкатенации строк, манипуляций и проблем. Наиболее простой способ построить динамическую страницу - это написать свою разметку и включить в нее несколько выражений, которые будут обработаны в определенном контексте, в результате весь шаблон будет преобразован в конечный формат. В нашем случае этим форматом будет HTML (или даже DOM). Это именно то что делают шаблонизаторы – они получают DSL, обрабатывают его в соответствующем контексте и затем преобразуют в конечный формат.
+
+Шаблоны очень часто используются на back-end. Например вы можете вставлять PHP код внутри HTML и создавать динамические страницы, так же вы можете использовать Smarty или eRuby в Ruby, чтобы вставлять Ruby код в статические страницы.
+
+В JavaScript есть много шаблонизаторов, таких как mustache.js, handlebars и т.д. Большинство из них работают с шаблоном как со строкой. Шаблон может храниться различными способами:
+
+- статический файл, который будет получен AJAX’ом
+- скрипт встроенный внутри вашего представления
+- строка внутри вашего JavaScript кода
+
+К примеру:
+
+```html
+
+```
+
+Шаблонизатор превращает строку в элементы DOM, путем объединения ее с полученным контекстом. Таким образом все встроенные в разметку выражения анализируются и заменяются их значениями.
+
+Например, если мы обработаем шаблон показанный выше в контексте объекта: { names: ['foo', 'bar', 'baz'] } то получим:
+
+```html
+
Names
+ foo
+ bar
+ baz
+```
+
+На самом деле шаблоны в AngularJS это обычный HTML. Они не находятся в промежуточном формате, как большинство шаблонов. Что делает AngularJS компилятор, что бы обойти дерево DOM и найти уже известные директивы (элементы, атрибуты, классы или даже комментарии) ? Когда AngularJS находит любую из этих директив он вызывает логику связанную с ней, она может включать определение различных выражений в контексте текущего $scope.
+
+К примеру:
+
+
+```html
+
+
{{name}}
+
+```
+
+В контексте scope:
+
+```javascript
+$scope.names = ['foo', 'bar', 'baz'];
+```
+
+Будет получен тот же результат что и выше. Главное отличие в том, что шаблон расположен не внутри тега script, здесь это просто HTML.
+
+
+### Scope
+
+#### Observer
+
+>Шаблон observer (наблюдатель) – поведенческий шаблон проектирования, в котором объект называемый субъектом, хранит список своих зависимостей, которые называются наблюдателями и уведомляет их при каких либо изменениях состояния, обычно вызовом одного из их методов. В основном используется для реализации распределенных систем обработки событий.
+
+
+
+В приложениях AngularJS есть два основных способа взаимодействия между scope.
+
+Первый, вызов методов родительского scope из дочернего scope. Это возможно, потому что дочерний scope наследует прототип своего родителя, как упоминалось выше (смотреть Scope). Это позволяет осуществлять одностороннее взаимодействие от ребенка к родителю. Иногда необходимо вызвать метод дочернего scope или уведомить его о возникновении события в родительском scope. AngularJS предоставляет встроенный шаблон наблюдатель, который позволяет делать это.
+
+Второй возможный вариант использования шаблона observer, когда несколько scope подписаны на события, но scope в котором оно возникает ничего о нем не знает. Это позволяет уменьшить связанность scope' ов, они не должны ничего знать о других scope.
+
+Каждый scope в AngularJS имеет публичные методы $on, $emit и $broadcast. Метод $on в качестве аргументов принимает имя события и функцию обратного вызова. Эту функцию можно представить как наблюдателя – объект который реализует интерфейс observer (В JavaScript все функции первого класса, поэтому мы можем обеспечить только реализацию метода уведомления).
+
+```JavaScript
+function ExampleCtrl($scope) {
+ $scope.$on('event-name', function handler() {
+ //body
+ });
+}
+```
+
+Таким образом текущий scope подписывается на событие "event-name". Когда оно возникнет в любом из родительских или дочерних scope, будет вызван обработчик.
+
+Методы $emit и $broadcast используются для запуска событий, соответственно вверх и вниз по цепочке наследования.
+
+К примеру:
+
+```JavaScript
+function ExampleCtrl($scope) {
+ $scope.$emit('event-name', { foo: 'bar' });
+}
+```
+
+В примере выше scope генерирует событие "event-name" вверх для всех scope. Это значит что каждый родительский scope, который подписан на событие "event-name", будет уведомлен и его обработчик будет вызван.
+
+Тоже самое происходит когда вызывается метод $broadcast. Разница лишь в том, что событие будет передаваться вниз – для всех дочерних scope. Каждый scope может подписаться на любое событие с несколькими функциями обратного вызова (т. е. он может связать несколько наблюдателей с данным событием).
+
+В JavaScript сообществе этот шаблон более известен как публикация/подписка.
+
+For a best practice example see [Observer Pattern as an External Service](#observer-pattern-as-an-external-service)
+
+#### Chain of Responsibilities
+
+>Chain of Responsibilities (цепочка обязанностей) – поведенческий шаблон проектирования, состоит из объекта команды и последовательности обрабатывающих объектов (обработчиков). Каждый обработчик содержит логику, определяющую тип команды, которую он может обработать. Затем команда поступают к следующему обработчику в цепочке. Шаблон так же содержит механизм для добавления новых обработчиков в конец этой цепочки.
+
+
+
+Как показано выше, scope образует иерархию, известную как цепочка scope. Некоторые из этих scope изолированы, это значит, что они не наследуют прототипы своих родительских scope, но связаны с ним через его свойство $parent.
+
+После вызова $emit или $broadcast возникает событие, которое начинает движение (вниз или вверх в зависимости от вызванного метода) по цепочке scope, ее можно представить как шину событий или точнее как цепочку обязанностей. Каждый последующий scope может:
+
+- Обработать событие и передать его следующему scope в цепочке
+- Обработать событие и остановить его распространение
+- Пропустить событие к следующему scope в цепочке, без его обработки
+- Остановить распространение события без его обработки
+
+В примере ниже, ChildCtrl генерирует событие, которое распространяется вверх по цепочке scope. Здесь каждый родительский scope (ParentCtrl и MainCtrl) должны обработать событие записав в консоль: "foo received". Если какой нибудь из scope должен быть конечным получателем, он может вызвать метод stopPropagation в объекте события.
+
+```JavaScript
+myModule.controller('MainCtrl', function ($scope) {
+ $scope.$on('foo', function () {
+ console.log('foo received');
+ });
+});
+
+myModule.controller('ParentCtrl', function ($scope) {
+ $scope.$on('foo', function (e) {
+ console.log('foo received');
+ });
+});
+
+myModule.controller('ChildCtrl', function ($scope) {
+ $scope.$emit('foo');
+});
+```
+
+Обработчики в показанной выше UML диаграмме, являются различными scope, добавленными в контроллер.
+
+#### Command
+
+>Command - поведенческий шаблон проектирования, в котором объект используется для инкапсуляции всей необходимой информации и вызова метода через некоторое время. Эта информация включает имя метода, объект которому принадлежит метод и значения параметров метода.
+
+
+
+В AngularJS шаблон Command позволяет описать реализацию связывания данных (data binding).
+
+Когда мы хотим связать нашу модель с представлением мы можем использовать директиву ng-bind (для одностороннего связывания данных) и ng-model (для двустороннего связывания данных). К примеру, если мы хотим, что бы каждое изменение модели отображалось в представлении:
+
+```html
+
+```
+
+Теперь каждый раз когда мы изменяем значение foo, текст внутри тега span тоже будет изменен. Также можно использовать более сложные выражения:
+
+```html
+
+```
+
+В примере выше значением тега span будет сумма значений foo и bar в верхнем регистре. Что происходит внутри ?
+В каждом scope есть метод $watch. Когда компилятор AngularJS находит директиву ng-bind, он создает нового наблюдателя для выражения foo + ' ' + bar | uppercase, ($scope.$watch("foo + ' ' + bar | uppercase", function () { /* body */ });). Функция обратного вызова будет вызвана каждый раз когда изменяется значение выражения. В данном случае функция обратного вызова будет обновлять значение тега span.
+
+Вот несколько первых строк реализации $watch:
+
+```javascript
+$watch: function(watchExp, listener, objectEquality) {
+ var scope = this,
+ get = compileToFn(watchExp, 'watch'),
+ array = scope.$$watchers,
+ watcher = {
+ fn: listener,
+ last: initWatchVal,
+ get: get,
+ exp: watchExp,
+ eq: !!objectEquality
+ };
+//...
+```
+
+Мы можем представить watcher как Command. Выражение Command будет вычисляться в каждом цикле "$digest". Как только AngularJS обнаружит изменение выражения, он вызовет функцию слушателя. Watcher включает всю необходимую информацию для наблюдения и делегирования выполнение команды слушателю (фактическому получателю). Мы можем представить $scope как Client и цикл $digest как Invoker команд.
+
+### Controllers
+
+#### Page Controller
+
+>Объект, который обрабатывает запросы определенной страницы или действия на сайте. Мартин Фаулер.
+
+
+
+Согласно [4](#Ссылки) контроллерами на страницу:
+
+>Шаблон контроллер страницы допускает ввод данных с полученной страницы, выполнение запрошенных действий для модели и определяет правильное представление для результирующей страницы. Разделение диспетчерской логики от остального кода представления.
+
+Из-за большого количества дублируемого кода на страницах (к примеру футеры, хедеры, код заботящийся о сессии пользователя) контроллеры могут образовывать иерархию. В AngularJS есть контроллеры, которые ограничены scope. Они не принимают запросы пользователей, так как это ответственность $route или $state, а за отображение отвечают директивы ng-view/ui-view.
+
+Так же как в контроллерах страницы, контроллеры AngularJS отвечают за взаимодействие с пользователем, обеспечивая обновление моделей. Эти модели после добавления в scope не защищены от просмотра, все методы включенные в представление в итоге становятся действиями пользователя (методы scope). Другое сходство между контроллерами страниц и AngularJS контроллерами – это иерархия, которую они образуют. Этому соответствует иерархия scope видимости. Таким образом простыми действиями мы можем изолировать базовые контроллеры.
+
+Контроллеры AngularJS очень похожи на ASP.NET WebForms, так как их обязанности практически одинаковы. Вот пример иерархии между несколькими контроллерами:
+
+```HTML
+
+
+
+
+
+
+ {{user.name}}
+
+
+
+
+```
+
+```JavaScript
+function MainCtrl($scope, $location, User) {
+ if (!User.isAuthenticated()) {
+ $location.path('/unauthenticated');
+ }
+}
+
+function ChildCtrl($scope, User) {
+ $scope.click = function () {
+ alert('You clicked me!');
+ };
+ $scope.user = User.get(0);
+}
+```
+
+Этот пример иллюстрирует самый простой способ повторного использования логики с помощью базового контроллера, но в любом случае в "production" приложениях не рекомендуется помещать логику авторизации в контроллеры. Доступ к различным маршрутам можно определить на более высоком уровне абстракции.
+
+ChildCtr отвечает за отображение модели в представлении и обработку действий, таких как нажатие на кнопку с названием «Click».
+
+### Others
+
+#### Module Pattern
+
+На самом деле это не шаблон проектирования от "банды четырех" и даже ни один из "Patterns of Enterprise Application Architecture". Это традиционный JavaScript шаблон проектирования, целью которого является обеспечение инкапсуляции.
+Используя шаблон модуль вы можете получить приватность данных на основе функционально-лексической области видимости. Каждый модуль может иметь ноль и более приватных методов, которые скрыты в локальной области видимости.
+
+Эта функция возвращает объект, который предоставляет публичный API для данного модуля:
+
+```javascript
+var Page = (function () {
+
+ var title;
+
+ function setTitle(t) {
+ document.title = t;
+ title = t;
+ }
+
+ function getTitle() {
+ return title;
+ }
+
+ return {
+ setTitle: setTitle,
+ getTitle: getTitle
+ };
+}());
+```
+
+В примере выше IIFE (Immediately-Invoked Function Expression - выражение немедленно вызванной функции), которая после вызова возвращает объект, с двумя методами (setTitle и getTitle). Возвращенный объект присвоен переменной Page. В таком случае пользователь объекта Page не имеет прямого доступа к переменной title, которая определена внутри локальной области видимости IIFE.
+
+Шаблон модуль очень полезен при определении service в AngularJS. Используя этот шаблон мы можем достичь (и на самом деле достигаем) приватности:
+
+```javascript
+app.factory('foo', function () {
+
+ function privateMember() {
+ //body...
+ }
+
+ function publicMember() {
+ //body...
+ privateMember();
+ //body
+ }
+
+ return {
+ publicMember: publicMember
+ };
+});
+```
+
+После того как мы добавим foo в любой другой компонент, у нас не будет возможности использовать приватные методы, только публичные. Это решение является довольно мощным, особенно, когда мы создаем библиотеки для повторного использования.
+
+#### Data Mapper
+
+>Шаблон Data Mapper – это слой доступа к данным, который выполняет двунаправленную передачу данных между постоянным хранилищем данных (часто это реляционная БД) и данными в памяти. Цель этого шаблона – хранить в памяти представление постоянных данных, независимо друг от друга и от себя самого.
+
+
+
+Как уже говорилось Data Mapper используется для двунаправленной передачи данных между постоянным хранилищем данных и данными в памяти. Обычно AngularJS приложение взаимодействует с API сервера, которое написано на любом серверном языке (Ruby, PHP, Java, JavaScript и т.д.).
+
+Если у нас есть RESTful API, service $resource поможет нам взаимодействовать с сервером в Active Record подобном стиле. Хотя некоторые приложения возвращают данные с сервера не в самом подходящем формате, который мы хотим использовать на front-end.
+
+Давайте предположим что в нашем приложении, у каждого пользователя есть:
+
+- name
+- address
+- list of friends
+
+И API у которого есть следующие методы:
+
+- `GET /user/:id` - возвращает имя и адрес полученного пользователя
+- `GET /friends/:id` - возвращает список друзей данного пользователя
+
+Одно из решений, использовать два различных service, один для первого метода и другой для второго. Возможно более подходящим решением будет, использование одного service, который называется User, он загружает друзей пользователя, когда мы запрашиваем User:
+
+```javascript
+app.factory('User', function ($q) {
+
+ function User(name, address, friends) {
+ this.name = name;
+ this.address = address;
+ this.friends = friends;
+ }
+
+ User.get = function (params) {
+ var user = $http.get('/user/' + params.id),
+ friends = $http.get('/friends/' + params.id);
+ $q.all([user, friends])
+ .then(function (user, friends) {
+ return new User(user.name, user.address, friends);
+ });
+ };
+ return User;
+});
+```
+
+Таким образом мы создали псевдо Data Mapper, который адаптируется к нашему API в соответствии с требованиями SPA.
+
+Мы можем использовать User следующим образом:
+
+```javascript
+function MainCtrl($scope, User) {
+ User.get({ id: 1 })
+ .then(function (data) {
+ $scope.user = data;
+ });
+}
+```
+
+И соответствующий шаблон:
+
+```html
+
+
+ Name: {{user.name}}
+
+
+ Address: {{user.address}}
+
+
+ Friends with ids:
+
+
{{friend}}
+
+
+
+```
+
+#### Шаблон Observer как внешний сервис
+
+##### Описание
+
+Пример ниже взят отсюда [here](https://github.com/greglbd/angular-observer-pattern). Здесь фабрика создает сервис, который реализует шаблон Observer.
+Этот шаблон хорошо работает при использовании синтаксиса ControllerAs и может быть более эффективным чем `$scope.$watch`, так же Observer будет более специфичным для конкретного scope или объекта, когда они правильно используют $emit and $broadcast
+
+**Вариант использования:** Вы можете использовать этот шаблон для взаимодействия двух контроллеров, которые обращаются к одной модели, но не подключены друг к другу.
+
+##### Пример контроллера
+
+Пример ниже показывает как подписаться, сгенерировать и отписаться от события.
+
+```javascript
+angular.module('app.controllers')
+ .controller('ObserverExample', ObserverExample);
+ObserverExample.$inject= ['ObserverService', '$timeout'];
+
+function ObserverExample(ObserverService, $timeout) {
+ var vm = this;
+ var id = 'vm1';
+
+ ObserverService.attach(callbackFunction, 'let_me_know', id)
+
+ function callbackFunction(params){
+ console.log('now i know');
+ ObserverService.detachByEvent('let_me_know')
+ }
+
+ $timeout(function(){
+ ObserverService.notify('let_me_know');
+ }, 5000);
+}
+```
+Еще один способ удалить событие
+
+```javascript
+angular.module('app.controllers')
+ .controller('ObserverExample', ObserverExample);
+ObserverExample.$inject= ['ObserverService', '$timeout', '$scope'];
+
+function ObserverExample(ObserverService, $timeout, $scope) {
+ var vm = this;
+ var id = 'vm1';
+ ObserverService.attach(callbackFunction, 'let_me_know', id)
+
+ function callbackFunction(params){
+ console.log('now i know');
+ }
+
+ $timeout(function(){
+ ObserverService.notify('let_me_know');
+ }, 5000);
+
+ // Cleanup listeners when this controller is destroyed
+ $scope.$on('$destroy', function handler() {
+ ObserverService.detachByEvent('let_me_know')
+ });
+}
+```
+
+## Ссылки
+
+1. [Wikipedia](https://en.wikipedia.org/wiki). Краткое описание шаблонов проектирования в Википедии.
+2. [AngularJS' documentation](https://docs.angularjs.org)
+3. [AngularJS' git repository](https://github.com/angular/angular.js)
+4. [Page Controller](http://msdn.microsoft.com/en-us/library/ff649595.aspx)
+5. [Patterns of Enterprise Application Architecture (P of EAA)](http://martinfowler.com/books/eaa.html)
+6. [Using Dependancy Injection to Avoid Singletons](http://googletesting.blogspot.com/2008/05/tott-using-dependancy-injection-to.html)
+7. [Why would one use the Publish/Subscribe pattern (in JS/jQuery)?](https://stackoverflow.com/questions/13512949/why-would-one-use-the-publish-subscribe-pattern-in-js-jquery)
diff --git a/i18n/README-zh-cn.md b/i18n/README-zh-cn.md
new file mode 100644
index 0000000..de9dfc1
--- /dev/null
+++ b/i18n/README-zh-cn.md
@@ -0,0 +1,1685 @@
+# AngularJS 模式
+
+
+
+## 目录
+
+* [译本](#translations)
+* [摘要](#abstract)
+* [介绍](#introduction)
+* [AngularJS 概览](#angularjs-overview)
+ * [Partials](#partials)
+ * [Controllers](#controllers)
+ * [Scope](#scope)
+ * [Directives](#directives)
+ * [Filters](#filters)
+ * [Services](#services)
+* [AngularJS 模式](#angularjs-patterns)
+ * [Services](#services-1)
+ * [单例模式](#singleton)
+ * [工厂方法模式](#factory-method)
+ * [修饰模式](#decorator)
+ * [外观模式](#facade)
+ * [代理模式](#proxy)
+ * [Active Record 模式](#active-record)
+ * [截取筛选器模式](#intercepting-filters)
+ * [Directives](#directives-1)
+ * [组合模式](#composite)
+ * [解释器模式](#interpreter)
+ * [模版视图模式](#template-view)
+ * [Scope](#scope-1)
+ * [观察者模式](#observer)
+ * [责任链模式](#chain-of-responsibilities)
+ * [命令模式](#command)
+ * [Controllers](#controllers-1)
+ * [页面控制器模式](#page-controller)
+ * [其它](#others)
+ * [模块模式](#module-pattern)
+ * [数据映射器模式](#data-mapper)
+ * [观察者模式作为外部服务](#observer-pattern-as-an-external-service)
+* [参考文献](#references)
+
+
+
+## 译本
+
+- [英文原文](https://github.com/mgechev/angularjs-in-patterns/blob/master/README.md) 作者：[mgechev](https://github.com/mgechev)
+- [日文翻译](https://github.com/mgechev/angularjs-in-patterns/blob/master/i18n/README-ja-jp.md) 译者：[morizotter](https://twitter.com/morizotter)
+- [法文翻译](https://github.com/mgechev/angularjs-in-patterns/blob/master/i18n/README-fr-fr.md) 译者：[manekinekko](https://github.com/manekinekko)
+- [俄文翻译](http://habrahabr.ru/post/250149/)
+
+(由于 AngularJS 的组件名称和专有术语通常会被直接用于程序源代码中，此中文版会尽量将此类词汇保留为原有英文，或将其译名放置在注释内，以避免歧义。如果您对本译文有任何改进建议，请提交 Pull Request。)
+
+## 摘要
+
+学习新事物的最好方式之一就是观察其如何运用整合已知的知识。本文将介绍面向对象、设计模式和架构模式的基本概念，而非向读者传授如何熟练使用这些设计或架构模式。本文的主旨是介绍 AngularJS 框架中的各种软件设计和架构模式以及如何在 AngularJS 单页应用中运用它们。
+
+
+## 介绍
+
+本文将首先简要介绍 AngularJS 框架，分析其主要构件 - directive、filter、controller、service 和 scope。第二部分会依照 AngularJS 构件组成顺序，分别列述 AngularJS 框架所实现的各种设计和架构模式，其中会特别注出被多个构件共同使用的模式。
+
+
+在文章最后还会提及一些 AngularJS 单页应用中常用的架构模式。
+
+
+## AngularJS 概览
+
+AngularJS 是由 Google 开发的 JavaScript 框架，其提供了一个用于开发 CRUD 单页应用 (SPA) 的稳健基础。单页应用指的是一旦网页完成加载后，用户进行任何操作都无需重新加载完整的网页。这也意味着所有应用资源 (数据、模版、代码、样式) 都应该预先完成加载，或者更理想的是按需加载。由于大部分 CRUD 应用都包含共通的特质，AngularJS 提供了一套经过优化的现成工具实现来满足此需求。其中重要特质包括：
+
+
+- 双向数据绑定 (two-way data binding)
+- 依赖注入 (dependency injection)
+- 关注点分离 (separation of concerns)
+- 可测试性 (testability)
+- 抽象化 (abstraction)
+
+关注点分离是依靠将 AngularJS 应用划分为相互隔离的构件来实现的，如：
+
+
+- partials (片段)
+- controllers (控制器)
+- directives (指示器)
+- services (服务)
+- filters (筛选器)
+
+这些构件可以在不同的模块中组合，以帮助实现更高层级的抽象化以及处理复杂事件。每个单独构件都会封装应用程序中特定部分的逻辑。
+
+
+### Partials
+
+Partial (模版片段) 实际就是 HTML 字符串，其元素和属性中可能包含一些 AngularJS 表达式。与 mustache.js 和 handlebars 等框架相比，AngularJS 的一个不同之处就是其模版并非是一种需要转化为 HTML 的中间格式。
+
+
+每个单页应用都会在初始化时读取 `index.html` 文件。在 AngularJS 中，此文件包含有一套用来配置和启动应用程序的标准的和自定义的 HTML 属性、元素和注释。接下来的每个用户操作将仅仅加载一个 partial 文件或者通过软件框架的数据绑定等方式来改变应用的当前状态。
+
+
+**Partial 示例**
+
+```HTML
+
+
+
+
+
+
+
+
+
+```
+
+Partial 文件可以通过 AngularJS 表达式来定义不同用户交互操作所对应的行为。例如在上面的例子中，`ng-click` 属性的值表示将执行当前 *scope* 中的 `changeFoo` 函数。
+
+
+### Controllers
+
+AnuglarJS 中的 controller (控制器) 本质上就是 JavaScript 函数。它可以通过将函数绑定到对应的 *scope* 上来帮助处理用户与网页应用的交互操作 (例如鼠标或键盘事件等)。Controller 所需要的所有外部构件都是通过 AngularJS 的依赖注入 (Dependency Injection) 机制实现。Controller 还会将数据也绑定到 *scope* 上，从而给 partial 提供模型 (*model*) 功能。我们可以将这些数据看成是视图模型 (*view model*)。
+
+
+```JavaScript
+function MyController($scope) {
+ $scope.buttonText = 'Click me to change foo!';
+ $scope.foo = 42;
+
+ $scope.changeFoo = function () {
+ $scope.foo += 1;
+ alert('Foo changed');
+ };
+}
+```
+
+如果将以上 controller 示例与前一节中的 partial 示例结合在一起，用户就可以在应用程序中进行一些不同的交互操作。
+
+
+1. 通过改写输入框中的文本来改变 `foo` 的值。由于这里使用了双向数据绑定，`foo` 值会立刻改变。
+2. 点击 `Click me to change foo!` 按钮来改变 `foo` 的值。
+
+
+
+所有自定义的元素、属性、注释或类，只要被预先定义过，就都可以被 AngularJS 的 *directive* 识别。
+
+
+### Scope
+
+在 AngularJS 中，scope 是一个开放给 partial 的 JavaScript 对象。Scope 可以包含不同的属性 - 基本数据 (primitives)、对象和函数。所有归属于 scope 的函数都可以通过解析该 scope 所对应 partial 中的 AngularJS 表达式来执行，也可以由任何构件直接调用该函数 (使用这种方式将保留指向该 scope 的引用不变)。附属于 scope 的数据可以通过使用合适的 *directive* 来绑定到视图上，如此一来，所有 partial 中的修改都会映射为某个 scope 属性的变化，反之亦然。
+
+
+AngularJS 应用中的 scope 还有另一个重要的特质，即它们都被连接到一条原型链 (prototypical chain) 上 (除了那些被表明为独立 (*isolated*) 的 scope)。在这种方式中，任何子 scope 都能调用属于其父母的函数，因为这些函数是该 scope 的直接或间接原型的属性。
+
+
+以下例子展示了 scope 继承关系：
+
+
+```HTML
+