12 2016 档案

ASP.NET Core应用的错误处理[1]：三种呈现错误页面的方式
摘要：由于ASP.NET Core应用是一个同时处理多个请求的服务器应用，所以在处理某个请求过程中抛出的异常并不会导致整个应用的终止。出于安全方面的考量，为了避免敏感信息的外泄，客户端在默认的情况下并不会得到详细的出错信息，这无疑会在开发环境下增加查错纠错的难度。对于生产环境来说，我们也希望最终用户能够根据具体的错误类型得到具有针对性并且友好的错误消息。ASP.NET Core提供了相应的中间件帮助我们将定制化的错误信息呈现出来，这些中间件都定义在“Microsoft.AspNetCore.Diagnostics”这个NuGet包中。 阅读全文
posted @ 2016-12-29 08:46 Artech 阅读(20557) 评论(6) 推荐(19) 编辑
ASP.NET Core的路由[5]：内联路由约束的检验
摘要：当某个请求能够被成功路由的前提是它满足某个Route对象设置的路由规则，具体来说，当前请求的URL不仅需要满足路由模板体现的路径模式，请求还需要满足Route对象的所有约束。路由系统采用IRouteConstraint接口来表示路由约束，所以我们在接下来的内容中将路由约束统称为RouteConstraint。 在大部分情况下，约束都是针对路由模板中定义的某个路由参数，其目的在于验证URL携带的某部分的内容是否有效。不过也有一些约束与路由参数无关，这些约束规范往往是除URL之前的其他请求元素，比如前面提到的HttpMethodRouteConstraint检验的就是请求采用的方法。 阅读全文
posted @ 2016-12-26 23:03 Artech 阅读(3871) 评论(3) 推荐(11) 编辑
为.NET Core项目定义Item Template
摘要：为这个星球上最强大的IDE，Visual Studio不仅仅提供了很多原生的特性，更重要的是它是一个可定制的IDE，比如自定义Project Template和Item Template就是一个非常有用的扩展点。这里我们主要关注Item Template，它时我们可以在“Add new Item”对话框中添加我们自定义的Item.我们之前自定义了一些Item Template，最近想在.NET Core项目中使用它们，但是失败了。今天为了这个折腾得够呛，不过好在最后还是解决了——虽然解决方案仅仅是添加一行代码 阅读全文
posted @ 2016-12-23 17:10 Artech 阅读(2956) 评论(2) 推荐(5) 编辑
ASP.NET Core的路由[4]：来认识一下实现路由的RouterMiddleware中间件
摘要：然ASP.NET Core应用的路由是通过RouterMiddleware这个中间件来完成的，但是具体的路由解析功能都落在指定的Router对象上，不过我们依然有必要以代码实现的角度来介绍一下这个中间件。 阅读全文
posted @ 2016-12-23 08:26 Artech 阅读(7013) 评论(3) 推荐(9) 编辑
ASP.NET Core的路由[3]：Router的创建者——RouteBuilder
摘要：在《注册URL模式与HttpHandler的映射关系》演示的实例中，我们总是利用一个RouteBuilder对象来为RouterMiddleware中间件创建所需的Router对象，接下来我们就着重来介绍这个对象。RouteBuilder是我们对所有实现了IRouteBuilder接口的所有类型以及对应对象的统称。 阅读全文
posted @ 2016-12-22 09:15 Artech 阅读(5904) 评论(3) 推荐(10) 编辑
ASP.NET Core的路由[2]：路由系统的核心对象——Router
摘要：ASP.NET Core应用中的路由机制实现在RouterMiddleware中间件中，它的目的在于通过路由解析为请求找到一个匹配的处理器，同时将请求携带的数据以路由参数的形式解析出来供后续请求处理流程使用。但是具体的路由解析功能其实并没有直接实现在RouterMiddleware中间件中，而是由一个Router对象来完成的。 阅读全文
posted @ 2016-12-21 08:48 Artech 阅读(6492) 评论(4) 推荐(12) 编辑
ASP.NET Core的路由[1]：注册URL模式与HttpHandler的映射关系
摘要：ASP.NET Core的路由是通过一个类型为RouterMiddleware的中间件来实现的。如果我们将最终处理HTTP请求的组件称为HttpHandler，那么RouterMiddleware中间件的意义在于实现请求路径与对应HttpHandler之间的映射关系。对于传递给RouterMiddleware中间件的每一个请求，它会通过分析请求URL的模式并选择并提取对应的HttpHandler来处理该请求。除此之外，请求的URL还会携带相应参数，该中间件在进行路由解析过程中还会根据生成相应的路由参数提供给处理该请求的Handler。 阅读全文
posted @ 2016-12-15 08:23 Artech 阅读(7542) 评论(5) 推荐(13) 编辑
ASP.NET Core应用针对静态文件请求的处理[5]: DefaultFilesMiddleware中间件如何显示默认页面
摘要：DefaultFilesMiddleware中间件的目的在于将目标目录下的默认文件作为响应内容。我们知道，如果直接请求的就是这个默认文件，那么前面介绍的StaticFileMiddleware中间件会将这个文件响应给客户端。如果我们能够将针对目录的请求重定向到这个默认文件上，一切就迎刃而解了。实际上DefaultFilesMiddleware中间件的实现逻辑很简单，它采用URL重写的形式修改了当前请求的地址，即将针对目录的URL修改成针对默认文件的URL 阅读全文
posted @ 2016-12-14 08:10 Artech 阅读(3552) 评论(2) 推荐(6) 编辑
ASP.NET Core应用针对静态文件请求的处理[4]: DirectoryBrowserMiddleware中间件如何呈现目录结构
摘要：和StaticFileMiddleware中间件一样，DirectoryBrowserMiddleware中间本质上还是定义了一个请求地址与某个物理目录之间的映射关系，而目标目录体现为一个FileProvider对象。当这个中间件接收到匹配的请求后，会根据请求地址解析出对应目录的相对路径，并利用这个FileProvider获取目录的内容。目录的内容最终会以一个HTML文档的形式被定义，而此HTML最终会被这个中间件作为响应的内容，“目录浏览器”的实现原理就这么简单。 阅读全文
posted @ 2016-12-13 08:28 Artech 阅读(2778) 评论(1) 推荐(6) 编辑
ASP.NET Core应用针对静态文件请求的处理[3]: StaticFileMiddleware中间件如何处理针对文件请求
摘要：我们通过《以Web的形式发布静态文件》和《条件请求与区间请求》中的实例演示，以及上面针对条件请求和区间请求的介绍，从提供的功能和特性的角度对这个名为StaticFileMiddleware的中间进行了全面的介绍，接下来我们将更近一步，将从实现原理的角度来进一步认识这个中间件。 阅读全文
posted @ 2016-12-09 08:24 Artech 阅读(5225) 评论(4) 推荐(11) 编辑
ASP.NET Core应用针对静态文件请求的处理[2]: 条件请求与区间请求
摘要：通过调用ApplicationBuilder的扩展方法UseStaticFiles注册的StaticFileMiddleware中间件帮助我们处理针对文件的请求。对于StaticFileMiddleware处理请求的逻辑，大部分读者都应该想得到：它根据请求的地址找到目标文件的路径，然后利用注册的ContentTypeProvider根据路径解析出与文件内容相匹配的媒体类型，默认情况下得到的媒体类型是根据目标文件的扩展名解析出来的。解析出来的媒体类型将作为响应报头Content-Type的值。StaticFileMiddleware中间件最终利用FileProvider读取文件的内容作为响应消息的主体。实际上，这个中间件在处理请求时比我们想象的要多得多，针对条件请求（Conditional Request）和区间请求（Range Request）的处理就没有在上面演示的实例中体现出来。 阅读全文
posted @ 2016-12-08 08:41 Artech 阅读(3924) 评论(6) 推荐(5) 编辑
ASP.NET Core应用针对静态文件请求的处理[1]: 以Web的形式发布静态文件
摘要：虽然ASP.NET Core是一款“动态”的Web服务端框架，但是在很多情况下都需要处理针对静态文件的请求，最为常见的就是这对JavaScript脚本文件、CSS样式文件和图片文件的请求。针对不同格式的静态文件请求的处理，ASP.NET Core为我们提供了三个中间件，它们将是本章论述的重点。不过在针对对它们展开介绍之前，我们照理通过一些简单的实例来体验一下如何在一个ASP.NET Core应用中发布静态文件。 阅读全文
posted @ 2016-12-07 08:28 Artech 阅读(9352) 评论(6) 推荐(22) 编辑
在ASP.NET Core应用中如何设置和获取与执行环境相关的信息？
摘要：HostingEnvironment是承载应用当前执行环境的描述，它是对所有实现了IHostingEnvironment接口的所有类型以及对应对象的统称。HostingEnvironment类型是对IHostingEnvironment接口的默认实现。对于通过HostingEnvironment的四个属性（ApplicationName、EnvironmentName、WebRootPath和ContentRootPath） 承载的四个与执行环境相关的设置，在WebHostOptions对象上都具有对应的属性，后者是前者的数据来源。由于WebHostOptions对象是WebHostBuilder根据它采用的配置来创建的，所以这些设置最初来源于使用的配置。 阅读全文
posted @ 2016-12-06 08:34 Artech 阅读(13124) 评论(5) 推荐(8) 编辑
如何远程关闭一个ASP.NET Core应用？
摘要：在《历数依赖注入的N种玩法》演示系统自动注册服务的实例中，我们会发现输出的列表包含两个特殊的服务，它们的对应的服务接口分别是IApplicationLifetime和IHostingEnvironment，我们将分别实现这两个接口的服务统称在ApplicationLifetime和HostingEnvironment。我们从其命名即可以看出ApplicationLifetime与应用的声明周期有关，而HostingEnvironment则用来表示当前的执行环境，本篇文章我们着重来了解ApplicationLifetime与整个AASP.NET Core应用的生命周期有何关系. 阅读全文
posted @ 2016-12-05 08:37 Artech 阅读(5890) 评论(4) 推荐(9) 编辑