feat(router): auxiliary routes

Closes angular#2775
btford · Aug 4, 2015 · 2cd208a · 2cd208a
1 parent 7bf7ec6
commit 2cd208a
Show file tree

Hide file tree

Showing 22 changed files with 1,422 additions and 964 deletions.
diff --git a/modules/angular2/src/router/helpers.ts b/modules/angular2/src/router/helpers.ts
diff --git a/modules/angular2/src/router/instruction.ts b/modules/angular2/src/router/instruction.ts
@@ -9,6 +9,7 @@ import {
 import {isPresent, isBlank, normalizeBlank} from 'angular2/src/facade/lang';
 
 import {PathRecognizer} from './path_recognizer';
+import {Url} from './url_parser';
 
 export class RouteParams {
   constructor(public params: StringMap<string, string>) {}
@@ -18,34 +19,66 @@ export class RouteParams {
 
 
 /**
- * An `Instruction` represents the component hierarchy of the application based on a given route
+ * Represents a completed instruction, including auxiliary routes.
  */
 export class Instruction {
-  // "capturedUrl" is the part of the URL captured by this instruction
-  // "accumulatedUrl" is the part of the URL captured by this instruction and all children
-  accumulatedUrl: string;
-  reuse: boolean = false;
-  specificity: number;
-
-  constructor(public component: any, public capturedUrl: string,
-              private _recognizer: PathRecognizer, public child: Instruction = null,
-              private _params: StringMap<string, any> = null) {
-    this.accumulatedUrl = capturedUrl;
-    this.specificity = _recognizer.specificity;
-    if (isPresent(child)) {
-      this.child = child;
-      this.specificity += child.specificity;
-      var childUrl = child.accumulatedUrl;
-      if (isPresent(childUrl)) {
-        this.accumulatedUrl += childUrl;
-      }
-    }
+  constructor(public component: ComponentInstruction, public child: Instruction,
+              public auxInstruction: StringMap<string, Instruction>) {}
+
+  replaceChild(child: Instruction): Instruction {
+    return new Instruction(this.component, child, this.auxInstruction);
   }
+}
 
-  params(): StringMap<string, string> {
-    if (isBlank(this._params)) {
-      this._params = this._recognizer.parseParams(this.capturedUrl);
-    }
-    return this._params;
+/**
+ * Represents a partially completed instruction during recognition that only has the
+ * primary (non-aux) route instructions matched.
+ */
+export class PrimaryInstruction {
+  constructor(public component: ComponentInstruction, public child: PrimaryInstruction,
+              public auxUrls: List<Url>) {}
+}
+
+export function stringifyInstruction(instruction: Instruction): string {
+  var params = instruction.component.urlParams.length > 0 ?
+                   ('?' + instruction.component.urlParams.join('&')) :
+                   '';
+
+  return instruction.component.urlPath + stringifyAux(instruction) +
+         stringifyPrimary(instruction.child) + params;
+}
+
+function stringifyPrimary(instruction: Instruction): string {
+  if (isBlank(instruction)) {
+    return '';
   }
+  var params = instruction.component.urlParams.length > 0 ?
+                   (';' + instruction.component.urlParams.join(';')) :
+                   '';
+  return '/' + instruction.component.urlPath + params + stringifyAux(instruction) +
+         stringifyPrimary(instruction.child);
+}
+
+function stringifyAux(instruction: Instruction): string {
+  var routes = [];
+  StringMapWrapper.forEach(instruction.auxInstruction, (auxInstruction, _) => {
+    routes.push(stringifyPrimary(auxInstruction));
+  });
+  if (routes.length > 0) {
+    return '(' + routes.join('//') + ')';
+  }
+  return '';
+}
+
+
+/**
+ * A `ComponentInstruction` represents the route state for a single component.
+ */
+export class ComponentInstruction {
+  reuse: boolean = false;
+
+  constructor(public urlPath: string, public urlParams: List<string>,
+              public recognizer: PathRecognizer, public params: StringMap<string, any> = null) {}
+
+  get componentType() { return this.recognizer.handler.componentType; }
 }
diff --git a/modules/angular2/src/router/interfaces.ts b/modules/angular2/src/router/interfaces.ts
@@ -1,4 +1,4 @@
-import {Instruction} from './instruction';
+import {ComponentInstruction} from './instruction';
 import {global} from 'angular2/src/facade/lang';
 
 // This is here only so that after TS transpilation the file is not empty.
@@ -11,33 +11,33 @@ var __ignore_me = global;
  * Defines route lifecycle method [onActivate]
  */
 export interface OnActivate {
-  onActivate(nextInstruction: Instruction, prevInstruction: Instruction): any;
+  onActivate(nextInstruction: ComponentInstruction, prevInstruction: ComponentInstruction): any;
 }
 
 /**
  * Defines route lifecycle method [onReuse]
  */
 export interface OnReuse {
-  onReuse(nextInstruction: Instruction, prevInstruction: Instruction): any;
+  onReuse(nextInstruction: ComponentInstruction, prevInstruction: ComponentInstruction): any;
 }
 
 /**
  * Defines route lifecycle method [onDeactivate]
  */
 export interface OnDeactivate {
-  onDeactivate(nextInstruction: Instruction, prevInstruction: Instruction): any;
+  onDeactivate(nextInstruction: ComponentInstruction, prevInstruction: ComponentInstruction): any;
 }
 
 /**
  * Defines route lifecycle method [canReuse]
  */
 export interface CanReuse {
-  canReuse(nextInstruction: Instruction, prevInstruction: Instruction): any;
+  canReuse(nextInstruction: ComponentInstruction, prevInstruction: ComponentInstruction): any;
 }
 
 /**
  * Defines route lifecycle method [canDeactivate]
  */
 export interface CanDeactivate {
-  canDeactivate(nextInstruction: Instruction, prevInstruction: Instruction): any;
+  canDeactivate(nextInstruction: ComponentInstruction, prevInstruction: ComponentInstruction): any;
 }