2016-06-23 09:47:54 -07:00
|
|
|
/**
|
|
|
|
* @license
|
|
|
|
* Copyright Google Inc. All Rights Reserved.
|
|
|
|
*
|
|
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
|
|
* found in the LICENSE file at https://angular.io/license
|
|
|
|
*/
|
|
|
|
|
2016-06-14 19:49:25 -07:00
|
|
|
import {PlatformLocation} from '@angular/common';
|
2016-07-26 05:21:19 -07:00
|
|
|
import {analyzeAppProvidersForDeprecatedConfiguration, platformCoreDynamic} from '@angular/compiler';
|
2016-08-15 13:44:01 -07:00
|
|
|
import {ApplicationRef, ComponentRef, NgModule, PLATFORM_INITIALIZER, PlatformRef, Type, createPlatformFactory, platformCore} from '@angular/core';
|
2016-07-18 03:50:31 -07:00
|
|
|
import {BrowserModule} from '@angular/platform-browser';
|
2016-06-14 19:49:25 -07:00
|
|
|
|
2016-07-18 03:50:31 -07:00
|
|
|
import {Console, ReflectionCapabilities, reflector, wtfInit} from '../core_private';
|
2016-06-14 19:49:25 -07:00
|
|
|
|
|
|
|
import {Parse5DomAdapter} from './parse5_adapter';
|
|
|
|
|
|
|
|
function notSupported(feature: string): Error {
|
|
|
|
throw new Error(`platform-server does not support '${feature}'.`);
|
|
|
|
}
|
|
|
|
|
|
|
|
class ServerPlatformLocation extends PlatformLocation {
|
|
|
|
getBaseHrefFromDOM(): string { throw notSupported('getBaseHrefFromDOM'); };
|
|
|
|
onPopState(fn: any): void { notSupported('onPopState'); };
|
|
|
|
onHashChange(fn: any): void { notSupported('onHashChange'); };
|
|
|
|
get pathname(): string { throw notSupported('pathname'); }
|
|
|
|
get search(): string { throw notSupported('search'); }
|
|
|
|
get hash(): string { throw notSupported('hash'); }
|
|
|
|
replaceState(state: any, title: string, url: string): void { notSupported('replaceState'); };
|
|
|
|
pushState(state: any, title: string, url: string): void { notSupported('pushState'); };
|
|
|
|
forward(): void { notSupported('forward'); };
|
|
|
|
back(): void { notSupported('back'); };
|
|
|
|
}
|
|
|
|
|
2016-07-18 03:50:31 -07:00
|
|
|
export const INTERNAL_SERVER_PLATFORM_PROVIDERS: Array<any /*Type | Provider | any[]*/> = [
|
2016-06-14 19:49:25 -07:00
|
|
|
{provide: PLATFORM_INITIALIZER, useValue: initParse5Adapter, multi: true},
|
refactor(core): clean up platform bootstrap and initTestEnvironment
- Introduces `CompilerFactory` which can be part of a `PlatformRef`.
- Introduces `WorkerAppModule`, `WorkerUiModule`, `ServerModule`
- Introduces `serverDynamicPlatform` for applications using runtime compilation
on the server.
- Changes browser bootstrap for runtime and offline compilation (see below for an example).
* introduces `bootstrapModule` and `bootstrapModuleFactory` in `@angular/core`
* introduces new `browserDynamicPlatform` in `@angular/platform-browser-dynamic
- Changes `initTestEnvironment` (which used to be `setBaseTestProviders`) to not take a compiler factory any more (see below for an example).
BREAKING CHANGE:
## Migration from `setBaseTestProviders` to `initTestEnvironment`:
- For the browser platform:
BEFORE:
```
import {setBaseTestProviders} from ‘@angular/core/testing’;
import {TEST_BROWSER_DYNAMIC_PLATFORM_PROVIDERS,
TEST_BROWSER_DYNAMIC_APPLICATION_PROVIDERS} from ‘@angular/platform-browser-dynamic/testing’;
setBaseTestProviders(TEST_BROWSER_DYNAMIC_PLATFORM_PROVIDERS,
TEST_BROWSER_DYNAMIC_APPLICATION_PROVIDERS);
```
AFTER:
```
import {initTestEnvironment} from ‘@angular/core/testing’;
import {browserDynamicTestPlatform,
BrowserDynamicTestModule} from ‘@angular/platform-browser-dynamic/testing’;
initTestEnvironment(
BrowserDynamicTestModule,
browserDynamicTestPlatform());
```
- For the server platform:
BEFORE:
```
import {setBaseTestProviders} from ‘@angular/core/testing’;
import {TEST_SERVER_PLATFORM_PROVIDERS,
TEST_SERVER_APPLICATION_PROVIDERS} from ‘@angular/platform-server/testing/server’;
setBaseTestProviders(TEST_SERVER_PLATFORM_PROVIDERS,
TEST_SERVER_APPLICATION_PROVIDERS);
```
AFTER:
```
import {initTestEnvironment} from ‘@angular/core/testing’;
import {serverTestPlatform,
ServerTestModule} from ‘@angular/platform-browser-dynamic/testing’;
initTestEnvironment(
ServerTestModule,
serverTestPlatform());
```
## Bootstrap changes
```
@AppModule({
modules: [BrowserModule],
precompile: [MainComponent],
providers: […], // additional providers
directives: […], // additional platform directives
pipes: […] // additional platform pipes
})
class MyModule {
constructor(appRef: ApplicationRef) {
appRef.bootstrap(MainComponent);
}
}
// offline compile
import {browserPlatform} from ‘@angular/platform-browser’;
import {bootstrapModuleFactory} from ‘@angular/core’;
bootstrapModuleFactory(MyModuleNgFactory, browserPlatform());
// runtime compile long form
import {browserDynamicPlatform} from ‘@angular/platform-browser-dynamic’;
import {bootstrapModule} from ‘@angular/core’;
bootstrapModule(MyModule, browserDynamicPlatform());
```
Closes #9922
Part of #9726
2016-07-08 10:47:17 -07:00
|
|
|
{provide: PlatformLocation, useClass: ServerPlatformLocation},
|
|
|
|
];
|
|
|
|
|
2016-06-14 19:49:25 -07:00
|
|
|
function initParse5Adapter() {
|
|
|
|
Parse5DomAdapter.makeCurrent();
|
|
|
|
wtfInit();
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2016-08-15 13:44:01 -07:00
|
|
|
* The ng module for the server.
|
|
|
|
*
|
2016-06-14 19:49:25 -07:00
|
|
|
* @experimental
|
|
|
|
*/
|
2016-08-15 13:44:01 -07:00
|
|
|
@NgModule({imports: [BrowserModule]})
|
|
|
|
export class ServerModule {
|
|
|
|
}
|
2016-07-26 05:21:19 -07:00
|
|
|
|
|
|
|
/**
|
2016-08-15 13:44:01 -07:00
|
|
|
* @experimental
|
2016-07-26 05:21:19 -07:00
|
|
|
*/
|
2016-08-15 13:44:01 -07:00
|
|
|
export const platformServer =
|
|
|
|
createPlatformFactory(platformCore, 'server', INTERNAL_SERVER_PLATFORM_PROVIDERS);
|
refactor(core): clean up platform bootstrap and initTestEnvironment
- Introduces `CompilerFactory` which can be part of a `PlatformRef`.
- Introduces `WorkerAppModule`, `WorkerUiModule`, `ServerModule`
- Introduces `serverDynamicPlatform` for applications using runtime compilation
on the server.
- Changes browser bootstrap for runtime and offline compilation (see below for an example).
* introduces `bootstrapModule` and `bootstrapModuleFactory` in `@angular/core`
* introduces new `browserDynamicPlatform` in `@angular/platform-browser-dynamic
- Changes `initTestEnvironment` (which used to be `setBaseTestProviders`) to not take a compiler factory any more (see below for an example).
BREAKING CHANGE:
## Migration from `setBaseTestProviders` to `initTestEnvironment`:
- For the browser platform:
BEFORE:
```
import {setBaseTestProviders} from ‘@angular/core/testing’;
import {TEST_BROWSER_DYNAMIC_PLATFORM_PROVIDERS,
TEST_BROWSER_DYNAMIC_APPLICATION_PROVIDERS} from ‘@angular/platform-browser-dynamic/testing’;
setBaseTestProviders(TEST_BROWSER_DYNAMIC_PLATFORM_PROVIDERS,
TEST_BROWSER_DYNAMIC_APPLICATION_PROVIDERS);
```
AFTER:
```
import {initTestEnvironment} from ‘@angular/core/testing’;
import {browserDynamicTestPlatform,
BrowserDynamicTestModule} from ‘@angular/platform-browser-dynamic/testing’;
initTestEnvironment(
BrowserDynamicTestModule,
browserDynamicTestPlatform());
```
- For the server platform:
BEFORE:
```
import {setBaseTestProviders} from ‘@angular/core/testing’;
import {TEST_SERVER_PLATFORM_PROVIDERS,
TEST_SERVER_APPLICATION_PROVIDERS} from ‘@angular/platform-server/testing/server’;
setBaseTestProviders(TEST_SERVER_PLATFORM_PROVIDERS,
TEST_SERVER_APPLICATION_PROVIDERS);
```
AFTER:
```
import {initTestEnvironment} from ‘@angular/core/testing’;
import {serverTestPlatform,
ServerTestModule} from ‘@angular/platform-browser-dynamic/testing’;
initTestEnvironment(
ServerTestModule,
serverTestPlatform());
```
## Bootstrap changes
```
@AppModule({
modules: [BrowserModule],
precompile: [MainComponent],
providers: […], // additional providers
directives: […], // additional platform directives
pipes: […] // additional platform pipes
})
class MyModule {
constructor(appRef: ApplicationRef) {
appRef.bootstrap(MainComponent);
}
}
// offline compile
import {browserPlatform} from ‘@angular/platform-browser’;
import {bootstrapModuleFactory} from ‘@angular/core’;
bootstrapModuleFactory(MyModuleNgFactory, browserPlatform());
// runtime compile long form
import {browserDynamicPlatform} from ‘@angular/platform-browser-dynamic’;
import {bootstrapModule} from ‘@angular/core’;
bootstrapModule(MyModule, browserDynamicPlatform());
```
Closes #9922
Part of #9726
2016-07-08 10:47:17 -07:00
|
|
|
|
|
|
|
/**
|
|
|
|
* The server platform that supports the runtime compiler.
|
|
|
|
*
|
|
|
|
* @experimental
|
|
|
|
*/
|
2016-07-26 05:21:19 -07:00
|
|
|
export const platformDynamicServer =
|
2016-08-15 19:37:42 -07:00
|
|
|
createPlatformFactory(platformCoreDynamic, 'serverDynamic', INTERNAL_SERVER_PLATFORM_PROVIDERS);
|