ASP.NET?Core怎么構(gòu)建OData查詢Restful?API

這篇文章主要講解了“ASP.NET Core怎么構(gòu)建OData查詢Restful API”，文中的講解內(nèi)容簡單清晰，易于學(xué)習(xí)與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學(xué)習(xí)“ASP.NET Core怎么構(gòu)建OData查詢Restful API”吧！

前言：

本文使用 .NET Core SDK 3.1 的版本。

OData 是 Open Data Protocol 的簡寫，

OData 允許以簡單和標(biāo)準(zhǔn)的方式創(chuàng)建和使用可查詢和互操作的 Restful API。

官方文檔訪問 OData - Basic Tutorial

創(chuàng)建 Web API 項(xiàng)目，并引入 OData 相關(guān)的 NuGet 包：

dotnet pack Microsoft.AspNetCore.OData -v 7.5.8

一、建構(gòu) OData 實(shí)體模型

在建構(gòu) OData 實(shí)體模型之前，需要先創(chuàng)建相關(guān)的 DTO

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

隨后建構(gòu) OData 實(shí)體模型

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

二、配置 OData 中間件

配置 OData 服務(wù)

    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);
            // 第一個(gè)參數(shù) 路由名稱，第二個(gè)參數(shù) 路由前綴，第三個(gè)參數(shù) 創(chuàng)建OData實(shí)體數(shù)據(jù)模型的方法
            // 通過這個(gè)方式創(chuàng)建了與OData相關(guān)聯(lián)的路由
            endpoints.MapODataRoute("odata", "odata", PersonModelBuilder.GetEdmModel());
        });
    }

三、OData 實(shí)現(xiàn) Restful API 查詢

創(chuàng)建一個(gè) PersonController 控制器，并繼承 ODataController。

給 Action 的特性增加上 [EnableQuery] 來表示當(dāng)前 API 是 OData 協(xié)議的方法，

在 Action 的入?yún)⒓由咸匦?[FromODataUri] 來表示當(dāng)前入?yún)碜?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 訪問查詢?nèi)繑?shù)據(jù)的 API，

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

我們先看結(jié)果，我們可以得到如下 JSON

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

得到的結(jié)果不難看出，OData 查詢 API 的 Uri 通過 $ 符號(hào)起始的參數(shù)來對 Action 返回的結(jié)果進(jìn)行改造，進(jìn)行排序，字段的篩選等等功能。
我們訪問 @odata.context 參數(shù)的 Value 這個(gè) Uri，我們可以看到該接口相關(guān)實(shí)體的詳細(xì)詳細(xì)。

通過下面 Uri 訪問查詢某條數(shù)據(jù)的 API，

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

我們可以得到如下 JSON

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

感謝各位的閱讀，以上就是“ASP.NET Core怎么構(gòu)建OData查詢Restful API”的內(nèi)容了，經(jīng)過本文的學(xué)習(xí)后，相信大家對ASP.NET Core怎么構(gòu)建OData查詢Restful API這一問題有了更深刻的體會(huì)，具體使用情況還需要大家實(shí)踐驗(yàn)證。這里是億速云，小編將為大家推送更多相關(guān)知識(shí)點(diǎn)的文章，歡迎關(guān)注！