asp.net core 2.0 一些有用有趣的设置.
面向(targeting)不同的.net版本:
打开asp.net core 2.0的项目文件: xxx.csproj, 这部分:
<Project Sdk="Microsoft.NET.Sdk.Web"> <PropertyGroup> <TargetFramework>netcoreapp2.0</TargetFramework> </PropertyGroup>
TargetFramework就是指向的版本. 也可以指向多个.net版本, 那就使用TargetFrameworks, 例如:
<TargetFrameworks>netcoreapp2.0;net47</TargetFrameworks>
编译后, 在bin/debug文件夹下就会有两个文件夹:
Microsoft.AspNetCore.All
并不是标准的Nuget包, 它不包含任何代码或dll, 它作为一个metapackage, 引用了很多其他的包而已
Program.cs
asp.net core 应用其实就是一个控制台应用, 运行了asp.net core相关的库而已.
program.cs里面都是对于宿主和环境的配置.
在这里, 已经进行了默认的配置.
但是如果你想捕获asp.net core启动时候的错误, 并显示错误页面, 那么:
.CaptureStartupErrors(true)
是否应该监听Microsoft.AspNetCore.Hosting.Server.IServer制定的url(ipv4, v6, hostname, localhost, unix socket), 可以使用:
.PreferHostingUrls(true)
监听指定的url:
.UseUrls("http://0.0.0.0:5000")
使用ApplicationInsights:
.UseApplicationInsights()
Startup.cs
startup里面是用来预加载/配置服务和中间件的.
ConfigureServices方法用来注册服务.
Configure方法用来配置请求管道.
添加mvc中间件, 就在ConfigureServices方法里:
services.AddMvc();
使用mvc中间件, 在Configure里:
app.UseMvc(routes => { routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); });
Dependency Injection
每次调用创建一个实例:
services.AddTransient<IEmailService, EmailService>();
每次http请求创建一个实例:
services.AddScoped<IEmailService, EmailService>();
只创建一个实例:
services.AddSingleton<IEmailService, EmailService>();
如果你不想让容器自动dispose掉服务(容器会自动调用服务的Dispose方法), 那么你应该手动添加服务, 例如:
services.AddSingleton(new EmailService());
http 请求管道中间件的顺序 最佳实践:
1. 异常处理中间件
2. 静态文件中间件
3. 用户验证中间件
4. mvc中间件
创建自定义中间件
有两种方法:
1. 直接在Startup里面写
可以使用四个方法: Run, Map, MapWhen, Use.
Run方法直接短路, 返回Response.
Map用于处理分支, 判断请求地址的开头, 为分支添加特定中间件等等
MapWhen也是处理分支, 但是可以控制分支的状态
Use, 可以调用下一个中间件(next.Invoke())或者短路请求.
2. 单独写一个类
public class CommunicationMiddleware { private readonly RequestDelegate _next; public CommunicationMiddleware(RequestDelegate next) { _next = next; } public async Task Invoke(HttpContext context) { await _next.Invoke(context); } }
然后再写一个extension 方法:
public static class CommunicationMiddlewareExtension { public static IApplicationBuilder UseCommunicationMiddleware(this IApplicationBuilder builder) { return builder.UseMiddleware<CommunicationMiddleware>(); } }
最后在Startup的Configure里调用即可:
app.UseCommunicationMiddleware(); app.UseMvc(routes => { routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}"); });
Url Redirection 和 Url Rewriting
他们是不同的.
url redirection是从服务器端绕了一圈, 然后回到客户端, 客户端收到301或者302之后, 再调用新地址.
url rewriting是服务器端自己完成的, 客户端一无所知.
可以这样来使用Url Rewriting:
var options = new RewriteOptions() .AddRewrite("NewUser", "/User/Registration/Index", false); app.UseRewriter(options);
异常处理
默认情况下400到599的错误信息都不会显示. 就会显示一个异常页面.
但是可以自定义错误页面:
app.UseStatusCodePages("text/plain", "HTTP ERROR: Status Code: {0}");
多个环境
asp.net core 2.0默认先加载appSettings.json, 然后根据环境不同再加载appSettings.{environment}.json. 如果有必要就覆盖或替换一些值.
根据环境使用不同的Startup文件:
.UseStartup("AssemblyName")
StartupDevelopment, StartupStaging, StartupProduction.
Web Api的三种风格
RTC, 包含Action的Name
Rest, 它是一种http协议的最佳实践方式而已. 主要目的是管理和控制资源.
HATEOAS, 客户端通过遍历http response里面的超媒体链接, 可以动态导航到所需的资源, 酷.
使用HATEOAS, 需要安装包Halcyon.mvc
下面是我的关于ASP.NET Core Web API相关技术的公众号--草根专栏:
