mirror of
https://github.com/aspnet/JavaScriptServices.git
synced 2025-12-23 18:19:40 +00:00
Compare commits
3 Commits
rybrande/m
...
2.0.4
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
09ae669370 | ||
|
|
44d39bc0d4 | ||
|
|
79fd6debad |
51
.gitattributes
vendored
Executable file
51
.gitattributes
vendored
Executable file
@@ -0,0 +1,51 @@
|
|||||||
|
*.doc diff=astextplain
|
||||||
|
*.DOC diff=astextplain
|
||||||
|
*.docx diff=astextplain
|
||||||
|
*.DOCX diff=astextplain
|
||||||
|
*.dot diff=astextplain
|
||||||
|
*.DOT diff=astextplain
|
||||||
|
*.pdf diff=astextplain
|
||||||
|
*.PDF diff=astextplain
|
||||||
|
*.rtf diff=astextplain
|
||||||
|
*.RTF diff=astextplain
|
||||||
|
|
||||||
|
*.jpg binary
|
||||||
|
*.png binary
|
||||||
|
*.gif binary
|
||||||
|
|
||||||
|
*.cs text=auto diff=csharp
|
||||||
|
*.vb text=auto
|
||||||
|
*.resx text=auto
|
||||||
|
*.c text=auto
|
||||||
|
*.cpp text=auto
|
||||||
|
*.cxx text=auto
|
||||||
|
*.h text=auto
|
||||||
|
*.hxx text=auto
|
||||||
|
*.py text=auto
|
||||||
|
*.rb text=auto
|
||||||
|
*.java text=auto
|
||||||
|
*.html text=auto
|
||||||
|
*.htm text=auto
|
||||||
|
*.css text=auto
|
||||||
|
*.scss text=auto
|
||||||
|
*.sass text=auto
|
||||||
|
*.less text=auto
|
||||||
|
*.js text=auto
|
||||||
|
*.lisp text=auto
|
||||||
|
*.clj text=auto
|
||||||
|
*.sql text=auto
|
||||||
|
*.php text=auto
|
||||||
|
*.lua text=auto
|
||||||
|
*.m text=auto
|
||||||
|
*.asm text=auto
|
||||||
|
*.erl text=auto
|
||||||
|
*.fs text=auto
|
||||||
|
*.fsx text=auto
|
||||||
|
*.hs text=auto
|
||||||
|
|
||||||
|
*.csproj text=auto
|
||||||
|
*.vbproj text=auto
|
||||||
|
*.fsproj text=auto
|
||||||
|
*.dbproj text=auto
|
||||||
|
*.sln text=auto eol=crlf
|
||||||
|
*.sh eol=lf
|
||||||
44
.gitignore
vendored
Normal file
44
.gitignore
vendored
Normal file
@@ -0,0 +1,44 @@
|
|||||||
|
[Oo]bj/
|
||||||
|
[Bb]in/
|
||||||
|
TestResults/
|
||||||
|
.nuget/
|
||||||
|
*.sln.ide/
|
||||||
|
_ReSharper.*/
|
||||||
|
packages/
|
||||||
|
artifacts/
|
||||||
|
PublishProfiles/
|
||||||
|
*.user
|
||||||
|
*.suo
|
||||||
|
*.cache
|
||||||
|
*.docstates
|
||||||
|
_ReSharper.*
|
||||||
|
nuget.exe
|
||||||
|
*net45.csproj
|
||||||
|
*net451.csproj
|
||||||
|
*k10.csproj
|
||||||
|
*.psess
|
||||||
|
*.vsp
|
||||||
|
*.pidb
|
||||||
|
*.userprefs
|
||||||
|
*DS_Store
|
||||||
|
*.ncrunchsolution
|
||||||
|
*.*sdf
|
||||||
|
*.ipch
|
||||||
|
|
||||||
|
.vs/
|
||||||
|
npm-debug.log
|
||||||
|
/.build/
|
||||||
|
global.json
|
||||||
|
*.g.targets
|
||||||
|
|
||||||
|
# The templates can't contain their own .gitignore files, because Yeoman has strange default handling for
|
||||||
|
# files with that name (https://github.com/npm/npm/issues/1862). So, each template instead has a template_gitignore
|
||||||
|
# file which gets renamed after the files are copied. And so any files that need to be excluded in the source
|
||||||
|
# repo have to be excluded here.
|
||||||
|
/templates/*/node_modules/
|
||||||
|
/templates/*/wwwroot/dist/
|
||||||
|
/templates/*/ClientApp/dist/
|
||||||
|
/templates/*/yarn.lock
|
||||||
|
.vscode/
|
||||||
|
|
||||||
|
/templates/*/Properties/launchSettings.json
|
||||||
19
.travis.yml
Executable file
19
.travis.yml
Executable file
@@ -0,0 +1,19 @@
|
|||||||
|
language: csharp
|
||||||
|
sudo: required
|
||||||
|
dist: trusty
|
||||||
|
addons:
|
||||||
|
apt:
|
||||||
|
packages:
|
||||||
|
- gettext
|
||||||
|
- libcurl4-openssl-dev
|
||||||
|
- libicu-dev
|
||||||
|
- libssl-dev
|
||||||
|
- libunwind8
|
||||||
|
- zlib1g
|
||||||
|
mono: none
|
||||||
|
os:
|
||||||
|
- linux
|
||||||
|
- osx
|
||||||
|
osx_image: xcode7.1
|
||||||
|
script:
|
||||||
|
- ./build.sh
|
||||||
4
CONTRIBUTING.md
Normal file
4
CONTRIBUTING.md
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
Contributing
|
||||||
|
======
|
||||||
|
|
||||||
|
Information on contributing to this repo is in the [Contributing Guide](https://github.com/aspnet/Home/blob/dev/CONTRIBUTING.md) in the Home repo.
|
||||||
9
Directory.Build.props
Normal file
9
Directory.Build.props
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
<Project>
|
||||||
|
<Import Project="version.props" />
|
||||||
|
<Import Project="build\dependencies.props" />
|
||||||
|
<Import Project="build\sources.props" />
|
||||||
|
|
||||||
|
<PropertyGroup>
|
||||||
|
<RepositoryRoot>$(MSBuildThisFileDirectory)</RepositoryRoot>
|
||||||
|
</PropertyGroup>
|
||||||
|
</Project>
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
<Project>
|
<Project>
|
||||||
<PropertyGroup>
|
<PropertyGroup>
|
||||||
<RuntimeFrameworkVersion Condition=" '$(TargetFramework)' == 'netcoreapp3.0' ">$(MicrosoftNETCoreAppPackageVersion)</RuntimeFrameworkVersion>
|
|
||||||
<NETStandardImplicitPackageVersion Condition=" '$(TargetFramework)' == 'netstandard2.0' ">$(NETStandardLibrary20PackageVersion)</NETStandardImplicitPackageVersion>
|
<NETStandardImplicitPackageVersion Condition=" '$(TargetFramework)' == 'netstandard2.0' ">$(NETStandardLibrary20PackageVersion)</NETStandardImplicitPackageVersion>
|
||||||
|
<RuntimeFrameworkVersion Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">$(MicrosoftNETCoreApp20PackageVersion)</RuntimeFrameworkVersion>
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
</Project>
|
</Project>
|
||||||
@@ -1,12 +1,9 @@
|
|||||||
|
|
||||||
Microsoft Visual Studio Solution File, Format Version 12.00
|
Microsoft Visual Studio Solution File, Format Version 12.00
|
||||||
# Visual Studio 15
|
# Visual Studio 15
|
||||||
VisualStudioVersion = 15.0.26730.16
|
VisualStudioVersion = 15.0.26430.4
|
||||||
MinimumVisualStudioVersion = 15.0.26730.03
|
MinimumVisualStudioVersion = 10.0.40219.1
|
||||||
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{27304DDE-AFB2-4F8B-B765-E3E2F11E886C}"
|
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{27304DDE-AFB2-4F8B-B765-E3E2F11E886C}"
|
||||||
ProjectSection(SolutionItems) = preProject
|
|
||||||
src\Directory.Build.props = src\Directory.Build.props
|
|
||||||
EndProjectSection
|
|
||||||
EndProject
|
EndProject
|
||||||
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.NodeServices", "src\Microsoft.AspNetCore.NodeServices\Microsoft.AspNetCore.NodeServices.csproj", "{66B77203-1469-41DF-92F2-2BE6900BD36F}"
|
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.NodeServices", "src\Microsoft.AspNetCore.NodeServices\Microsoft.AspNetCore.NodeServices.csproj", "{66B77203-1469-41DF-92F2-2BE6900BD36F}"
|
||||||
EndProject
|
EndProject
|
||||||
@@ -31,13 +28,13 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Webpack", "samples\misc\Web
|
|||||||
EndProject
|
EndProject
|
||||||
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "NodeServicesExamples", "samples\misc\NodeServicesExamples\NodeServicesExamples.csproj", "{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}"
|
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "NodeServicesExamples", "samples\misc\NodeServicesExamples\NodeServicesExamples.csproj", "{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}"
|
||||||
EndProject
|
EndProject
|
||||||
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{645F7363-1240-4FB6-9422-B32A327C979F}"
|
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "templates", "templates", "{1598B415-73F1-4B37-B3B4-0A10677ABB2D}"
|
||||||
ProjectSection(SolutionItems) = preProject
|
|
||||||
Directory.Build.props = Directory.Build.props
|
|
||||||
Directory.Build.targets = Directory.Build.targets
|
|
||||||
EndProjectSection
|
|
||||||
EndProject
|
EndProject
|
||||||
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.SpaServices.Extensions", "src\Microsoft.AspNetCore.SpaServices.Extensions\Microsoft.AspNetCore.SpaServices.Extensions.csproj", "{D40BD1C4-6A6F-4213-8535-1057F3EB3400}"
|
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "build", "build", "{E415FE14-13B0-469F-836D-95059E6BAA6E}"
|
||||||
|
ProjectSection(SolutionItems) = preProject
|
||||||
|
src\build\common.props = src\build\common.props
|
||||||
|
src\build\Key.snk = src\build\Key.snk
|
||||||
|
EndProjectSection
|
||||||
EndProject
|
EndProject
|
||||||
Global
|
Global
|
||||||
GlobalSection(SolutionConfigurationPlatforms) = preSolution
|
GlobalSection(SolutionConfigurationPlatforms) = preSolution
|
||||||
@@ -69,10 +66,6 @@ Global
|
|||||||
{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}.Debug|Any CPU.Build.0 = Debug|Any CPU
|
{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}.Debug|Any CPU.Build.0 = Debug|Any CPU
|
||||||
{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}.Release|Any CPU.ActiveCfg = Release|Any CPU
|
{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}.Release|Any CPU.ActiveCfg = Release|Any CPU
|
||||||
{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}.Release|Any CPU.Build.0 = Release|Any CPU
|
{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}.Release|Any CPU.Build.0 = Release|Any CPU
|
||||||
{D40BD1C4-6A6F-4213-8535-1057F3EB3400}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
|
|
||||||
{D40BD1C4-6A6F-4213-8535-1057F3EB3400}.Debug|Any CPU.Build.0 = Debug|Any CPU
|
|
||||||
{D40BD1C4-6A6F-4213-8535-1057F3EB3400}.Release|Any CPU.ActiveCfg = Release|Any CPU
|
|
||||||
{D40BD1C4-6A6F-4213-8535-1057F3EB3400}.Release|Any CPU.Build.0 = Release|Any CPU
|
|
||||||
EndGlobalSection
|
EndGlobalSection
|
||||||
GlobalSection(SolutionProperties) = preSolution
|
GlobalSection(SolutionProperties) = preSolution
|
||||||
HideSolutionNode = FALSE
|
HideSolutionNode = FALSE
|
||||||
@@ -85,9 +78,5 @@ Global
|
|||||||
{1931B19A-EC42-4D56-B2D0-FB06D17244DA} = {E6A161EA-646C-4033-9090-95BE809AB8D9}
|
{1931B19A-EC42-4D56-B2D0-FB06D17244DA} = {E6A161EA-646C-4033-9090-95BE809AB8D9}
|
||||||
{DE479DC3-1461-4EAD-A188-4AF7AA4AE344} = {E6A161EA-646C-4033-9090-95BE809AB8D9}
|
{DE479DC3-1461-4EAD-A188-4AF7AA4AE344} = {E6A161EA-646C-4033-9090-95BE809AB8D9}
|
||||||
{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE} = {E6A161EA-646C-4033-9090-95BE809AB8D9}
|
{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE} = {E6A161EA-646C-4033-9090-95BE809AB8D9}
|
||||||
{D40BD1C4-6A6F-4213-8535-1057F3EB3400} = {27304DDE-AFB2-4F8B-B765-E3E2F11E886C}
|
|
||||||
EndGlobalSection
|
|
||||||
GlobalSection(ExtensibilityGlobals) = postSolution
|
|
||||||
SolutionGuid = {DDF59B0D-2DEC-45D6-8667-DCB767487101}
|
|
||||||
EndGlobalSection
|
EndGlobalSection
|
||||||
EndGlobal
|
EndGlobal
|
||||||
@@ -1,10 +1,12 @@
|
|||||||
Copyright (c) .NET Foundation. All rights reserved.
|
Copyright (c) .NET Foundation and Contributors
|
||||||
|
|
||||||
|
All rights reserved.
|
||||||
|
|
||||||
Licensed under the Apache License, Version 2.0 (the "License"); you may not use
|
Licensed under the Apache License, Version 2.0 (the "License"); you may not use
|
||||||
these files except in compliance with the License. You may obtain a copy of the
|
this file except in compliance with the License. You may obtain a copy of the
|
||||||
License at
|
License at
|
||||||
|
|
||||||
http://www.apache.org/licenses/LICENSE-2.0
|
http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
|
||||||
Unless required by applicable law or agreed to in writing, software distributed
|
Unless required by applicable law or agreed to in writing, software distributed
|
||||||
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
|
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
|
||||||
7
NuGet.config
Normal file
7
NuGet.config
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<configuration>
|
||||||
|
<packageSources>
|
||||||
|
<clear />
|
||||||
|
<!-- Restore sources should be defined in build/sources.props. -->
|
||||||
|
</packageSources>
|
||||||
|
</configuration>
|
||||||
100
README.md
Normal file
100
README.md
Normal file
@@ -0,0 +1,100 @@
|
|||||||
|
# JavaScriptServices
|
||||||
|
|
||||||
|
AppVeyor: [](https://ci.appveyor.com/project/aspnetci/javascriptservices/branch/dev)
|
||||||
|
|
||||||
|
This project is part of ASP.NET Core. You can find samples, documentation and getting started instructions for ASP.NET Core at the [Home](https://github.com/aspnet/home) repo.
|
||||||
|
|
||||||
|
## What is this?
|
||||||
|
|
||||||
|
`JavaScriptServices` is a set of client-side technologies for ASP.NET Core. It provides infrastructure that you'll find useful if you:
|
||||||
|
|
||||||
|
- Use Angular / React / Vue / Aurelia / Knockout / etc.
|
||||||
|
- Build your client-side resources using Webpack.
|
||||||
|
- Execute JavaScript on the server at runtime.
|
||||||
|
|
||||||
|
Read [Building Single Page Applications on ASP.NET Core with JavaScriptServices](https://blogs.msdn.microsoft.com/webdev/2017/02/14/building-single-page-applications-on-asp-net-core-with-javascriptservices/) for more details.
|
||||||
|
|
||||||
|
This repo contains:
|
||||||
|
|
||||||
|
* A set of NuGet/NPM packages that implement functionality for:
|
||||||
|
* Invoking arbitrary NPM packages at runtime from .NET code ([docs](https://github.com/aspnet/JavaScriptServices/tree/dev/src/Microsoft.AspNetCore.NodeServices#simple-usage-example))
|
||||||
|
* Server-side prerendering of SPA components ([docs](https://github.com/aspnet/JavaScriptServices/tree/dev/src/Microsoft.AspNetCore.SpaServices#server-side-prerendering))
|
||||||
|
* Webpack dev middleware ([docs](https://github.com/aspnet/JavaScriptServices/tree/dev/src/Microsoft.AspNetCore.SpaServices#webpack-dev-middleware))
|
||||||
|
* Hot module replacement (HMR) ([docs](https://github.com/aspnet/JavaScriptServices/tree/dev/src/Microsoft.AspNetCore.SpaServices#webpack-hot-module-replacement))
|
||||||
|
* Server-side and client-side routing integration ([docs](https://github.com/aspnet/JavaScriptServices/tree/dev/src/Microsoft.AspNetCore.SpaServices#routing-helper-mapspafallbackroute))
|
||||||
|
* Server-side and client-side validation integration
|
||||||
|
* "Lazy loading" for Knockout apps
|
||||||
|
* A Yeoman generator that creates preconfigured app starting points ([guide](http://blog.stevensanderson.com/2016/05/02/angular2-react-knockout-apps-on-aspnet-core/))
|
||||||
|
* Samples and docs
|
||||||
|
|
||||||
|
It's cross-platform (Windows, Linux, or macOS) and works with .NET Core 1.0.1 or later.
|
||||||
|
|
||||||
|
## Creating new applications
|
||||||
|
|
||||||
|
If you want to build a brand-new ASP.NET Core app that uses Angular / React / Knockout on the client, consider starting with the `aspnetcore-spa` generator. This lets you choose your client-side framework. It generates a starting point that includes applicable features such as Webpack dev middleware, server-side prerendering, and efficient production builds. It's much easier than configuring everything to work together manually!
|
||||||
|
|
||||||
|
To do this, install Yeoman and these generator templates:
|
||||||
|
|
||||||
|
npm install -g yo generator-aspnetcore-spa
|
||||||
|
|
||||||
|
Generate your new application starting point:
|
||||||
|
|
||||||
|
cd some-empty-directory
|
||||||
|
yo aspnetcore-spa
|
||||||
|
|
||||||
|
Once the generator has run and restored all the dependencies, you can start up your new ASP.NET Core SPA:
|
||||||
|
|
||||||
|
dotnet run
|
||||||
|
|
||||||
|
For a more detailed walkthrough, see [getting started with the `aspnetcore-spa` generator](http://blog.stevensanderson.com/2016/05/02/angular2-react-knockout-apps-on-aspnet-core/).
|
||||||
|
|
||||||
|
## Adding to existing applications
|
||||||
|
|
||||||
|
If you have an existing ASP.NET Core application, or if you just want to use the underlying JavaScriptServices packages directly, you can install these packages using NuGet and NPM:
|
||||||
|
|
||||||
|
* `Microsoft.AspNetCore.NodeServices`
|
||||||
|
* This provides a fast and robust way for .NET code to run JavaScript on the server inside a Node.js environment. You can use this to consume arbitrary functionality from NPM packages at runtime in your ASP.NET Core app.
|
||||||
|
* Most applications developers don't need to use this directly, but you can do so if you want to implement your own functionality that involves calling Node.js code from .NET at runtime.
|
||||||
|
* Find [documentation and usage examples here](https://github.com/aspnet/JavaScriptServices/tree/dev/src/Microsoft.AspNetCore.NodeServices#microsoftaspnetcorenodeservices).
|
||||||
|
* `Microsoft.AspNetCore.SpaServices`
|
||||||
|
* This provides infrastructure that's generally useful when building Single Page Applications (SPAs) with technologies such as Angular or React (for example, server-side prerendering and webpack middleware). Internally, it uses the `NodeServices` package to implement its features.
|
||||||
|
* Find [documentation and usage examples here](https://github.com/aspnet/JavaScriptServices/tree/dev/src/Microsoft.AspNetCore.SpaServices#microsoftaspnetcorespaservices).
|
||||||
|
* `Microsoft.AspNetCore.AngularServices`
|
||||||
|
* This builds on the `SpaServices` package and includes features specific to Angular. Currently, this includes validation helpers.
|
||||||
|
* The code is [here](https://github.com/aspnet/JavaScriptServices/tree/dev/src/Microsoft.AspNetCore.AngularServices). You'll find a usage example for [the validation helper here](https://github.com/aspnet/JavaScriptServices/blob/dev/samples/angular/MusicStore/wwwroot/ng-app/components/admin/album-edit/album-edit.ts).
|
||||||
|
|
||||||
|
There was previously a `Microsoft.AspNetCore.ReactServices` but this is not currently needed - all applicable functionality is in `Microsoft.AspNetCore.SpaServices`, because it's sufficiently general. We might add a new `Microsoft.AspNetCore.ReactServices` package in the future if new React-specific requirements emerge.
|
||||||
|
|
||||||
|
If you want to build a helper library for some other SPA framework, you can do so by taking a dependency on `Microsoft.AspNetCore.SpaServices` and wrapping its functionality in whatever way is most useful for your SPA framework.
|
||||||
|
|
||||||
|
## Samples and templates
|
||||||
|
|
||||||
|
Inside this repo, [the `templates` directory](https://github.com/aspnet/JavaScriptServices/tree/dev/templates) contains the application starting points that the `aspnetcore-spa` generator emits. You can clone this repo and run those applications directly. But it's easier to [use the Yeoman tool to run the generator](http://blog.stevensanderson.com/2016/05/02/angular2-react-knockout-apps-on-aspnet-core/).
|
||||||
|
|
||||||
|
The [`samples` directory](https://github.com/aspnet/JavaScriptServices/tree/dev/samples) contains examples of:
|
||||||
|
|
||||||
|
- Using the JavaScript services family of packages with Angular and React.
|
||||||
|
- A standalone `NodeServices` usage for runtime code transpilation and image processing.
|
||||||
|
|
||||||
|
**To run the samples:**
|
||||||
|
|
||||||
|
* Clone this repo
|
||||||
|
* At the repo's root directory (the one containing `src`, `samples`, etc.), run `dotnet restore`
|
||||||
|
* Change directory to the sample you want to run (for example, `cd samples/angular/MusicStore`)
|
||||||
|
* Restore Node dependencies by running `npm install`
|
||||||
|
* If you're trying to run the Angular "Music Store" sample, then also run `gulp` (which you need to have installed globally). None of the other samples require this.
|
||||||
|
* Run the application (`dotnet run`)
|
||||||
|
* Browse to [http://localhost:5000](http://localhost:5000)
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
If you're interested in contributing to the various packages, samples, and project templates in this repo, that's great! You can run the code in this repo as follows:
|
||||||
|
|
||||||
|
* Clone the repo
|
||||||
|
* Run `dotnet restore` at the repo root dir
|
||||||
|
* Go to whatever sample or template you want to run (for example, `cd templates/AngularSpa`)
|
||||||
|
* Restore NPM dependencies (run `npm install`)
|
||||||
|
* If the sample/template you're trying to run has a file called `webpack.config.vendor.js` at its root, run `webpack --config webpack.config.vendor.js`. If it has a file called `webpack.config.js`, run `webpack` (no args). You might need to install webpack first, by running `npm install -g webpack`.
|
||||||
|
* Launch it (`dotnet run`)
|
||||||
|
|
||||||
|
If you're planning to submit a pull request, and if it's more than a trivial fix (for example, for a typo), it's usually a good idea first to file an issue describing what you're proposing to do and how it will work. Then you can find out if it's likely that such a pull request will be accepted, and how it fits into wider ongoing plans.
|
||||||
40
appveyor.yml
Executable file
40
appveyor.yml
Executable file
@@ -0,0 +1,40 @@
|
|||||||
|
init:
|
||||||
|
- git config --global core.autocrlf true
|
||||||
|
install:
|
||||||
|
- ps: Install-Product node 6.9.2 x64
|
||||||
|
# .NET Core SDK binaries
|
||||||
|
# Download .NET Core 2.0 Preview 3 SDK and add to PATH
|
||||||
|
- ps: $urlCurrent = "https://dotnetcli.azureedge.net/dotnet/Sdk/2.0.0-preview3-006729/dotnet-sdk-2.0.0-preview3-006729-win-x64.zip"
|
||||||
|
- ps: $env:DOTNET_INSTALL_DIR = "$pwd\.dotnetsdk"
|
||||||
|
- ps: mkdir $env:DOTNET_INSTALL_DIR -Force | Out-Null
|
||||||
|
- ps: $tempFileCurrent = [System.IO.Path]::Combine([System.IO.Path]::GetTempPath(), [System.IO.Path]::GetRandomFileName())
|
||||||
|
- ps: (New-Object System.Net.WebClient).DownloadFile($urlCurrent, $tempFileCurrent)
|
||||||
|
- ps: Add-Type -AssemblyName System.IO.Compression.FileSystem; [System.IO.Compression.ZipFile]::ExtractToDirectory($tempFileCurrent, $env:DOTNET_INSTALL_DIR)
|
||||||
|
- ps: $env:Path = "$env:DOTNET_INSTALL_DIR;$env:Path"
|
||||||
|
build_script:
|
||||||
|
- ps: Push-Location
|
||||||
|
- cd templates/package-builder
|
||||||
|
- npm install
|
||||||
|
- npm run build
|
||||||
|
- ps: Pop-Location
|
||||||
|
artifacts:
|
||||||
|
- path: templates\package-builder\dist\artifacts\generator-aspnetcore-spa.tar.gz
|
||||||
|
name: generator-aspnetcore-spa
|
||||||
|
- path: templates\package-builder\dist\artifacts\*.nupkg
|
||||||
|
name: Microsoft.AspNetCore.SpaTemplates
|
||||||
|
type: NuGetPackage
|
||||||
|
# - ps: .\build.ps1
|
||||||
|
clone_depth: 1
|
||||||
|
test_script:
|
||||||
|
- dotnet restore
|
||||||
|
- ps: Push-Location
|
||||||
|
- cd test
|
||||||
|
- npm install selenium-standalone
|
||||||
|
- ps: Start-Process node './start-selenium.js'
|
||||||
|
- npm install
|
||||||
|
- npm test
|
||||||
|
on_finish :
|
||||||
|
- ps: Pop-Location
|
||||||
|
# After running tests, upload results to Appveyor
|
||||||
|
- ps: (new-object net.webclient).UploadFile("https://ci.appveyor.com/api/testresults/junit/$($env:APPVEYOR_JOB_ID)", (Resolve-Path .\test\tmp\junit\*.xml))
|
||||||
|
deploy: off
|
||||||
2
build.cmd
Executable file
2
build.cmd
Executable file
@@ -0,0 +1,2 @@
|
|||||||
|
@ECHO OFF
|
||||||
|
PowerShell -NoProfile -NoLogo -ExecutionPolicy unrestricted -Command "[System.Threading.Thread]::CurrentThread.CurrentCulture = ''; [System.Threading.Thread]::CurrentThread.CurrentUICulture = '';& '%~dp0build.ps1' %*; exit $LASTEXITCODE"
|
||||||
186
build.ps1
Normal file
186
build.ps1
Normal file
@@ -0,0 +1,186 @@
|
|||||||
|
#!/usr/bin/env powershell
|
||||||
|
#requires -version 4
|
||||||
|
|
||||||
|
<#
|
||||||
|
.SYNOPSIS
|
||||||
|
Build this repository
|
||||||
|
|
||||||
|
.DESCRIPTION
|
||||||
|
Downloads korebuild if required. Then builds the repository.
|
||||||
|
|
||||||
|
.PARAMETER Path
|
||||||
|
The folder to build. Defaults to the folder containing this script.
|
||||||
|
|
||||||
|
.PARAMETER Channel
|
||||||
|
The channel of KoreBuild to download. Overrides the value from the config file.
|
||||||
|
|
||||||
|
.PARAMETER DotNetHome
|
||||||
|
The directory where .NET Core tools will be stored.
|
||||||
|
|
||||||
|
.PARAMETER ToolsSource
|
||||||
|
The base url where build tools can be downloaded. Overrides the value from the config file.
|
||||||
|
|
||||||
|
.PARAMETER Update
|
||||||
|
Updates KoreBuild to the latest version even if a lock file is present.
|
||||||
|
|
||||||
|
.PARAMETER ConfigFile
|
||||||
|
The path to the configuration file that stores values. Defaults to version.props.
|
||||||
|
|
||||||
|
.PARAMETER MSBuildArgs
|
||||||
|
Arguments to be passed to MSBuild
|
||||||
|
|
||||||
|
.NOTES
|
||||||
|
This function will create a file $PSScriptRoot/korebuild-lock.txt. This lock file can be committed to source, but does not have to be.
|
||||||
|
When the lockfile is not present, KoreBuild will create one using latest available version from $Channel.
|
||||||
|
|
||||||
|
The $ConfigFile is expected to be an JSON file. It is optional, and the configuration values in it are optional as well. Any options set
|
||||||
|
in the file are overridden by command line parameters.
|
||||||
|
|
||||||
|
.EXAMPLE
|
||||||
|
Example config file:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"$schema": "https://raw.githubusercontent.com/aspnet/BuildTools/dev/tools/korebuild.schema.json",
|
||||||
|
"channel": "dev",
|
||||||
|
"toolsSource": "https://aspnetcore.blob.core.windows.net/buildtools"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
#>
|
||||||
|
[CmdletBinding(PositionalBinding = $false)]
|
||||||
|
param(
|
||||||
|
[string]$Path = $PSScriptRoot,
|
||||||
|
[Alias('c')]
|
||||||
|
[string]$Channel,
|
||||||
|
[Alias('d')]
|
||||||
|
[string]$DotNetHome,
|
||||||
|
[Alias('s')]
|
||||||
|
[string]$ToolsSource,
|
||||||
|
[Alias('u')]
|
||||||
|
[switch]$Update,
|
||||||
|
[string]$ConfigFile = $null,
|
||||||
|
[Parameter(ValueFromRemainingArguments = $true)]
|
||||||
|
[string[]]$MSBuildArgs
|
||||||
|
)
|
||||||
|
|
||||||
|
Set-StrictMode -Version 2
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
|
||||||
|
#
|
||||||
|
# Functions
|
||||||
|
#
|
||||||
|
|
||||||
|
function Get-KoreBuild {
|
||||||
|
|
||||||
|
$lockFile = Join-Path $Path 'korebuild-lock.txt'
|
||||||
|
|
||||||
|
if (!(Test-Path $lockFile) -or $Update) {
|
||||||
|
Get-RemoteFile "$ToolsSource/korebuild/channels/$Channel/latest.txt" $lockFile
|
||||||
|
}
|
||||||
|
|
||||||
|
$version = Get-Content $lockFile | Where-Object { $_ -like 'version:*' } | Select-Object -first 1
|
||||||
|
if (!$version) {
|
||||||
|
Write-Error "Failed to parse version from $lockFile. Expected a line that begins with 'version:'"
|
||||||
|
}
|
||||||
|
$version = $version.TrimStart('version:').Trim()
|
||||||
|
$korebuildPath = Join-Paths $DotNetHome ('buildtools', 'korebuild', $version)
|
||||||
|
|
||||||
|
if (!(Test-Path $korebuildPath)) {
|
||||||
|
Write-Host -ForegroundColor Magenta "Downloading KoreBuild $version"
|
||||||
|
New-Item -ItemType Directory -Path $korebuildPath | Out-Null
|
||||||
|
$remotePath = "$ToolsSource/korebuild/artifacts/$version/korebuild.$version.zip"
|
||||||
|
|
||||||
|
try {
|
||||||
|
$tmpfile = Join-Path ([IO.Path]::GetTempPath()) "KoreBuild-$([guid]::NewGuid()).zip"
|
||||||
|
Get-RemoteFile $remotePath $tmpfile
|
||||||
|
if (Get-Command -Name 'Expand-Archive' -ErrorAction Ignore) {
|
||||||
|
# Use built-in commands where possible as they are cross-plat compatible
|
||||||
|
Expand-Archive -Path $tmpfile -DestinationPath $korebuildPath
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
# Fallback to old approach for old installations of PowerShell
|
||||||
|
Add-Type -AssemblyName System.IO.Compression.FileSystem
|
||||||
|
[System.IO.Compression.ZipFile]::ExtractToDirectory($tmpfile, $korebuildPath)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
Remove-Item -Recurse -Force $korebuildPath -ErrorAction Ignore
|
||||||
|
throw
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
Remove-Item $tmpfile -ErrorAction Ignore
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return $korebuildPath
|
||||||
|
}
|
||||||
|
|
||||||
|
function Join-Paths([string]$path, [string[]]$childPaths) {
|
||||||
|
$childPaths | ForEach-Object { $path = Join-Path $path $_ }
|
||||||
|
return $path
|
||||||
|
}
|
||||||
|
|
||||||
|
function Get-RemoteFile([string]$RemotePath, [string]$LocalPath) {
|
||||||
|
if ($RemotePath -notlike 'http*') {
|
||||||
|
Copy-Item $RemotePath $LocalPath
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
$retries = 10
|
||||||
|
while ($retries -gt 0) {
|
||||||
|
$retries -= 1
|
||||||
|
try {
|
||||||
|
Invoke-WebRequest -UseBasicParsing -Uri $RemotePath -OutFile $LocalPath
|
||||||
|
return
|
||||||
|
}
|
||||||
|
catch {
|
||||||
|
Write-Verbose "Request failed. $retries retries remaining"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
Write-Error "Download failed: '$RemotePath'."
|
||||||
|
}
|
||||||
|
|
||||||
|
#
|
||||||
|
# Main
|
||||||
|
#
|
||||||
|
|
||||||
|
# Load configuration or set defaults
|
||||||
|
|
||||||
|
$Path = Resolve-Path $Path
|
||||||
|
if (!$ConfigFile) { $ConfigFile = Join-Path $Path 'korebuild.json' }
|
||||||
|
|
||||||
|
if (Test-Path $ConfigFile) {
|
||||||
|
try {
|
||||||
|
$config = Get-Content -Raw -Encoding UTF8 -Path $ConfigFile | ConvertFrom-Json
|
||||||
|
if ($config) {
|
||||||
|
if (!($Channel) -and (Get-Member -Name 'channel' -InputObject $config)) { [string] $Channel = $config.channel }
|
||||||
|
if (!($ToolsSource) -and (Get-Member -Name 'toolsSource' -InputObject $config)) { [string] $ToolsSource = $config.toolsSource}
|
||||||
|
}
|
||||||
|
} catch {
|
||||||
|
Write-Warning "$ConfigFile could not be read. Its settings will be ignored."
|
||||||
|
Write-Warning $Error[0]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!$DotNetHome) {
|
||||||
|
$DotNetHome = if ($env:DOTNET_HOME) { $env:DOTNET_HOME } `
|
||||||
|
elseif ($env:USERPROFILE) { Join-Path $env:USERPROFILE '.dotnet'} `
|
||||||
|
elseif ($env:HOME) {Join-Path $env:HOME '.dotnet'}`
|
||||||
|
else { Join-Path $PSScriptRoot '.dotnet'}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!$Channel) { $Channel = 'dev' }
|
||||||
|
if (!$ToolsSource) { $ToolsSource = 'https://aspnetcore.blob.core.windows.net/buildtools' }
|
||||||
|
|
||||||
|
# Execute
|
||||||
|
|
||||||
|
$korebuildPath = Get-KoreBuild
|
||||||
|
Import-Module -Force -Scope Local (Join-Path $korebuildPath 'KoreBuild.psd1')
|
||||||
|
|
||||||
|
try {
|
||||||
|
Install-Tools $ToolsSource $DotNetHome
|
||||||
|
Invoke-RepositoryBuild $Path @MSBuildArgs
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
Remove-Module 'KoreBuild' -ErrorAction Ignore
|
||||||
|
}
|
||||||
220
build.sh
Executable file
220
build.sh
Executable file
@@ -0,0 +1,220 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
#
|
||||||
|
# variables
|
||||||
|
#
|
||||||
|
|
||||||
|
RESET="\033[0m"
|
||||||
|
RED="\033[0;31m"
|
||||||
|
YELLOW="\033[0;33m"
|
||||||
|
MAGENTA="\033[0;95m"
|
||||||
|
DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||||
|
[ -z "${DOTNET_HOME:-}" ] && DOTNET_HOME="$HOME/.dotnet"
|
||||||
|
config_file="$DIR/korebuild.json"
|
||||||
|
verbose=false
|
||||||
|
update=false
|
||||||
|
repo_path="$DIR"
|
||||||
|
channel=''
|
||||||
|
tools_source=''
|
||||||
|
|
||||||
|
#
|
||||||
|
# Functions
|
||||||
|
#
|
||||||
|
__usage() {
|
||||||
|
echo "Usage: $(basename "${BASH_SOURCE[0]}") [options] [[--] <MSBUILD_ARG>...]"
|
||||||
|
echo ""
|
||||||
|
echo "Arguments:"
|
||||||
|
echo " <MSBUILD_ARG>... Arguments passed to MSBuild. Variable number of arguments allowed."
|
||||||
|
echo ""
|
||||||
|
echo "Options:"
|
||||||
|
echo " --verbose Show verbose output."
|
||||||
|
echo " -c|--channel <CHANNEL> The channel of KoreBuild to download. Overrides the value from the config file.."
|
||||||
|
echo " --config-file <FILE> The path to the configuration file that stores values. Defaults to korebuild.json."
|
||||||
|
echo " -d|--dotnet-home <DIR> The directory where .NET Core tools will be stored. Defaults to '\$DOTNET_HOME' or '\$HOME/.dotnet."
|
||||||
|
echo " --path <PATH> The directory to build. Defaults to the directory containing the script."
|
||||||
|
echo " -s|--tools-source <URL> The base url where build tools can be downloaded. Overrides the value from the config file."
|
||||||
|
echo " -u|--update Update to the latest KoreBuild even if the lock file is present."
|
||||||
|
echo ""
|
||||||
|
echo "Description:"
|
||||||
|
echo " This function will create a file \$DIR/korebuild-lock.txt. This lock file can be committed to source, but does not have to be."
|
||||||
|
echo " When the lockfile is not present, KoreBuild will create one using latest available version from \$channel."
|
||||||
|
|
||||||
|
if [[ "${1:-}" != '--no-exit' ]]; then
|
||||||
|
exit 2
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
get_korebuild() {
|
||||||
|
local version
|
||||||
|
local lock_file="$repo_path/korebuild-lock.txt"
|
||||||
|
if [ ! -f "$lock_file" ] || [ "$update" = true ]; then
|
||||||
|
__get_remote_file "$tools_source/korebuild/channels/$channel/latest.txt" "$lock_file"
|
||||||
|
fi
|
||||||
|
version="$(grep 'version:*' -m 1 "$lock_file")"
|
||||||
|
if [[ "$version" == '' ]]; then
|
||||||
|
__error "Failed to parse version from $lock_file. Expected a line that begins with 'version:'"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
version="$(echo "${version#version:}" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
|
||||||
|
local korebuild_path="$DOTNET_HOME/buildtools/korebuild/$version"
|
||||||
|
|
||||||
|
{
|
||||||
|
if [ ! -d "$korebuild_path" ]; then
|
||||||
|
mkdir -p "$korebuild_path"
|
||||||
|
local remote_path="$tools_source/korebuild/artifacts/$version/korebuild.$version.zip"
|
||||||
|
tmpfile="$(mktemp)"
|
||||||
|
echo -e "${MAGENTA}Downloading KoreBuild ${version}${RESET}"
|
||||||
|
if __get_remote_file "$remote_path" "$tmpfile"; then
|
||||||
|
unzip -q -d "$korebuild_path" "$tmpfile"
|
||||||
|
fi
|
||||||
|
rm "$tmpfile" || true
|
||||||
|
fi
|
||||||
|
|
||||||
|
source "$korebuild_path/KoreBuild.sh"
|
||||||
|
} || {
|
||||||
|
if [ -d "$korebuild_path" ]; then
|
||||||
|
echo "Cleaning up after failed installation"
|
||||||
|
rm -rf "$korebuild_path" || true
|
||||||
|
fi
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
__error() {
|
||||||
|
echo -e "${RED}error: $*${RESET}" 1>&2
|
||||||
|
}
|
||||||
|
|
||||||
|
__warn() {
|
||||||
|
echo -e "${YELLOW}warning: $*${RESET}"
|
||||||
|
}
|
||||||
|
|
||||||
|
__machine_has() {
|
||||||
|
hash "$1" > /dev/null 2>&1
|
||||||
|
return $?
|
||||||
|
}
|
||||||
|
|
||||||
|
__get_remote_file() {
|
||||||
|
local remote_path=$1
|
||||||
|
local local_path=$2
|
||||||
|
|
||||||
|
if [[ "$remote_path" != 'http'* ]]; then
|
||||||
|
cp "$remote_path" "$local_path"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
local failed=false
|
||||||
|
if __machine_has wget; then
|
||||||
|
wget --tries 10 --quiet -O "$local_path" "$remote_path" || failed=true
|
||||||
|
else
|
||||||
|
failed=true
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$failed" = true ] && __machine_has curl; then
|
||||||
|
failed=false
|
||||||
|
curl --retry 10 -sSL -f --create-dirs -o "$local_path" "$remote_path" || failed=true
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ "$failed" = true ]; then
|
||||||
|
__error "Download failed: $remote_path" 1>&2
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
#
|
||||||
|
# main
|
||||||
|
#
|
||||||
|
|
||||||
|
while [[ $# -gt 0 ]]; do
|
||||||
|
case $1 in
|
||||||
|
-\?|-h|--help)
|
||||||
|
__usage --no-exit
|
||||||
|
exit 0
|
||||||
|
;;
|
||||||
|
-c|--channel|-Channel)
|
||||||
|
shift
|
||||||
|
channel="${1:-}"
|
||||||
|
[ -z "$channel" ] && __usage
|
||||||
|
;;
|
||||||
|
--config-file|-ConfigFile)
|
||||||
|
shift
|
||||||
|
config_file="${1:-}"
|
||||||
|
[ -z "$config_file" ] && __usage
|
||||||
|
if [ ! -f "$config_file" ]; then
|
||||||
|
__error "Invalid value for --config-file. $config_file does not exist."
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
-d|--dotnet-home|-DotNetHome)
|
||||||
|
shift
|
||||||
|
DOTNET_HOME="${1:-}"
|
||||||
|
[ -z "$DOTNET_HOME" ] && __usage
|
||||||
|
;;
|
||||||
|
--path|-Path)
|
||||||
|
shift
|
||||||
|
repo_path="${1:-}"
|
||||||
|
[ -z "$repo_path" ] && __usage
|
||||||
|
;;
|
||||||
|
-s|--tools-source|-ToolsSource)
|
||||||
|
shift
|
||||||
|
tools_source="${1:-}"
|
||||||
|
[ -z "$tools_source" ] && __usage
|
||||||
|
;;
|
||||||
|
-u|--update|-Update)
|
||||||
|
update=true
|
||||||
|
;;
|
||||||
|
--verbose|-Verbose)
|
||||||
|
verbose=true
|
||||||
|
;;
|
||||||
|
--)
|
||||||
|
shift
|
||||||
|
break
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
break
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
shift
|
||||||
|
done
|
||||||
|
|
||||||
|
if ! __machine_has unzip; then
|
||||||
|
__error 'Missing required command: unzip'
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if ! __machine_has curl && ! __machine_has wget; then
|
||||||
|
__error 'Missing required command. Either wget or curl is required.'
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
[ -z "${config_file:-}" ] && config_file="$repo_path/korebuild.json"
|
||||||
|
if [ -f "$config_file" ]; then
|
||||||
|
if __machine_has jq ; then
|
||||||
|
if jq '.' "$config_file" >/dev/null ; then
|
||||||
|
config_channel="$(jq -r 'select(.channel!=null) | .channel' "$config_file")"
|
||||||
|
config_tools_source="$(jq -r 'select(.toolsSource!=null) | .toolsSource' "$config_file")"
|
||||||
|
else
|
||||||
|
__warn "$config_file is invalid JSON. Its settings will be ignored."
|
||||||
|
fi
|
||||||
|
elif __machine_has python ; then
|
||||||
|
if python -c "import json,codecs;obj=json.load(codecs.open('$config_file', 'r', 'utf-8-sig'))" >/dev/null ; then
|
||||||
|
config_channel="$(python -c "import json,codecs;obj=json.load(codecs.open('$config_file', 'r', 'utf-8-sig'));print(obj['channel'] if 'channel' in obj else '')")"
|
||||||
|
config_tools_source="$(python -c "import json,codecs;obj=json.load(codecs.open('$config_file', 'r', 'utf-8-sig'));print(obj['toolsSource'] if 'toolsSource' in obj else '')")"
|
||||||
|
else
|
||||||
|
__warn "$config_file is invalid JSON. Its settings will be ignored."
|
||||||
|
fi
|
||||||
|
else
|
||||||
|
__warn 'Missing required command: jq or pyton. Could not parse the JSON file. Its settings will be ignored.'
|
||||||
|
fi
|
||||||
|
|
||||||
|
[ ! -z "${config_channel:-}" ] && channel="$config_channel"
|
||||||
|
[ ! -z "${config_tools_source:-}" ] && tools_source="$config_tools_source"
|
||||||
|
fi
|
||||||
|
|
||||||
|
[ -z "$channel" ] && channel='dev'
|
||||||
|
[ -z "$tools_source" ] && tools_source='https://aspnetcore.blob.core.windows.net/buildtools'
|
||||||
|
|
||||||
|
get_korebuild
|
||||||
|
install_tools "$tools_source" "$DOTNET_HOME"
|
||||||
|
invoke_repository_build "$repo_path" "$@"
|
||||||
@@ -1,15 +1,17 @@
|
|||||||
<Project>
|
<Project>
|
||||||
<Import Project="version.props" />
|
|
||||||
<Import Project="build\dependencies.props" />
|
|
||||||
<Import Project="build\sources.props" />
|
|
||||||
|
|
||||||
<PropertyGroup>
|
<PropertyGroup>
|
||||||
<Product>Microsoft ASP.NET Core</Product>
|
<Product>Microsoft ASP.NET Core</Product>
|
||||||
<RepositoryUrl>https://github.com/aspnet/javascriptservices</RepositoryUrl>
|
<RepositoryUrl>https://github.com/aspnet/javascriptservices</RepositoryUrl>
|
||||||
<RepositoryType>git</RepositoryType>
|
<RepositoryType>git</RepositoryType>
|
||||||
<RepositoryRoot>$(MSBuildThisFileDirectory)</RepositoryRoot>
|
<AssemblyOriginatorKeyFile>$(MSBuildThisFileDirectory)Key.snk</AssemblyOriginatorKeyFile>
|
||||||
<AssemblyOriginatorKeyFile>$(MSBuildThisFileDirectory)build\Key.snk</AssemblyOriginatorKeyFile>
|
|
||||||
<SignAssembly>true</SignAssembly>
|
<SignAssembly>true</SignAssembly>
|
||||||
|
<PublicSign Condition="'$(OS)' != 'Windows_NT'">true</PublicSign>
|
||||||
<TreatWarningsAsErrors>true</TreatWarningsAsErrors>
|
<TreatWarningsAsErrors>true</TreatWarningsAsErrors>
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<PackageReference Include="Internal.AspNetCore.Sdk" Version="$(InternalAspNetCoreSdkPackageVersion)" PrivateAssets="All" />
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
</Project>
|
</Project>
|
||||||
23
build/dependencies.props
Normal file
23
build/dependencies.props
Normal file
@@ -0,0 +1,23 @@
|
|||||||
|
<Project>
|
||||||
|
<PropertyGroup>
|
||||||
|
<InternalAspNetCoreSdkPackageVersion>2.0.2-rc1-15526</InternalAspNetCoreSdkPackageVersion>
|
||||||
|
<MicrosoftAspNetCoreDiagnosticsPackageVersion>2.0.1-rtm-105</MicrosoftAspNetCoreDiagnosticsPackageVersion>
|
||||||
|
<MicrosoftAspNetCoreHostingAbstractionsPackageVersion>2.0.1-rtm-105</MicrosoftAspNetCoreHostingAbstractionsPackageVersion>
|
||||||
|
<MicrosoftAspNetCoreHostingPackageVersion>2.0.1-rtm-105</MicrosoftAspNetCoreHostingPackageVersion>
|
||||||
|
<MicrosoftAspNetCoreMvcPackageVersion>2.0.1-rtm-105</MicrosoftAspNetCoreMvcPackageVersion>
|
||||||
|
<MicrosoftAspNetCoreMvcTagHelpersPackageVersion>2.0.1-rtm-105</MicrosoftAspNetCoreMvcTagHelpersPackageVersion>
|
||||||
|
<MicrosoftAspNetCoreMvcViewFeaturesPackageVersion>2.0.1-rtm-105</MicrosoftAspNetCoreMvcViewFeaturesPackageVersion>
|
||||||
|
<MicrosoftAspNetCoreServerIISIntegrationPackageVersion>2.0.1-rtm-105</MicrosoftAspNetCoreServerIISIntegrationPackageVersion>
|
||||||
|
<MicrosoftAspNetCoreServerKestrelPackageVersion>2.0.1-rtm-105</MicrosoftAspNetCoreServerKestrelPackageVersion>
|
||||||
|
<MicrosoftAspNetCoreStaticFilesPackageVersion>2.0.1-rtm-105</MicrosoftAspNetCoreStaticFilesPackageVersion>
|
||||||
|
<MicrosoftExtensionsDependencyInjectionPackageVersion>2.0.0</MicrosoftExtensionsDependencyInjectionPackageVersion>
|
||||||
|
<MicrosoftExtensionsLoggingConsolePackageVersion>2.0.0</MicrosoftExtensionsLoggingConsolePackageVersion>
|
||||||
|
<MicrosoftExtensionsLoggingDebugPackageVersion>2.0.0</MicrosoftExtensionsLoggingDebugPackageVersion>
|
||||||
|
<NewtonsoftJsonRuntimePackageVersion>10.0.1</NewtonsoftJsonRuntimePackageVersion>
|
||||||
|
<MicrosoftNETCoreApp20PackageVersion>2.0.5</MicrosoftNETCoreApp20PackageVersion>
|
||||||
|
<NETStandardLibrary20PackageVersion>2.0.1</NETStandardLibrary20PackageVersion>
|
||||||
|
<SystemThreadingTasksDataflowPackageVersion>4.8.0</SystemThreadingTasksDataflowPackageVersion>
|
||||||
|
</PropertyGroup>
|
||||||
|
|
||||||
|
<Import Project="$(DotNetPackageVersionPropsPath)" Condition=" '$(DotNetPackageVersionPropsPath)' != '' " />
|
||||||
|
</Project>
|
||||||
@@ -1,12 +1,12 @@
|
|||||||
<Project>
|
<Project>
|
||||||
<Import Project="$(DotNetRestoreSourcePropsPath)" Condition="'$(DotNetRestoreSourcePropsPath)' != ''"/>
|
<Import Project="$(DotNetRestoreSourcePropsPath)" Condition="'$(DotNetRestoreSourcePropsPath)' != ''"/>
|
||||||
|
|
||||||
<PropertyGroup Label="RestoreSources">
|
<PropertyGroup>
|
||||||
<RestoreSources>$(DotNetRestoreSources)</RestoreSources>
|
<RestoreSources>$(DotNetRestoreSources)</RestoreSources>
|
||||||
<RestoreSources Condition="'$(DotNetBuildOffline)' != 'true' AND '$(AspNetUniverseBuildOffline)' != 'true' ">
|
<RestoreSources Condition="'$(DotNetBuildOffline)' != 'true' AND '$(AspNetUniverseBuildOffline)' != 'true' ">
|
||||||
$(RestoreSources);
|
$(RestoreSources);
|
||||||
https://dotnet.myget.org/F/dotnet-core/api/v3/index.json;
|
https://dotnet.myget.org/F/aspnet-2-0-2-october2017-patch/api/v3/index.json;
|
||||||
https://dotnet.myget.org/F/aspnetcore-dev/api/v3/index.json;
|
https://dotnet.myget.org/F/aspnetcore-master/api/v3/index.json;
|
||||||
https://dotnet.myget.org/F/aspnetcore-tools/api/v3/index.json;
|
https://dotnet.myget.org/F/aspnetcore-tools/api/v3/index.json;
|
||||||
</RestoreSources>
|
</RestoreSources>
|
||||||
<RestoreSources Condition="'$(DotNetBuildOffline)' != 'true'">
|
<RestoreSources Condition="'$(DotNetBuildOffline)' != 'true'">
|
||||||
2
korebuild-lock.txt
Normal file
2
korebuild-lock.txt
Normal file
@@ -0,0 +1,2 @@
|
|||||||
|
version:2.0.5-rtm-10016
|
||||||
|
commithash:02bda79ac9c564229da734a836f258d6c1321eb7
|
||||||
4
korebuild.json
Normal file
4
korebuild.json
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://raw.githubusercontent.com/aspnet/BuildTools/release/2.0/tools/korebuild.schema.json",
|
||||||
|
"channel": "release/2.0"
|
||||||
|
}
|
||||||
@@ -1,7 +1,9 @@
|
|||||||
<Project Sdk="Microsoft.NET.Sdk">
|
<Project Sdk="Microsoft.NET.Sdk">
|
||||||
|
|
||||||
|
<Import Project="..\..\..\build\common.props" />
|
||||||
|
|
||||||
<PropertyGroup>
|
<PropertyGroup>
|
||||||
<TargetFramework>netcoreapp3.0</TargetFramework>
|
<TargetFrameworks>netcoreapp2.0;net461</TargetFrameworks>
|
||||||
<IsPackable>false</IsPackable>
|
<IsPackable>false</IsPackable>
|
||||||
<OutputType>exe</OutputType>
|
<OutputType>exe</OutputType>
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
@@ -13,7 +15,6 @@
|
|||||||
|
|
||||||
<ItemGroup>
|
<ItemGroup>
|
||||||
<PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="$(MicrosoftExtensionsDependencyInjectionPackageVersion)" />
|
<PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="$(MicrosoftExtensionsDependencyInjectionPackageVersion)" />
|
||||||
<PackageReference Include="Microsoft.Extensions.Logging.Console" Version="$(MicrosoftExtensionsLoggingConsolePackageVersion)" />
|
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
|
|
||||||
</Project>
|
</Project>
|
||||||
1
src/JavaScriptServices/samples/misc/LatencyTest/Program.cs → samples/misc/LatencyTest/Program.cs
Normal file → Executable file
1
src/JavaScriptServices/samples/misc/LatencyTest/Program.cs → samples/misc/LatencyTest/Program.cs
Normal file → Executable file
@@ -21,6 +21,7 @@ namespace ConsoleApplication
|
|||||||
// Since .NET Core 1.1, the HTTP hosting model has become basically as fast as the Socket hosting model
|
// Since .NET Core 1.1, the HTTP hosting model has become basically as fast as the Socket hosting model
|
||||||
//options.UseSocketHosting();
|
//options.UseSocketHosting();
|
||||||
|
|
||||||
|
options.ProjectPath = Directory.GetCurrentDirectory();
|
||||||
options.WatchFileExtensions = new string[] {}; // Don't watch anything
|
options.WatchFileExtensions = new string[] {}; // Don't watch anything
|
||||||
});
|
});
|
||||||
var serviceProvider = services.BuildServiceProvider();
|
var serviceProvider = services.BuildServiceProvider();
|
||||||
@@ -1,7 +1,9 @@
|
|||||||
<Project Sdk="Microsoft.NET.Sdk.Web">
|
<Project Sdk="Microsoft.NET.Sdk.Web">
|
||||||
|
|
||||||
|
<Import Project="..\..\..\build\common.props" />
|
||||||
|
|
||||||
<PropertyGroup>
|
<PropertyGroup>
|
||||||
<TargetFramework>netcoreapp3.0</TargetFramework>
|
<TargetFrameworks>netcoreapp2.0;net461</TargetFrameworks>
|
||||||
<TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>
|
<TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>
|
||||||
<IsPackable>false</IsPackable>
|
<IsPackable>false</IsPackable>
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
@@ -18,8 +20,6 @@
|
|||||||
<PackageReference Include="Microsoft.AspNetCore.Server.Kestrel" Version="$(MicrosoftAspNetCoreServerKestrelPackageVersion)" />
|
<PackageReference Include="Microsoft.AspNetCore.Server.Kestrel" Version="$(MicrosoftAspNetCoreServerKestrelPackageVersion)" />
|
||||||
<PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="$(MicrosoftAspNetCoreStaticFilesPackageVersion)" />
|
<PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="$(MicrosoftAspNetCoreStaticFilesPackageVersion)" />
|
||||||
<PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="$(MicrosoftExtensionsLoggingDebugPackageVersion)" />
|
<PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="$(MicrosoftExtensionsLoggingDebugPackageVersion)" />
|
||||||
<PackageReference Include="Microsoft.Extensions.Logging.Console" Version="$(MicrosoftExtensionsLoggingConsolePackageVersion)" />
|
|
||||||
<PackageReference Include="Microsoft.NET.Sdk.Razor" Version="$(MicrosoftNETSdkRazorPackageVersion)" PrivateAssets="All" />
|
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
|
|
||||||
<Target Name="PrepublishScript" BeforeTargets="PrepareForPublish">
|
<Target Name="PrepublishScript" BeforeTargets="PrepareForPublish">
|
||||||
0
src/JavaScriptServices/samples/misc/NodeServicesExamples/Startup.cs → samples/misc/NodeServicesExamples/Startup.cs
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/NodeServicesExamples/Startup.cs → samples/misc/NodeServicesExamples/Startup.cs
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/NodeServicesExamples/appsettings.json → samples/misc/NodeServicesExamples/appsettings.json
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/NodeServicesExamples/appsettings.json → samples/misc/NodeServicesExamples/appsettings.json
Normal file → Executable file
|
Before Width: | Height: | Size: 31 KiB After Width: | Height: | Size: 31 KiB |
0
src/JavaScriptServices/samples/misc/Webpack/Controllers/HomeController.cs → samples/misc/Webpack/Controllers/HomeController.cs
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Controllers/HomeController.cs → samples/misc/Webpack/Controllers/HomeController.cs
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Startup.cs → samples/misc/Webpack/Startup.cs
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Startup.cs → samples/misc/Webpack/Startup.cs
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Views/Home/Index.cshtml → samples/misc/Webpack/Views/Home/Index.cshtml
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Views/Home/Index.cshtml → samples/misc/Webpack/Views/Home/Index.cshtml
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Views/Shared/Error.cshtml → samples/misc/Webpack/Views/Shared/Error.cshtml
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Views/Shared/Error.cshtml → samples/misc/Webpack/Views/Shared/Error.cshtml
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Views/Shared/_Layout.cshtml → samples/misc/Webpack/Views/Shared/_Layout.cshtml
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Views/Shared/_Layout.cshtml → samples/misc/Webpack/Views/Shared/_Layout.cshtml
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Views/_ViewImports.cshtml → samples/misc/Webpack/Views/_ViewImports.cshtml
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Views/_ViewImports.cshtml → samples/misc/Webpack/Views/_ViewImports.cshtml
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Views/_ViewStart.cshtml → samples/misc/Webpack/Views/_ViewStart.cshtml
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/Views/_ViewStart.cshtml → samples/misc/Webpack/Views/_ViewStart.cshtml
Normal file → Executable file
@@ -1,7 +1,9 @@
|
|||||||
<Project Sdk="Microsoft.NET.Sdk.Web">
|
<Project Sdk="Microsoft.NET.Sdk.Web">
|
||||||
|
|
||||||
|
<Import Project="..\..\..\build\common.props" />
|
||||||
|
|
||||||
<PropertyGroup>
|
<PropertyGroup>
|
||||||
<TargetFramework>netcoreapp3.0</TargetFramework>
|
<TargetFrameworks>netcoreapp2.0;net461</TargetFrameworks>
|
||||||
<TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>
|
<TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>
|
||||||
<IsPackable>false</IsPackable>
|
<IsPackable>false</IsPackable>
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
@@ -18,8 +20,6 @@
|
|||||||
<PackageReference Include="Microsoft.AspNetCore.Server.Kestrel" Version="$(MicrosoftAspNetCoreServerKestrelPackageVersion)" />
|
<PackageReference Include="Microsoft.AspNetCore.Server.Kestrel" Version="$(MicrosoftAspNetCoreServerKestrelPackageVersion)" />
|
||||||
<PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="$(MicrosoftAspNetCoreStaticFilesPackageVersion)" />
|
<PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="$(MicrosoftAspNetCoreStaticFilesPackageVersion)" />
|
||||||
<PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="$(MicrosoftExtensionsLoggingDebugPackageVersion)" />
|
<PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="$(MicrosoftExtensionsLoggingDebugPackageVersion)" />
|
||||||
<PackageReference Include="Microsoft.Extensions.Logging.Console" Version="$(MicrosoftExtensionsLoggingConsolePackageVersion)" />
|
|
||||||
<PackageReference Include="Microsoft.NET.Sdk.Razor" Version="$(MicrosoftNETSdkRazorPackageVersion)" PrivateAssets="All" />
|
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
|
|
||||||
<Target Name="PrepublishScript" BeforeTargets="PrepareForPublish">
|
<Target Name="PrepublishScript" BeforeTargets="PrepareForPublish">
|
||||||
0
src/JavaScriptServices/samples/misc/Webpack/appsettings.json → samples/misc/Webpack/appsettings.json
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/appsettings.json → samples/misc/Webpack/appsettings.json
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/wwwroot/favicon.ico → samples/misc/Webpack/wwwroot/favicon.ico
Normal file → Executable file
0
src/JavaScriptServices/samples/misc/Webpack/wwwroot/favicon.ico → samples/misc/Webpack/wwwroot/favicon.ico
Normal file → Executable file
|
Before Width: | Height: | Size: 31 KiB After Width: | Height: | Size: 31 KiB |
31
src/JavaScriptServices/.gitignore
vendored
31
src/JavaScriptServices/.gitignore
vendored
@@ -1,31 +0,0 @@
|
|||||||
[Oo]bj/
|
|
||||||
[Bb]in/
|
|
||||||
TestResults/
|
|
||||||
.nuget/
|
|
||||||
*.sln.ide/
|
|
||||||
_ReSharper.*/
|
|
||||||
packages/
|
|
||||||
artifacts/
|
|
||||||
PublishProfiles/
|
|
||||||
*.user
|
|
||||||
*.suo
|
|
||||||
*.cache
|
|
||||||
*.docstates
|
|
||||||
_ReSharper.*
|
|
||||||
nuget.exe
|
|
||||||
*net45.csproj
|
|
||||||
*net451.csproj
|
|
||||||
*k10.csproj
|
|
||||||
*.psess
|
|
||||||
*.vsp
|
|
||||||
*.pidb
|
|
||||||
*.userprefs
|
|
||||||
*DS_Store
|
|
||||||
*.ncrunchsolution
|
|
||||||
*.*sdf
|
|
||||||
*.ipch
|
|
||||||
.vs/
|
|
||||||
npm-debug.log
|
|
||||||
/.build/
|
|
||||||
.vscode/
|
|
||||||
global.json
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
{
|
|
||||||
"Default": {
|
|
||||||
"rules": [
|
|
||||||
"DefaultCompositeRule"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,96 +0,0 @@
|
|||||||
# JavaScriptServices
|
|
||||||
|
|
||||||
AppVeyor: [](https://ci.appveyor.com/project/aspnetci/javascriptservices/branch/dev)
|
|
||||||
|
|
||||||
This project is part of ASP.NET Core. You can find samples, documentation and getting started instructions for ASP.NET Core at the [Home](https://github.com/aspnet/home) repo.
|
|
||||||
|
|
||||||
## What is this?
|
|
||||||
|
|
||||||
`JavaScriptServices` is a set of client-side technologies for ASP.NET Core. It provides infrastructure that you'll find useful if you:
|
|
||||||
|
|
||||||
- Use Angular / React / Vue / Aurelia / Knockout / etc.
|
|
||||||
- Build your client-side resources using Webpack.
|
|
||||||
- Execute JavaScript on the server at runtime.
|
|
||||||
|
|
||||||
Read [Building Single Page Applications on ASP.NET Core with JavaScriptServices](https://blogs.msdn.microsoft.com/webdev/2017/02/14/building-single-page-applications-on-asp-net-core-with-javascriptservices/) for more details.
|
|
||||||
|
|
||||||
This repo contains:
|
|
||||||
|
|
||||||
* A set of NuGet/NPM packages that implement functionality for:
|
|
||||||
* Invoking arbitrary NPM packages at runtime from .NET code ([docs](/src/Microsoft.AspNetCore.NodeServices#simple-usage-example))
|
|
||||||
* Server-side prerendering of SPA components ([docs](/src/Microsoft.AspNetCore.SpaServices#server-side-prerendering))
|
|
||||||
* Webpack dev middleware ([docs](/src/Microsoft.AspNetCore.SpaServices#webpack-dev-middleware))
|
|
||||||
* Hot module replacement (HMR) ([docs](/src/Microsoft.AspNetCore.SpaServices#webpack-hot-module-replacement))
|
|
||||||
* Server-side and client-side routing integration ([docs](/src/Microsoft.AspNetCore.SpaServices#routing-helper-mapspafallbackroute))
|
|
||||||
* Server-side and client-side validation integration
|
|
||||||
* "Lazy loading" for Knockout apps
|
|
||||||
* Samples and docs
|
|
||||||
|
|
||||||
It's cross-platform (Windows, Linux, or macOS) and works with .NET Core 2.0 or later.
|
|
||||||
|
|
||||||
## Creating new applications
|
|
||||||
|
|
||||||
Prerequisites:
|
|
||||||
|
|
||||||
* [.NET Core 2.0](https://www.microsoft.com/net/core) (or later) SDK
|
|
||||||
* [Node.js](https://nodejs.org/) version 6 (or later)
|
|
||||||
|
|
||||||
With these prerequisites, you can immediately create new ASP.NET Core applications that use Angular, React, or React+Redux without having to install anything extra.
|
|
||||||
|
|
||||||
### Option 1: Creating Angular/React/Redux applications from the command line (cross-platform)
|
|
||||||
|
|
||||||
In an empty directory, run (for example) `dotnet new angular`. Other supported SPA frameworks include React and React+Redux. You can see the list of available SPA templates by running `dotnet new spa`.
|
|
||||||
|
|
||||||
Once the generator has run and restored all the dependencies, you can start up your new ASP.NET Core SPA:
|
|
||||||
|
|
||||||
npm install
|
|
||||||
dotnet run
|
|
||||||
|
|
||||||
### Option 2: Creating Angular/React/Redux applications using Visual Studio 2017 Update 3 or later (Windows only)
|
|
||||||
|
|
||||||
Using the `File`->`New Project` dialog, select *ASP.NET Core Web Application*. You will then be offered the option to create an application with Angular, React, or React+Redux. When the application is created, you can build and run it in the normal way.
|
|
||||||
|
|
||||||
### More info and other SPA frameworks
|
|
||||||
|
|
||||||
For a more detailed (albeit somewhat outdated) walkthrough, see [getting started with the `aspnetcore-spa` generator](http://blog.stevensanderson.com/2016/05/02/angular2-react-knockout-apps-on-aspnet-core/).
|
|
||||||
|
|
||||||
If you want to build an ASP.NET Core application with Aurelia, Knockout, or Vue, you can use the `Microsoft.AspNetCore.SpaTemplates` package. On the command line, run `dotnet new --install Microsoft.AspNetCore.SpaTemplates`. Then you will be able to run `dotnet new aurelia` (or `dotnet new vue`, etc.) to create your new application.
|
|
||||||
|
|
||||||
## Adding to existing applications
|
|
||||||
|
|
||||||
If you have an existing ASP.NET Core application, or if you just want to use the underlying JavaScriptServices packages directly, you can install these packages using NuGet and NPM:
|
|
||||||
|
|
||||||
* `Microsoft.AspNetCore.NodeServices`
|
|
||||||
* This provides a fast and robust way for .NET code to run JavaScript on the server inside a Node.js environment. You can use this to consume arbitrary functionality from NPM packages at runtime in your ASP.NET Core app.
|
|
||||||
* Most applications developers don't need to use this directly, but you can do so if you want to implement your own functionality that involves calling Node.js code from .NET at runtime.
|
|
||||||
* Find [documentation and usage examples here](/src/Microsoft.AspNetCore.NodeServices#microsoftaspnetcorenodeservices).
|
|
||||||
* `Microsoft.AspNetCore.SpaServices`
|
|
||||||
* This provides infrastructure that's generally useful when building Single Page Applications (SPAs) with technologies such as Angular or React (for example, server-side prerendering and webpack middleware). Internally, it uses the `NodeServices` package to implement its features.
|
|
||||||
* Find [documentation and usage examples here](/src/Microsoft.AspNetCore.SpaServices#microsoftaspnetcorespaservices)
|
|
||||||
|
|
||||||
There were previously other packages called `Microsoft.AspNetCore.AngularServices` and `Microsoft.AspNetCore.ReactServices` but these are not currently needed - all applicable functionality is in `Microsoft.AspNetCore.SpaServices`, because it's sufficiently general.
|
|
||||||
|
|
||||||
If you want to build a helper library for some other SPA framework, you can do so by taking a dependency on `Microsoft.AspNetCore.SpaServices` and wrapping its functionality in whatever way is most useful for your SPA framework.
|
|
||||||
|
|
||||||
## Samples
|
|
||||||
|
|
||||||
The [`samples` directory](/samples) contains examples of:
|
|
||||||
|
|
||||||
- Using the JavaScript services family of packages with Angular and React.
|
|
||||||
- A standalone `NodeServices` usage for runtime code transpilation and image processing.
|
|
||||||
|
|
||||||
**To run the samples:**
|
|
||||||
|
|
||||||
* Clone this repo
|
|
||||||
* At the repo's root directory (the one containing `src`, `samples`, etc.), run `dotnet restore`
|
|
||||||
* Change directory to the sample you want to run (for example, `cd samples/angular/MusicStore`)
|
|
||||||
* Restore Node dependencies by running `npm install`
|
|
||||||
* If you're trying to run the Angular "Music Store" sample, then also run `gulp` (which you need to have installed globally). None of the other samples require this.
|
|
||||||
* Run the application (`dotnet run`)
|
|
||||||
* Browse to [http://localhost:5000](http://localhost:5000)
|
|
||||||
|
|
||||||
## Contributing
|
|
||||||
|
|
||||||
If you're interested in contributing to the various packages, samples, and project templates in this repo, that's great!
|
|
||||||
|
|
||||||
Before working on a pull request, especially if it's more than a trivial fix (for example, for a typo), it's usually a good idea first to file an issue describing what you're proposing to do and how it will work. Then you can find out if it's likely that such a pull request will be accepted, and how it fits into wider ongoing plans.
|
|
||||||
@@ -1,30 +0,0 @@
|
|||||||
<Project>
|
|
||||||
<PropertyGroup>
|
|
||||||
<MSBuildAllProjects>$(MSBuildAllProjects);$(MSBuildThisFileFullPath)</MSBuildAllProjects>
|
|
||||||
</PropertyGroup>
|
|
||||||
<PropertyGroup Label="Package Versions">
|
|
||||||
<InternalAspNetCoreSdkPackageVersion>3.0.0-build-20181114.5</InternalAspNetCoreSdkPackageVersion>
|
|
||||||
<MicrosoftAspNetCoreDiagnosticsPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreDiagnosticsPackageVersion>
|
|
||||||
<MicrosoftAspNetCoreHostingAbstractionsPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreHostingAbstractionsPackageVersion>
|
|
||||||
<MicrosoftAspNetCoreHostingPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreHostingPackageVersion>
|
|
||||||
<MicrosoftAspNetCoreMvcPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreMvcPackageVersion>
|
|
||||||
<MicrosoftAspNetCoreMvcTagHelpersPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreMvcTagHelpersPackageVersion>
|
|
||||||
<MicrosoftAspNetCoreMvcViewFeaturesPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreMvcViewFeaturesPackageVersion>
|
|
||||||
<MicrosoftAspNetCoreServerIISIntegrationPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreServerIISIntegrationPackageVersion>
|
|
||||||
<MicrosoftAspNetCoreServerKestrelPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreServerKestrelPackageVersion>
|
|
||||||
<MicrosoftAspNetCoreStaticFilesPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreStaticFilesPackageVersion>
|
|
||||||
<MicrosoftAspNetCoreWebSocketsPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreWebSocketsPackageVersion>
|
|
||||||
<MicrosoftExtensionsDependencyInjectionPackageVersion>3.0.0-preview-181113-11</MicrosoftExtensionsDependencyInjectionPackageVersion>
|
|
||||||
<MicrosoftExtensionsFileProvidersPhysicalPackageVersion>3.0.0-preview-181113-11</MicrosoftExtensionsFileProvidersPhysicalPackageVersion>
|
|
||||||
<MicrosoftExtensionsLoggingAbstractionsPackageVersion>3.0.0-preview-181113-11</MicrosoftExtensionsLoggingAbstractionsPackageVersion>
|
|
||||||
<MicrosoftExtensionsLoggingConsolePackageVersion>3.0.0-preview-181113-11</MicrosoftExtensionsLoggingConsolePackageVersion>
|
|
||||||
<MicrosoftExtensionsLoggingDebugPackageVersion>3.0.0-preview-181113-11</MicrosoftExtensionsLoggingDebugPackageVersion>
|
|
||||||
<MicrosoftNETCoreAppPackageVersion>3.0.0-preview1-26907-05</MicrosoftNETCoreAppPackageVersion>
|
|
||||||
<MicrosoftNETSdkRazorPackageVersion>3.0.0-alpha1-10742</MicrosoftNETSdkRazorPackageVersion>
|
|
||||||
<NETStandardLibrary20PackageVersion>2.0.3</NETStandardLibrary20PackageVersion>
|
|
||||||
<NewtonsoftJsonPackageVersion>11.0.2</NewtonsoftJsonPackageVersion>
|
|
||||||
<SystemThreadingTasksDataflowPackageVersion>4.10.0-preview1-26907-04</SystemThreadingTasksDataflowPackageVersion>
|
|
||||||
</PropertyGroup>
|
|
||||||
<Import Project="$(DotNetPackageVersionPropsPath)" Condition=" '$(DotNetPackageVersionPropsPath)' != '' " />
|
|
||||||
<PropertyGroup Label="Package Versions: Pinned" />
|
|
||||||
</Project>
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
<Project>
|
|
||||||
<Import Project="dependencies.props" />
|
|
||||||
|
|
||||||
<PropertyGroup>
|
|
||||||
<!-- These properties are use by the automation that updates dependencies.props -->
|
|
||||||
<LineupPackageId>Internal.AspNetCore.Universe.Lineup</LineupPackageId>
|
|
||||||
<LineupPackageRestoreSource>https://dotnet.myget.org/F/aspnetcore-dev/api/v3/index.json</LineupPackageRestoreSource>
|
|
||||||
</PropertyGroup>
|
|
||||||
|
|
||||||
<ItemGroup>
|
|
||||||
<DotNetCoreRuntime Include="$(MicrosoftNETCoreAppPackageVersion)" />
|
|
||||||
</ItemGroup>
|
|
||||||
</Project>
|
|
||||||
@@ -1,28 +0,0 @@
|
|||||||
[cmdletbinding(SupportsShouldProcess = $true)]
|
|
||||||
param(
|
|
||||||
)
|
|
||||||
|
|
||||||
$ErrorActionPreference = 'Stop'
|
|
||||||
Set-StrictMode -Version 2
|
|
||||||
|
|
||||||
Push-Location "src"
|
|
||||||
try {
|
|
||||||
$dirs = Get-ChildItem -Directory
|
|
||||||
foreach($dir in $dirs)
|
|
||||||
{
|
|
||||||
Push-Location $dir
|
|
||||||
try{
|
|
||||||
if(Test-Path -Path "package.json")
|
|
||||||
{
|
|
||||||
npm install
|
|
||||||
npm run build
|
|
||||||
}
|
|
||||||
}
|
|
||||||
finally{
|
|
||||||
Pop-Location
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
finally {
|
|
||||||
Pop-Location
|
|
||||||
}
|
|
||||||
@@ -1,13 +0,0 @@
|
|||||||
<Project>
|
|
||||||
<Import Project="..\Directory.Build.props" />
|
|
||||||
|
|
||||||
<PropertyGroup>
|
|
||||||
<TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>
|
|
||||||
<GenerateDocumentationFile>true</GenerateDocumentationFile>
|
|
||||||
<PackageTags>aspnetcore;aspnetcoremvc;nodeservices</PackageTags>
|
|
||||||
</PropertyGroup>
|
|
||||||
|
|
||||||
<ItemGroup>
|
|
||||||
<PackageReference Include="Internal.AspNetCore.Sdk" PrivateAssets="All" Version="$(InternalAspNetCoreSdkPackageVersion)" />
|
|
||||||
</ItemGroup>
|
|
||||||
</Project>
|
|
||||||
@@ -1,626 +0,0 @@
|
|||||||
(function (e, a) { for (var i in a) e[i] = a[i]; }(exports, /******/(function (modules) { // webpackBootstrap
|
|
||||||
/******/ // The module cache
|
|
||||||
/******/ var installedModules = {};
|
|
||||||
/******/
|
|
||||||
/******/ // The require function
|
|
||||||
/******/ function __webpack_require__(moduleId) {
|
|
||||||
/******/
|
|
||||||
/******/ // Check if module is in cache
|
|
||||||
/******/ if (installedModules[moduleId]) {
|
|
||||||
/******/ return installedModules[moduleId].exports;
|
|
||||||
/******/
|
|
||||||
}
|
|
||||||
/******/ // Create a new module (and put it into the cache)
|
|
||||||
/******/ var module = installedModules[moduleId] = {
|
|
||||||
/******/ i: moduleId,
|
|
||||||
/******/ l: false,
|
|
||||||
/******/ exports: {}
|
|
||||||
/******/
|
|
||||||
};
|
|
||||||
/******/
|
|
||||||
/******/ // Execute the module function
|
|
||||||
/******/ modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
|
|
||||||
/******/
|
|
||||||
/******/ // Flag the module as loaded
|
|
||||||
/******/ module.l = true;
|
|
||||||
/******/
|
|
||||||
/******/ // Return the exports of the module
|
|
||||||
/******/ return module.exports;
|
|
||||||
/******/
|
|
||||||
}
|
|
||||||
/******/
|
|
||||||
/******/
|
|
||||||
/******/ // expose the modules object (__webpack_modules__)
|
|
||||||
/******/ __webpack_require__.m = modules;
|
|
||||||
/******/
|
|
||||||
/******/ // expose the module cache
|
|
||||||
/******/ __webpack_require__.c = installedModules;
|
|
||||||
/******/
|
|
||||||
/******/ // define getter function for harmony exports
|
|
||||||
/******/ __webpack_require__.d = function (exports, name, getter) {
|
|
||||||
/******/ if (!__webpack_require__.o(exports, name)) {
|
|
||||||
/******/ Object.defineProperty(exports, name, { enumerable: true, get: getter });
|
|
||||||
/******/
|
|
||||||
}
|
|
||||||
/******/
|
|
||||||
};
|
|
||||||
/******/
|
|
||||||
/******/ // define __esModule on exports
|
|
||||||
/******/ __webpack_require__.r = function (exports) {
|
|
||||||
/******/ if (typeof Symbol !== 'undefined' && Symbol.toStringTag) {
|
|
||||||
/******/ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
||||||
/******/
|
|
||||||
}
|
|
||||||
/******/ Object.defineProperty(exports, '__esModule', { value: true });
|
|
||||||
/******/
|
|
||||||
};
|
|
||||||
/******/
|
|
||||||
/******/ // create a fake namespace object
|
|
||||||
/******/ // mode & 1: value is a module id, require it
|
|
||||||
/******/ // mode & 2: merge all properties of value into the ns
|
|
||||||
/******/ // mode & 4: return value when already ns object
|
|
||||||
/******/ // mode & 8|1: behave like require
|
|
||||||
/******/ __webpack_require__.t = function (value, mode) {
|
|
||||||
/******/ if (mode & 1) value = __webpack_require__(value);
|
|
||||||
/******/ if (mode & 8) return value;
|
|
||||||
/******/ if ((mode & 4) && typeof value === 'object' && value && value.__esModule) return value;
|
|
||||||
/******/ var ns = Object.create(null);
|
|
||||||
/******/ __webpack_require__.r(ns);
|
|
||||||
/******/ Object.defineProperty(ns, 'default', { enumerable: true, value: value });
|
|
||||||
/******/ if (mode & 2 && typeof value != 'string') for (var key in value) __webpack_require__.d(ns, key, function (key) { return value[key]; }.bind(null, key));
|
|
||||||
/******/ return ns;
|
|
||||||
/******/
|
|
||||||
};
|
|
||||||
/******/
|
|
||||||
/******/ // getDefaultExport function for compatibility with non-harmony modules
|
|
||||||
/******/ __webpack_require__.n = function (module) {
|
|
||||||
/******/ var getter = module && module.__esModule ?
|
|
||||||
/******/ function getDefault() { return module['default']; } :
|
|
||||||
/******/ function getModuleExports() { return module; };
|
|
||||||
/******/ __webpack_require__.d(getter, 'a', getter);
|
|
||||||
/******/ return getter;
|
|
||||||
/******/
|
|
||||||
};
|
|
||||||
/******/
|
|
||||||
/******/ // Object.prototype.hasOwnProperty.call
|
|
||||||
/******/ __webpack_require__.o = function (object, property) { return Object.prototype.hasOwnProperty.call(object, property); };
|
|
||||||
/******/
|
|
||||||
/******/ // __webpack_public_path__
|
|
||||||
/******/ __webpack_require__.p = "";
|
|
||||||
/******/
|
|
||||||
/******/
|
|
||||||
/******/ // Load entry module and return exports
|
|
||||||
/******/ return __webpack_require__(__webpack_require__.s = 0);
|
|
||||||
/******/
|
|
||||||
})
|
|
||||||
/************************************************************************/
|
|
||||||
/******/([
|
|
||||||
/* 0 */
|
|
||||||
/***/ (function (module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
module.exports = __webpack_require__(1);
|
|
||||||
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 1 */
|
|
||||||
/***/ (function (module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
"use strict";
|
|
||||||
|
|
||||||
exports.__esModule = true;
|
|
||||||
// Limit dependencies to core Node modules. This means the code in this file has to be very low-level and unattractive,
|
|
||||||
// but simplifies things for the consumer of this module.
|
|
||||||
__webpack_require__(2);
|
|
||||||
var net = __webpack_require__(3);
|
|
||||||
var path = __webpack_require__(4);
|
|
||||||
var readline = __webpack_require__(5);
|
|
||||||
var ArgsUtil_1 = __webpack_require__(6);
|
|
||||||
var ExitWhenParentExits_1 = __webpack_require__(7);
|
|
||||||
var virtualConnectionServer = __webpack_require__(8);
|
|
||||||
// Webpack doesn't support dynamic requires for files not present at compile time, so grab a direct
|
|
||||||
// reference to Node's runtime 'require' function.
|
|
||||||
var dynamicRequire = eval('require');
|
|
||||||
// Signal to the .NET side when we're ready to accept invocations
|
|
||||||
var server = net.createServer().on('listening', function () {
|
|
||||||
console.log('[Microsoft.AspNetCore.NodeServices:Listening]');
|
|
||||||
});
|
|
||||||
// Each virtual connection represents a separate invocation
|
|
||||||
virtualConnectionServer.createInterface(server).on('connection', function (connection) {
|
|
||||||
readline.createInterface(connection, null).on('line', function (line) {
|
|
||||||
try {
|
|
||||||
// Get a reference to the function to invoke
|
|
||||||
var invocation = JSON.parse(line);
|
|
||||||
var invokedModule = dynamicRequire(path.resolve(process.cwd(), invocation.moduleName));
|
|
||||||
var invokedFunction = invocation.exportedFunctionName ? invokedModule[invocation.exportedFunctionName] : invokedModule;
|
|
||||||
// Prepare a callback for accepting non-streamed JSON responses
|
|
||||||
var hasInvokedCallback_1 = false;
|
|
||||||
var invocationCallback = function (errorValue, successValue) {
|
|
||||||
if (hasInvokedCallback_1) {
|
|
||||||
throw new Error('Cannot supply more than one result. The callback has already been invoked,'
|
|
||||||
+ ' or the result stream has already been accessed');
|
|
||||||
}
|
|
||||||
hasInvokedCallback_1 = true;
|
|
||||||
connection.end(JSON.stringify({
|
|
||||||
result: successValue,
|
|
||||||
errorMessage: errorValue && (errorValue.message || errorValue),
|
|
||||||
errorDetails: errorValue && (errorValue.stack || null)
|
|
||||||
}));
|
|
||||||
};
|
|
||||||
// Also support streamed binary responses
|
|
||||||
Object.defineProperty(invocationCallback, 'stream', {
|
|
||||||
enumerable: true,
|
|
||||||
get: function () {
|
|
||||||
hasInvokedCallback_1 = true;
|
|
||||||
return connection;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
// Actually invoke it, passing through any supplied args
|
|
||||||
invokedFunction.apply(null, [invocationCallback].concat(invocation.args));
|
|
||||||
}
|
|
||||||
catch (ex) {
|
|
||||||
connection.end(JSON.stringify({
|
|
||||||
errorMessage: ex.message,
|
|
||||||
errorDetails: ex.stack
|
|
||||||
}));
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
// Begin listening now. The underlying transport varies according to the runtime platform.
|
|
||||||
// On Windows it's Named Pipes; on Linux/OSX it's Domain Sockets.
|
|
||||||
var useWindowsNamedPipes = /^win/.test(process.platform);
|
|
||||||
var parsedArgs = ArgsUtil_1.parseArgs(process.argv);
|
|
||||||
var listenAddress = (useWindowsNamedPipes ? '\\\\.\\pipe\\' : '/tmp/') + parsedArgs.listenAddress;
|
|
||||||
server.listen(listenAddress);
|
|
||||||
ExitWhenParentExits_1.exitWhenParentExits(parseInt(parsedArgs.parentPid), /* ignoreSigint */ true);
|
|
||||||
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 2 */
|
|
||||||
/***/ (function (module, exports) {
|
|
||||||
|
|
||||||
// When Node writes to stdout/strerr, we capture that and convert the lines into calls on the
|
|
||||||
// active .NET ILogger. But by default, stdout/stderr don't have any way of distinguishing
|
|
||||||
// linebreaks inside log messages from the linebreaks that delimit separate log messages,
|
|
||||||
// so multiline strings will end up being written to the ILogger as multiple independent
|
|
||||||
// log messages. This makes them very hard to make sense of, especially when they represent
|
|
||||||
// something like stack traces.
|
|
||||||
//
|
|
||||||
// To fix this, we intercept stdout/stderr writes, and replace internal linebreaks with a
|
|
||||||
// marker token. When .NET receives the lines, it converts the marker tokens back to regular
|
|
||||||
// linebreaks within the logged messages.
|
|
||||||
//
|
|
||||||
// Note that it's better to do the interception at the stdout/stderr level, rather than at
|
|
||||||
// the console.log/console.error (etc.) level, because this takes place after any native
|
|
||||||
// message formatting has taken place (e.g., inserting values for % placeholders).
|
|
||||||
var findInternalNewlinesRegex = /\n(?!$)/g;
|
|
||||||
var encodedNewline = '__ns_newline__';
|
|
||||||
encodeNewlinesWrittenToStream(process.stdout);
|
|
||||||
encodeNewlinesWrittenToStream(process.stderr);
|
|
||||||
function encodeNewlinesWrittenToStream(outputStream) {
|
|
||||||
var origWriteFunction = outputStream.write;
|
|
||||||
outputStream.write = function (value) {
|
|
||||||
// Only interfere with the write if it's definitely a string
|
|
||||||
if (typeof value === 'string') {
|
|
||||||
var argsClone = Array.prototype.slice.call(arguments, 0);
|
|
||||||
argsClone[0] = encodeNewlinesInString(value);
|
|
||||||
origWriteFunction.apply(this, argsClone);
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
origWriteFunction.apply(this, arguments);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
function encodeNewlinesInString(str) {
|
|
||||||
return str.replace(findInternalNewlinesRegex, encodedNewline);
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 3 */
|
|
||||||
/***/ (function (module, exports) {
|
|
||||||
|
|
||||||
module.exports = require("net");
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 4 */
|
|
||||||
/***/ (function (module, exports) {
|
|
||||||
|
|
||||||
module.exports = require("path");
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 5 */
|
|
||||||
/***/ (function (module, exports) {
|
|
||||||
|
|
||||||
module.exports = require("readline");
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 6 */
|
|
||||||
/***/ (function (module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
"use strict";
|
|
||||||
|
|
||||||
exports.__esModule = true;
|
|
||||||
function parseArgs(args) {
|
|
||||||
// Very simplistic parsing which is sufficient for the cases needed. We don't want to bring in any external
|
|
||||||
// dependencies (such as an args-parsing library) to this file.
|
|
||||||
var result = {};
|
|
||||||
var currentKey = null;
|
|
||||||
args.forEach(function (arg) {
|
|
||||||
if (arg.indexOf('--') === 0) {
|
|
||||||
var argName = arg.substring(2);
|
|
||||||
result[argName] = undefined;
|
|
||||||
currentKey = argName;
|
|
||||||
}
|
|
||||||
else if (currentKey) {
|
|
||||||
result[currentKey] = arg;
|
|
||||||
currentKey = null;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
exports.parseArgs = parseArgs;
|
|
||||||
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 7 */
|
|
||||||
/***/ (function (module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
"use strict";
|
|
||||||
|
|
||||||
/*
|
|
||||||
In general, we want the Node child processes to be terminated as soon as the parent .NET processes exit,
|
|
||||||
because we have no further use for them. If the .NET process shuts down gracefully, it will run its
|
|
||||||
finalizers, one of which (in OutOfProcessNodeInstance.cs) will kill its associated Node process immediately.
|
|
||||||
|
|
||||||
But if the .NET process is terminated forcefully (e.g., on Linux/OSX with 'kill -9'), then it won't have
|
|
||||||
any opportunity to shut down its child processes, and by default they will keep running. In this case, it's
|
|
||||||
up to the child process to detect this has happened and terminate itself.
|
|
||||||
|
|
||||||
There are many possible approaches to detecting when a parent process has exited, most of which behave
|
|
||||||
differently between Windows and Linux/OS X:
|
|
||||||
|
|
||||||
- On Windows, the parent process can mark its child as being a 'job' that should auto-terminate when
|
|
||||||
the parent does (http://stackoverflow.com/a/4657392). Not cross-platform.
|
|
||||||
- The child Node process can get a callback when the parent disconnects (process.on('disconnect', ...)).
|
|
||||||
But despite http://stackoverflow.com/a/16487966, no callback fires in any case I've tested (Windows / OS X).
|
|
||||||
- The child Node process can get a callback when its stdin/stdout are disconnected, as described at
|
|
||||||
http://stackoverflow.com/a/15693934. This works well on OS X, but calling stdout.resume() on Windows
|
|
||||||
causes the process to terminate prematurely.
|
|
||||||
- I don't know why, but on Windows, it's enough to invoke process.stdin.resume(). For some reason this causes
|
|
||||||
the child Node process to exit as soon as the parent one does, but I don't see this documented anywhere.
|
|
||||||
- You can poll to see if the parent process, or your stdin/stdout connection to it, is gone
|
|
||||||
- You can directly pass a parent process PID to the child, and then have the child poll to see if it's
|
|
||||||
still running (e.g., using process.kill(pid, 0), which doesn't kill it but just tests whether it exists,
|
|
||||||
as per https://nodejs.org/api/process.html#process_process_kill_pid_signal)
|
|
||||||
- Or, on each poll, you can try writing to process.stdout. If the parent has died, then this will throw.
|
|
||||||
However I don't see this documented anywhere. It would be nice if you could just poll for whether or not
|
|
||||||
process.stdout is still connected (without actually writing to it) but I haven't found any property whose
|
|
||||||
value changes until you actually try to write to it.
|
|
||||||
|
|
||||||
Of these, the only cross-platform approach that is actually documented as a valid strategy is simply polling
|
|
||||||
to check whether the parent PID is still running. So that's what we do here.
|
|
||||||
*/
|
|
||||||
exports.__esModule = true;
|
|
||||||
var pollIntervalMs = 1000;
|
|
||||||
function exitWhenParentExits(parentPid, ignoreSigint) {
|
|
||||||
setInterval(function () {
|
|
||||||
if (!processExists(parentPid)) {
|
|
||||||
// Can't log anything at this point, because out stdout was connected to the parent,
|
|
||||||
// but the parent is gone.
|
|
||||||
process.exit();
|
|
||||||
}
|
|
||||||
}, pollIntervalMs);
|
|
||||||
if (ignoreSigint) {
|
|
||||||
// Pressing ctrl+c in the terminal sends a SIGINT to all processes in the foreground process tree.
|
|
||||||
// By default, the Node process would then exit before the .NET process, because ASP.NET implements
|
|
||||||
// a delayed shutdown to allow ongoing requests to complete.
|
|
||||||
//
|
|
||||||
// This is problematic, because if Node exits first, the CopyToAsync code in ConditionalProxyMiddleware
|
|
||||||
// will experience a read fault, and logs a huge load of errors. Fortunately, since the Node process is
|
|
||||||
// already set up to shut itself down if it detects the .NET process is terminated, all we have to do is
|
|
||||||
// ignore the SIGINT. The Node process will then terminate automatically after the .NET process does.
|
|
||||||
//
|
|
||||||
// A better solution would be to have WebpackDevMiddleware listen for SIGINT and gracefully close any
|
|
||||||
// ongoing EventSource connections before letting the Node process exit, independently of the .NET
|
|
||||||
// process exiting. However, doing this well in general is very nontrivial (see all the discussion at
|
|
||||||
// https://github.com/nodejs/node/issues/2642).
|
|
||||||
process.on('SIGINT', function () {
|
|
||||||
console.log('Received SIGINT. Waiting for .NET process to exit...');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
exports.exitWhenParentExits = exitWhenParentExits;
|
|
||||||
function processExists(pid) {
|
|
||||||
try {
|
|
||||||
// Sending signal 0 - on all platforms - tests whether the process exists. As long as it doesn't
|
|
||||||
// throw, that means it does exist.
|
|
||||||
process.kill(pid, 0);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
catch (ex) {
|
|
||||||
// If the reason for the error is that we don't have permission to ask about this process,
|
|
||||||
// report that as a separate problem.
|
|
||||||
if (ex.code === 'EPERM') {
|
|
||||||
throw new Error("Attempted to check whether process " + pid + " was running, but got a permissions error.");
|
|
||||||
}
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 8 */
|
|
||||||
/***/ (function (module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
"use strict";
|
|
||||||
|
|
||||||
exports.__esModule = true;
|
|
||||||
var events_1 = __webpack_require__(9);
|
|
||||||
var VirtualConnection_1 = __webpack_require__(10);
|
|
||||||
// Keep this in sync with the equivalent constant in the .NET code. Both sides split up their transmissions into frames with this max length,
|
|
||||||
// and both will reject longer frames.
|
|
||||||
var MaxFrameBodyLength = 16 * 1024;
|
|
||||||
/**
|
|
||||||
* Accepts connections to a net.Server and adapts them to behave as multiplexed connections. That is, for each physical socket connection,
|
|
||||||
* we track a list of 'virtual connections' whose API is a Duplex stream. The remote clients may open and close as many virtual connections
|
|
||||||
* as they wish, reading and writing to them independently, without the overhead of establishing new physical connections each time.
|
|
||||||
*/
|
|
||||||
function createInterface(server) {
|
|
||||||
var emitter = new events_1.EventEmitter();
|
|
||||||
server.on('connection', function (socket) {
|
|
||||||
// For each physical socket connection, maintain a set of virtual connections. Issue a notification whenever
|
|
||||||
// a new virtual connections is opened.
|
|
||||||
var childSockets = new VirtualConnectionsCollection(socket, function (virtualConnection) {
|
|
||||||
emitter.emit('connection', virtualConnection);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
return emitter;
|
|
||||||
}
|
|
||||||
exports.createInterface = createInterface;
|
|
||||||
/**
|
|
||||||
* Tracks the 'virtual connections' associated with a single physical socket connection.
|
|
||||||
*/
|
|
||||||
var VirtualConnectionsCollection = /** @class */ (function () {
|
|
||||||
function VirtualConnectionsCollection(_socket, _onVirtualConnectionCallback) {
|
|
||||||
var _this = this;
|
|
||||||
this._socket = _socket;
|
|
||||||
this._onVirtualConnectionCallback = _onVirtualConnectionCallback;
|
|
||||||
this._currentFrameHeader = null;
|
|
||||||
this._virtualConnections = {};
|
|
||||||
// If the remote end closes the physical socket, treat all the virtual connections as being closed remotely too
|
|
||||||
this._socket.on('close', function () {
|
|
||||||
Object.getOwnPropertyNames(_this._virtualConnections).forEach(function (id) {
|
|
||||||
// A 'null' frame signals that the connection was closed remotely
|
|
||||||
_this._virtualConnections[id].onReceivedData(null);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
this._socket.on('readable', this._onIncomingDataAvailable.bind(this));
|
|
||||||
}
|
|
||||||
/**
|
|
||||||
* This is called whenever the underlying socket signals that it may have some data available to read. It will synchronously read as many
|
|
||||||
* message frames as it can from the underlying socket, opens virtual connections as needed, and dispatches data to them.
|
|
||||||
*/
|
|
||||||
VirtualConnectionsCollection.prototype._onIncomingDataAvailable = function () {
|
|
||||||
var exhaustedAllData = false;
|
|
||||||
while (!exhaustedAllData) {
|
|
||||||
// We might already have a pending frame header from the previous time this method ran, but if not, that's the next thing we need to read
|
|
||||||
if (this._currentFrameHeader === null) {
|
|
||||||
this._currentFrameHeader = this._readNextFrameHeader();
|
|
||||||
}
|
|
||||||
if (this._currentFrameHeader === null) {
|
|
||||||
// There's not enough data to fill a frameheader, so wait until more arrives later
|
|
||||||
// The next attempt to read from the socket will start from the same place this one did (incomplete reads don't consume any data)
|
|
||||||
exhaustedAllData = true;
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
var frameBodyLength = this._currentFrameHeader.bodyLength;
|
|
||||||
var frameBodyOrNull = frameBodyLength > 0 ? this._socket.read(this._currentFrameHeader.bodyLength) : null;
|
|
||||||
if (frameBodyOrNull !== null || frameBodyLength === 0) {
|
|
||||||
// We have a complete frame header+body pair, so we can now dispatch this to a virtual connection. We set _currentFrameHeader back to null
|
|
||||||
// so that the next thing we try to read is the next frame header.
|
|
||||||
var headerCopy = this._currentFrameHeader;
|
|
||||||
this._currentFrameHeader = null;
|
|
||||||
this._onReceivedCompleteFrame(headerCopy, frameBodyOrNull);
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
// There's not enough data to fill the pending frame body, so wait until more arrives later
|
|
||||||
// The next attempt to read from the socket will start from the same place this one did (incomplete reads don't consume any data)
|
|
||||||
exhaustedAllData = true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
VirtualConnectionsCollection.prototype._onReceivedCompleteFrame = function (header, bodyIfNotEmpty) {
|
|
||||||
// An incoming zero-length frame signals that there's no more data to read.
|
|
||||||
// Signal this to the Node stream APIs by pushing a 'null' chunk to it.
|
|
||||||
var virtualConnection = this._getOrOpenVirtualConnection(header);
|
|
||||||
virtualConnection.onReceivedData(header.bodyLength > 0 ? bodyIfNotEmpty : null);
|
|
||||||
};
|
|
||||||
VirtualConnectionsCollection.prototype._getOrOpenVirtualConnection = function (header) {
|
|
||||||
if (this._virtualConnections.hasOwnProperty(header.connectionIdString)) {
|
|
||||||
// It's an existing virtual connection
|
|
||||||
return this._virtualConnections[header.connectionIdString];
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
// It's a new one
|
|
||||||
return this._openVirtualConnection(header);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
VirtualConnectionsCollection.prototype._openVirtualConnection = function (header) {
|
|
||||||
var _this = this;
|
|
||||||
var beginWriteCallback = function (data, writeCompletedCallback) {
|
|
||||||
// Only send nonempty frames, since empty ones are a signal to close the virtual connection
|
|
||||||
if (data.length > 0) {
|
|
||||||
_this._sendFrame(header.connectionIdBinary, data, writeCompletedCallback);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
var newVirtualConnection = new VirtualConnection_1.VirtualConnection(beginWriteCallback);
|
|
||||||
newVirtualConnection.on('end', function () {
|
|
||||||
// The virtual connection was closed remotely. Clean up locally.
|
|
||||||
_this._onVirtualConnectionWasClosed(header.connectionIdString);
|
|
||||||
});
|
|
||||||
newVirtualConnection.on('finish', function () {
|
|
||||||
// The virtual connection was closed locally. Clean up locally, and notify the remote that we're done.
|
|
||||||
_this._onVirtualConnectionWasClosed(header.connectionIdString);
|
|
||||||
_this._sendFrame(header.connectionIdBinary, Buffer.alloc(0));
|
|
||||||
});
|
|
||||||
this._virtualConnections[header.connectionIdString] = newVirtualConnection;
|
|
||||||
this._onVirtualConnectionCallback(newVirtualConnection);
|
|
||||||
return newVirtualConnection;
|
|
||||||
};
|
|
||||||
/**
|
|
||||||
* Attempts to read a complete frame header, synchronously, from the underlying socket.
|
|
||||||
* If not enough data is available synchronously, returns null without consuming any data from the socket.
|
|
||||||
*/
|
|
||||||
VirtualConnectionsCollection.prototype._readNextFrameHeader = function () {
|
|
||||||
var headerBuf = this._socket.read(12);
|
|
||||||
if (headerBuf !== null) {
|
|
||||||
// We have enough data synchronously
|
|
||||||
var connectionIdBinary = headerBuf.slice(0, 8);
|
|
||||||
var connectionIdString = connectionIdBinary.toString('hex');
|
|
||||||
var bodyLength = headerBuf.readInt32LE(8);
|
|
||||||
if (bodyLength < 0 || bodyLength > MaxFrameBodyLength) {
|
|
||||||
// Throwing here is going to bring down the whole process, so this cannot be allowed to happen in real use.
|
|
||||||
// But it won't happen in real use, because this is only used with our .NET client, which doesn't violate this rule.
|
|
||||||
throw new Error('Illegal frame body length: ' + bodyLength);
|
|
||||||
}
|
|
||||||
return { connectionIdBinary: connectionIdBinary, connectionIdString: connectionIdString, bodyLength: bodyLength };
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
// Not enough bytes are available synchronously, so none were consumed
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
};
|
|
||||||
VirtualConnectionsCollection.prototype._sendFrame = function (connectionIdBinary, data, callback) {
|
|
||||||
// For all sends other than the last one, only invoke the callback if it failed.
|
|
||||||
// Also, only invoke the callback at most once.
|
|
||||||
var hasInvokedCallback = false;
|
|
||||||
var finalCallback = callback && (function (error) {
|
|
||||||
if (!hasInvokedCallback) {
|
|
||||||
hasInvokedCallback = true;
|
|
||||||
callback(error);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
var notFinalCallback = callback && (function (error) {
|
|
||||||
if (error) {
|
|
||||||
finalCallback(error);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
// The amount of data we're writing might exceed MaxFrameBodyLength, so split into frames as needed.
|
|
||||||
// Note that we always send at least one frame, even if it's empty (because that's the close-virtual-connection signal).
|
|
||||||
// If needed, this could be changed to send frames asynchronously, so that large sends could proceed in parallel
|
|
||||||
// (though that would involve making a clone of 'data', to avoid the risk of it being mutated during the send).
|
|
||||||
var bytesSent = 0;
|
|
||||||
do {
|
|
||||||
var nextFrameBodyLength = Math.min(MaxFrameBodyLength, data.length - bytesSent);
|
|
||||||
var isFinalChunk = (bytesSent + nextFrameBodyLength) === data.length;
|
|
||||||
this._socket.write(connectionIdBinary, notFinalCallback);
|
|
||||||
this._sendInt32LE(nextFrameBodyLength, notFinalCallback);
|
|
||||||
this._socket.write(data.slice(bytesSent, bytesSent + nextFrameBodyLength), isFinalChunk ? finalCallback : notFinalCallback);
|
|
||||||
bytesSent += nextFrameBodyLength;
|
|
||||||
} while (bytesSent < data.length);
|
|
||||||
};
|
|
||||||
/**
|
|
||||||
* Sends a number serialized in the correct format for .NET to receive as a System.Int32
|
|
||||||
*/
|
|
||||||
VirtualConnectionsCollection.prototype._sendInt32LE = function (value, callback) {
|
|
||||||
var buf = Buffer.alloc(4);
|
|
||||||
buf.writeInt32LE(value, 0);
|
|
||||||
this._socket.write(buf, callback);
|
|
||||||
};
|
|
||||||
VirtualConnectionsCollection.prototype._onVirtualConnectionWasClosed = function (id) {
|
|
||||||
if (this._virtualConnections.hasOwnProperty(id)) {
|
|
||||||
delete this._virtualConnections[id];
|
|
||||||
}
|
|
||||||
};
|
|
||||||
return VirtualConnectionsCollection;
|
|
||||||
}());
|
|
||||||
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 9 */
|
|
||||||
/***/ (function (module, exports) {
|
|
||||||
|
|
||||||
module.exports = require("events");
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 10 */
|
|
||||||
/***/ (function (module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
"use strict";
|
|
||||||
|
|
||||||
var __extends = (this && this.__extends) || (function () {
|
|
||||||
var extendStatics = function (d, b) {
|
|
||||||
extendStatics = Object.setPrototypeOf ||
|
|
||||||
({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
|
|
||||||
function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
|
|
||||||
return extendStatics(d, b);
|
|
||||||
}
|
|
||||||
return function (d, b) {
|
|
||||||
extendStatics(d, b);
|
|
||||||
function __() { this.constructor = d; }
|
|
||||||
d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
|
|
||||||
};
|
|
||||||
})();
|
|
||||||
exports.__esModule = true;
|
|
||||||
var stream_1 = __webpack_require__(11);
|
|
||||||
/**
|
|
||||||
* Represents a virtual connection. Multiple virtual connections may be multiplexed over a single physical socket connection.
|
|
||||||
*/
|
|
||||||
var VirtualConnection = /** @class */ (function (_super) {
|
|
||||||
__extends(VirtualConnection, _super);
|
|
||||||
function VirtualConnection(_beginWriteCallback) {
|
|
||||||
var _this = _super.call(this) || this;
|
|
||||||
_this._beginWriteCallback = _beginWriteCallback;
|
|
||||||
_this._flowing = false;
|
|
||||||
_this._receivedDataQueue = [];
|
|
||||||
return _this;
|
|
||||||
}
|
|
||||||
VirtualConnection.prototype._read = function () {
|
|
||||||
this._flowing = true;
|
|
||||||
// Keep pushing data until we run out, or the underlying framework asks us to stop.
|
|
||||||
// When we finish, the 'flowing' state is detemined by whether more data is still being requested.
|
|
||||||
while (this._flowing && this._receivedDataQueue.length > 0) {
|
|
||||||
var nextChunk = this._receivedDataQueue.shift();
|
|
||||||
this._flowing = this.push(nextChunk);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
VirtualConnection.prototype._write = function (chunk, encodingIfString, callback) {
|
|
||||||
if (typeof chunk === 'string') {
|
|
||||||
chunk = Buffer.from(chunk, encodingIfString);
|
|
||||||
}
|
|
||||||
this._beginWriteCallback(chunk, callback);
|
|
||||||
};
|
|
||||||
VirtualConnection.prototype.onReceivedData = function (dataOrNullToSignalEOF) {
|
|
||||||
if (this._flowing) {
|
|
||||||
this._flowing = this.push(dataOrNullToSignalEOF);
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
this._receivedDataQueue.push(dataOrNullToSignalEOF);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
return VirtualConnection;
|
|
||||||
}(stream_1.Duplex));
|
|
||||||
exports.VirtualConnection = VirtualConnection;
|
|
||||||
|
|
||||||
|
|
||||||
/***/
|
|
||||||
}),
|
|
||||||
/* 11 */
|
|
||||||
/***/ (function (module, exports) {
|
|
||||||
|
|
||||||
module.exports = require("stream");
|
|
||||||
|
|
||||||
/***/
|
|
||||||
})
|
|
||||||
/******/])));
|
|
||||||
@@ -1,109 +0,0 @@
|
|||||||
{
|
|
||||||
"AssemblyIdentity": "Microsoft.AspNetCore.NodeServices.Sockets, Version=2.1.1.0, Culture=neutral, PublicKeyToken=adb9793829ddae60",
|
|
||||||
"Types": [
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.Sockets.NodeServicesOptionsExtensions",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"Abstract": true,
|
|
||||||
"Static": true,
|
|
||||||
"Sealed": true,
|
|
||||||
"ImplementedInterfaces": [],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "UseSocketHosting",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "options",
|
|
||||||
"Type": "Microsoft.AspNetCore.NodeServices.NodeServicesOptions"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Static": true,
|
|
||||||
"Extension": true,
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.Sockets.VirtualConnections.VirtualConnectionReadErrorHandler",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"Sealed": true,
|
|
||||||
"BaseType": "System.MulticastDelegate",
|
|
||||||
"ImplementedInterfaces": [],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "Invoke",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "ex",
|
|
||||||
"Type": "System.Exception"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Virtual": true,
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "BeginInvoke",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "ex",
|
|
||||||
"Type": "System.Exception"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "callback",
|
|
||||||
"Type": "System.AsyncCallback"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "object",
|
|
||||||
"Type": "System.Object"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.IAsyncResult",
|
|
||||||
"Virtual": true,
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "EndInvoke",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "result",
|
|
||||||
"Type": "System.IAsyncResult"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Virtual": true,
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Constructor",
|
|
||||||
"Name": ".ctor",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "object",
|
|
||||||
"Type": "System.Object"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "method",
|
|
||||||
"Type": "System.IntPtr"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -1,416 +0,0 @@
|
|||||||
(function(e, a) { for(var i in a) e[i] = a[i]; }(exports, /******/ (function(modules) { // webpackBootstrap
|
|
||||||
/******/ // The module cache
|
|
||||||
/******/ var installedModules = {};
|
|
||||||
/******/
|
|
||||||
/******/ // The require function
|
|
||||||
/******/ function __webpack_require__(moduleId) {
|
|
||||||
/******/
|
|
||||||
/******/ // Check if module is in cache
|
|
||||||
/******/ if(installedModules[moduleId]) {
|
|
||||||
/******/ return installedModules[moduleId].exports;
|
|
||||||
/******/ }
|
|
||||||
/******/ // Create a new module (and put it into the cache)
|
|
||||||
/******/ var module = installedModules[moduleId] = {
|
|
||||||
/******/ i: moduleId,
|
|
||||||
/******/ l: false,
|
|
||||||
/******/ exports: {}
|
|
||||||
/******/ };
|
|
||||||
/******/
|
|
||||||
/******/ // Execute the module function
|
|
||||||
/******/ modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
|
|
||||||
/******/
|
|
||||||
/******/ // Flag the module as loaded
|
|
||||||
/******/ module.l = true;
|
|
||||||
/******/
|
|
||||||
/******/ // Return the exports of the module
|
|
||||||
/******/ return module.exports;
|
|
||||||
/******/ }
|
|
||||||
/******/
|
|
||||||
/******/
|
|
||||||
/******/ // expose the modules object (__webpack_modules__)
|
|
||||||
/******/ __webpack_require__.m = modules;
|
|
||||||
/******/
|
|
||||||
/******/ // expose the module cache
|
|
||||||
/******/ __webpack_require__.c = installedModules;
|
|
||||||
/******/
|
|
||||||
/******/ // define getter function for harmony exports
|
|
||||||
/******/ __webpack_require__.d = function(exports, name, getter) {
|
|
||||||
/******/ if(!__webpack_require__.o(exports, name)) {
|
|
||||||
/******/ Object.defineProperty(exports, name, { enumerable: true, get: getter });
|
|
||||||
/******/ }
|
|
||||||
/******/ };
|
|
||||||
/******/
|
|
||||||
/******/ // define __esModule on exports
|
|
||||||
/******/ __webpack_require__.r = function(exports) {
|
|
||||||
/******/ if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
|
|
||||||
/******/ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
||||||
/******/ }
|
|
||||||
/******/ Object.defineProperty(exports, '__esModule', { value: true });
|
|
||||||
/******/ };
|
|
||||||
/******/
|
|
||||||
/******/ // create a fake namespace object
|
|
||||||
/******/ // mode & 1: value is a module id, require it
|
|
||||||
/******/ // mode & 2: merge all properties of value into the ns
|
|
||||||
/******/ // mode & 4: return value when already ns object
|
|
||||||
/******/ // mode & 8|1: behave like require
|
|
||||||
/******/ __webpack_require__.t = function(value, mode) {
|
|
||||||
/******/ if(mode & 1) value = __webpack_require__(value);
|
|
||||||
/******/ if(mode & 8) return value;
|
|
||||||
/******/ if((mode & 4) && typeof value === 'object' && value && value.__esModule) return value;
|
|
||||||
/******/ var ns = Object.create(null);
|
|
||||||
/******/ __webpack_require__.r(ns);
|
|
||||||
/******/ Object.defineProperty(ns, 'default', { enumerable: true, value: value });
|
|
||||||
/******/ if(mode & 2 && typeof value != 'string') for(var key in value) __webpack_require__.d(ns, key, function(key) { return value[key]; }.bind(null, key));
|
|
||||||
/******/ return ns;
|
|
||||||
/******/ };
|
|
||||||
/******/
|
|
||||||
/******/ // getDefaultExport function for compatibility with non-harmony modules
|
|
||||||
/******/ __webpack_require__.n = function(module) {
|
|
||||||
/******/ var getter = module && module.__esModule ?
|
|
||||||
/******/ function getDefault() { return module['default']; } :
|
|
||||||
/******/ function getModuleExports() { return module; };
|
|
||||||
/******/ __webpack_require__.d(getter, 'a', getter);
|
|
||||||
/******/ return getter;
|
|
||||||
/******/ };
|
|
||||||
/******/
|
|
||||||
/******/ // Object.prototype.hasOwnProperty.call
|
|
||||||
/******/ __webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };
|
|
||||||
/******/
|
|
||||||
/******/ // __webpack_public_path__
|
|
||||||
/******/ __webpack_require__.p = "";
|
|
||||||
/******/
|
|
||||||
/******/
|
|
||||||
/******/ // Load entry module and return exports
|
|
||||||
/******/ return __webpack_require__(__webpack_require__.s = 1);
|
|
||||||
/******/ })
|
|
||||||
/************************************************************************/
|
|
||||||
/******/ ([
|
|
||||||
/* 0 */
|
|
||||||
/***/ (function(module, exports) {
|
|
||||||
|
|
||||||
module.exports = require("path");
|
|
||||||
|
|
||||||
/***/ }),
|
|
||||||
/* 1 */
|
|
||||||
/***/ (function(module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
module.exports = __webpack_require__(2);
|
|
||||||
|
|
||||||
|
|
||||||
/***/ }),
|
|
||||||
/* 2 */
|
|
||||||
/***/ (function(module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
"use strict";
|
|
||||||
|
|
||||||
exports.__esModule = true;
|
|
||||||
// Limit dependencies to core Node modules. This means the code in this file has to be very low-level and unattractive,
|
|
||||||
// but simplifies things for the consumer of this module.
|
|
||||||
__webpack_require__(3);
|
|
||||||
__webpack_require__(4);
|
|
||||||
var http = __webpack_require__(5);
|
|
||||||
var path = __webpack_require__(0);
|
|
||||||
var ArgsUtil_1 = __webpack_require__(6);
|
|
||||||
var ExitWhenParentExits_1 = __webpack_require__(7);
|
|
||||||
// Webpack doesn't support dynamic requires for files not present at compile time, so grab a direct
|
|
||||||
// reference to Node's runtime 'require' function.
|
|
||||||
var dynamicRequire = eval('require');
|
|
||||||
var server = http.createServer(function (req, res) {
|
|
||||||
readRequestBodyAsJson(req, function (bodyJson) {
|
|
||||||
var hasSentResult = false;
|
|
||||||
var callback = function (errorValue, successValue) {
|
|
||||||
if (!hasSentResult) {
|
|
||||||
hasSentResult = true;
|
|
||||||
if (errorValue) {
|
|
||||||
respondWithError(res, errorValue);
|
|
||||||
}
|
|
||||||
else if (typeof successValue !== 'string') {
|
|
||||||
// Arbitrary object/number/etc - JSON-serialize it
|
|
||||||
var successValueJson = void 0;
|
|
||||||
try {
|
|
||||||
successValueJson = JSON.stringify(successValue);
|
|
||||||
}
|
|
||||||
catch (ex) {
|
|
||||||
// JSON serialization error - pass it back to .NET
|
|
||||||
respondWithError(res, ex);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
res.setHeader('Content-Type', 'application/json');
|
|
||||||
res.end(successValueJson);
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
// String - can bypass JSON-serialization altogether
|
|
||||||
res.setHeader('Content-Type', 'text/plain');
|
|
||||||
res.end(successValue);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
// Support streamed responses
|
|
||||||
Object.defineProperty(callback, 'stream', {
|
|
||||||
enumerable: true,
|
|
||||||
get: function () {
|
|
||||||
if (!hasSentResult) {
|
|
||||||
hasSentResult = true;
|
|
||||||
res.setHeader('Content-Type', 'application/octet-stream');
|
|
||||||
}
|
|
||||||
return res;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
try {
|
|
||||||
var resolvedPath = path.resolve(process.cwd(), bodyJson.moduleName);
|
|
||||||
var invokedModule = dynamicRequire(resolvedPath);
|
|
||||||
var func = bodyJson.exportedFunctionName ? invokedModule[bodyJson.exportedFunctionName] : invokedModule;
|
|
||||||
if (!func) {
|
|
||||||
throw new Error('The module "' + resolvedPath + '" has no export named "' + bodyJson.exportedFunctionName + '"');
|
|
||||||
}
|
|
||||||
func.apply(null, [callback].concat(bodyJson.args));
|
|
||||||
}
|
|
||||||
catch (synchronousException) {
|
|
||||||
callback(synchronousException, null);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
});
|
|
||||||
var parsedArgs = ArgsUtil_1.parseArgs(process.argv);
|
|
||||||
var requestedPortOrZero = parsedArgs.port || 0; // 0 means 'let the OS decide'
|
|
||||||
server.listen(requestedPortOrZero, 'localhost', function () {
|
|
||||||
var addressInfo = server.address();
|
|
||||||
// Signal to HttpNodeHost which loopback IP address (IPv4 or IPv6) and port it should make its HTTP connections on
|
|
||||||
console.log('[Microsoft.AspNetCore.NodeServices.HttpNodeHost:Listening on {' + addressInfo.address + '} port ' + addressInfo.port + '\]');
|
|
||||||
// Signal to the NodeServices base class that we're ready to accept invocations
|
|
||||||
console.log('[Microsoft.AspNetCore.NodeServices:Listening]');
|
|
||||||
});
|
|
||||||
ExitWhenParentExits_1.exitWhenParentExits(parseInt(parsedArgs.parentPid), /* ignoreSigint */ true);
|
|
||||||
function readRequestBodyAsJson(request, callback) {
|
|
||||||
var requestBodyAsString = '';
|
|
||||||
request.on('data', function (chunk) { requestBodyAsString += chunk; });
|
|
||||||
request.on('end', function () { callback(JSON.parse(requestBodyAsString)); });
|
|
||||||
}
|
|
||||||
function respondWithError(res, errorValue) {
|
|
||||||
res.statusCode = 500;
|
|
||||||
res.end(JSON.stringify({
|
|
||||||
errorMessage: errorValue.message || errorValue,
|
|
||||||
errorDetails: errorValue.stack || null
|
|
||||||
}));
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
/***/ }),
|
|
||||||
/* 3 */
|
|
||||||
/***/ (function(module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
"use strict";
|
|
||||||
|
|
||||||
exports.__esModule = true;
|
|
||||||
var path = __webpack_require__(0);
|
|
||||||
var startsWith = function (str, prefix) { return str.substring(0, prefix.length) === prefix; };
|
|
||||||
var appRootDir = process.cwd();
|
|
||||||
function patchedLStat(pathToStatLong, fsReqWrap) {
|
|
||||||
try {
|
|
||||||
// If the lstat completes without errors, we don't modify its behavior at all
|
|
||||||
return origLStat.apply(this, arguments);
|
|
||||||
}
|
|
||||||
catch (ex) {
|
|
||||||
var shouldOverrideError = startsWith(ex.message, 'EPERM') // It's a permissions error
|
|
||||||
&& typeof appRootDirLong === 'string'
|
|
||||||
&& startsWith(appRootDirLong, pathToStatLong) // ... for an ancestor directory
|
|
||||||
&& ex.stack.indexOf('Object.realpathSync ') >= 0; // ... during symlink resolution
|
|
||||||
if (shouldOverrideError) {
|
|
||||||
// Fake the result to give the same result as an 'lstat' on the app root dir.
|
|
||||||
// This stops Node failing to load modules just because it doesn't know whether
|
|
||||||
// ancestor directories are symlinks or not. If there's a genuine file
|
|
||||||
// permissions issue, it will still surface later when Node actually
|
|
||||||
// tries to read the file.
|
|
||||||
return origLStat.call(this, appRootDir, fsReqWrap);
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
// In any other case, preserve the original error
|
|
||||||
throw ex;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
;
|
|
||||||
// It's only necessary to apply this workaround on Windows
|
|
||||||
var appRootDirLong = null;
|
|
||||||
var origLStat = null;
|
|
||||||
if (/^win/.test(process.platform)) {
|
|
||||||
try {
|
|
||||||
// Get the app's root dir in Node's internal "long" format (e.g., \\?\C:\dir\subdir)
|
|
||||||
appRootDirLong = path._makeLong(appRootDir);
|
|
||||||
// Actually apply the patch, being as defensive as possible
|
|
||||||
var bindingFs = process.binding('fs');
|
|
||||||
origLStat = bindingFs.lstat;
|
|
||||||
if (typeof origLStat === 'function') {
|
|
||||||
bindingFs.lstat = patchedLStat;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
catch (ex) {
|
|
||||||
// If some future version of Node throws (e.g., to prevent use of process.binding()),
|
|
||||||
// don't apply the patch, but still let the application run.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
/***/ }),
|
|
||||||
/* 4 */
|
|
||||||
/***/ (function(module, exports) {
|
|
||||||
|
|
||||||
// When Node writes to stdout/strerr, we capture that and convert the lines into calls on the
|
|
||||||
// active .NET ILogger. But by default, stdout/stderr don't have any way of distinguishing
|
|
||||||
// linebreaks inside log messages from the linebreaks that delimit separate log messages,
|
|
||||||
// so multiline strings will end up being written to the ILogger as multiple independent
|
|
||||||
// log messages. This makes them very hard to make sense of, especially when they represent
|
|
||||||
// something like stack traces.
|
|
||||||
//
|
|
||||||
// To fix this, we intercept stdout/stderr writes, and replace internal linebreaks with a
|
|
||||||
// marker token. When .NET receives the lines, it converts the marker tokens back to regular
|
|
||||||
// linebreaks within the logged messages.
|
|
||||||
//
|
|
||||||
// Note that it's better to do the interception at the stdout/stderr level, rather than at
|
|
||||||
// the console.log/console.error (etc.) level, because this takes place after any native
|
|
||||||
// message formatting has taken place (e.g., inserting values for % placeholders).
|
|
||||||
var findInternalNewlinesRegex = /\n(?!$)/g;
|
|
||||||
var encodedNewline = '__ns_newline__';
|
|
||||||
encodeNewlinesWrittenToStream(process.stdout);
|
|
||||||
encodeNewlinesWrittenToStream(process.stderr);
|
|
||||||
function encodeNewlinesWrittenToStream(outputStream) {
|
|
||||||
var origWriteFunction = outputStream.write;
|
|
||||||
outputStream.write = function (value) {
|
|
||||||
// Only interfere with the write if it's definitely a string
|
|
||||||
if (typeof value === 'string') {
|
|
||||||
var argsClone = Array.prototype.slice.call(arguments, 0);
|
|
||||||
argsClone[0] = encodeNewlinesInString(value);
|
|
||||||
origWriteFunction.apply(this, argsClone);
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
origWriteFunction.apply(this, arguments);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
function encodeNewlinesInString(str) {
|
|
||||||
return str.replace(findInternalNewlinesRegex, encodedNewline);
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
/***/ }),
|
|
||||||
/* 5 */
|
|
||||||
/***/ (function(module, exports) {
|
|
||||||
|
|
||||||
module.exports = require("http");
|
|
||||||
|
|
||||||
/***/ }),
|
|
||||||
/* 6 */
|
|
||||||
/***/ (function(module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
"use strict";
|
|
||||||
|
|
||||||
exports.__esModule = true;
|
|
||||||
function parseArgs(args) {
|
|
||||||
// Very simplistic parsing which is sufficient for the cases needed. We don't want to bring in any external
|
|
||||||
// dependencies (such as an args-parsing library) to this file.
|
|
||||||
var result = {};
|
|
||||||
var currentKey = null;
|
|
||||||
args.forEach(function (arg) {
|
|
||||||
if (arg.indexOf('--') === 0) {
|
|
||||||
var argName = arg.substring(2);
|
|
||||||
result[argName] = undefined;
|
|
||||||
currentKey = argName;
|
|
||||||
}
|
|
||||||
else if (currentKey) {
|
|
||||||
result[currentKey] = arg;
|
|
||||||
currentKey = null;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
exports.parseArgs = parseArgs;
|
|
||||||
|
|
||||||
|
|
||||||
/***/ }),
|
|
||||||
/* 7 */
|
|
||||||
/***/ (function(module, exports, __webpack_require__) {
|
|
||||||
|
|
||||||
"use strict";
|
|
||||||
|
|
||||||
/*
|
|
||||||
In general, we want the Node child processes to be terminated as soon as the parent .NET processes exit,
|
|
||||||
because we have no further use for them. If the .NET process shuts down gracefully, it will run its
|
|
||||||
finalizers, one of which (in OutOfProcessNodeInstance.cs) will kill its associated Node process immediately.
|
|
||||||
|
|
||||||
But if the .NET process is terminated forcefully (e.g., on Linux/OSX with 'kill -9'), then it won't have
|
|
||||||
any opportunity to shut down its child processes, and by default they will keep running. In this case, it's
|
|
||||||
up to the child process to detect this has happened and terminate itself.
|
|
||||||
|
|
||||||
There are many possible approaches to detecting when a parent process has exited, most of which behave
|
|
||||||
differently between Windows and Linux/OS X:
|
|
||||||
|
|
||||||
- On Windows, the parent process can mark its child as being a 'job' that should auto-terminate when
|
|
||||||
the parent does (http://stackoverflow.com/a/4657392). Not cross-platform.
|
|
||||||
- The child Node process can get a callback when the parent disconnects (process.on('disconnect', ...)).
|
|
||||||
But despite http://stackoverflow.com/a/16487966, no callback fires in any case I've tested (Windows / OS X).
|
|
||||||
- The child Node process can get a callback when its stdin/stdout are disconnected, as described at
|
|
||||||
http://stackoverflow.com/a/15693934. This works well on OS X, but calling stdout.resume() on Windows
|
|
||||||
causes the process to terminate prematurely.
|
|
||||||
- I don't know why, but on Windows, it's enough to invoke process.stdin.resume(). For some reason this causes
|
|
||||||
the child Node process to exit as soon as the parent one does, but I don't see this documented anywhere.
|
|
||||||
- You can poll to see if the parent process, or your stdin/stdout connection to it, is gone
|
|
||||||
- You can directly pass a parent process PID to the child, and then have the child poll to see if it's
|
|
||||||
still running (e.g., using process.kill(pid, 0), which doesn't kill it but just tests whether it exists,
|
|
||||||
as per https://nodejs.org/api/process.html#process_process_kill_pid_signal)
|
|
||||||
- Or, on each poll, you can try writing to process.stdout. If the parent has died, then this will throw.
|
|
||||||
However I don't see this documented anywhere. It would be nice if you could just poll for whether or not
|
|
||||||
process.stdout is still connected (without actually writing to it) but I haven't found any property whose
|
|
||||||
value changes until you actually try to write to it.
|
|
||||||
|
|
||||||
Of these, the only cross-platform approach that is actually documented as a valid strategy is simply polling
|
|
||||||
to check whether the parent PID is still running. So that's what we do here.
|
|
||||||
*/
|
|
||||||
exports.__esModule = true;
|
|
||||||
var pollIntervalMs = 1000;
|
|
||||||
function exitWhenParentExits(parentPid, ignoreSigint) {
|
|
||||||
setInterval(function () {
|
|
||||||
if (!processExists(parentPid)) {
|
|
||||||
// Can't log anything at this point, because out stdout was connected to the parent,
|
|
||||||
// but the parent is gone.
|
|
||||||
process.exit();
|
|
||||||
}
|
|
||||||
}, pollIntervalMs);
|
|
||||||
if (ignoreSigint) {
|
|
||||||
// Pressing ctrl+c in the terminal sends a SIGINT to all processes in the foreground process tree.
|
|
||||||
// By default, the Node process would then exit before the .NET process, because ASP.NET implements
|
|
||||||
// a delayed shutdown to allow ongoing requests to complete.
|
|
||||||
//
|
|
||||||
// This is problematic, because if Node exits first, the CopyToAsync code in ConditionalProxyMiddleware
|
|
||||||
// will experience a read fault, and logs a huge load of errors. Fortunately, since the Node process is
|
|
||||||
// already set up to shut itself down if it detects the .NET process is terminated, all we have to do is
|
|
||||||
// ignore the SIGINT. The Node process will then terminate automatically after the .NET process does.
|
|
||||||
//
|
|
||||||
// A better solution would be to have WebpackDevMiddleware listen for SIGINT and gracefully close any
|
|
||||||
// ongoing EventSource connections before letting the Node process exit, independently of the .NET
|
|
||||||
// process exiting. However, doing this well in general is very nontrivial (see all the discussion at
|
|
||||||
// https://github.com/nodejs/node/issues/2642).
|
|
||||||
process.on('SIGINT', function () {
|
|
||||||
console.log('Received SIGINT. Waiting for .NET process to exit...');
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
exports.exitWhenParentExits = exitWhenParentExits;
|
|
||||||
function processExists(pid) {
|
|
||||||
try {
|
|
||||||
// Sending signal 0 - on all platforms - tests whether the process exists. As long as it doesn't
|
|
||||||
// throw, that means it does exist.
|
|
||||||
process.kill(pid, 0);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
catch (ex) {
|
|
||||||
// If the reason for the error is that we don't have permission to ask about this process,
|
|
||||||
// report that as a separate problem.
|
|
||||||
if (ex.code === 'EPERM') {
|
|
||||||
throw new Error("Attempted to check whether process " + pid + " was running, but got a permissions error.");
|
|
||||||
}
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
/***/ })
|
|
||||||
/******/ ])));
|
|
||||||
@@ -1,935 +0,0 @@
|
|||||||
{
|
|
||||||
"AssemblyIdentity": "Microsoft.AspNetCore.NodeServices, Version=2.1.1.0, Culture=neutral, PublicKeyToken=adb9793829ddae60",
|
|
||||||
"Types": [
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.Extensions.DependencyInjection.NodeServicesServiceCollectionExtensions",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"Abstract": true,
|
|
||||||
"Static": true,
|
|
||||||
"Sealed": true,
|
|
||||||
"ImplementedInterfaces": [],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "AddNodeServices",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "serviceCollection",
|
|
||||||
"Type": "Microsoft.Extensions.DependencyInjection.IServiceCollection"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Static": true,
|
|
||||||
"Extension": true,
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "AddNodeServices",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "serviceCollection",
|
|
||||||
"Type": "Microsoft.Extensions.DependencyInjection.IServiceCollection"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "setupAction",
|
|
||||||
"Type": "System.Action<Microsoft.AspNetCore.NodeServices.NodeServicesOptions>"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Static": true,
|
|
||||||
"Extension": true,
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.NodeServicesFactory",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"Abstract": true,
|
|
||||||
"Static": true,
|
|
||||||
"Sealed": true,
|
|
||||||
"ImplementedInterfaces": [],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "CreateNodeServices",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "options",
|
|
||||||
"Type": "Microsoft.AspNetCore.NodeServices.NodeServicesOptions"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "Microsoft.AspNetCore.NodeServices.INodeServices",
|
|
||||||
"Static": true,
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.NodeServicesOptions",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"ImplementedInterfaces": [],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_NodeInstanceFactory",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Func<Microsoft.AspNetCore.NodeServices.HostingModels.INodeInstance>",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_NodeInstanceFactory",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.Func<Microsoft.AspNetCore.NodeServices.HostingModels.INodeInstance>"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_ProjectPath",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.String",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_ProjectPath",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.String"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_WatchFileExtensions",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.String[]",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_WatchFileExtensions",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.String[]"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_NodeInstanceOutputLogger",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "Microsoft.Extensions.Logging.ILogger",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_NodeInstanceOutputLogger",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "Microsoft.Extensions.Logging.ILogger"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_LaunchWithDebugging",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Boolean",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_LaunchWithDebugging",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.Boolean"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_DebuggingPort",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Int32",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_DebuggingPort",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.Int32"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_EnvironmentVariables",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Collections.Generic.IDictionary<System.String, System.String>",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_EnvironmentVariables",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.Collections.Generic.IDictionary<System.String, System.String>"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_InvocationTimeoutMilliseconds",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Int32",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_InvocationTimeoutMilliseconds",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.Int32"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_ApplicationStoppingToken",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Threading.CancellationToken",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_ApplicationStoppingToken",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.Threading.CancellationToken"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Constructor",
|
|
||||||
"Name": ".ctor",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "serviceProvider",
|
|
||||||
"Type": "System.IServiceProvider"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.INodeServices",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Interface",
|
|
||||||
"Abstract": true,
|
|
||||||
"ImplementedInterfaces": [
|
|
||||||
"System.IDisposable"
|
|
||||||
],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "InvokeAsync<T0>",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "moduleName",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "args",
|
|
||||||
"Type": "System.Object[]",
|
|
||||||
"IsParams": true
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Threading.Tasks.Task<T0>",
|
|
||||||
"GenericParameter": [
|
|
||||||
{
|
|
||||||
"ParameterName": "T",
|
|
||||||
"ParameterPosition": 0,
|
|
||||||
"BaseTypeOrInterfaces": []
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "InvokeAsync<T0>",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "cancellationToken",
|
|
||||||
"Type": "System.Threading.CancellationToken"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "moduleName",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "args",
|
|
||||||
"Type": "System.Object[]",
|
|
||||||
"IsParams": true
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Threading.Tasks.Task<T0>",
|
|
||||||
"GenericParameter": [
|
|
||||||
{
|
|
||||||
"ParameterName": "T",
|
|
||||||
"ParameterPosition": 0,
|
|
||||||
"BaseTypeOrInterfaces": []
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "InvokeExportAsync<T0>",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "moduleName",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "exportedFunctionName",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "args",
|
|
||||||
"Type": "System.Object[]",
|
|
||||||
"IsParams": true
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Threading.Tasks.Task<T0>",
|
|
||||||
"GenericParameter": [
|
|
||||||
{
|
|
||||||
"ParameterName": "T",
|
|
||||||
"ParameterPosition": 0,
|
|
||||||
"BaseTypeOrInterfaces": []
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "InvokeExportAsync<T0>",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "cancellationToken",
|
|
||||||
"Type": "System.Threading.CancellationToken"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "moduleName",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "exportedFunctionName",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "args",
|
|
||||||
"Type": "System.Object[]",
|
|
||||||
"IsParams": true
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Threading.Tasks.Task<T0>",
|
|
||||||
"GenericParameter": [
|
|
||||||
{
|
|
||||||
"ParameterName": "T",
|
|
||||||
"ParameterPosition": 0,
|
|
||||||
"BaseTypeOrInterfaces": []
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.EmbeddedResourceReader",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"Abstract": true,
|
|
||||||
"Static": true,
|
|
||||||
"Sealed": true,
|
|
||||||
"ImplementedInterfaces": [],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "Read",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "assemblyContainingType",
|
|
||||||
"Type": "System.Type"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "path",
|
|
||||||
"Type": "System.String"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.String",
|
|
||||||
"Static": true,
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.StringAsTempFile",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"Sealed": true,
|
|
||||||
"ImplementedInterfaces": [
|
|
||||||
"System.IDisposable"
|
|
||||||
],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_FileName",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.String",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "Dispose",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Sealed": true,
|
|
||||||
"Virtual": true,
|
|
||||||
"ImplementedInterface": "System.IDisposable",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "Finalize",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Virtual": true,
|
|
||||||
"Override": true,
|
|
||||||
"Visibility": "Protected",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Constructor",
|
|
||||||
"Name": ".ctor",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "content",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "applicationStoppingToken",
|
|
||||||
"Type": "System.Threading.CancellationToken"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.HostingModels.INodeInstance",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Interface",
|
|
||||||
"Abstract": true,
|
|
||||||
"ImplementedInterfaces": [
|
|
||||||
"System.IDisposable"
|
|
||||||
],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "InvokeExportAsync<T0>",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "cancellationToken",
|
|
||||||
"Type": "System.Threading.CancellationToken"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "moduleName",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "exportNameOrNull",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "args",
|
|
||||||
"Type": "System.Object[]",
|
|
||||||
"IsParams": true
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Threading.Tasks.Task<T0>",
|
|
||||||
"GenericParameter": [
|
|
||||||
{
|
|
||||||
"ParameterName": "T",
|
|
||||||
"ParameterPosition": 0,
|
|
||||||
"BaseTypeOrInterfaces": []
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.HostingModels.NodeInvocationException",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"BaseType": "System.Exception",
|
|
||||||
"ImplementedInterfaces": [],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_NodeInstanceUnavailable",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Boolean",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_AllowConnectionDraining",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Boolean",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Constructor",
|
|
||||||
"Name": ".ctor",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "message",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "details",
|
|
||||||
"Type": "System.String"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Constructor",
|
|
||||||
"Name": ".ctor",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "message",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "details",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "nodeInstanceUnavailable",
|
|
||||||
"Type": "System.Boolean"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "allowConnectionDraining",
|
|
||||||
"Type": "System.Boolean"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.HostingModels.NodeInvocationInfo",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"ImplementedInterfaces": [],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_ModuleName",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.String",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_ModuleName",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.String"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_ExportedFunctionName",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.String",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_ExportedFunctionName",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.String"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "get_Args",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Object[]",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "set_Args",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "value",
|
|
||||||
"Type": "System.Object[]"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Constructor",
|
|
||||||
"Name": ".ctor",
|
|
||||||
"Parameters": [],
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.HostingModels.NodeServicesOptionsExtensions",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"Abstract": true,
|
|
||||||
"Static": true,
|
|
||||||
"Sealed": true,
|
|
||||||
"ImplementedInterfaces": [],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "UseHttpHosting",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "options",
|
|
||||||
"Type": "Microsoft.AspNetCore.NodeServices.NodeServicesOptions"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Static": true,
|
|
||||||
"Extension": true,
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "Microsoft.AspNetCore.NodeServices.HostingModels.OutOfProcessNodeInstance",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"Kind": "Class",
|
|
||||||
"Abstract": true,
|
|
||||||
"ImplementedInterfaces": [
|
|
||||||
"Microsoft.AspNetCore.NodeServices.HostingModels.INodeInstance"
|
|
||||||
],
|
|
||||||
"Members": [
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "Dispose",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Sealed": true,
|
|
||||||
"Virtual": true,
|
|
||||||
"ImplementedInterface": "System.IDisposable",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "InvokeExportAsync<T0>",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "cancellationToken",
|
|
||||||
"Type": "System.Threading.CancellationToken"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "moduleName",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "exportNameOrNull",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "args",
|
|
||||||
"Type": "System.Object[]",
|
|
||||||
"IsParams": true
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Threading.Tasks.Task<T0>",
|
|
||||||
"Sealed": true,
|
|
||||||
"Virtual": true,
|
|
||||||
"ImplementedInterface": "Microsoft.AspNetCore.NodeServices.HostingModels.INodeInstance",
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": [
|
|
||||||
{
|
|
||||||
"ParameterName": "T",
|
|
||||||
"ParameterPosition": 0,
|
|
||||||
"BaseTypeOrInterfaces": []
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "InvokeExportAsync<T0>",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "invocationInfo",
|
|
||||||
"Type": "Microsoft.AspNetCore.NodeServices.HostingModels.NodeInvocationInfo"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "cancellationToken",
|
|
||||||
"Type": "System.Threading.CancellationToken"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Threading.Tasks.Task<T0>",
|
|
||||||
"Virtual": true,
|
|
||||||
"Abstract": true,
|
|
||||||
"Visibility": "Protected",
|
|
||||||
"GenericParameter": [
|
|
||||||
{
|
|
||||||
"ParameterName": "T",
|
|
||||||
"ParameterPosition": 0,
|
|
||||||
"BaseTypeOrInterfaces": []
|
|
||||||
}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "PrepareNodeProcessStartInfo",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "entryPointFilename",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "projectPath",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "commandLineArguments",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "environmentVars",
|
|
||||||
"Type": "System.Collections.Generic.IDictionary<System.String, System.String>"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "launchWithDebugging",
|
|
||||||
"Type": "System.Boolean"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "debuggingPort",
|
|
||||||
"Type": "System.Int32"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Diagnostics.ProcessStartInfo",
|
|
||||||
"Virtual": true,
|
|
||||||
"Visibility": "Protected",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "OnOutputDataReceived",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "outputData",
|
|
||||||
"Type": "System.String"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Virtual": true,
|
|
||||||
"Visibility": "Protected",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "OnErrorDataReceived",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "errorData",
|
|
||||||
"Type": "System.String"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Virtual": true,
|
|
||||||
"Visibility": "Protected",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "Dispose",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "disposing",
|
|
||||||
"Type": "System.Boolean"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Virtual": true,
|
|
||||||
"Visibility": "Protected",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Method",
|
|
||||||
"Name": "Finalize",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "System.Void",
|
|
||||||
"Virtual": true,
|
|
||||||
"Override": true,
|
|
||||||
"Visibility": "Protected",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Constructor",
|
|
||||||
"Name": ".ctor",
|
|
||||||
"Parameters": [
|
|
||||||
{
|
|
||||||
"Name": "entryPointScript",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "projectPath",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "watchFileExtensions",
|
|
||||||
"Type": "System.String[]"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "commandLineArguments",
|
|
||||||
"Type": "System.String"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "applicationStoppingToken",
|
|
||||||
"Type": "System.Threading.CancellationToken"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "nodeOutputLogger",
|
|
||||||
"Type": "Microsoft.Extensions.Logging.ILogger"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "environmentVars",
|
|
||||||
"Type": "System.Collections.Generic.IDictionary<System.String, System.String>"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "invocationTimeoutMilliseconds",
|
|
||||||
"Type": "System.Int32"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "launchWithDebugging",
|
|
||||||
"Type": "System.Boolean"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Name": "debuggingPort",
|
|
||||||
"Type": "System.Int32"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"Visibility": "Public",
|
|
||||||
"GenericParameter": []
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"Kind": "Field",
|
|
||||||
"Name": "OutputLogger",
|
|
||||||
"Parameters": [],
|
|
||||||
"ReturnType": "Microsoft.Extensions.Logging.ILogger",
|
|
||||||
"ReadOnly": true,
|
|
||||||
"Visibility": "Protected",
|
|
||||||
"GenericParameter": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"GenericParameters": []
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -1,84 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
using Microsoft.AspNetCore.NodeServices.Npm;
|
|
||||||
using Microsoft.AspNetCore.NodeServices.Util;
|
|
||||||
using Microsoft.AspNetCore.SpaServices.Prerendering;
|
|
||||||
using Microsoft.AspNetCore.SpaServices.Util;
|
|
||||||
using System;
|
|
||||||
using System.IO;
|
|
||||||
using System.Text.RegularExpressions;
|
|
||||||
using System.Threading.Tasks;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices.AngularCli
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Provides an implementation of <see cref="ISpaPrerendererBuilder"/> that can build
|
|
||||||
/// an Angular application by invoking the Angular CLI.
|
|
||||||
/// </summary>
|
|
||||||
public class AngularCliBuilder : ISpaPrerendererBuilder
|
|
||||||
{
|
|
||||||
private static TimeSpan RegexMatchTimeout = TimeSpan.FromSeconds(5); // This is a development-time only feature, so a very long timeout is fine
|
|
||||||
|
|
||||||
private readonly string _npmScriptName;
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Constructs an instance of <see cref="AngularCliBuilder"/>.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="npmScript">The name of the script in your package.json file that builds the server-side bundle for your Angular application.</param>
|
|
||||||
public AngularCliBuilder(string npmScript)
|
|
||||||
{
|
|
||||||
if (string.IsNullOrEmpty(npmScript))
|
|
||||||
{
|
|
||||||
throw new ArgumentException("Cannot be null or empty.", nameof(npmScript));
|
|
||||||
}
|
|
||||||
|
|
||||||
_npmScriptName = npmScript;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <inheritdoc />
|
|
||||||
public async Task Build(ISpaBuilder spaBuilder)
|
|
||||||
{
|
|
||||||
var sourcePath = spaBuilder.Options.SourcePath;
|
|
||||||
if (string.IsNullOrEmpty(sourcePath))
|
|
||||||
{
|
|
||||||
throw new InvalidOperationException($"To use {nameof(AngularCliBuilder)}, you must supply a non-empty value for the {nameof(SpaOptions.SourcePath)} property of {nameof(SpaOptions)} when calling {nameof(SpaApplicationBuilderExtensions.UseSpa)}.");
|
|
||||||
}
|
|
||||||
|
|
||||||
var logger = LoggerFinder.GetOrCreateLogger(
|
|
||||||
spaBuilder.ApplicationBuilder,
|
|
||||||
nameof(AngularCliBuilder));
|
|
||||||
var npmScriptRunner = new NpmScriptRunner(
|
|
||||||
sourcePath,
|
|
||||||
_npmScriptName,
|
|
||||||
"--watch",
|
|
||||||
null);
|
|
||||||
npmScriptRunner.AttachToLogger(logger);
|
|
||||||
|
|
||||||
using (var stdOutReader = new EventedStreamStringReader(npmScriptRunner.StdOut))
|
|
||||||
using (var stdErrReader = new EventedStreamStringReader(npmScriptRunner.StdErr))
|
|
||||||
{
|
|
||||||
try
|
|
||||||
{
|
|
||||||
await npmScriptRunner.StdOut.WaitForMatch(
|
|
||||||
new Regex("Date", RegexOptions.None, RegexMatchTimeout));
|
|
||||||
}
|
|
||||||
catch (EndOfStreamException ex)
|
|
||||||
{
|
|
||||||
throw new InvalidOperationException(
|
|
||||||
$"The NPM script '{_npmScriptName}' exited without indicating success.\n" +
|
|
||||||
$"Output was: {stdOutReader.ReadAsString()}\n" +
|
|
||||||
$"Error output was: {stdErrReader.ReadAsString()}", ex);
|
|
||||||
}
|
|
||||||
catch (OperationCanceledException ex)
|
|
||||||
{
|
|
||||||
throw new InvalidOperationException(
|
|
||||||
$"The NPM script '{_npmScriptName}' timed out without indicating success. " +
|
|
||||||
$"Output was: {stdOutReader.ReadAsString()}\n" +
|
|
||||||
$"Error output was: {stdErrReader.ReadAsString()}", ex);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,145 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
using Microsoft.Extensions.Logging;
|
|
||||||
using Microsoft.AspNetCore.NodeServices.Npm;
|
|
||||||
using Microsoft.AspNetCore.NodeServices.Util;
|
|
||||||
using Microsoft.AspNetCore.SpaServices.Util;
|
|
||||||
using System;
|
|
||||||
using System.IO;
|
|
||||||
using System.Text.RegularExpressions;
|
|
||||||
using System.Threading.Tasks;
|
|
||||||
using System.Threading;
|
|
||||||
using System.Net.Http;
|
|
||||||
using Microsoft.AspNetCore.SpaServices.Extensions.Util;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices.AngularCli
|
|
||||||
{
|
|
||||||
internal static class AngularCliMiddleware
|
|
||||||
{
|
|
||||||
private const string LogCategoryName = "Microsoft.AspNetCore.SpaServices";
|
|
||||||
private static TimeSpan RegexMatchTimeout = TimeSpan.FromSeconds(5); // This is a development-time only feature, so a very long timeout is fine
|
|
||||||
|
|
||||||
public static void Attach(
|
|
||||||
ISpaBuilder spaBuilder,
|
|
||||||
string npmScriptName)
|
|
||||||
{
|
|
||||||
var sourcePath = spaBuilder.Options.SourcePath;
|
|
||||||
if (string.IsNullOrEmpty(sourcePath))
|
|
||||||
{
|
|
||||||
throw new ArgumentException("Cannot be null or empty", nameof(sourcePath));
|
|
||||||
}
|
|
||||||
|
|
||||||
if (string.IsNullOrEmpty(npmScriptName))
|
|
||||||
{
|
|
||||||
throw new ArgumentException("Cannot be null or empty", nameof(npmScriptName));
|
|
||||||
}
|
|
||||||
|
|
||||||
// Start Angular CLI and attach to middleware pipeline
|
|
||||||
var appBuilder = spaBuilder.ApplicationBuilder;
|
|
||||||
var logger = LoggerFinder.GetOrCreateLogger(appBuilder, LogCategoryName);
|
|
||||||
var angularCliServerInfoTask = StartAngularCliServerAsync(sourcePath, npmScriptName, logger);
|
|
||||||
|
|
||||||
// Everything we proxy is hardcoded to target http://localhost because:
|
|
||||||
// - the requests are always from the local machine (we're not accepting remote
|
|
||||||
// requests that go directly to the Angular CLI middleware server)
|
|
||||||
// - given that, there's no reason to use https, and we couldn't even if we
|
|
||||||
// wanted to, because in general the Angular CLI server has no certificate
|
|
||||||
var targetUriTask = angularCliServerInfoTask.ContinueWith(
|
|
||||||
task => new UriBuilder("http", "localhost", task.Result.Port).Uri);
|
|
||||||
|
|
||||||
SpaProxyingExtensions.UseProxyToSpaDevelopmentServer(spaBuilder, () =>
|
|
||||||
{
|
|
||||||
// On each request, we create a separate startup task with its own timeout. That way, even if
|
|
||||||
// the first request times out, subsequent requests could still work.
|
|
||||||
var timeout = spaBuilder.Options.StartupTimeout;
|
|
||||||
return targetUriTask.WithTimeout(timeout,
|
|
||||||
$"The Angular CLI process did not start listening for requests " +
|
|
||||||
$"within the timeout period of {timeout.Seconds} seconds. " +
|
|
||||||
$"Check the log output for error information.");
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
private static async Task<AngularCliServerInfo> StartAngularCliServerAsync(
|
|
||||||
string sourcePath, string npmScriptName, ILogger logger)
|
|
||||||
{
|
|
||||||
var portNumber = TcpPortFinder.FindAvailablePort();
|
|
||||||
logger.LogInformation($"Starting @angular/cli on port {portNumber}...");
|
|
||||||
|
|
||||||
var npmScriptRunner = new NpmScriptRunner(
|
|
||||||
sourcePath, npmScriptName, $"--port {portNumber}", null);
|
|
||||||
npmScriptRunner.AttachToLogger(logger);
|
|
||||||
|
|
||||||
Match openBrowserLine;
|
|
||||||
using (var stdErrReader = new EventedStreamStringReader(npmScriptRunner.StdErr))
|
|
||||||
{
|
|
||||||
try
|
|
||||||
{
|
|
||||||
openBrowserLine = await npmScriptRunner.StdOut.WaitForMatch(
|
|
||||||
new Regex("open your browser on (http\\S+)", RegexOptions.None, RegexMatchTimeout));
|
|
||||||
}
|
|
||||||
catch (EndOfStreamException ex)
|
|
||||||
{
|
|
||||||
throw new InvalidOperationException(
|
|
||||||
$"The NPM script '{npmScriptName}' exited without indicating that the " +
|
|
||||||
$"Angular CLI was listening for requests. The error output was: " +
|
|
||||||
$"{stdErrReader.ReadAsString()}", ex);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
var uri = new Uri(openBrowserLine.Groups[1].Value);
|
|
||||||
var serverInfo = new AngularCliServerInfo { Port = uri.Port };
|
|
||||||
|
|
||||||
// Even after the Angular CLI claims to be listening for requests, there's a short
|
|
||||||
// period where it will give an error if you make a request too quickly
|
|
||||||
await WaitForAngularCliServerToAcceptRequests(uri);
|
|
||||||
|
|
||||||
return serverInfo;
|
|
||||||
}
|
|
||||||
|
|
||||||
private static async Task WaitForAngularCliServerToAcceptRequests(Uri cliServerUri)
|
|
||||||
{
|
|
||||||
// To determine when it's actually ready, try making HEAD requests to '/'. If it
|
|
||||||
// produces any HTTP response (even if it's 404) then it's ready. If it rejects the
|
|
||||||
// connection then it's not ready. We keep trying forever because this is dev-mode
|
|
||||||
// only, and only a single startup attempt will be made, and there's a further level
|
|
||||||
// of timeouts enforced on a per-request basis.
|
|
||||||
var timeoutMilliseconds = 1000;
|
|
||||||
using (var client = new HttpClient())
|
|
||||||
{
|
|
||||||
while (true)
|
|
||||||
{
|
|
||||||
try
|
|
||||||
{
|
|
||||||
// If we get any HTTP response, the CLI server is ready
|
|
||||||
await client.SendAsync(
|
|
||||||
new HttpRequestMessage(HttpMethod.Head, cliServerUri),
|
|
||||||
new CancellationTokenSource(timeoutMilliseconds).Token);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
catch (Exception)
|
|
||||||
{
|
|
||||||
await Task.Delay(500);
|
|
||||||
|
|
||||||
// Depending on the host's networking configuration, the requests can take a while
|
|
||||||
// to go through, most likely due to the time spent resolving 'localhost'.
|
|
||||||
// Each time we have a failure, allow a bit longer next time (up to a maximum).
|
|
||||||
// This only influences the time until we regard the dev server as 'ready', so it
|
|
||||||
// doesn't affect the runtime perf (even in dev mode) once the first connection is made.
|
|
||||||
// Resolves https://github.com/aspnet/JavaScriptServices/issues/1611
|
|
||||||
if (timeoutMilliseconds < 10000)
|
|
||||||
{
|
|
||||||
timeoutMilliseconds += 3000;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
class AngularCliServerInfo
|
|
||||||
{
|
|
||||||
public int Port { get; set; }
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,43 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
using System;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices.AngularCli
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Extension methods for enabling Angular CLI middleware support.
|
|
||||||
/// </summary>
|
|
||||||
public static class AngularCliMiddlewareExtensions
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Handles requests by passing them through to an instance of the Angular CLI server.
|
|
||||||
/// This means you can always serve up-to-date CLI-built resources without having
|
|
||||||
/// to run the Angular CLI server manually.
|
|
||||||
///
|
|
||||||
/// This feature should only be used in development. For production deployments, be
|
|
||||||
/// sure not to enable the Angular CLI server.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="spaBuilder">The <see cref="ISpaBuilder"/>.</param>
|
|
||||||
/// <param name="npmScript">The name of the script in your package.json file that launches the Angular CLI process.</param>
|
|
||||||
public static void UseAngularCliServer(
|
|
||||||
this ISpaBuilder spaBuilder,
|
|
||||||
string npmScript)
|
|
||||||
{
|
|
||||||
if (spaBuilder == null)
|
|
||||||
{
|
|
||||||
throw new ArgumentNullException(nameof(spaBuilder));
|
|
||||||
}
|
|
||||||
|
|
||||||
var spaOptions = spaBuilder.Options;
|
|
||||||
|
|
||||||
if (string.IsNullOrEmpty(spaOptions.SourcePath))
|
|
||||||
{
|
|
||||||
throw new InvalidOperationException($"To use {nameof(UseAngularCliServer)}, you must supply a non-empty value for the {nameof(SpaOptions.SourcePath)} property of {nameof(SpaOptions)} when calling {nameof(SpaApplicationBuilderExtensions.UseSpa)}.");
|
|
||||||
}
|
|
||||||
|
|
||||||
AngularCliMiddleware.Attach(spaBuilder, npmScript);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,24 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
using System;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices
|
|
||||||
{
|
|
||||||
internal class DefaultSpaBuilder : ISpaBuilder
|
|
||||||
{
|
|
||||||
public IApplicationBuilder ApplicationBuilder { get; }
|
|
||||||
|
|
||||||
public SpaOptions Options { get; }
|
|
||||||
|
|
||||||
public DefaultSpaBuilder(IApplicationBuilder applicationBuilder, SpaOptions options)
|
|
||||||
{
|
|
||||||
ApplicationBuilder = applicationBuilder
|
|
||||||
?? throw new ArgumentNullException(nameof(applicationBuilder));
|
|
||||||
|
|
||||||
Options = options
|
|
||||||
?? throw new ArgumentNullException(nameof(options));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,25 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Defines a class that provides mechanisms for configuring the hosting
|
|
||||||
/// of a Single Page Application (SPA) and attaching middleware.
|
|
||||||
/// </summary>
|
|
||||||
public interface ISpaBuilder
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// The <see cref="IApplicationBuilder"/> representing the middleware pipeline
|
|
||||||
/// in which the SPA is being hosted.
|
|
||||||
/// </summary>
|
|
||||||
IApplicationBuilder ApplicationBuilder { get; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Describes configuration options for hosting a SPA.
|
|
||||||
/// </summary>
|
|
||||||
SpaOptions Options { get; }
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,18 +0,0 @@
|
|||||||
<Project Sdk="Microsoft.NET.Sdk">
|
|
||||||
|
|
||||||
<PropertyGroup>
|
|
||||||
<Description>Helpers for building single-page applications on ASP.NET MVC Core.</Description>
|
|
||||||
<TargetFramework>netcoreapp3.0</TargetFramework>
|
|
||||||
</PropertyGroup>
|
|
||||||
|
|
||||||
<ItemGroup>
|
|
||||||
<ProjectReference Include="..\Microsoft.AspNetCore.SpaServices\Microsoft.AspNetCore.SpaServices.csproj" />
|
|
||||||
</ItemGroup>
|
|
||||||
|
|
||||||
<ItemGroup>
|
|
||||||
<PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="$(MicrosoftAspNetCoreStaticFilesPackageVersion)" />
|
|
||||||
<PackageReference Include="Microsoft.AspNetCore.WebSockets" Version="$(MicrosoftAspNetCoreWebSocketsPackageVersion)" />
|
|
||||||
<PackageReference Include="Microsoft.Extensions.FileProviders.Physical" Version="$(MicrosoftExtensionsFileProvidersPhysicalPackageVersion)" />
|
|
||||||
</ItemGroup>
|
|
||||||
|
|
||||||
</Project>
|
|
||||||
@@ -1,131 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.Extensions.Logging;
|
|
||||||
using Microsoft.AspNetCore.NodeServices.Util;
|
|
||||||
using System;
|
|
||||||
using System.Diagnostics;
|
|
||||||
using System.Runtime.InteropServices;
|
|
||||||
using System.Text.RegularExpressions;
|
|
||||||
using System.Collections.Generic;
|
|
||||||
|
|
||||||
// This is under the NodeServices namespace because post 2.1 it will be moved to that package
|
|
||||||
namespace Microsoft.AspNetCore.NodeServices.Npm
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Executes the <c>script</c> entries defined in a <c>package.json</c> file,
|
|
||||||
/// capturing any output written to stdio.
|
|
||||||
/// </summary>
|
|
||||||
internal class NpmScriptRunner
|
|
||||||
{
|
|
||||||
public EventedStreamReader StdOut { get; }
|
|
||||||
public EventedStreamReader StdErr { get; }
|
|
||||||
|
|
||||||
private static Regex AnsiColorRegex = new Regex("\x001b\\[[0-9;]*m", RegexOptions.None, TimeSpan.FromSeconds(1));
|
|
||||||
|
|
||||||
public NpmScriptRunner(string workingDirectory, string scriptName, string arguments, IDictionary<string, string> envVars)
|
|
||||||
{
|
|
||||||
if (string.IsNullOrEmpty(workingDirectory))
|
|
||||||
{
|
|
||||||
throw new ArgumentException("Cannot be null or empty.", nameof(workingDirectory));
|
|
||||||
}
|
|
||||||
|
|
||||||
if (string.IsNullOrEmpty(scriptName))
|
|
||||||
{
|
|
||||||
throw new ArgumentException("Cannot be null or empty.", nameof(scriptName));
|
|
||||||
}
|
|
||||||
|
|
||||||
var npmExe = "npm";
|
|
||||||
var completeArguments = $"run {scriptName} -- {arguments ?? string.Empty}";
|
|
||||||
if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
|
|
||||||
{
|
|
||||||
// On Windows, the NPM executable is a .cmd file, so it can't be executed
|
|
||||||
// directly (except with UseShellExecute=true, but that's no good, because
|
|
||||||
// it prevents capturing stdio). So we need to invoke it via "cmd /c".
|
|
||||||
npmExe = "cmd";
|
|
||||||
completeArguments = $"/c npm {completeArguments}";
|
|
||||||
}
|
|
||||||
|
|
||||||
var processStartInfo = new ProcessStartInfo(npmExe)
|
|
||||||
{
|
|
||||||
Arguments = completeArguments,
|
|
||||||
UseShellExecute = false,
|
|
||||||
RedirectStandardInput = true,
|
|
||||||
RedirectStandardOutput = true,
|
|
||||||
RedirectStandardError = true,
|
|
||||||
WorkingDirectory = workingDirectory
|
|
||||||
};
|
|
||||||
|
|
||||||
if (envVars != null)
|
|
||||||
{
|
|
||||||
foreach (var keyValuePair in envVars)
|
|
||||||
{
|
|
||||||
processStartInfo.Environment[keyValuePair.Key] = keyValuePair.Value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
var process = LaunchNodeProcess(processStartInfo);
|
|
||||||
StdOut = new EventedStreamReader(process.StandardOutput);
|
|
||||||
StdErr = new EventedStreamReader(process.StandardError);
|
|
||||||
}
|
|
||||||
|
|
||||||
public void AttachToLogger(ILogger logger)
|
|
||||||
{
|
|
||||||
// When the NPM task emits complete lines, pass them through to the real logger
|
|
||||||
StdOut.OnReceivedLine += line =>
|
|
||||||
{
|
|
||||||
if (!string.IsNullOrWhiteSpace(line))
|
|
||||||
{
|
|
||||||
// NPM tasks commonly emit ANSI colors, but it wouldn't make sense to forward
|
|
||||||
// those to loggers (because a logger isn't necessarily any kind of terminal)
|
|
||||||
logger.LogInformation(StripAnsiColors(line));
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
StdErr.OnReceivedLine += line =>
|
|
||||||
{
|
|
||||||
if (!string.IsNullOrWhiteSpace(line))
|
|
||||||
{
|
|
||||||
logger.LogError(StripAnsiColors(line));
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
// But when it emits incomplete lines, assume this is progress information and
|
|
||||||
// hence just pass it through to StdOut regardless of logger config.
|
|
||||||
StdErr.OnReceivedChunk += chunk =>
|
|
||||||
{
|
|
||||||
var containsNewline = Array.IndexOf(
|
|
||||||
chunk.Array, '\n', chunk.Offset, chunk.Count) >= 0;
|
|
||||||
if (!containsNewline)
|
|
||||||
{
|
|
||||||
Console.Write(chunk.Array, chunk.Offset, chunk.Count);
|
|
||||||
}
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
private static string StripAnsiColors(string line)
|
|
||||||
=> AnsiColorRegex.Replace(line, string.Empty);
|
|
||||||
|
|
||||||
private static Process LaunchNodeProcess(ProcessStartInfo startInfo)
|
|
||||||
{
|
|
||||||
try
|
|
||||||
{
|
|
||||||
var process = Process.Start(startInfo);
|
|
||||||
|
|
||||||
// See equivalent comment in OutOfProcessNodeInstance.cs for why
|
|
||||||
process.EnableRaisingEvents = true;
|
|
||||||
|
|
||||||
return process;
|
|
||||||
}
|
|
||||||
catch (Exception ex)
|
|
||||||
{
|
|
||||||
var message = $"Failed to start 'npm'. To resolve this:.\n\n"
|
|
||||||
+ "[1] Ensure that 'npm' is installed and can be found in one of the PATH directories.\n"
|
|
||||||
+ $" Current PATH enviroment variable is: { Environment.GetEnvironmentVariable("PATH") }\n"
|
|
||||||
+ " Make sure the executable is in one of those directories, or update your PATH.\n\n"
|
|
||||||
+ "[2] See the InnerException for further details of the cause.";
|
|
||||||
throw new InvalidOperationException(message, ex);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,25 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
using System.Threading.Tasks;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices.Prerendering
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Represents the ability to build a Single Page Application (SPA) on demand
|
|
||||||
/// so that it can be prerendered. This is only intended to be used at development
|
|
||||||
/// time. In production, a SPA should already have been built during publishing.
|
|
||||||
/// </summary>
|
|
||||||
public interface ISpaPrerendererBuilder
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Builds the Single Page Application so that a JavaScript entrypoint file
|
|
||||||
/// exists on disk. Prerendering middleware can then execute that file in
|
|
||||||
/// a Node environment.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="spaBuilder">The <see cref="ISpaBuilder"/>.</param>
|
|
||||||
/// <returns>A <see cref="Task"/> representing completion of the build process.</returns>
|
|
||||||
Task Build(ISpaBuilder spaBuilder);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,269 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Hosting;
|
|
||||||
using Microsoft.AspNetCore.Http;
|
|
||||||
using Microsoft.AspNetCore.Http.Features;
|
|
||||||
using Microsoft.AspNetCore.NodeServices;
|
|
||||||
using Microsoft.AspNetCore.SpaServices;
|
|
||||||
using Microsoft.AspNetCore.SpaServices.Extensions.Util;
|
|
||||||
using Microsoft.AspNetCore.SpaServices.Prerendering;
|
|
||||||
using Microsoft.Extensions.DependencyInjection;
|
|
||||||
using Microsoft.Net.Http.Headers;
|
|
||||||
using System;
|
|
||||||
using System.Collections.Generic;
|
|
||||||
using System.IO;
|
|
||||||
using System.Linq;
|
|
||||||
using System.Text;
|
|
||||||
using System.Threading.Tasks;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.Builder
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Extension methods for configuring prerendering of a Single Page Application.
|
|
||||||
/// </summary>
|
|
||||||
public static class SpaPrerenderingExtensions
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Enables server-side prerendering middleware for a Single Page Application.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="spaBuilder">The <see cref="ISpaBuilder"/>.</param>
|
|
||||||
/// <param name="configuration">Supplies configuration for the prerendering middleware.</param>
|
|
||||||
public static void UseSpaPrerendering(
|
|
||||||
this ISpaBuilder spaBuilder,
|
|
||||||
Action<SpaPrerenderingOptions> configuration)
|
|
||||||
{
|
|
||||||
if (spaBuilder == null)
|
|
||||||
{
|
|
||||||
throw new ArgumentNullException(nameof(spaBuilder));
|
|
||||||
}
|
|
||||||
|
|
||||||
if (configuration == null)
|
|
||||||
{
|
|
||||||
throw new ArgumentNullException(nameof(configuration));
|
|
||||||
}
|
|
||||||
|
|
||||||
var options = new SpaPrerenderingOptions();
|
|
||||||
configuration.Invoke(options);
|
|
||||||
|
|
||||||
var capturedBootModulePath = options.BootModulePath;
|
|
||||||
if (string.IsNullOrEmpty(capturedBootModulePath))
|
|
||||||
{
|
|
||||||
throw new InvalidOperationException($"To use {nameof(UseSpaPrerendering)}, you " +
|
|
||||||
$"must set a nonempty value on the ${nameof(SpaPrerenderingOptions.BootModulePath)} " +
|
|
||||||
$"property on the ${nameof(SpaPrerenderingOptions)}.");
|
|
||||||
}
|
|
||||||
|
|
||||||
// If we're building on demand, start that process in the background now
|
|
||||||
var buildOnDemandTask = options.BootModuleBuilder?.Build(spaBuilder);
|
|
||||||
|
|
||||||
// Get all the necessary context info that will be used for each prerendering call
|
|
||||||
var applicationBuilder = spaBuilder.ApplicationBuilder;
|
|
||||||
var serviceProvider = applicationBuilder.ApplicationServices;
|
|
||||||
var nodeServices = GetNodeServices(serviceProvider);
|
|
||||||
var applicationStoppingToken = serviceProvider.GetRequiredService<IApplicationLifetime>()
|
|
||||||
.ApplicationStopping;
|
|
||||||
var applicationBasePath = serviceProvider.GetRequiredService<IHostingEnvironment>()
|
|
||||||
.ContentRootPath;
|
|
||||||
var moduleExport = new JavaScriptModuleExport(capturedBootModulePath);
|
|
||||||
var excludePathStrings = (options.ExcludeUrls ?? Array.Empty<string>())
|
|
||||||
.Select(url => new PathString(url))
|
|
||||||
.ToArray();
|
|
||||||
var buildTimeout = spaBuilder.Options.StartupTimeout;
|
|
||||||
|
|
||||||
applicationBuilder.Use(async (context, next) =>
|
|
||||||
{
|
|
||||||
// If this URL is excluded, skip prerendering.
|
|
||||||
// This is typically used to ensure that static client-side resources
|
|
||||||
// (e.g., /dist/*.css) are served normally or through SPA development
|
|
||||||
// middleware, and don't return the prerendered index.html page.
|
|
||||||
foreach (var excludePathString in excludePathStrings)
|
|
||||||
{
|
|
||||||
if (context.Request.Path.StartsWithSegments(excludePathString))
|
|
||||||
{
|
|
||||||
await next();
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// If we're building on demand, wait for that to finish, or raise any build errors
|
|
||||||
if (buildOnDemandTask != null && !buildOnDemandTask.IsCompleted)
|
|
||||||
{
|
|
||||||
// For better debuggability, create a per-request timeout that makes it clear if the
|
|
||||||
// prerendering builder took too long for this request, but without aborting the
|
|
||||||
// underlying build task so that subsequent requests could still work.
|
|
||||||
await buildOnDemandTask.WithTimeout(buildTimeout,
|
|
||||||
$"The prerendering build process did not complete within the " +
|
|
||||||
$"timeout period of {buildTimeout.Seconds} seconds. " +
|
|
||||||
$"Check the log output for error information.");
|
|
||||||
}
|
|
||||||
|
|
||||||
// It's no good if we try to return a 304. We need to capture the actual
|
|
||||||
// HTML content so it can be passed as a template to the prerenderer.
|
|
||||||
RemoveConditionalRequestHeaders(context.Request);
|
|
||||||
|
|
||||||
// Make sure we're not capturing compressed content, because then we'd have
|
|
||||||
// to decompress it. Since this sub-request isn't leaving the machine, there's
|
|
||||||
// little to no benefit in having compression on it.
|
|
||||||
var originalAcceptEncodingValue = GetAndRemoveAcceptEncodingHeader(context.Request);
|
|
||||||
|
|
||||||
// Capture the non-prerendered responses, which in production will typically only
|
|
||||||
// be returning the default SPA index.html page (because other resources will be
|
|
||||||
// served statically from disk). We will use this as a template in which to inject
|
|
||||||
// the prerendered output.
|
|
||||||
using (var outputBuffer = new MemoryStream())
|
|
||||||
{
|
|
||||||
var originalResponseStream = context.Response.Body;
|
|
||||||
context.Response.Body = outputBuffer;
|
|
||||||
|
|
||||||
try
|
|
||||||
{
|
|
||||||
await next();
|
|
||||||
outputBuffer.Seek(0, SeekOrigin.Begin);
|
|
||||||
}
|
|
||||||
finally
|
|
||||||
{
|
|
||||||
context.Response.Body = originalResponseStream;
|
|
||||||
|
|
||||||
if (!string.IsNullOrEmpty(originalAcceptEncodingValue))
|
|
||||||
{
|
|
||||||
context.Request.Headers[HeaderNames.AcceptEncoding] = originalAcceptEncodingValue;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// If it isn't an HTML page that we can use as the template for prerendering,
|
|
||||||
// - ... because it's not text/html
|
|
||||||
// - ... or because it's an error
|
|
||||||
// then prerendering doesn't apply to this request, so just pass through the
|
|
||||||
// response as-is. Note that the non-text/html case is not an error: this is
|
|
||||||
// typically how the SPA dev server responses for static content are returned
|
|
||||||
// in development mode.
|
|
||||||
var canPrerender = IsSuccessStatusCode(context.Response.StatusCode)
|
|
||||||
&& IsHtmlContentType(context.Response.ContentType);
|
|
||||||
if (!canPrerender)
|
|
||||||
{
|
|
||||||
await outputBuffer.CopyToAsync(context.Response.Body);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Most prerendering logic will want to know about the original, unprerendered
|
|
||||||
// HTML that the client would be getting otherwise. Typically this is used as
|
|
||||||
// a template from which the fully prerendered page can be generated.
|
|
||||||
var customData = new Dictionary<string, object>
|
|
||||||
{
|
|
||||||
{ "originalHtml", Encoding.UTF8.GetString(outputBuffer.GetBuffer()) }
|
|
||||||
};
|
|
||||||
|
|
||||||
// If the developer wants to use custom logic to pass arbitrary data to the
|
|
||||||
// prerendering JS code (e.g., to pass through cookie data), now's their chance
|
|
||||||
options.SupplyData?.Invoke(context, customData);
|
|
||||||
|
|
||||||
var (unencodedAbsoluteUrl, unencodedPathAndQuery)
|
|
||||||
= GetUnencodedUrlAndPathQuery(context);
|
|
||||||
var renderResult = await Prerenderer.RenderToString(
|
|
||||||
applicationBasePath,
|
|
||||||
nodeServices,
|
|
||||||
applicationStoppingToken,
|
|
||||||
moduleExport,
|
|
||||||
unencodedAbsoluteUrl,
|
|
||||||
unencodedPathAndQuery,
|
|
||||||
customDataParameter: customData,
|
|
||||||
timeoutMilliseconds: 0,
|
|
||||||
requestPathBase: context.Request.PathBase.ToString());
|
|
||||||
|
|
||||||
await ServePrerenderResult(context, renderResult);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
private static bool IsHtmlContentType(string contentType)
|
|
||||||
{
|
|
||||||
if (string.Equals(contentType, "text/html", StringComparison.Ordinal))
|
|
||||||
{
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
|
|
||||||
return contentType != null
|
|
||||||
&& contentType.StartsWith("text/html;", StringComparison.Ordinal);
|
|
||||||
}
|
|
||||||
|
|
||||||
private static bool IsSuccessStatusCode(int statusCode)
|
|
||||||
=> statusCode >= 200 && statusCode < 300;
|
|
||||||
|
|
||||||
private static void RemoveConditionalRequestHeaders(HttpRequest request)
|
|
||||||
{
|
|
||||||
request.Headers.Remove(HeaderNames.IfMatch);
|
|
||||||
request.Headers.Remove(HeaderNames.IfModifiedSince);
|
|
||||||
request.Headers.Remove(HeaderNames.IfNoneMatch);
|
|
||||||
request.Headers.Remove(HeaderNames.IfUnmodifiedSince);
|
|
||||||
request.Headers.Remove(HeaderNames.IfRange);
|
|
||||||
}
|
|
||||||
|
|
||||||
private static string GetAndRemoveAcceptEncodingHeader(HttpRequest request)
|
|
||||||
{
|
|
||||||
var headers = request.Headers;
|
|
||||||
var value = (string)null;
|
|
||||||
|
|
||||||
if (headers.ContainsKey(HeaderNames.AcceptEncoding))
|
|
||||||
{
|
|
||||||
value = headers[HeaderNames.AcceptEncoding];
|
|
||||||
headers.Remove(HeaderNames.AcceptEncoding);
|
|
||||||
}
|
|
||||||
|
|
||||||
return value;
|
|
||||||
}
|
|
||||||
|
|
||||||
private static (string, string) GetUnencodedUrlAndPathQuery(HttpContext httpContext)
|
|
||||||
{
|
|
||||||
// This is a duplicate of code from Prerenderer.cs in the SpaServices package.
|
|
||||||
// Once the SpaServices.Extension package implementation gets merged back into
|
|
||||||
// SpaServices, this duplicate can be removed. To remove this, change the code
|
|
||||||
// above that calls Prerenderer.RenderToString to use the internal overload
|
|
||||||
// that takes an HttpContext instead of a url/path+query pair.
|
|
||||||
var requestFeature = httpContext.Features.Get<IHttpRequestFeature>();
|
|
||||||
var unencodedPathAndQuery = requestFeature.RawTarget;
|
|
||||||
var request = httpContext.Request;
|
|
||||||
var unencodedAbsoluteUrl = $"{request.Scheme}://{request.Host}{unencodedPathAndQuery}";
|
|
||||||
return (unencodedAbsoluteUrl, unencodedPathAndQuery);
|
|
||||||
}
|
|
||||||
|
|
||||||
private static async Task ServePrerenderResult(HttpContext context, RenderToStringResult renderResult)
|
|
||||||
{
|
|
||||||
context.Response.Clear();
|
|
||||||
|
|
||||||
if (!string.IsNullOrEmpty(renderResult.RedirectUrl))
|
|
||||||
{
|
|
||||||
var permanentRedirect = renderResult.StatusCode.GetValueOrDefault() == 301;
|
|
||||||
context.Response.Redirect(renderResult.RedirectUrl, permanentRedirect);
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
// The Globals property exists for back-compatibility but is meaningless
|
|
||||||
// for prerendering that returns complete HTML pages
|
|
||||||
if (renderResult.Globals != null)
|
|
||||||
{
|
|
||||||
throw new InvalidOperationException($"{nameof(renderResult.Globals)} is not " +
|
|
||||||
$"supported when prerendering via {nameof(UseSpaPrerendering)}(). Instead, " +
|
|
||||||
$"your prerendering logic should return a complete HTML page, in which you " +
|
|
||||||
$"embed any information you wish to return to the client.");
|
|
||||||
}
|
|
||||||
|
|
||||||
if (renderResult.StatusCode.HasValue)
|
|
||||||
{
|
|
||||||
context.Response.StatusCode = renderResult.StatusCode.Value;
|
|
||||||
}
|
|
||||||
|
|
||||||
context.Response.ContentType = "text/html";
|
|
||||||
await context.Response.WriteAsync(renderResult.Html);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private static INodeServices GetNodeServices(IServiceProvider serviceProvider)
|
|
||||||
{
|
|
||||||
// Use the registered instance, or create a new private instance if none is registered
|
|
||||||
var instance = (INodeServices)serviceProvider.GetService(typeof(INodeServices));
|
|
||||||
return instance ?? NodeServicesFactory.CreateNodeServices(
|
|
||||||
new NodeServicesOptions(serviceProvider));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,43 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Http;
|
|
||||||
using Microsoft.AspNetCore.SpaServices.Prerendering;
|
|
||||||
using System;
|
|
||||||
using System.Collections.Generic;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.Builder
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Represents options for the SPA prerendering middleware.
|
|
||||||
/// </summary>
|
|
||||||
public class SpaPrerenderingOptions
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Gets or sets an <see cref="ISpaPrerendererBuilder"/> that the prerenderer will invoke before
|
|
||||||
/// looking for the boot module file.
|
|
||||||
///
|
|
||||||
/// This is only intended to be used during development as a way of generating the JavaScript boot
|
|
||||||
/// file automatically when the application runs. This property should be left as <c>null</c> in
|
|
||||||
/// production applications.
|
|
||||||
/// </summary>
|
|
||||||
public ISpaPrerendererBuilder BootModuleBuilder { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets or sets the path, relative to your application root, of the JavaScript file
|
|
||||||
/// containing prerendering logic.
|
|
||||||
/// </summary>
|
|
||||||
public string BootModulePath { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets or sets an array of URL prefixes for which prerendering should not run.
|
|
||||||
/// </summary>
|
|
||||||
public string[] ExcludeUrls { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets or sets a callback that will be invoked during prerendering, allowing you to pass additional
|
|
||||||
/// data to the prerendering entrypoint code.
|
|
||||||
/// </summary>
|
|
||||||
public Action<HttpContext, IDictionary<string, object>> SupplyData { get; set; }
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,62 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Http;
|
|
||||||
using Microsoft.AspNetCore.Hosting;
|
|
||||||
using System;
|
|
||||||
using System.Net.Http;
|
|
||||||
using System.Threading;
|
|
||||||
using System.Threading.Tasks;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices.Extensions.Proxy
|
|
||||||
{
|
|
||||||
// This duplicates and updates the proxying logic in SpaServices so that we can update
|
|
||||||
// the project templates without waiting for 2.1 to ship. When 2.1 is ready to ship,
|
|
||||||
// merge the additional proxying features (e.g., proxying websocket connections) back
|
|
||||||
// into the SpaServices proxying code. It's all internal.
|
|
||||||
internal class ConditionalProxyMiddleware
|
|
||||||
{
|
|
||||||
private readonly RequestDelegate _next;
|
|
||||||
private readonly Task<Uri> _baseUriTask;
|
|
||||||
private readonly string _pathPrefix;
|
|
||||||
private readonly bool _pathPrefixIsRoot;
|
|
||||||
private readonly HttpClient _httpClient;
|
|
||||||
private readonly CancellationToken _applicationStoppingToken;
|
|
||||||
|
|
||||||
public ConditionalProxyMiddleware(
|
|
||||||
RequestDelegate next,
|
|
||||||
string pathPrefix,
|
|
||||||
TimeSpan requestTimeout,
|
|
||||||
Task<Uri> baseUriTask,
|
|
||||||
IApplicationLifetime applicationLifetime)
|
|
||||||
{
|
|
||||||
if (!pathPrefix.StartsWith("/"))
|
|
||||||
{
|
|
||||||
pathPrefix = "/" + pathPrefix;
|
|
||||||
}
|
|
||||||
|
|
||||||
_next = next;
|
|
||||||
_pathPrefix = pathPrefix;
|
|
||||||
_pathPrefixIsRoot = string.Equals(_pathPrefix, "/", StringComparison.Ordinal);
|
|
||||||
_baseUriTask = baseUriTask;
|
|
||||||
_httpClient = SpaProxy.CreateHttpClientForProxy(requestTimeout);
|
|
||||||
_applicationStoppingToken = applicationLifetime.ApplicationStopping;
|
|
||||||
}
|
|
||||||
|
|
||||||
public async Task Invoke(HttpContext context)
|
|
||||||
{
|
|
||||||
if (context.Request.Path.StartsWithSegments(_pathPrefix) || _pathPrefixIsRoot)
|
|
||||||
{
|
|
||||||
var didProxyRequest = await SpaProxy.PerformProxyRequest(
|
|
||||||
context, _httpClient, _baseUriTask, _applicationStoppingToken, proxy404s: false);
|
|
||||||
if (didProxyRequest)
|
|
||||||
{
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Not a request we can proxy
|
|
||||||
await _next.Invoke(context);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,302 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Http;
|
|
||||||
using System;
|
|
||||||
using System.IO;
|
|
||||||
using System.Linq;
|
|
||||||
using System.Net;
|
|
||||||
using System.Net.Http;
|
|
||||||
using System.Net.WebSockets;
|
|
||||||
using System.Threading;
|
|
||||||
using System.Threading.Tasks;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices.Extensions.Proxy
|
|
||||||
{
|
|
||||||
// This duplicates and updates the proxying logic in SpaServices so that we can update
|
|
||||||
// the project templates without waiting for 2.1 to ship. When 2.1 is ready to ship,
|
|
||||||
// remove the old ConditionalProxy.cs from SpaServices and replace its usages with this.
|
|
||||||
// Doesn't affect public API surface - it's all internal.
|
|
||||||
internal static class SpaProxy
|
|
||||||
{
|
|
||||||
private const int DefaultWebSocketBufferSize = 4096;
|
|
||||||
private const int StreamCopyBufferSize = 81920;
|
|
||||||
|
|
||||||
// Don't forward User-Agent/Accept because of https://github.com/aspnet/JavaScriptServices/issues/1469
|
|
||||||
// Others just aren't applicable in proxy scenarios
|
|
||||||
private static readonly string[] NotForwardedWebSocketHeaders = new[] { "Accept", "Connection", "Host", "User-Agent", "Upgrade", "Sec-WebSocket-Key", "Sec-WebSocket-Version" };
|
|
||||||
|
|
||||||
public static HttpClient CreateHttpClientForProxy(TimeSpan requestTimeout)
|
|
||||||
{
|
|
||||||
var handler = new HttpClientHandler
|
|
||||||
{
|
|
||||||
AllowAutoRedirect = false,
|
|
||||||
UseCookies = false,
|
|
||||||
|
|
||||||
};
|
|
||||||
|
|
||||||
return new HttpClient(handler)
|
|
||||||
{
|
|
||||||
Timeout = requestTimeout
|
|
||||||
};
|
|
||||||
}
|
|
||||||
|
|
||||||
public static async Task<bool> PerformProxyRequest(
|
|
||||||
HttpContext context,
|
|
||||||
HttpClient httpClient,
|
|
||||||
Task<Uri> baseUriTask,
|
|
||||||
CancellationToken applicationStoppingToken,
|
|
||||||
bool proxy404s)
|
|
||||||
{
|
|
||||||
// Stop proxying if either the server or client wants to disconnect
|
|
||||||
var proxyCancellationToken = CancellationTokenSource.CreateLinkedTokenSource(
|
|
||||||
context.RequestAborted,
|
|
||||||
applicationStoppingToken).Token;
|
|
||||||
|
|
||||||
// We allow for the case where the target isn't known ahead of time, and want to
|
|
||||||
// delay proxied requests until the target becomes known. This is useful, for example,
|
|
||||||
// when proxying to Angular CLI middleware: we won't know what port it's listening
|
|
||||||
// on until it finishes starting up.
|
|
||||||
var baseUri = await baseUriTask;
|
|
||||||
var targetUri = new Uri(
|
|
||||||
baseUri,
|
|
||||||
context.Request.Path + context.Request.QueryString);
|
|
||||||
|
|
||||||
try
|
|
||||||
{
|
|
||||||
if (context.WebSockets.IsWebSocketRequest)
|
|
||||||
{
|
|
||||||
await AcceptProxyWebSocketRequest(context, ToWebSocketScheme(targetUri), proxyCancellationToken);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
{
|
|
||||||
using (var requestMessage = CreateProxyHttpRequest(context, targetUri))
|
|
||||||
using (var responseMessage = await httpClient.SendAsync(
|
|
||||||
requestMessage,
|
|
||||||
HttpCompletionOption.ResponseHeadersRead,
|
|
||||||
proxyCancellationToken))
|
|
||||||
{
|
|
||||||
if (!proxy404s)
|
|
||||||
{
|
|
||||||
if (responseMessage.StatusCode == HttpStatusCode.NotFound)
|
|
||||||
{
|
|
||||||
// We're not proxying 404s, i.e., we want to resume the middleware pipeline
|
|
||||||
// and let some other middleware handle this.
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
await CopyProxyHttpResponse(context, responseMessage, proxyCancellationToken);
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
catch (OperationCanceledException)
|
|
||||||
{
|
|
||||||
// If we're aborting because either the client disconnected, or the server
|
|
||||||
// is shutting down, don't treat this as an error.
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
catch (IOException)
|
|
||||||
{
|
|
||||||
// This kind of exception can also occur if a proxy read/write gets interrupted
|
|
||||||
// due to the process shutting down.
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
catch (HttpRequestException ex)
|
|
||||||
{
|
|
||||||
throw new HttpRequestException(
|
|
||||||
$"Failed to proxy the request to {targetUri.ToString()}, because the request to " +
|
|
||||||
$"the proxy target failed. Check that the proxy target server is running and " +
|
|
||||||
$"accepting requests to {baseUri.ToString()}.\n\n" +
|
|
||||||
$"The underlying exception message was '{ex.Message}'." +
|
|
||||||
$"Check the InnerException for more details.", ex);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private static HttpRequestMessage CreateProxyHttpRequest(HttpContext context, Uri uri)
|
|
||||||
{
|
|
||||||
var request = context.Request;
|
|
||||||
|
|
||||||
var requestMessage = new HttpRequestMessage();
|
|
||||||
var requestMethod = request.Method;
|
|
||||||
if (!HttpMethods.IsGet(requestMethod) &&
|
|
||||||
!HttpMethods.IsHead(requestMethod) &&
|
|
||||||
!HttpMethods.IsDelete(requestMethod) &&
|
|
||||||
!HttpMethods.IsTrace(requestMethod))
|
|
||||||
{
|
|
||||||
var streamContent = new StreamContent(request.Body);
|
|
||||||
requestMessage.Content = streamContent;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Copy the request headers
|
|
||||||
foreach (var header in request.Headers)
|
|
||||||
{
|
|
||||||
if (!requestMessage.Headers.TryAddWithoutValidation(header.Key, header.Value.ToArray()) && requestMessage.Content != null)
|
|
||||||
{
|
|
||||||
requestMessage.Content?.Headers.TryAddWithoutValidation(header.Key, header.Value.ToArray());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
requestMessage.Headers.Host = uri.Authority;
|
|
||||||
requestMessage.RequestUri = uri;
|
|
||||||
requestMessage.Method = new HttpMethod(request.Method);
|
|
||||||
|
|
||||||
return requestMessage;
|
|
||||||
}
|
|
||||||
|
|
||||||
private static async Task CopyProxyHttpResponse(HttpContext context, HttpResponseMessage responseMessage, CancellationToken cancellationToken)
|
|
||||||
{
|
|
||||||
context.Response.StatusCode = (int)responseMessage.StatusCode;
|
|
||||||
foreach (var header in responseMessage.Headers)
|
|
||||||
{
|
|
||||||
context.Response.Headers[header.Key] = header.Value.ToArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
foreach (var header in responseMessage.Content.Headers)
|
|
||||||
{
|
|
||||||
context.Response.Headers[header.Key] = header.Value.ToArray();
|
|
||||||
}
|
|
||||||
|
|
||||||
// SendAsync removes chunking from the response. This removes the header so it doesn't expect a chunked response.
|
|
||||||
context.Response.Headers.Remove("transfer-encoding");
|
|
||||||
|
|
||||||
using (var responseStream = await responseMessage.Content.ReadAsStreamAsync())
|
|
||||||
{
|
|
||||||
await responseStream.CopyToAsync(context.Response.Body, StreamCopyBufferSize, cancellationToken);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private static Uri ToWebSocketScheme(Uri uri)
|
|
||||||
{
|
|
||||||
if (uri == null)
|
|
||||||
{
|
|
||||||
throw new ArgumentNullException(nameof(uri));
|
|
||||||
}
|
|
||||||
|
|
||||||
var uriBuilder = new UriBuilder(uri);
|
|
||||||
if (string.Equals(uriBuilder.Scheme, "https", StringComparison.OrdinalIgnoreCase))
|
|
||||||
{
|
|
||||||
uriBuilder.Scheme = "wss";
|
|
||||||
}
|
|
||||||
else if (string.Equals(uriBuilder.Scheme, "http", StringComparison.OrdinalIgnoreCase))
|
|
||||||
{
|
|
||||||
uriBuilder.Scheme = "ws";
|
|
||||||
}
|
|
||||||
|
|
||||||
return uriBuilder.Uri;
|
|
||||||
}
|
|
||||||
|
|
||||||
private static async Task<bool> AcceptProxyWebSocketRequest(HttpContext context, Uri destinationUri, CancellationToken cancellationToken)
|
|
||||||
{
|
|
||||||
if (context == null)
|
|
||||||
{
|
|
||||||
throw new ArgumentNullException(nameof(context));
|
|
||||||
}
|
|
||||||
|
|
||||||
if (destinationUri == null)
|
|
||||||
{
|
|
||||||
throw new ArgumentNullException(nameof(destinationUri));
|
|
||||||
}
|
|
||||||
|
|
||||||
using (var client = new ClientWebSocket())
|
|
||||||
{
|
|
||||||
foreach (var headerEntry in context.Request.Headers)
|
|
||||||
{
|
|
||||||
if (!NotForwardedWebSocketHeaders.Contains(headerEntry.Key, StringComparer.OrdinalIgnoreCase))
|
|
||||||
{
|
|
||||||
try
|
|
||||||
{
|
|
||||||
client.Options.SetRequestHeader(headerEntry.Key, headerEntry.Value);
|
|
||||||
}
|
|
||||||
catch (ArgumentException)
|
|
||||||
{
|
|
||||||
// On net461, certain header names are reserved and can't be set.
|
|
||||||
// We filter out the known ones via the test above, but there could
|
|
||||||
// be others arbitrarily set by the client. It's not helpful to
|
|
||||||
// consider it an error, so just skip non-forwardable headers.
|
|
||||||
// The perf implications of handling this via a catch aren't an
|
|
||||||
// issue since this is a dev-time only feature.
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
try
|
|
||||||
{
|
|
||||||
// Note that this is not really good enough to make Websockets work with
|
|
||||||
// Angular CLI middleware. For some reason, ConnectAsync takes over 1 second,
|
|
||||||
// on Windows, by which time the logic in SockJS has already timed out and made
|
|
||||||
// it fall back on some other transport (xhr_streaming, usually). It's fine
|
|
||||||
// on Linux though, completing almost instantly.
|
|
||||||
//
|
|
||||||
// The slowness on Windows does not cause a problem though, because the transport
|
|
||||||
// fallback logic works correctly and doesn't surface any errors, but it would be
|
|
||||||
// better if ConnectAsync was fast enough and the initial Websocket transport
|
|
||||||
// could actually be used.
|
|
||||||
await client.ConnectAsync(destinationUri, cancellationToken);
|
|
||||||
}
|
|
||||||
catch (WebSocketException)
|
|
||||||
{
|
|
||||||
context.Response.StatusCode = 400;
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
using (var server = await context.WebSockets.AcceptWebSocketAsync(client.SubProtocol))
|
|
||||||
{
|
|
||||||
var bufferSize = DefaultWebSocketBufferSize;
|
|
||||||
await Task.WhenAll(
|
|
||||||
PumpWebSocket(client, server, bufferSize, cancellationToken),
|
|
||||||
PumpWebSocket(server, client, bufferSize, cancellationToken));
|
|
||||||
}
|
|
||||||
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private static async Task PumpWebSocket(WebSocket source, WebSocket destination, int bufferSize, CancellationToken cancellationToken)
|
|
||||||
{
|
|
||||||
if (bufferSize <= 0)
|
|
||||||
{
|
|
||||||
throw new ArgumentOutOfRangeException(nameof(bufferSize));
|
|
||||||
}
|
|
||||||
|
|
||||||
var buffer = new byte[bufferSize];
|
|
||||||
|
|
||||||
while (true)
|
|
||||||
{
|
|
||||||
// Because WebSocket.ReceiveAsync doesn't work well with CancellationToken (it doesn't
|
|
||||||
// actually exit when the token notifies, at least not in the 'server' case), use
|
|
||||||
// polling. The perf might not be ideal, but this is a dev-time feature only.
|
|
||||||
var resultTask = source.ReceiveAsync(new ArraySegment<byte>(buffer), cancellationToken);
|
|
||||||
while (true)
|
|
||||||
{
|
|
||||||
if (cancellationToken.IsCancellationRequested)
|
|
||||||
{
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (resultTask.IsCompleted)
|
|
||||||
{
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
|
|
||||||
await Task.Delay(100);
|
|
||||||
}
|
|
||||||
|
|
||||||
var result = resultTask.Result; // We know it's completed already
|
|
||||||
if (result.MessageType == WebSocketMessageType.Close)
|
|
||||||
{
|
|
||||||
if (destination.State == WebSocketState.Open || destination.State == WebSocketState.CloseReceived)
|
|
||||||
{
|
|
||||||
await destination.CloseOutputAsync(source.CloseStatus.Value, source.CloseStatusDescription, cancellationToken);
|
|
||||||
}
|
|
||||||
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
|
|
||||||
await destination.SendAsync(new ArraySegment<byte>(buffer, 0, result.Count), result.MessageType, result.EndOfMessage, cancellationToken);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,92 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Hosting;
|
|
||||||
using Microsoft.AspNetCore.SpaServices;
|
|
||||||
using Microsoft.AspNetCore.SpaServices.Extensions.Proxy;
|
|
||||||
using System;
|
|
||||||
using System.Threading;
|
|
||||||
using System.Threading.Tasks;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.Builder
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Extension methods for proxying requests to a local SPA development server during
|
|
||||||
/// development. Not for use in production applications.
|
|
||||||
/// </summary>
|
|
||||||
public static class SpaProxyingExtensions
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Configures the application to forward incoming requests to a local Single Page
|
|
||||||
/// Application (SPA) development server. This is only intended to be used during
|
|
||||||
/// development. Do not enable this middleware in production applications.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="spaBuilder">The <see cref="ISpaBuilder"/>.</param>
|
|
||||||
/// <param name="baseUri">The target base URI to which requests should be proxied.</param>
|
|
||||||
public static void UseProxyToSpaDevelopmentServer(
|
|
||||||
this ISpaBuilder spaBuilder,
|
|
||||||
string baseUri)
|
|
||||||
{
|
|
||||||
UseProxyToSpaDevelopmentServer(
|
|
||||||
spaBuilder,
|
|
||||||
new Uri(baseUri));
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Configures the application to forward incoming requests to a local Single Page
|
|
||||||
/// Application (SPA) development server. This is only intended to be used during
|
|
||||||
/// development. Do not enable this middleware in production applications.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="spaBuilder">The <see cref="ISpaBuilder"/>.</param>
|
|
||||||
/// <param name="baseUri">The target base URI to which requests should be proxied.</param>
|
|
||||||
public static void UseProxyToSpaDevelopmentServer(
|
|
||||||
this ISpaBuilder spaBuilder,
|
|
||||||
Uri baseUri)
|
|
||||||
{
|
|
||||||
UseProxyToSpaDevelopmentServer(
|
|
||||||
spaBuilder,
|
|
||||||
() => Task.FromResult(baseUri));
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Configures the application to forward incoming requests to a local Single Page
|
|
||||||
/// Application (SPA) development server. This is only intended to be used during
|
|
||||||
/// development. Do not enable this middleware in production applications.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="spaBuilder">The <see cref="ISpaBuilder"/>.</param>
|
|
||||||
/// <param name="baseUriTaskFactory">A callback that will be invoked on each request to supply a <see cref="Task"/> that resolves with the target base URI to which requests should be proxied.</param>
|
|
||||||
public static void UseProxyToSpaDevelopmentServer(
|
|
||||||
this ISpaBuilder spaBuilder,
|
|
||||||
Func<Task<Uri>> baseUriTaskFactory)
|
|
||||||
{
|
|
||||||
var applicationBuilder = spaBuilder.ApplicationBuilder;
|
|
||||||
var applicationStoppingToken = GetStoppingToken(applicationBuilder);
|
|
||||||
|
|
||||||
// Since we might want to proxy WebSockets requests (e.g., by default, AngularCliMiddleware
|
|
||||||
// requires it), enable it for the app
|
|
||||||
applicationBuilder.UseWebSockets();
|
|
||||||
|
|
||||||
// It's important not to time out the requests, as some of them might be to
|
|
||||||
// server-sent event endpoints or similar, where it's expected that the response
|
|
||||||
// takes an unlimited time and never actually completes
|
|
||||||
var neverTimeOutHttpClient =
|
|
||||||
SpaProxy.CreateHttpClientForProxy(Timeout.InfiniteTimeSpan);
|
|
||||||
|
|
||||||
// Proxy all requests to the SPA development server
|
|
||||||
applicationBuilder.Use(async (context, next) =>
|
|
||||||
{
|
|
||||||
var didProxyRequest = await SpaProxy.PerformProxyRequest(
|
|
||||||
context, neverTimeOutHttpClient, baseUriTaskFactory(), applicationStoppingToken,
|
|
||||||
proxy404s: true);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
private static CancellationToken GetStoppingToken(IApplicationBuilder appBuilder)
|
|
||||||
{
|
|
||||||
var applicationLifetime = appBuilder
|
|
||||||
.ApplicationServices
|
|
||||||
.GetService(typeof(IApplicationLifetime));
|
|
||||||
return ((IApplicationLifetime)applicationLifetime).ApplicationStopping;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,101 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
using Microsoft.Extensions.Logging;
|
|
||||||
using Microsoft.AspNetCore.NodeServices.Npm;
|
|
||||||
using Microsoft.AspNetCore.NodeServices.Util;
|
|
||||||
using Microsoft.AspNetCore.SpaServices.Util;
|
|
||||||
using System;
|
|
||||||
using System.IO;
|
|
||||||
using System.Collections.Generic;
|
|
||||||
using System.Text.RegularExpressions;
|
|
||||||
using System.Threading.Tasks;
|
|
||||||
using Microsoft.AspNetCore.SpaServices.Extensions.Util;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices.ReactDevelopmentServer
|
|
||||||
{
|
|
||||||
internal static class ReactDevelopmentServerMiddleware
|
|
||||||
{
|
|
||||||
private const string LogCategoryName = "Microsoft.AspNetCore.SpaServices";
|
|
||||||
private static TimeSpan RegexMatchTimeout = TimeSpan.FromSeconds(5); // This is a development-time only feature, so a very long timeout is fine
|
|
||||||
|
|
||||||
public static void Attach(
|
|
||||||
ISpaBuilder spaBuilder,
|
|
||||||
string npmScriptName)
|
|
||||||
{
|
|
||||||
var sourcePath = spaBuilder.Options.SourcePath;
|
|
||||||
if (string.IsNullOrEmpty(sourcePath))
|
|
||||||
{
|
|
||||||
throw new ArgumentException("Cannot be null or empty", nameof(sourcePath));
|
|
||||||
}
|
|
||||||
|
|
||||||
if (string.IsNullOrEmpty(npmScriptName))
|
|
||||||
{
|
|
||||||
throw new ArgumentException("Cannot be null or empty", nameof(npmScriptName));
|
|
||||||
}
|
|
||||||
|
|
||||||
// Start create-react-app and attach to middleware pipeline
|
|
||||||
var appBuilder = spaBuilder.ApplicationBuilder;
|
|
||||||
var logger = LoggerFinder.GetOrCreateLogger(appBuilder, LogCategoryName);
|
|
||||||
var portTask = StartCreateReactAppServerAsync(sourcePath, npmScriptName, logger);
|
|
||||||
|
|
||||||
// Everything we proxy is hardcoded to target http://localhost because:
|
|
||||||
// - the requests are always from the local machine (we're not accepting remote
|
|
||||||
// requests that go directly to the create-react-app server)
|
|
||||||
// - given that, there's no reason to use https, and we couldn't even if we
|
|
||||||
// wanted to, because in general the create-react-app server has no certificate
|
|
||||||
var targetUriTask = portTask.ContinueWith(
|
|
||||||
task => new UriBuilder("http", "localhost", task.Result).Uri);
|
|
||||||
|
|
||||||
SpaProxyingExtensions.UseProxyToSpaDevelopmentServer(spaBuilder, () =>
|
|
||||||
{
|
|
||||||
// On each request, we create a separate startup task with its own timeout. That way, even if
|
|
||||||
// the first request times out, subsequent requests could still work.
|
|
||||||
var timeout = spaBuilder.Options.StartupTimeout;
|
|
||||||
return targetUriTask.WithTimeout(timeout,
|
|
||||||
$"The create-react-app server did not start listening for requests " +
|
|
||||||
$"within the timeout period of {timeout.Seconds} seconds. " +
|
|
||||||
$"Check the log output for error information.");
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
private static async Task<int> StartCreateReactAppServerAsync(
|
|
||||||
string sourcePath, string npmScriptName, ILogger logger)
|
|
||||||
{
|
|
||||||
var portNumber = TcpPortFinder.FindAvailablePort();
|
|
||||||
logger.LogInformation($"Starting create-react-app server on port {portNumber}...");
|
|
||||||
|
|
||||||
var envVars = new Dictionary<string, string>
|
|
||||||
{
|
|
||||||
{ "PORT", portNumber.ToString() },
|
|
||||||
{ "BROWSER", "none" }, // We don't want create-react-app to open its own extra browser window pointing to the internal dev server port
|
|
||||||
};
|
|
||||||
var npmScriptRunner = new NpmScriptRunner(
|
|
||||||
sourcePath, npmScriptName, null, envVars);
|
|
||||||
npmScriptRunner.AttachToLogger(logger);
|
|
||||||
|
|
||||||
using (var stdErrReader = new EventedStreamStringReader(npmScriptRunner.StdErr))
|
|
||||||
{
|
|
||||||
try
|
|
||||||
{
|
|
||||||
// Although the React dev server may eventually tell us the URL it's listening on,
|
|
||||||
// it doesn't do so until it's finished compiling, and even then only if there were
|
|
||||||
// no compiler warnings. So instead of waiting for that, consider it ready as soon
|
|
||||||
// as it starts listening for requests.
|
|
||||||
await npmScriptRunner.StdOut.WaitForMatch(
|
|
||||||
new Regex("Starting the development server", RegexOptions.None, RegexMatchTimeout));
|
|
||||||
}
|
|
||||||
catch (EndOfStreamException ex)
|
|
||||||
{
|
|
||||||
throw new InvalidOperationException(
|
|
||||||
$"The NPM script '{npmScriptName}' exited without indicating that the " +
|
|
||||||
$"create-react-app server was listening for requests. The error output was: " +
|
|
||||||
$"{stdErrReader.ReadAsString()}", ex);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return portNumber;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,43 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
using System;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices.ReactDevelopmentServer
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Extension methods for enabling React development server middleware support.
|
|
||||||
/// </summary>
|
|
||||||
public static class ReactDevelopmentServerMiddlewareExtensions
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Handles requests by passing them through to an instance of the create-react-app server.
|
|
||||||
/// This means you can always serve up-to-date CLI-built resources without having
|
|
||||||
/// to run the create-react-app server manually.
|
|
||||||
///
|
|
||||||
/// This feature should only be used in development. For production deployments, be
|
|
||||||
/// sure not to enable the create-react-app server.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="spaBuilder">The <see cref="ISpaBuilder"/>.</param>
|
|
||||||
/// <param name="npmScript">The name of the script in your package.json file that launches the create-react-app server.</param>
|
|
||||||
public static void UseReactDevelopmentServer(
|
|
||||||
this ISpaBuilder spaBuilder,
|
|
||||||
string npmScript)
|
|
||||||
{
|
|
||||||
if (spaBuilder == null)
|
|
||||||
{
|
|
||||||
throw new ArgumentNullException(nameof(spaBuilder));
|
|
||||||
}
|
|
||||||
|
|
||||||
var spaOptions = spaBuilder.Options;
|
|
||||||
|
|
||||||
if (string.IsNullOrEmpty(spaOptions.SourcePath))
|
|
||||||
{
|
|
||||||
throw new InvalidOperationException($"To use {nameof(UseReactDevelopmentServer)}, you must supply a non-empty value for the {nameof(SpaOptions.SourcePath)} property of {nameof(SpaOptions)} when calling {nameof(SpaApplicationBuilderExtensions.UseSpa)}.");
|
|
||||||
}
|
|
||||||
|
|
||||||
ReactDevelopmentServerMiddleware.Attach(spaBuilder, npmScript);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,46 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.SpaServices;
|
|
||||||
using Microsoft.Extensions.DependencyInjection;
|
|
||||||
using Microsoft.Extensions.Options;
|
|
||||||
using System;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.Builder
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Provides extension methods used for configuring an application to
|
|
||||||
/// host a client-side Single Page Application (SPA).
|
|
||||||
/// </summary>
|
|
||||||
public static class SpaApplicationBuilderExtensions
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Handles all requests from this point in the middleware chain by returning
|
|
||||||
/// the default page for the Single Page Application (SPA).
|
|
||||||
///
|
|
||||||
/// This middleware should be placed late in the chain, so that other middleware
|
|
||||||
/// for serving static files, MVC actions, etc., takes precedence.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="app">The <see cref="IApplicationBuilder"/>.</param>
|
|
||||||
/// <param name="configuration">
|
|
||||||
/// This callback will be invoked so that additional middleware can be registered within
|
|
||||||
/// the context of this SPA.
|
|
||||||
/// </param>
|
|
||||||
public static void UseSpa(this IApplicationBuilder app, Action<ISpaBuilder> configuration)
|
|
||||||
{
|
|
||||||
if (configuration == null)
|
|
||||||
{
|
|
||||||
throw new ArgumentNullException(nameof(configuration));
|
|
||||||
}
|
|
||||||
|
|
||||||
// Use the options configured in DI (or blank if none was configured). We have to clone it
|
|
||||||
// otherwise if you have multiple UseSpa calls, their configurations would interfere with one another.
|
|
||||||
var optionsProvider = app.ApplicationServices.GetService<IOptions<SpaOptions>>();
|
|
||||||
var options = new SpaOptions(optionsProvider.Value);
|
|
||||||
|
|
||||||
var spaBuilder = new DefaultSpaBuilder(app, options);
|
|
||||||
configuration.Invoke(spaBuilder);
|
|
||||||
SpaDefaultPageMiddleware.Attach(spaBuilder);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,60 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
using Microsoft.AspNetCore.Hosting;
|
|
||||||
using Microsoft.Extensions.DependencyInjection;
|
|
||||||
using System;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices
|
|
||||||
{
|
|
||||||
internal class SpaDefaultPageMiddleware
|
|
||||||
{
|
|
||||||
public static void Attach(ISpaBuilder spaBuilder)
|
|
||||||
{
|
|
||||||
if (spaBuilder == null)
|
|
||||||
{
|
|
||||||
throw new ArgumentNullException(nameof(spaBuilder));
|
|
||||||
}
|
|
||||||
|
|
||||||
var app = spaBuilder.ApplicationBuilder;
|
|
||||||
var options = spaBuilder.Options;
|
|
||||||
|
|
||||||
// Rewrite all requests to the default page
|
|
||||||
app.Use((context, next) =>
|
|
||||||
{
|
|
||||||
context.Request.Path = options.DefaultPage;
|
|
||||||
return next();
|
|
||||||
});
|
|
||||||
|
|
||||||
// Serve it as a static file
|
|
||||||
// Developers who need to host more than one SPA with distinct default pages can
|
|
||||||
// override the file provider
|
|
||||||
app.UseSpaStaticFilesInternal(
|
|
||||||
options.DefaultPageStaticFileOptions ?? new StaticFileOptions(),
|
|
||||||
allowFallbackOnServingWebRootFiles: true);
|
|
||||||
|
|
||||||
// If the default file didn't get served as a static file (usually because it was not
|
|
||||||
// present on disk), the SPA is definitely not going to work.
|
|
||||||
app.Use((context, next) =>
|
|
||||||
{
|
|
||||||
var message = "The SPA default page middleware could not return the default page " +
|
|
||||||
$"'{options.DefaultPage}' because it was not found, and no other middleware " +
|
|
||||||
"handled the request.\n";
|
|
||||||
|
|
||||||
// Try to clarify the common scenario where someone runs an application in
|
|
||||||
// Production environment without first publishing the whole application
|
|
||||||
// or at least building the SPA.
|
|
||||||
var hostEnvironment = (IHostingEnvironment)context.RequestServices.GetService(typeof(IHostingEnvironment));
|
|
||||||
if (hostEnvironment != null && hostEnvironment.IsProduction())
|
|
||||||
{
|
|
||||||
message += "Your application is running in Production mode, so make sure it has " +
|
|
||||||
"been published, or that you have built your SPA manually. Alternatively you " +
|
|
||||||
"may wish to switch to the Development environment.\n";
|
|
||||||
}
|
|
||||||
|
|
||||||
throw new InvalidOperationException(message);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,78 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
using Microsoft.AspNetCore.Hosting;
|
|
||||||
using Microsoft.AspNetCore.Http;
|
|
||||||
using Microsoft.Extensions.FileProviders;
|
|
||||||
using System;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Describes options for hosting a Single Page Application (SPA).
|
|
||||||
/// </summary>
|
|
||||||
public class SpaOptions
|
|
||||||
{
|
|
||||||
private PathString _defaultPage = "/index.html";
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Constructs a new instance of <see cref="SpaOptions"/>.
|
|
||||||
/// </summary>
|
|
||||||
public SpaOptions()
|
|
||||||
{
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Constructs a new instance of <see cref="SpaOptions"/>.
|
|
||||||
/// </summary>
|
|
||||||
/// <param name="copyFromOptions">An instance of <see cref="SpaOptions"/> from which values should be copied.</param>
|
|
||||||
internal SpaOptions(SpaOptions copyFromOptions)
|
|
||||||
{
|
|
||||||
_defaultPage = copyFromOptions.DefaultPage;
|
|
||||||
DefaultPageStaticFileOptions = copyFromOptions.DefaultPageStaticFileOptions;
|
|
||||||
SourcePath = copyFromOptions.SourcePath;
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets or sets the URL of the default page that hosts your SPA user interface.
|
|
||||||
/// The default value is <c>"/index.html"</c>.
|
|
||||||
/// </summary>
|
|
||||||
public PathString DefaultPage
|
|
||||||
{
|
|
||||||
get => _defaultPage;
|
|
||||||
set
|
|
||||||
{
|
|
||||||
if (string.IsNullOrEmpty(value.Value))
|
|
||||||
{
|
|
||||||
throw new ArgumentException($"The value for {nameof(DefaultPage)} cannot be null or empty.");
|
|
||||||
}
|
|
||||||
|
|
||||||
_defaultPage = value;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets or sets the <see cref="StaticFileOptions"/> that supplies content
|
|
||||||
/// for serving the SPA's default page.
|
|
||||||
///
|
|
||||||
/// If not set, a default file provider will read files from the
|
|
||||||
/// <see cref="IHostingEnvironment.WebRootPath"/>, which by default is
|
|
||||||
/// the <c>wwwroot</c> directory.
|
|
||||||
/// </summary>
|
|
||||||
public StaticFileOptions DefaultPageStaticFileOptions { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets or sets the path, relative to the application working directory,
|
|
||||||
/// of the directory that contains the SPA source files during
|
|
||||||
/// development. The directory may not exist in published applications.
|
|
||||||
/// </summary>
|
|
||||||
public string SourcePath { get; set; }
|
|
||||||
|
|
||||||
/// <summary>
|
|
||||||
/// Gets or sets the maximum duration that a request will wait for the SPA
|
|
||||||
/// to become ready to serve to the client.
|
|
||||||
/// </summary>
|
|
||||||
public TimeSpan StartupTimeout { get; set; } = TimeSpan.FromSeconds(50);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,52 +0,0 @@
|
|||||||
// Copyright (c) .NET Foundation. All rights reserved.
|
|
||||||
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
|
|
||||||
|
|
||||||
using Microsoft.AspNetCore.Hosting;
|
|
||||||
using Microsoft.Extensions.DependencyInjection;
|
|
||||||
using Microsoft.Extensions.FileProviders;
|
|
||||||
using System;
|
|
||||||
using System.IO;
|
|
||||||
|
|
||||||
namespace Microsoft.AspNetCore.SpaServices.StaticFiles
|
|
||||||
{
|
|
||||||
/// <summary>
|
|
||||||
/// Provides an implementation of <see cref="ISpaStaticFileProvider"/> that supplies
|
|
||||||
/// physical files at a location configured using <see cref="SpaStaticFilesOptions"/>.
|
|
||||||
/// </summary>
|
|
||||||
internal class DefaultSpaStaticFileProvider : ISpaStaticFileProvider
|
|
||||||
{
|
|
||||||
private IFileProvider _fileProvider;
|
|
||||||
|
|
||||||
public DefaultSpaStaticFileProvider(
|
|
||||||
IServiceProvider serviceProvider,
|
|
||||||
SpaStaticFilesOptions options)
|
|
||||||
{
|
|
||||||
if (options == null)
|
|
||||||
{
|
|
||||||
throw new ArgumentNullException(nameof(options));
|
|
||||||
}
|
|
||||||
|
|
||||||
if (string.IsNullOrEmpty(options.RootPath))
|
|
||||||
{
|
|
||||||
throw new ArgumentException($"The {nameof(options.RootPath)} property " +
|
|
||||||
$"of {nameof(options)} cannot be null or empty.");
|
|
||||||
}
|
|
||||||
|
|
||||||
var env = serviceProvider.GetRequiredService<IHostingEnvironment>();
|
|
||||||
var absoluteRootPath = Path.Combine(
|
|
||||||
env.ContentRootPath,
|
|
||||||
options.RootPath);
|
|
||||||
|
|
||||||
// PhysicalFileProvider will throw if you pass a non-existent path,
|
|
||||||
// but we don't want that scenario to be an error because for SPA
|
|
||||||
// scenarios, it's better if non-existing directory just means we
|
|
||||||
// don't serve any static files.
|
|
||||||
if (Directory.Exists(absoluteRootPath))
|
|
||||||
{
|
|
||||||
_fileProvider = new PhysicalFileProvider(absoluteRootPath);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
public IFileProvider FileProvider => _fileProvider;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user