Create an OData v4 Endpoint Using ASP.NET Web API 2.2(使用ASP.NET Web API 2.2创建OData v4端点)...

开放数据协议Open Data Protocol(OData)是web的一种数据存取协议,OData通过设置CRUD操作(Create创建。Read读取。Update更新,Delete删除)提供一种统一的方式来查询或者操作数据。

ASP.Net Web API同一时候支持该协议v3和v4版本号,你甚至能够在执行v4的端点(Endpoint)时执行v3的端点(Endpoint)。

本课程展示了怎样创建OData v4的端点(Endpoint)来提供CRUD操作。

教程里使用的软件版本号

    • Web API 2.2
      • OData v4
      • Visual Studio 2013 Update 2
      • Entity Framework 6
      • .NET 4.5

教程版本号

点击Creating an OData v3 Endpoint可跳转至OData Version 3.

创建Visual Studioproject

打开Visual Studio,在File(文件)菜单中。选择 New  >  Project(新建>项目)。

展开   Installed  >  Templates  >  Visual C#  >  Web(已安装>模板>Visual C#>Web)。选择 ASP.NET Web Application(ASP.NET Web应用程序)模板,将project名称命名为“ ProductService”。

在 New Project(新建项目)对话框里选择Empty(空模板)。在 "Add folders and core references..."(为下面对象加入目录和核心引用)。择Web API,然后点击OK(确定)。

安装OData包

在Tools(工具)菜单里。选择 NuGet Package Manager  >  Package Manager Console(NuGet程序包管理>程序包管理器控制台)。在程序包管理器控制台视窗里输入:

1Install-Package Microsoft.AspNet.Odata 2

该命令将会安装最新的OData NuGet包。

加入一个Model 类(模型类)

在你的应用程序里。一个Model(模型)就是一个展现数据实体的对象。

在 Solution Explorer(解决方式资源管理器)里,右击名为Models的目录,在右键菜单里,选择 Add  >  Class(加入>类)。

依照惯例。model classes(模型类)会被放入名为Models的目录里,只是在你project里你并不一定要遵循这种规则。

将该类命名为 Product,在Product.cs文件中,使用下面代码替换样本代码。

1namespace ProductService.Models 2{ 3 public class Product 4 { 5 public int Id { get; set; } 6 public string Name { get; set; } 7 public decimal Price { get; set; } 8 public string Category { get; set; } 9 } 10} 11
1Id 2

 属性是这个实体的键。client能够依据键来查询实体。要查询并得到Id  是5的 Product,它的资源路径便是 /Products(5),在后台数据库里Id  也是主键。

启用实体框架

在本次教程里,我们将使用 Entity Framework (EF) Code First来创建后台数据库。

Web API OData并不一定须要EF,你能够使用不论什么可将数据实体转换为models(模型)的数据訪问层。

首先,安装EF的NuGet包。在Tools(工具)菜单里。选择 NuGet Package Manager  >  Package Manager Console(NuGet程序包管理>程序包管理器控制台)。

在程序包管理器控制台视窗里输入:

1Install-Package EntityFramework 2

打开 Web.config文件,将下面位于 configuration  节点内。 configSections节点后的部分加入至该文件里对应位置。

1<configuration> 2 <configSections> 3 <!-- ... --> 4 </configSections> 5 6 <span style="background-color: rgb(255, 255, 0);"><!-- Add this: --></span> 7 <connectionStrings> 8 <add name="ProductsContext" connectionString="Data Source=(localdb)\v11.0; 9 Initial Catalog=ProductsContext; Integrated Security=True; MultipleActiveResultSets=True; 10 AttachDbFilename=|DataDirectory|ProductsContext.mdf" 11 providerName="System.Data.SqlClient" /> 12 </connectionStrings> 13
1该设置里加入了一个链接LocalDB(本地数据库)的链接字符串。 2

当你在本地执行此程序时,本地数据库将被使用。

下一步。在Models目录里加入一个名为ProductsContext  的类。

1using System.Data.Entity; 2namespace ProductService.Models 3{ 4 public class ProductsContext : DbContext 5 { 6 public ProductsContext() 7 : base("name=ProductsContext") 8 { 9 } 10 public DbSet<Product> Products { get; set; } 11 } 12} 13
1在构造函数里, 2

"name=ProductsContext"给出了连接字符串的名称。

配置OData Endpoint

打开文件 App_Start/WebApiConfig.cs,加入下面引用语句。

1using ProductService.Models; 2using System.Web.OData.Builder; 3using System.Web.OData.Extensions; 4
1然后加入下面代码至 2

Register方法中:

