NET Core-学习笔记（二）

这里要分享的是接着上篇：NET Core-学习笔记（一）展开的继续学习core笔记，有不妥之处或者更好见解的地方希望各位朋友多多分享。

下面是本篇将要分享的学习步奏，对于刚学或者即将要学习的朋友做个相互交流：

1.一起阅览core框架自动生成的Controller代码

2.路由及路由参数格式限制

3.两种方法设置虚拟路径访问资源文件夹和效果区别

4.怎么设置异常访问时全局返回信息

5.构造器依赖注入方式ILogger，IOptions例子

6.ConfigurationBuilder使用

下面一步一个脚印的来分享：

1.一起阅览core框架自动生成的Controller代码

首先，咋们来看一个图

重点部分已经使用红色框好了，先是这个ApplicationDbContext应用程序数据上下文，是由构造器传递进来的，但是这种情况一般是需要new 这个构造器对应的class，才能传递进入参数，当翻遍整个项目都暂时没有找到对应new这个Controller的地方，因此这也延伸出了这里要说的注入方式；这个ApplicationDbContext大家可以打开项目文件Startup.cs里面有这样一段：

services.AddDbContext<ApplicationDbContext>(options=>options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));

是的刚才说的访问数据库上下文就是由这里注入进来的，只需要这么一段，就能链接上数据库了，当让里面的Configuration.GetConnectionString是获取数据库字符串，这些上一篇文章简单介绍了下；

其次，大家可以看到Controller里面的几个操作方法都是async Task的模式，对应的方法内使用的也是await FunAsync();来返回数据，这里的几个关键字大家应该很熟悉了是4.5框架扩展出来的；简单说下本人使用这几个关键词一般注意的逻辑，async await两个肯定是成对出现的，await从单词也能看出是等待的意思，主要是等待后面的方法执行完成返回结果，返回的结果对应的值应该是Task包装的数据，而Task任务都是有Result，这样通过Result获取之前方法执行的结果；

2.路由及路由参数格式限制

首先，说道mvc就不得不说对应的路由core框架设置路由是在StartUp.cs文件Configure方法中，初始化代码如下：

//设置mvc路由
            app.UseMvc(routes =>
            {
                //这里的{id?} ?号表示可以有可无
                routes.MapRoute(
                    name: "default",
                    template: "{controller=Home}/{action=Index}/{id?}");
            });

这里有两种设置默认值的方式一种就是上面代码那样直接=号后面设置默认值，另外一种就是MapRoute方法的第三个参数和以前mvc版本一样new{param}的格式，大家可以自己试试；

然后，我们一起参数格式限制，直接在参数后面：数据类型（如 id：int），这个时候参数只能传递对应的数据类型的数据，这里列举两个格式如图（注如果是正则无需可以去掉）：

routes.MapRoute(
                  name: "first",
                  template: "{controller=Home}/{action=Index}/{id:int}");
                routes.MapRoute(
                  name: "second",
                  template: "{controller=Home}/{action=Index}/{id:regex(d+)}");

很实用更多的限制可以查看：https://docs.asp.net/en/latest/fundamentals/routing.html

3.两种方法设置虚拟路径访问资源文件夹和效果区别

首先，咋们定位到Startup.cs文件Configure方法，要开放查看可访问资源的目录需要用到UseDirectoryBrowser和UseFileServer两个方法，其实他们都对应ConfigureServices服务方法中添加的AddDirectoryBrowser()服务，所以需要现在ConfigureServices服务方法中增加一段services.AddDirectoryBrowser();代码；

先来看UseDirectoryBrowser方法，我们一起在core项目跟目录下创建一个angularjs文件夹并在里面增加angular-1.0.js文件，文件内容可以随意（我这里只有一段注释///这里是ng），目录结果如图：

然后在Configure方法增加如下代码：

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
        {

            //启动磁盘查看
            app.UseDirectoryBrowser(new DirectoryBrowserOptions
            {
                FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), "angularjs")),
                RequestPath = "/ng"

            });
        }

FileProvider对应的PhysicalFileProvider主要用来设置物理路径，RequestPath对应的是虚拟路径也就是开放给浏览器可访问资源的路径，来看下执行dotnet run命令后浏览器效果：

这里效果是可以点击js文件，但是无法直接在浏览器中展示js文件的内容，也就是无法访问到js文件；

再来看UseFileServer()，我们把刚才的UseDirectoryBrowser代码先注释避免影响效果，然后在Configure方法中增加如下代码：

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
        {
            app.UseFileServer(new FileServerOptions()
            {
                FileProvider = new PhysicalFileProvider(
                Path.Combine(Directory.GetCurrentDirectory(), "angularjs")),
                RequestPath = "/ng1",
                EnableDirectoryBrowsing = true
            });
        }

注意这里的虚拟路径设置的名称是ng1，并且增加了一段EnableDirectoryBrowsing=true这句话的意思是允许磁盘浏览效果相当于前面增加的代码services.AddDirectoryBrowser()只是这里不需要这句也能浏览文件目录，看效果：

这里也能浏览目录结构了，然后点击js文件能在浏览器中看到：

是的这就是js文件的内容，这种方式直接就能下载某个文件，而前面第一种就不行；如果希望第一种也能下载或者查看js文件，那么可以使用UseStaticFiles()方法来设置，代码如下：

app.UseStaticFiles(new StaticFileOptions
            {

                FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), "angularjs")), //物理根路径
                RequestPath = "/ng"  //设置访问虚拟路径

            });

            //启动磁盘文件查看
            app.UseDirectoryBrowser(new DirectoryBrowserOptions
            {
                FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), "angularjs")),
                RequestPath = "/ng"

            });

注意两个方法对应的参数RequestPath都是"/ng"，这里目的就是吧这种两个虚拟路径设置成一样的，UseStaticFiles()方法功能是运行某个目录下文件被访问，而默认.netcore自动生成的代码中有app.UseStaticFiles();这么一句，效果是默认只允许访问项目wwwroot文件夹中的静态资源，要访问其他根目录下的静态资源可以设置成上面的代码就行了，需要注意的是自定义的访问资源设置必须要在默认代码app.UseStaticFiles();下面才行，不然无法使用自带的静态文件。

 4.怎么设置异常访问时全局返回信息

这里要介绍的方法同样在Configure方法中执行，UseStatusCodePages（）和UseExceptionHandler（）函数，目前只实验了UseStatusCodePages一种参数设置，其他重载的没有试，希望朋友们测试过后能告知下效果和应用场景，谢谢；

先看，app.UseStatusCodePages("text/plain", "这是 response返回的status code: {0}");我这里直接返回的是文本数据到页面上，效果是在浏览器中输入了一个不在路由中的地址，那么浏览器就会显示此信息，这里面要注意的是{0}，大家可以看下方法的备注说明，说明的意思大致是这里直接使用占位符表示Response返回的Status code代码，假如我这里访问一个不再路由中的地址效果如下：

然后，app.UseExceptionHandler("/Home/Error");这个是创建项目默认的代码，这里指向的路由是HomeController中的Error方法，对应的试图我没有找到，不知道是项目故意不需要还是怎么样子，有知道的朋友告知下；

5.构造器依赖注入方式例子

构造器依赖注入其实前面有讲过，就是ApplicationDbContext和第一篇分享的代码中，这里说的是另外两个netcore项目自带的东西ILogger<T>（日志服务）和IOptions<T>（选项访问服务），直接上代码：

public class ArticlesController : Controller
    {
        private readonly ApplicationDbContext _context;

        private readonly IOptions<Article> _opArticle;

        private readonly ILogger<ArticlesController> _log;


        public ArticlesController(ApplicationDbContext context, IOptions<Article> opArticle, ILogger<ArticlesController> log)
        {
            _context = context;
            _opArticle = opArticle;
            _log = log;
        }

        // GET: Articles
        public async Task<IActionResult> Index()
        {
            _log.LogInformation("I {0} {1}", "love", "zuguo");
            ViewBag.TResult = 4 + 5;
            ViewBag.TouTiao = _opArticle.Value.Title;

            return View(await _context.Article.ToListAsync());
        }
    }

这里的ILogger<T>通过构造器赋值给了只读变量_log，因为是依赖注入进来的，所以可以直接使用方法我这里用到的是LogInformation方法其中一个重载，效果是在访问这个Controller的Index时候cmd命令窗显示了这个Info等级的信息：

更多的等级信息请查看:https://docs.asp.net/en/latest/fundamentals/logging.html

相对而言IOptions<T>使用的时候需要手动在Startup.cs文件中ConfigureServices方法设置代码services.AddOptions()来添加服务，这个选项访问服务功能可以把满足它泛型需求的class，new（）的类注入到其他的地方，这里有一个例子在ConfigureServices方法中添加如下代码：

services.AddOptions();
            //初始化参数信息
            services.Configure<Models.AiticleModels.Article>(b =>
            {

                b.Title = "今日头条，爱国活动";
            });

然后可以在通过构造器注入的某个地方获取参数值，只需要被注入对象.Value这就能获取到注入进来的泛型T实例，对应的代码就是第5点开始的代码，效果：

6.ConfigurationBuilder使用

先发一段框架自动生成的代码：

public Startup(IHostingEnvironment env)
        {
            //这里创建ConfigurationBuilder，其作用就是加载Congfig等配置文件
            var builder = new ConfigurationBuilder()

                //env.ContentRootPath：获取当前项目的跟路径
                .SetBasePath(env.ContentRootPath)
                //使用AddJsonFile方法把项目中的appsettings.json配置文件加载进来，后面的reloadOnChange顾名思义就是文件如果改动就重新加载
                .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
                //这里关注的是$"{param}"的这种写法，有点类似于string.Format()
                .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true);

            if (env.IsDevelopment())
            {
                //待研究
                builder.AddUserSecrets();

                //待研究
                builder.AddApplicationInsightsSettings(developerMode: true);
            }

            builder.AddEnvironmentVariables();

            //这返回一个配置文件跟节点：IConfigurationRoot
            Configuration = builder.Build();
           
        }

这个ConfigurationBuilder在启动器Startup中加载的时候就去读取配置文件（更多信息可以看第一篇或代码注释）；这里我们使用AddInMemoryCollection方法增加配置文件实例的数据：

//增加配置数据
            builder.AddInMemoryCollection(new Dictionary<string, string> {
                { "home","zuguo"}
            });

在后就以在Configuration使用的地方获取到这是的值，这里使用的是

var home = Configuration["home"];
Console.WriteLine($"hello,{home}");

在命令窗显示的信息如：

这篇就到这里，希望给大家带来了好处，希望更多的心得篇，勿喷。