【WebAPI No.1】建立简单的 .NETCore WebApi

介绍：

官方定义以下，强调两个关键点，便可以对接各类客户端（浏览器，移动设备），构建http服务的框架。Web API最重要的是能够构建面向各类客户端的服务。

core的WebAPI与ASP.NET WebAPI是有些区别的，如今使用的是控制器路由[Route("api/Menu")]和请求方式路由[HttpGet]、[HttpGet("{id}")]结合的 方式。直接在控制器和Action上使用方法注释。没有ASP.NET WebAPI存在单独的配置路由规则类。先配置，而后进行注册后才可使用。

Web API的主要功能：

1. 支持基于Http verb (GET, POST, PUT, DELETE)的CRUD (create, retrieve, update, delete)操做

 经过不一样的http动做表达不一样的含义，这样就不须要暴露多个API来支持这些基本操做。

2. 请求的回复经过Http Status Code表达不一样含义，而且客户端能够经过Accept header来与服务器协商格式，例如你但愿服务器返回JSON格式仍是XML格式。

3. 请求的回复格式支持 JSON，XML，而且能够扩展添加其余格式。

4. 原生支持OData。

5. 支持Self-host或者IIS host。

建立项目：

首先：打开vs选中新建项目- >选中.NET Core - >ASP.NET Core Web应用程序：

 

而后：在选择web应用程序，注意上面要选中.net Core 别选错了。在选择Web API

最后：看到一个新建好的项目结构：

 验证：最后打开基础网址看一下效果：

再修改网址路径：http://localhost:4833/api/values

基本介绍：

建立本身新的控制器：

路由的基本功能：

    控制器路由：

        [Route("api/Menu")]

    Action路由：

        1.根据HttpMethod路由 [HttpPut]

        2.根据Template模板路由[HttpGet("{id}")]

    Core WebAPI中返回数据处理，提供了更 多的选择：

        1.OKResult，OkObjectResult,返回状态为200

        注：用OkObjectResult 前台jquery自动解析为object对象，不须要进行反序列化处理

        2.ContentResult 返回字符串

        3.JsonResult 返回Json对象，前台不须要反序列化处理

        4.返回基础类型和引用类型 ，自动序列化，前台接收为object对象等

 请求的一点补充：

    get请求参数若是在路由中配置就不能使用？拼接直接使用/值形式；例如：

错误写法：http://localhost:4833/api/Test?id=5

正确写法：http://localhost:4833/api/Test/5

跨域处理：

Core WebAPI的项目中自带了跨域Cors的处理，不须要单独添加程序包。咱们只须要在全局配置处配置就能够了。

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc();
            services.AddCors(options =>
            {
                options.AddPolicy("any", builder =>
                {
                    builder.AllowAnyOrigin() //容许任何来源的主机访问
                    .AllowAnyMethod()
                    .AllowAnyHeader()
                    .AllowCredentials();//指定处理cookie
                });
            });
        }

View Code

首先要引用命名空间：

using Microsoft.AspNetCore.Cors;

而后在使用的Action上面增长：[EnableCors("any")] 

        [HttpGet("{id}")]
        [EnableCors("any")]
        public string Get(int id)
        {
            return "这是带"+id+"的返回值";
        }

 注：也能够在控制器上使用，这样当前控制器全部方法都支持跨域

Cookie的访问：

    后台经过HttpContext上下文能够直接操做Cookie  :ControllerContext.HttpContext.Response.Cookies.Append("name", "内容");

     前台JQuery的ajax请求，须要携带withCredentials才会将cookie的值保存到客户端

传送门：

WebApi系列文章目录介绍