1public static class WebApiConfig 2{ 3 public static void Register(HttpConfiguration config) 4 { 5 // New code: 6 ODataModelBuilder builder = new ODataConventionModelBuilder(); 7 builder.EntitySet<Product>("Products"); 8 config.MapODataServiceRoute( 9 routeName: "ODataRoute", 10 routePrefix: null, 11 model: builder.GetEdmModel()); 12 } 13} 14
1这段代码做了两件事情 2
  • 创建

Entity Data Model(EDM实体数据模型)

  • 添加一个Route(路由)

EDM是数据的抽象模型,EDM被用来创建服务的元数据文件。

ODataConventionModelBuilder使用默认的命名规则创建EDM。这样的方法须要少量的代码。假设你想很多其它支配EDM的话,你能够使用通过明白地加入属性、键和导航属性来创建EDM。

Route告诉了Web API应该如何路由Http请求至Endpoint(端点)中。你能够通过调用 MapODataServiceRoute  扩展的方法来创建 OData v4 route(路由)。

假设你的程序里有多个OData Endpoint,你须要为它们分别创建一个route,且给它们不同的Route路由名称和前缀。

加入OData控制器

控制器是处理Http请求的类。你能够为每个OData服务的实体创建不同的控制器。

在本教程里,你将为Product  实体创建一个控制器。

在 Solution Explorer(解决方式资源管理器)里,右击名为 Controllers 的目录,在右键菜单里,选择 Add  >  Class(加入>类)。将其命名为 ProductsController 。

在OData v3教程里我们使用了 Add Controller对话框,但眼下还没有OData v4版的。

在 ProductsController.cs中用下面代码替换样本代码。

1using ProductService.Models; 2using System.Data.Entity; 3using System.Data.Entity.Infrastructure; 4using System.Linq; 5using System.Net; 6using System.Threading.Tasks; 7using System.Web.Http; 8using System.Web.OData; 9namespace ProductService.Controllers 10{ 11 public class ProductsController : ODataController 12 { 13 ProductsContext db = new ProductsContext(); 14 private bool ProductExists(int key) 15 { 16 return db.Products.Any(p => p.Id == key); 17 } 18 protected override void Dispose(bool disposing) 19 { 20 db.Dispose(); 21 base.Dispose(disposing); 22 } 23 } 24} 25

控制器使用 ProductsContext类通过EF来訪问数据库。注意,该控制器重写了 Dispose  方法来释放 ProductsContext。

这是控制的開始。下一步,我们将为全部的CRUD操作加入方法。


Querying the Entity Set  查询实体集

加入下面代码至 ProductsController。

1[EnableQuery] 2public IQueryable<Product> Get() 3{ 4 return db.Products; 5} 6[EnableQuery] 7public SingleResult<Product> Get([FromODataUri] int key) 8{ 9 IQueryable<Product> result = db.Products.Where(p => p.Id == key); 10 return SingleResult.Create(result); 11} 12
1当中一个没有參数的Get 2

 方法返回Product  的实体集合。而有一个參数的Get  方法则是通过 Product的键来查找对应的 Product(在这样的情况下。键就是 Id属性)。

[EnableQuery]标签通过使用查询设置 $filter, $sort,  $page 来改动查询。具体信息请点击Supporting OData Query Options。


Adding an Entity to the Entity Set  加入实体至实体集

为了使client能够加入新Product  至数据库中,我们加入例如以下方法至 ProductsController。

1public async Task<IHttpActionResult> Post(Product product) 2{ 3 if (!ModelState.IsValid) 4 { 5 return BadRequest(ModelState); 6 } 7 db.Products.Add(product); 8 await db.SaveChangesAsync(); 9 return Created(product); 10} 11
1**Updating an Entity  2

更新实体**

OData支持两种不同的语法来更新实体。 PATCH 和 PUT。

  • PATCH

运行部分更新。client仅仅需指定须要更新的属性。

  • PUT 

替换整个实体。

PUT 的不利之处是client必须发送实体全部属性的值,包含那些没有改变的值。OData 规范书推荐使用 PATCH。

无论如何。下面是 PATCH和 PUT 方法的代码:

1public async Task<IHttpActionResult> Patch([FromODataUri] int key, Delta<Product> product) 2{ 3 if (!ModelState.IsValid) 4 { 5 return BadRequest(ModelState); 6 } 7 var entity = await db.Products.FindAsync(key); 8 if (entity == null) 9 { 10 return NotFound(); 11 } 12 product.Patch(entity); 13 try 14 { 15 await db.SaveChangesAsync(); 16 } 17 catch (DbUpdateConcurrencyException) 18 { 19 if (!ProductExists(key)) 20 { 21 return NotFound(); 22 } 23 else 24 { 25 throw; 26 } 27 } 28 return Updated(entity); 29} 30public async Task<IHttpActionResult> Put([FromODataUri] int key, Product update) 31{ 32 if (!ModelState.IsValid) 33 { 34 return BadRequest(ModelState); 35 } 36 if (key != update.Id) 37 { 38 return BadRequest(); 39 } 40 db.Entry(update).State = EntityState.Modified; 41 try 42 { 43 await db.SaveChangesAsync(); 44 } 45 catch (DbUpdateConcurrencyException) 46 { 47 if (!ProductExists(key)) 48 { 49 return NotFound(); 50 } 51 else 52 { 53 throw; 54 } 55 } 56 return Updated(update); 57} 58
12

PATCH情况下,控制器使用 Delta<T>来跟踪实体的改变。


Deleting an Entity  删除实体

为了能让client从数据库中删除实体,我们能够在 ProductsController中加入下面方法。

1public async Task<IHttpActionResult> Delete([FromODataUri] int key) 2{ 3 var product = await db.Products.FindAsync(key); 4 if (product == null) 5 { 6 return NotFound(); 7 } 8 db.Products.Remove(product); 9 await db.SaveChangesAsync(); 10 return StatusCode(HttpStatusCode.NoContent); 11} 12

原文地址http://www.asp.net/web-api/overview/odata-support-in-aspnet-web-api/odata-v4/create-an-odata-v4-endpoint

代码交流 2021