NET5实践：项目创建-结构概述-程序运行-发布部署

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/ 。微软做事一向是贴心小棉袄，资料文档整理很不错。