ASP.NET Core WebApi 项目搭建
提前准备下载
- Vs 2019
- .Net Core SDK
一、新建一个.NET Core 项目
这里我选用Vs 创建,先选一个文件夹例如
可以通过可视化界面创建,也可以通过命令行创建
我这里选择命令行创建
第一次打开C#时,会自动帮你下载omnisharp和debugger,在线下载安装需要等待安装完成
二、项目介绍
先介绍查看源码的方式F12
VS2019-工具-文本编辑器-C#-高级-勾选支持导航到反编译
目前只开源了.net Core2.X,3.X的暂时还看不到
Program类
首先介绍Main方法入口,0个引用说明是被框架调用
public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup<Startup>();
});
}
- 前期准备WebHostBuild()
CreateHostBuilder创建WebHost,默认配置
Host是一个静态类,里面有一个CreateDefaultBuilder方法,我们去看源码
这里实例化了一个WebHostBuilder类进去看看
private readonly HostingEnvironment _hostingEnvironment;
private readonly List<Action<WebHostBuilderContext, IServiceCollection>> _configureServicesDelegates;
private IConfiguration _config;
private WebHostOptions _options;
private WebHostBuilderContext _context;
private bool _webHostBuilt;
private List<Action<WebHostBuilderContext, IConfigurationBuilder>> _configureAppConfigurationBuilderDelegates;
public WebHostBuilder()//默认构造函数
{
_hostingEnvironment = new HostingEnvironment();
_configureServicesDelegates = new List<Action<WebHostBuilderContext, IServiceCollection>>();
_configureAppConfigurationBuilderDelegates = new List<Action<WebHostBuilderContext, IConfigurationBuilder>>();
_config = new ConfigurationBuilder().AddEnvironmentVariables("ASPNETCORE_").Build();
if (string.IsNullOrEmpty(GetSetting(WebHostDefaults.EnvironmentKey)))
{
UseSetting(WebHostDefaults.EnvironmentKey, Environment.GetEnvironmentVariable("Hosting:Environment") ?? Environment.GetEnvironmentVariable("ASPNET_ENV"));
}
if (string.IsNullOrEmpty(GetSetting(WebHostDefaults.ServerUrlsKey)))
{
UseSetting(WebHostDefaults.ServerUrlsKey, Environment.GetEnvironmentVariable("ASPNETCORE_SERVER.URLS"));
}
_context = new WebHostBuilderContext
{
Configuration = _config
}//
这里不就是实现依赖注入吗(构造函数实例化对象)
WebHost前期需要准备默认配置,这些配置它需要用到一些参数和一些变量通过注入的方式。
它具体需要配置那些地方呢
1.UseContentRoot
WebHostBuilder webHostBuilder = new WebHostBuilder();
if (string.IsNullOrEmpty(webHostBuilder.GetSetting(WebHostDefaults.ContentRootKey)))
{
webHostBuilder.UseContentRoot(Directory.GetCurrentDirectory());
}
指定了Web主机所使用的内容、站点根目录
因为前期就要将那些wwwroot静态文件,静态网页、配置文件读取到,所以先指定目录
2.UseConfiguration
if (args != null)
{
webHostBuilder.UseConfiguration(new ConfigurationBuilder().AddCommandLine(args).Build());
}
传的控制台命令args就在这里执行
3.UseKestrel
webHostBuilder.UseKestrel(delegate (WebHostBuilderContext builderContext, KestrelServerOptions options)
{
options.Configure(builderContext.Configuration.GetSection("Kestrel"));
}
配置Kestrel服务器
4.ConfigureAppConfiguration
ConfigureAppConfiguration(delegate (WebHostBuilderContext hostingContext, IConfigurationBuilder config)
{
IHostingEnvironment hostingEnvironment = hostingContext.HostingEnvironment;
config.AddJsonFile("appsettings.json", optional: true, reloadOnChange: true).AddJsonFile("appsettings." + hostingEnvironment.EnvironmentName + ".json", optional: true, reloadOnChange: true);
if (hostingEnvironment.IsDevelopment())
{
Assembly assembly = Assembly.Load(new AssemblyName(hostingEnvironment.ApplicationName));
if (assembly != null)
{
config.AddUserSecrets(assembly, optional: true);//在开发环境使用UserSecrets
}
}
config.AddEnvironmentVariables();//自动获取环境变量
if (args != null)
{
config.AddCommandLine(args);//命令行参数
}
}
首先配置了appsettings.json,然后规定在开发环境使用UserSecrets,UserSecrets是个人的密钥,项目中是不会推送至远程仓库,该怎么创建呢
5.ConfigureLogging
ConfigureLogging(delegate (WebHostBuilderContext hostingContext, ILoggingBuilder logging)
{
//添加服务的地方Logging配置
logging.AddConfiguration(hostingContext.Configuration.GetSection("Logging"));
logging.AddConsole();//控制台
logging.AddDebug();//Debug
logging.AddEventSourceLogger();//事件
}
配置日志
6.ConfigureServices
ConfigureServices(delegate (WebHostBuilderContext hostingContext, IServiceCollection services)
{
services.PostConfigure(delegate (HostFilteringOptions options)
{
if (options.AllowedHosts == null || options.AllowedHosts.Count == 0)
{
string[] array = hostingContext.Configuration["AllowedHosts"]?.Split(new char[1]
{
';'
}, StringSplitOptions.RemoveEmptyEntries);
options.AllowedHosts = ((array != null && array.Length != 0) ? array : new string[1]
{
"*"
});
}
});
services.AddSingleton((IOptionsChangeTokenSource<HostFilteringOptions>)new ConfigurationChangeTokenSource<HostFilteringOptions>(hostingContext.Configuration));
services.AddTransient<IStartupFilter, HostFilteringStartupFilter>();
}
ConfigureServices是Startup方法里面的,会自动把我们的一些服务进行默认配置,我们提前写好的配置服务,在WebHostBuilder里面构建,进行服务注入。
最后返回一个WebHostBuilder,就完成构建了。
我们在默认配置的时候是默认不包含我们自己创建的Startup的服务,而是系统默认的服务。
public void ConfigureServices(IServiceCollection services)
{
services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
}
- Build()-构建
构建一个Microsoft.AspNetCore.Hosting,托管Web应用程序的WebHost,一个方法只会执行一次
- Run()-构启动
发现run方法下面是一个异步方法
public static void Run(this IWebHost host)
{
host.RunAsync().GetAwaiter().GetResult();
}
public static async Task RunAsync(this IWebHost host, CancellationToken token = default(CancellationToken))
{
if (token.CanBeCanceled)
{
await host.RunAsync(token, null);
return;
}
ManualResetEventSlim done = new ManualResetEventSlim(initialState: false);
using (CancellationTokenSource cts = new CancellationTokenSource())
{
AttachCtrlcSigtermShutdown(cts, done, host.Services.GetRequiredService<WebHostOptions>().SuppressStatusMessages ? string.Empty : "Application is shutting down...");
try
{
await host.RunAsync(cts.Token, "Application started. Press Ctrl+C to shut down.");
}
finally
{
done.Set();
}
}
}
private static async Task RunAsync(this IWebHost host, CancellationToken token, string shutdownMessage)
{
using (host)
{
await host.StartAsync(token);
IHostingEnvironment service = host.Services.GetService<IHostingEnvironment>();
if (!host.Services.GetRequiredService<WebHostOptions>().SuppressStatusMessages)
{
Console.WriteLine("Hosting environment: " + service.EnvironmentName);
Console.WriteLine("Content root path: " + service.ContentRootPath);
ICollection<string> collection = host.ServerFeatures.Get<IServerAddressesFeature>()?.Addresses;
if (collection != null)
{
foreach (string item in collection)
{
Console.WriteLine("Now listening on: " + item);
}
}
if (!string.IsNullOrEmpty(shutdownMessage))
{
Console.WriteLine(shutdownMessage);
}
}
await host.WaitForTokenShutdownAsync(token);
}
}
因此显示以下信息
三、.Net Core进程内外托管
进程是指IIS Worker Process工作进程
启动IIS运行.net Core项目可以在任务管理器中看到,结束项目运行进程消失
进程内托管就是指的这个
进程外托管就是dotnet.exe,打开网页可以看到服务器
双击项目
AspNetCoreHostingModel配置了托管模式。InProcess指定进程内,OutProcess指定进程外
1.当AspNetCoreHostingModel设置InProcess进程内托管,启动IIS,任务管理器这时候有IIS Worker Process,网页服务器显示IIS
2.当AspNetCoreHostingModel设置InProcess进程内托管,启动项目,任务管理器这时候没有IIS Worker Process,网页服务器显示IIS
3.当AspNetCoreHostingModel设置OutProcess进程外托管,启动IIS,任务管理器这时候还是有IIS Worker Process,网页服务器显示Kestrel
4.当AspNetCoreHostingModel设置OutProcess进程外托管,启动项目,任务管理器没有IIS Worker Process,网页服务器显示Kestrel
这是怎么回事,怎么进程内外都会启动IIS Worker Process,进程内外到底有什么区别
原因分析:蓝色字体第1、3点进程内外的IIS服务都会启动,不过启动的作用确实不一样的
1.进程内启动IIS是当作服务器
2.进程外也启动IIS,是Kestrel配合IIS,将IIS当作反向代理服务器使用,不是作为整个项目的应用服务器了
以前是请求通过IIS监听,通过IIS托管代码响应直接完成
ASP.NET Core不同的是 靠ASP.NET Core Module把HTTP请求转发
IIS这个时候等同于Nginx反向代理,本身不再处理了
ASP.NET Core内置Kestrel服务器等价于IIS--Webserver