美文网首页
如何使用dotnet core 编写REST风格API

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

作者: elef | 来源:发表于2018-12-18 17:22 被阅读57次

当 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/

相关文章

网友评论

      本文标题:如何使用dotnet core 编写REST风格API

      本文链接:https://www.haomeiwen.com/subject/qqplkqtx.html