如何使用dotnet core 编写REST风格API

当 asp. net core 发布时, microsoft 和. net 社区决定合并 mvc 和 web api 的功能。这是有道理的, 因为两者是非常相似。这篇文章主要包含如下内容：

Web API 和 MVC
采用ASP.NET Core MVC 6 创建 REST API
编写 REST API 的其它框架 - NancyFx

ASP.NET Web API 和 MVC: 有什么区别吗?

在ASP.NET Core 之前，它们是非常相似的。都采用了MVC模式，包含 controllers 和 actions。Web API 缺少像Razor这样的视图引擎，而是用来实现REST API。MVC 是用来设计带有HTML前台的标准Web应用。

微软将 web api 吹捧为构建任何类型的 http 服务的框架。它是 wcf、soap 和较旧的 asmx 风格 web 服务的一个很好的替代方案。它是从头开始设计的, 考虑到了 json 和 rest。web api 还支持 odata, 这是通过 crud 操作查询数据的标准方式。

采用命令 dotnet new wepapi 创建项目，默认会创建一个样例API，包括 GET, POST, PUT, DELETE 这些REST标准的方法。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;

namespace dotnetCore.jwt.Controllers
{
    [Route("api/[controller]")]
    [ApiController]
    public class ValuesController : ControllerBase
    {
        // GET api/values
        [HttpGet]
        public ActionResult<IEnumerable<string>> Get()
        {
            return new string[] { "value1", "value2" };
        }
        // GET api/values/5
        [HttpGet("{id}")]
        public ActionResult<string> Get(int id)
        {
            return "value";
        }
        // POST api/values
        [HttpPost]
        public void Post([FromBody] string value)
        {
        }
        // PUT api/values/5
        [HttpPut("{id}")]
        public void Put(int id, [FromBody] string value)
        {
        }
        // DELETE api/values/5
        [HttpDelete("{id}")]
        public void Delete(int id)
        {
        }
    }
}

微软网站上有个标准教程

Nancy 也是编写API的一个好的选择

除了 asp. net 附带的标准 mvc 框架之外, 还有一些社区替代方案。其中最受欢迎的一种叫Nancy。它已经存在了相当长的时间, 并且是使用 mono 构建的 web 应用在 linux 上运行的热门选项, 因为它允许 asp. net 在没有 iis 或标准 system. web 管道的情况下工作。

Nancy能做什么？这里是基本框架内置功能的简短列表︰

基于 rest 路由
内置的简单视图引擎，可置换
提供静态文件服务
多租户服务托管
Rest API 认证 (基本认证，表单认证和基于令牌的认证)
灵活模型绑定
多格式内容协商
密码密钥和短语生成
SSL 证书处理
异步任务处理
依赖注入

Nancy对参数的读取让人非常喜欢,下面是一个简单示例，你可以了解下。

public class Module : NancyModule
{
    public Module()
    {
        Get("/greet/{name}", x => {
            return string.Concat("Hello ", x.name);
        });
    }
}

想了解更多Nancy的信息可以访问官方Github https://github.com/NancyFx/Nancy

文章参考：
https://stackify.com/asp-net-core-web-api-guide/
https://www.cnblogs.com/lilunjia/tag/NancyFx/

最后编辑于：2018.12.19 14:40:57