ASP.NET5实践01:项目创建-结构概述-程序运行-发布部署
1.项目创建
ASP.NET5项目模板有三种:
新建项目:
选择模板:
2.结构概述
References对应配置是project.json中:
"frameworks": { "dnx451": { }, "dnxcore50": { } },
ASP.NET5开发时支持多版本的clr共存,但运行时是使用其中一种。
dnxcore50是跨平台、模块化的coreclr。它有多种,如:dnx-coreclr-win-*,dnx-coreclr-linux-*等。
其它是完整版的,只支持windows的clr。
当然还有一种借助mono的clr。
wwwroot是web应用程序中的静态文件存储目录,也是web发布后部署时的根目录。
其中web.config是IIS部署时需要的配置文件。
由于ASP.NET5 Web程序是应用MVC6框架,管道是:Area/Controller/Action,不是实际文件路径。
所以要使用静态文件,需要引用依赖:"Microsoft.AspNet.StaticFiles": "1.0.0-rc1-final"
并在Startup.cs中Configure()中开启:app.UseStaticFiles();
Dependencies中的Bower和npm是前端开发工具插件。
Bower的使用配置文件是:
npm插件安装配置文件是:
当然npm插件使用需要:
在gulpfile.js上右键,可以调出任务:
关于前端开发工具介绍,在以后的专题中再详细点介绍。
Controllers是控制器。
Migrations是EntityFramework手动添加迁移生成的。
Models是实体模型类。
Services是功能/业务实现类。
ViewModels是视图模型类。
Views是视图文件。
appsettings.json是配置文件。比如配置数据库连接字符串。
说一下Startup.cs文件,参见代码注释:
namespace MyWeb { public class Startup { /// <summary> /// 构造函数 /// </summary> /// <param name="env">web宿主环境中运行应用程序的信息</param> public Startup(IHostingEnvironment env) { //用于生成应用程序中使用的基于的键/值配置设置 对象创建 var builder = new ConfigurationBuilder() //将 JSON 配置提供程序的路径添加到 configurationBuilder .AddJsonFile("appsettings.json") //获取或设置的环境的名称,自动设置此属性 //如果optional为fales时,就不用此设置。 .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true); //如果是开发环境 if (env.IsDevelopment()) { //http://go.microsoft.com/fwlink/?LinkID=532709 builder.AddUserSecrets(); } //添加读取IConfigurationProvider环境变量的配置值 builder.AddEnvironmentVariables(); //生成IConfiguration 键和值 //从提供程序集在IConfigurationBuilder.Providers 注册 Configuration = builder.Build(); } /// <summary> /// 键/值应用程序配置根属性,继承IConfiguration /// </summary> public IConfigurationRoot Configuration { get; set; } /// <summary> /// 程序运行时调用此方法来添加一些服务到容器中 /// </summary> /// <param name="services">服务集合</param> public void ConfigureServices(IServiceCollection services) { // Add framework services. services.AddEntityFramework() .AddSqlServer() .AddDbContext<ApplicationDbContext>(options => options.UseSqlServer(
Configuration["Data:DefaultConnection:ConnectionString"])); services.AddIdentity<ApplicationUser, IdentityRole>() .AddEntityFrameworkStores<ApplicationDbContext>() .AddDefaultTokenProviders(); services.AddMvc(); // Add application services.
// 使用依赖注入 services.AddTransient<IEmailSender, AuthMessageSender>(); services.AddTransient<ISmsSender, AuthMessageSender>(); } /// <summary> /// 配置,通常有些中间件调用需要配置等 /// </summary> /// <param name="app">配置应用程序的请求管道</param> /// <param name="env"></param> /// <param name="loggerFactory">日志中间件</param> public void Configure(IApplicationBuilder app, IHostingEnvironment env,
ILoggerFactory loggerFactory) { loggerFactory.AddConsole(Configuration.GetSection("Logging")); loggerFactory.AddDebug(); if (env.IsDevelopment()) { app.UseBrowserLink(); app.UseDeveloperExceptionPage(); app.UseDatabaseErrorPage(); } else { app.UseExceptionHandler("/Home/Error"); try { using (var serviceScope = app.ApplicationServices
.GetRequiredService<IServiceScopeFactory>().CreateScope()) { serviceScope.ServiceProvider.GetService<ApplicationDbContext>() .Database.Migrate(); } } catch { } } //IIS HttpPlatformHandler 反向代理服务器进行交互的中间件模块 app.UseIISPlatformHandler(options => options.AuthenticationDescriptions.Clear()); app.UseStaticFiles(); app.UseIdentity(); //配置路由 app.UseMvc(routes => { routes.MapRoute( name: "areaRoute", template: "{area:exists}/{controller}/{action}", defaults: new { action = "Index" }); routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}"); routes.MapRoute( name: "api", template: "{controller}/{id?}"); }); } // Entry point for the application. public static void Main(string[] args) => WebApplication.Run<Startup>(args); } }
3.程序运行
在vs2015开发中,可以用IIS Express直接运行,也可以选择web自宿主托管运行,如图:
当然,如果不用VS2015来运行,可以使用dnvm中dnx.exe(执行文件在clr里)工具来执行。
dnx.exe执行命令是对应project.json中commands配置:
"commands": { "web": "Microsoft.AspNet.Server.Kestrel", "ef": "EntityFramework.Commands" },
进入DOS下,看dnvm能用不?
VS2015中创建ASP.NET5程序后,就自动安装好dnvm了。
再试一下dnu和dnx工具:
嘎嘎!不能用。那就执行一下:
进入项目中project.json文件所在目录,执行dnx web:
OK!在不shut down情况下,就可以通过http://localhost:5000访问啦。
当然假如发布后,也可以直接执行web.cmd运行的方式。
注:如果运行不成功的话。
一般是依赖包没有下载完整,可以使用dnu restore来安装。
二是使用的clr和project.json配置的框架不一致。
4.发布部署
可以在dos下使用dnu publish命令来发布。这种方式演示就略了。
在VS解决方案中的项目上,右键“Publish Web”:
选择File System……
发布出来的目录(三个文件夹):
进入approot目录下,可以执行web.cmd命令脚本运行啦!
通常实际生产时,如何在IIS部署呢? 这里使用windows 10企业版iis测试部署。
先安装iis:
只需要勾选一下Internet Information Services一项即可!
打开IIS管理器中的“获取新的Web平台组件”:
如果没有安装,先安装它。这里我在更新vs2015时,已经安装过。
添加-安装HttpPlatformHandler。
再配置编辑器,修改节:
并解除锁定节:
准备工作基本完成啦!添加网站:
注意:连接权限设置,应用程序池需要改为无托管代码的!
测试:
5.小结
本章内容非常简单,我尽可能地截图说明!希望初学者能够学会!
项目创建,傻瓜也会的;
结构概述,这里我也不能说得很清楚,很详细。
程序运行,不管是没发布时如何运行,连发布部署后,也说过啦。
发布部署,这里介绍vs2015上如何发布,也说过常用的IIS部署。
其它方式部署,最好linux或os系统演示啦!以后再补!
读者也可以参见https://get.asp.net/ 。微软做事一向是贴心小棉袄,资料文档整理很不错。