iis服务器助手广告广告
返回顶部
首页 > 资讯 > 后端开发 > ASP.NET >ASP.NET Core构建OData查询Restful API
  • 825
分享到

ASP.NET Core构建OData查询Restful API

2024-04-02 19:04:59 825人浏览 八月长安
摘要

目录前言:一、建构 OData 实体模型二、配置 OData 中间件三、OData 实现 Restful api 查询参考文档前言: 本文使用 .net core SDK 3.1 的

前言:

本文使用 .net core SDK 3.1 的版本。

OData 是 Open Data Protocol 的简写,

OData 允许以简单和标准的方式创建和使用可查询和互操作的 Restful API。

官方文档访问 OData - Basic Tutorial

创建 WEB API 项目,并引入 OData 相关的 NuGet 包:

dotnet pack Microsoft.Aspnetcore.OData -v 7.5.8

一、建构 OData 实体模型

在建构 OData 实体模型之前,需要先创建相关的 DTO

    public class Person
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public int Age { get; set; }
    }

随后建构 OData 实体模型

    public static class PersonModelBuilder
    {
        public static IEdmModel GetEdmModel()
        {
            var oDataBuilder = new ODataConventionModelBuilder();
            oDataBuilder.EntitySet<Person>("Person");
            return oDataBuilder.GetEdmModel();
        }
    }

二、配置 OData 中间件

配置 OData 服务

    public void ConfigureServices(IServiceCollection services)
    {
        // ......
        services.AddOData();
    }

配置 OData 中间件

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        app.UseRouting();
        app.UseEndpoints(endpoints =>
        {
            endpoints.Select().Filter().OrderBy().Count().MaxTop(10);
            // 第一个参数 路由名称,第二个参数 路由前缀,第三个参数 创建OData实体数据模型的方法
            // 通过这个方式创建了与OData相关联的路由
            endpoints.MapODataRoute("odata", "odata", PersonModelBuilder.GetEdmModel());
        });
    }

三、OData 实现 Restful API 查询

创建一个 PersonController 控制器,并继承 ODataController。

给 Action 的特性增加上 [EnableQuery] 来表示当前 API 是 OData 协议的方法,

在 Action 的入参加上特性 [FromODataUri] 来表示当前入参来自 OData 格式的 Uri 中。

    public class PersonController : ODataController
    {
        private static readonly List<Person> PEOPLE = new List<Person>
        {
            new Person { Id = 1, Name = "张三", Age = 18 },
            new Person { Id = 2, Name = "李四", Age = 19 },
            new Person { Id = 3, Name = "王五", Age = 20 },
            new Person { Id = 4, Name = "赵六", Age = 21 },
        };
        [HttpGet, EnableQuery]
        public ActionResult Get()
        {
            var people = PEOPLE;
            return Ok(people);
        }
        [HttpGet, EnableQuery]
        public IActionResult Get([FromODataUri] int key)
        {
            var people = PEOPLE;
            return Ok(people.FirstOrDefault(b => b.Id == key));
        }
    }

通过下面 Uri 访问查询全部数据的 API,

	http://localhost:5000/odata/person?$select=name,age&$orderby=age desc&$count=true&$top=2&$skip=2

我们先看结果,我们可以得到如下 JSON

  {
    "@odata.context": "http://localhost:5000/odata/$metadata#Person(Name,Age)",
    "@odata.count": 4,
    "value": [
      { "Name": "李四", "Age": 19 },
      { "Name": "张三", "Age": 18 }
    ]
  }

得到的结果不难看出,OData 查询 API 的 Uri 通过 $ 符号起始的参数来对 Action 返回的结果进行改造,进行排序,字段的筛选等等功能。
我们访问 @odata.context 参数的 Value 这个 Uri,我们可以看到该接口相关实体的详细详细。

通过下面 Uri 访问查询某条数据的 API,

http://localhost:5000/odata/person(1)

我们可以得到如下 jsON

  {
    "@odata.context": "http://localhost:5000/odata/$metadata#Person/$entity",
    "Id": 1,
    "Name": "张三",
    "Age": 18
  }

参考文档

OData - Basic Tutorial

以上就是ASP.net core建构OData实体模型实现Restful API查询的详细内容,更多关于OData Restful API的资料请关注编程网其它相关文章!

--结束END--

本文标题: ASP.NET Core构建OData查询Restful API

本文链接: https://www.lsjlt.com/news/147643.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

本篇文章演示代码以及资料文档资料下载

下载Word文档到电脑,方便收藏和打印~

下载Word文档
猜你喜欢
软考高级职称资格查询
编程网,编程工程师的家园,是目前国内优秀的开源技术社区之一,形成了由开源软件库、代码分享、资讯、协作翻译、讨论区和博客等几大频道内容,为IT开发者提供了一个发现、使用、并交流开源技术的平台。
  • 官方手机版

  • 微信公众号

  • 商务合作