
HttpClient is an evolution of the existing Angular HTTP API, which exists alongside of it in a separate package, @angular/common/http. This structure ensures that existing codebases can slowly migrate to the new API. The new API improves significantly on the ergonomics and features of the legacy API. A partial list of new features includes: * Typed, synchronous response body access, including support for JSON body types * JSON is an assumed default and no longer needs to be explicitly parsed * Interceptors allow middleware logic to be inserted into the pipeline * Immutable request/response objects * Progress events for both request upload and response download * Post-request verification & flush based testing framework
98 lines
3.5 KiB
TypeScript
98 lines
3.5 KiB
TypeScript
/**
|
|
* @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
|
|
*/
|
|
|
|
import {ɵAnimationEngine} from '@angular/animations/browser';
|
|
import {PlatformLocation, ɵPLATFORM_SERVER_ID as PLATFORM_SERVER_ID} from '@angular/common';
|
|
import {HttpClientModule} from '@angular/common/http';
|
|
import {platformCoreDynamic} from '@angular/compiler';
|
|
import {Injectable, InjectionToken, Injector, NgModule, NgZone, PLATFORM_ID, PLATFORM_INITIALIZER, PlatformRef, Provider, RendererFactory2, RootRenderer, Testability, createPlatformFactory, isDevMode, platformCore, ɵALLOW_MULTIPLE_PLATFORMS as ALLOW_MULTIPLE_PLATFORMS} from '@angular/core';
|
|
import {HttpModule} from '@angular/http';
|
|
import {BrowserModule, DOCUMENT, ɵSharedStylesHost as SharedStylesHost, ɵgetDOM as getDOM} from '@angular/platform-browser';
|
|
import {NoopAnimationsModule, ɵAnimationRendererFactory} from '@angular/platform-browser/animations';
|
|
|
|
import {SERVER_HTTP_PROVIDERS} from './http';
|
|
import {ServerPlatformLocation} from './location';
|
|
import {Parse5DomAdapter, parseDocument} from './parse5_adapter';
|
|
import {PlatformState} from './platform_state';
|
|
import {ServerRendererFactory2} from './server_renderer';
|
|
import {ServerStylesHost} from './styles_host';
|
|
import {INITIAL_CONFIG, PlatformConfig} from './tokens';
|
|
|
|
function notSupported(feature: string): Error {
|
|
throw new Error(`platform-server does not support '${feature}'.`);
|
|
}
|
|
|
|
export const INTERNAL_SERVER_PLATFORM_PROVIDERS: Array<any /*Type | Provider | any[]*/> = [
|
|
{provide: DOCUMENT, useFactory: _document, deps: [Injector]},
|
|
{provide: PLATFORM_ID, useValue: PLATFORM_SERVER_ID},
|
|
{provide: PLATFORM_INITIALIZER, useFactory: initParse5Adapter, multi: true, deps: [Injector]},
|
|
{provide: PlatformLocation, useClass: ServerPlatformLocation}, PlatformState,
|
|
// Add special provider that allows multiple instances of platformServer* to be created.
|
|
{provide: ALLOW_MULTIPLE_PLATFORMS, useValue: true}
|
|
];
|
|
|
|
function initParse5Adapter(injector: Injector) {
|
|
return () => { Parse5DomAdapter.makeCurrent(); };
|
|
}
|
|
|
|
export function instantiateServerRendererFactory(
|
|
renderer: RendererFactory2, engine: ɵAnimationEngine, zone: NgZone) {
|
|
return new ɵAnimationRendererFactory(renderer, engine, zone);
|
|
}
|
|
|
|
export const SERVER_RENDER_PROVIDERS: Provider[] = [
|
|
ServerRendererFactory2,
|
|
{
|
|
provide: RendererFactory2,
|
|
useFactory: instantiateServerRendererFactory,
|
|
deps: [ServerRendererFactory2, ɵAnimationEngine, NgZone]
|
|
},
|
|
ServerStylesHost,
|
|
{provide: SharedStylesHost, useExisting: ServerStylesHost},
|
|
];
|
|
|
|
/**
|
|
* The ng module for the server.
|
|
*
|
|
* @experimental
|
|
*/
|
|
@NgModule({
|
|
exports: [BrowserModule],
|
|
imports: [HttpModule, HttpClientModule, NoopAnimationsModule],
|
|
providers: [
|
|
SERVER_RENDER_PROVIDERS,
|
|
SERVER_HTTP_PROVIDERS,
|
|
{provide: Testability, useValue: null},
|
|
],
|
|
})
|
|
export class ServerModule {
|
|
}
|
|
|
|
function _document(injector: Injector) {
|
|
let config: PlatformConfig|null = injector.get(INITIAL_CONFIG, null);
|
|
if (config && config.document) {
|
|
return parseDocument(config.document);
|
|
} else {
|
|
return getDOM().createHtmlDocument();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @experimental
|
|
*/
|
|
export const platformServer =
|
|
createPlatformFactory(platformCore, 'server', INTERNAL_SERVER_PLATFORM_PROVIDERS);
|
|
|
|
/**
|
|
* The server platform that supports the runtime compiler.
|
|
*
|
|
* @experimental
|
|
*/
|
|
export const platformDynamicServer =
|
|
createPlatformFactory(platformCoreDynamic, 'serverDynamic', INTERNAL_SERVER_PLATFORM_PROVIDERS);
|