广州网站优化公司咨询,厦门淘宝网站设计公司,邯郸seo排名,个人摄影网站模板什么是RESTREST 是 Representational State Transfer 的缩写. 它是一种架构的风格, 这种风格基于一套预定义的规则, 这些规则描述了网络资源是如何定义和寻址的.一个实现了REST这些规则的服务就叫做RESTful的服务.最早是由Roy Fielding提出的.RPC 风格/getUsers/getUser?id1/c… 什么是RESTREST 是 Representational State Transfer 的缩写. 它是一种架构的风格, 这种风格基于一套预定义的规则, 这些规则描述了网络资源是如何定义和寻址的.一个实现了REST这些规则的服务就叫做RESTful的服务.最早是由Roy Fielding提出的.RPC 风格/getUsers/getUser?id1/createUser/deleteUser?id4/updateUser?namedave 上面这些节点是针对User的CRUD操作. 这种样式风格的web服务更倾向于叫做RPC风格的服务.在RPC的世界里, 节点仅仅就是可以在远程被触发的函数, 而在REST的世界里, 节点就是实体, 也叫做资源.REST的原则/约束REST有6大原则/约束, 每一个原则都是对API有正面或负面影响的设计决定.RESTful API 最关心的有这几方面: 性能, 可扩展性, 简洁性, 互操作性, 通讯可见性, 组件便携性和可靠性.这些方面被封装在REST的6个原则里, 它们是: 1. 客服端-服务端约束: 客户端和服务端是分离的, 它们可以独自的进化.2. 无状态: 客户端和服务段的通信必须是无状态的, 状态应包含在请求里的. 也就是说请求里要包含服务端需要的所有的信息, 以便服务端可以理解请求并可以创造上下文.3. 分层系统: 就像其它的软件架构一样, REST也需要分层结构, 但是不允许某层直接访问不相邻的层. 4. 统一接口: 这里分为4点, 他们是: 资源标识符(URI), 资源的操作(也就是方法Method, HTTP动词), 自描述的响应(可以认为是媒体类型Media-Type), 以及状态管理(超媒体作为应用状态的引擎 HATEOAS, Hypermedia as the Engine of Application State).5. 缓存: 缓存约束派生于无状态约束, 它要求从服务端返回的响应必须明确表明是可缓存的还是不可缓存的.6. 按需编码: 这允许客户端可以从服务端访问特定的资源而无须知晓如何处理它们. 服务端可以扩展或自定义客户端的功能.只有满足了这6个原则的系统才可以真正称得上是RESTful的, 其实大部分系统的RESTful API并不是RESTful的, 但这样并不代表这些API就不好, 利弊需要开发人员去衡量.Richardson 成熟度模型Richardson 成熟度模型代表着你的API是否足够成熟, 分为4个级别, 0代表最差, 3代表最好.0级, 天花沼泽:这里HTTP协议只是被用来进行远程交互, 协议的其余部分都用错了, 都是RPC风格的实现(例如SOAP, 尤其是使用WCF的时候).例如:POST (查询数据信息)
http://host/myapiPOST (创建数据)
http://host/myapi 1级, 资源:这级里, 每个资源都映射到一个URI上了, 但是HTTP方法并没有正确的使用, 结果的复杂度不算太高.例如这两个查询:POST
http://host/api/authorsPOST
http://host/api/authors/{id} 2级, 动词:正确使用了HTTP动词, 状态码也正确的使用了, 同时也去掉了不必要的变种.例如:GET
http://host/api/authors200 Ok (authors)
POST (author representation)
http://host/api/authors201 Created (author)3级, 超媒体:API支持超媒体作为应用状态的引擎 HATEOAS, Hypermedia as the Engine of Application State, 引入了可发现性.例如:GET
http://host/api/authors200 Ok (返回了authors 和 驱动应用程序的超链接) 介绍ASP.NET Core略.但是, 你需要知道以下概念: .NET Core, .NET Standard.还需要会使用下列工具: .NET Core CLI, Visual Studio 2017/Visual Studio Code/Visual Studio for MacASP.NET Core 支持创建Web API, 但并不是直接支持RESTful的 Web API. ASP.NET Core的基本知识这部分还是需要简单的介绍下, 如果已经会了, 请略过本文其余部分.创建ASP.NET Core项目打开VS2017, 选择ASP.NET Core Web Application项目模板, 写好名字, OK. 选择空模板, OK: 项目建立好了, 结果如下:然后我们看一下项目文件, 右键编辑MyRestful.Api:这里, SDK属性表示了我们使用的是哪个SDK, 而目标框架是.NET Core 2.0.(提示: 如果需要指向多个目标框架的话可以使用TargetFrameworks元素, 注意多了个s) 看一下Program.cs:Main方法是程序的入口. 而Web的宿主是通过BuildWebHost函数来实例化的, 它调用了WebHost.CreateDefaultBuilder方法, 很明显这是一个建造者模式, 它最终会构建出一个web宿主.调用WebHost.CreateDefaultBuilder会返回一个IWebHostBuilder, 它允许我们进行一些配置动作.程序启动UseStartup方法会注册一个类, 这个类负责配置整个程序的启动过程. 这里默认用的是Startup类.Startup类有两个方法 ConfigureServices (这个可以没有) 和 Configure (这个必须有):在Configure方法里, 配置应该遵循Add/Use的风格样式, 首先定义需要什么, 然后定义如何使用它.而在ConfigureServices方法里, 所有程序级的依赖项都可以在这里注册到默认的IoC容器里, 把它们添加到IServiceCollection即可.Configure方法才是真正负责配置HTTP请求管道的方法, 并且运行时也需要它.IApplicationBuilder的扩展方法Run会传递一个RequestDelegate, 其内部功能就是回写Hello World. ASP.NET Core还允许我们按约定为指定环境建立单独的启动配置. 启动类可以通过这个函数定义UseStartup(startupAssemblyName: xxx); 运行时会在这个指定的组件查找叫做Startup, Startup[环境名]的类, 其中[环境名]就是ASPNETCORE_ENVIRONMENT这个环境变量的值. 如果能找到指定环境的类, 那么它将覆盖默认的启动类. 例如 环境变量值如果是Developmen的话, 那么运行时就会尝试寻找Startup和StartupDevelopment类, 该约定在启动类里面的方法名上也有效, 环境特定的启动类里的两个方法分别是 Configure[环境名]和Configure[环境名]Services. 除了之前讲的Run方法外, IApplicationBuilder还有一个Use扩展方法.Use扩展方法接受RequestDelegate作为参数来提供HttpContext, 同时接受也为下一层准备的RequestDelegate参数.需要注意的是, Run方法和Use方法定义的顺序非常重要, 运行时将会精确的按照创建的顺序来执行. 服务器ASP.NET Core 服务器的作用是响应客户端发过来的请求, 这些请求会作为HttpContext传递进来. ASP.NET Core 内置两种服务器:Kestrel, 它是跨平台的服务器, 基于Libuv.HTTP.sys, 它是仅限Windows系统的服务器, 基于HTTP.sys内核驱动.下面就是从客户端发请求到应用程序的流图:其中Kestrel可以作为一个独立进程自行托管, 也可以在IIS里. 但是还是建议使用IIS或Nginx等作为反向代理服务器. 在构建API或微服务时, 这些服务器可以作为网关使用, 因为它们会限制对外暴露的东西也可以更好的与现有系统集成, 所以它们会提供额外的防御层, 使用反向代理服务器(IIS)之后的流图如下:让web宿主工作于IIS之后需要使用IWebHostBuilder的UseIISIntegration这个扩展方法.除了内置的两种服务器, 您还可以使用自定义的服务器, 使用IWebHostBuilder的UserServer扩展方法, 它接受一个实现了IServer接口的实例, 您的自定义服务器需要实现该接口. 这里就不讲了. 中间件在应用程序请求管道内装配的组件就是中间件, 它们负责处理通过管道的请求和响应.在HTTP请求管道的上下文里, 中间件可以叫做请求委托, 它们是由Run, Map 和 Use 扩展方法共同组建而成的.每个中间件可以在它被调用之前和之后执行可选的逻辑, 同时也可以决定该请求是否可以被送到管道的下一个中间件那里.请求在中间件里的流图如下:看一下这个例子:如果我在浏览器地址输入 http://localhost:5000/return, 那么结果就是Returned!如果输入 http://localhost:5000/end, 那么是The End.如果输入 http://localhost:5000/xxx?value1234, 结果是 the number is 1234如果输入 http://localhost:5000/xxx?valueabcde, 结果是 Hello, the value is abcde! 注意: 应用程序管道里的请求委托(中间件)定义的顺序是非常重要的, 请求的时候按定义的顺序执行, 而响应的顺序正好相反. 中间件最好不要像上面一样写在Startup类里, 每个中间件应该放在单独的类里. 我把上例中检查是否为数字的中间件写在一个单独的类里:这种中间件没有实现特定的接口或者继承特定类, 它更像是Duck Typing (你走起路来像个鸭子, 叫起来像个鸭子, 那么你就是个鸭子).然后在Startup的Configure方法里调用app.UseMiddlewareNumberMiddleware()即可: 路由在ASP.NET Core里,使用路由中间件RouterMiddleware来处理路由.想要使用路由, 同样也是遵循 Add/Use 这个模式. 首先在ConfigureServices方法里添加(Add):然后在Configure方法里使用(Use):UseRouter这个扩展方法可以接受IRouter或者ActionIRouterBuilder作为参数.例如:当发送 http://localhost:5000/ GET请求的时候, 返回 Default route.当 GET http://localhost:5000/user/dave的时候, 返回 Hi dave当 POST http://localhost:5000/user/dave的时候, 返回 Hi, posted name is dave其中{name}, 是名为name的参数.如果写成user/{name}/{age:number}, 那么age这个参数的必须可以被解析为数值型.而user/{name}/{gender?}, 这里的gender参数可以没有. ControllerHTTP请求通过管道最终到达Action并返回的流图如下默认情况下Controller放在ASP.NET Core项目的Controllers目录下。在ASP.NET Core项目里可以通过多种方式来创建Controller当然最建议的方式还是通过继承AspNetCore.Mvc.Controller这个抽象类来建立Controller。例如上例中类名可以不是以Controller结尾。 还有其它的方式创建Controller按约定类名以Controller结尾的POCO类也会被认为是Controller例如 针对POCO类 即使名称不是以Controller结尾仍然可以把它作为Controller这就需要在类上面添加 [Controller] 这个属性 如果某个类的名字以Controller结尾 但是你不想把它当作Controller那么就应该为该类标注 [NonController] 这个属性 实际上 看源码就可以知道 Controller 继承于 ControllerBase: 而ControllerBase上面标注着 [Controller] 属性。 Action在Controller里面可以使用public修饰符来定义Action通常会带有参数可以返回任何类型但是大多数情况下应该返回IActionResult。Action的方法名要么是以HTTP的动词开头要么是使用HTTP动词属性标签包括[HttpGet], [HttpPut], [HttpPost], [HttpDelete], [HttpHead], [HttpOptions], [HttpPatch].例如其中某个方法名如果恰好是以HTTP的动词开头那么可以通过标注 [NonAction] 属性来表示这个方法不是Action。通过继承Controller基类的方法来创建Controller还是有很多好处的因为它提供了很多帮助方法例如Ok, NotFound, BadRequest等它们分别对应HTTP的状态码 200, 404, 400此外还有RedirectLocalRedirectRedirectToRouteJsonFileContent等方法。 为MVC定义路由有两种方式使用IRouteBuilder或者使用基于属性标签的路由。针对Rest最好还是使用基于属性标签的方式。路由属性标签可以标注在Controller或者Action方法上例如Controller类上标注的路由“api/[controller]”其中[controller] 就代表该类的名字去掉结尾Controller的部分也就是“api/person”。在Controller上使用[Route]属性就定义了该Controller下所有Action的路由基地址每个Action可以包含一个或者多个相对的路由模板地址这些路由模板可以在[Http...]中定义。但是如果使用 ~ 这个符号的话该Action的地址将会是绝对路由地址也就是覆盖了Controller定义的基路由。 实体绑定传入的请求会映射到Action方法的参数可以实原始数据类型也可以是复杂的类型例如Dtodata transfer object或ViewModel。这个把Http请求绑定到参数的过程叫做实体绑定。例如 其中id参数是定义在路由里的而name参数在路由里没有但是仍然可以从查询参数中把name参数映射出来。注意路由参数和查询参数的区别下面这个URL里val1和val2是查询参数它们是在url的后边使用?和分隔/product?val12val210 而针对上面的Action下面这个URL的路由参数id就是123/api/first/123 针对下面这个POST Action我们可以通过几种方式为其传递类型为Person的参数。可以使用查询参数/api/people?id1nameDave如果POST Json数据那么在Action里面得到的参数person的属性值都是null。这是因为这样的原始数据是包含在请求的Body里面为了解决这个问题你需要告诉Action从哪里获取参数针对这个例子就应该使用 [FromBody] 属性标签如果提交的是表单数据那么就应该使用[FromForm]:其它的出处还有 [FromHeader], [FromRoute], [FromServices]等。再看一个FromHeader的例子 如果使用复杂类型Person来获取person参数好像不行只能使用原始类型的吧 实体验证ASP.NET Core内置的实体验证是通过验证属性标签来实现的大多数情况下这样会很方便。例如其中Display不是验证标签但是通过它可以自定义属性的显式名称在其它错误信息里可以使用{0}来引用该名称。 判断实体参数是否符合要求可以检查ModelState.IsValid属性这个属性也是由ControllerBase提供的例如发送一个请求这是个不合理的参数返回的是400 BadRequest带着验证结果 尽管大多数情况西验证属性标签都满足要求但是有时候还是需要进行一些灵活的验证你可以使用像FluentValidation这样的第三方库也可以使用内置的方式来实现自定义验证。ASP.NET Core内置支持两种方式来进行自定义验证通过继承ValidationAttribute来创建自定义验证属性标签或者让实体实现IValidatebleObject接口。使用自定义验证属性标签把该标签放到name属性上使用刚才的请求其结果是 另一种方式在Person类实现IValidatableObject接口但是我使用这种方法并不好用不知道我哪里用错了 过滤器和中间件一样ASP.NET Core MVC的过滤器也可以在请求管道的特定阶段的之前或之后执行某些代码。过滤器还可以有子管道子管道里面包含着其它过滤器。过滤器和中间件的区别中间件是应用程序级别的它可以处理每个发送过来的请求而过滤器是针对MVC的它只会处理发往MVC的请求。ASP.NET Core MVC的过滤器分为5类授权过滤器它是第一个运行的它的作用就是判断HTTP Context中的用户是否拥有当前请求的权限如果用户没有权限那么它就会“短路”管道。资源过滤器在授权过滤器后运行在管道其它动作之前和管道动作都结束后运行。它可以实现缓存或由于性能原因执行短路操作。它在实体绑定之前运行所以它也可以对影响实体绑定。Action过滤器它在Action方法调用之前和之后立即执行它可以操作传进Action的参数和返回的结果。异常过滤器针对在写入响应Body之前发生的未处理的异常它可以应用全局的策略结果过滤器它可以在每个Action结果执行之前和之后运行代码但也只是在Action方法无错误的成功完成后才可以执行。下图标明了这些过滤器在管道中是如何交互的过滤器可以作为属性标签使用或者也可以在Startup类里面进行全局注册。例子using System.Threading.Tasks;using Microsoft.AspNetCore.Mvc.Filters;namespace MyRestful.Api.Filters{ public class DefaultNameFilter: IActionFilter, IAsyncActionFilter { public void OnActionExecuting(ActionExecutingContext context) { context.ActionDescriptor.RouteValues[name] Anonymous; } public void OnActionExecuted(ActionExecutedContext context) { context.HttpContext.Response.Headers[X-Name] context.ActionDescriptor.RouteValues[name]; } public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next) { OnActionExecuting(context); var result await next(); OnActionExecuted(result); } }}全局注册在Startup里public void ConfigureServices(IServiceCollection services) { services.AddMvc(options { options.Filters.AddDefaultNameFilter(); }); }或者自定义一个属性标签内部的代码是一样的using System;using System.Threading.Tasks;using Microsoft.AspNetCore.Mvc.Filters;namespace MyRestful.Api.Filters{ public class DefaultUserNameFilterAttribute: Attribute, IActionFilter, IAsyncActionFilter { public void OnActionExecuting(ActionExecutingContext context) { context.ActionDescriptor.RouteValues[name] Anonymous; } public void OnActionExecuted(ActionExecutedContext context) { context.HttpContext.Response.Headers[X-Name] context.ActionDescriptor.RouteValues[name]; } public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next) { OnActionExecuting(context); var result await next(); OnActionExecuted(result); } }}然后把该标签用在Action方法上即可[DefaultUserNameFilter] [HttpGet(first/{id})] public IActionResult FindFirstPerson(int id, string name) { return null; } 格式化响应结果Action的结果最好使用IActionResult, 但也可以使用其他类型例如IEnumerableT等。强制结果输出为特定的类型可以通过调用特定的方法来实现例如JsonResponse就是输出JSONContentResponse就是输出文本。另外也可以使用[Produces(xxx)] 这个过滤器它可以应用于全局controller或者Action。在REST服务里有个词叫内容协商它表示客户端通过Accept Header里的media-type来指定所需的结果格式。ASP.NET Core MVC 默认实现并使用JSON格式化但也支持其它格式这需要在startup里面注册。客户端浏览器可能在请求的Accept Headers里提供了多种的格式但是ASP.NET Core MVC 默认是忽略浏览器的Accept Header的并使用标准的输出格式。但是修改MvcOptions的RespectBrowserAcceptHeader值为true可以改变这个行为:ASP.NET Core还提供了 XML 格式可以在MvcOptions里面添加 今天先写到这还没有切入正题。原文地址: https://www.cnblogs.com/cgzl/p/9010978.html.NET社区新闻深度好文欢迎访问公众号文章汇总 http://www.csharpkit.com
