在ASP.NET Web API中使用OData

一.什么是OData
OData是一个开放的数据协议(Open Data Protocol)
在ASP.NET Web API中,
对于CRUD(create, read, update, and delete)应用比传统WebAPI增加了很大的灵活性
只要正确使用相关的协议,可以在同等情况下
对一个CRUD应用可以节约很多开发时间,从而提高开发效率

二.怎么搭建

做一个简单的订单查询示例
我们使用Code First模式创建两个实体对象Product(产品),Supplier(供应商)
1.新建一个ASP.NET Empty项目,选择上使用Web API,如下图

2.使用NuGet引用OData和EntityFramework程序集

3.在Models文件夹中增加Product(产品),Supplier(供应商)两个实体

public class Product
{
public int Id { get; set; }
public string Name { get; set; }
public decimal Price { get; set; }
public string Category { get; set; } [ForeignKey("Supplier")]
public int? SupplierId { get; set; }
public virtual Supplier Supplier { get; set; }
}
public class Supplier
{
public int Id { get; set; }
public string Name { get; set; }
public ICollection<Product> Products { get; set; }
}

4.增加ProductContext数据库上下文对象,并且在web.config中配置好ConnectionString

public class ProductContext : DbContext
{
public ProductContext()
: base("Demo")
{ }
public DbSet<Product> Products { get; set; }
public DbSet<Supplier> Suppliers { get; set; }
}
<connectionStrings>
<add name="Demo" connectionString="Data Source=(localdb)\v11.0;
Initial Catalog=Demo; Integrated Security=True; MultipleActiveResultSets=True;
AttachDbFilename=|DataDirectory|Demo.mdf"
providerName="System.Data.SqlClient" />
</connectionStrings>

5.生成数据库
我们启动程序包管理控制台,运行如下3个命令,
把我们Code First生成的实体生成到数据库
PM> Enable-Migrations
PM> Add-Migration FirstInit
PM> Update-Database
然后我们可以在服务器资源管理器中看到我们生成的数据库表,如下图

6.接下来我们在WebApiConfig中注册我们的OData路由

using Demo2.Models;
using System.Web.OData.Builder;
using System.Web.OData.Extensions;
namespace Demo2
{
public static class WebApiConfig
{
public static void Register(HttpConfiguration config)
{
ODataModelBuilder builder = new ODataConventionModelBuilder();
builder.EntitySet<Product>("Products");
builder.EntitySet<Supplier>("Suppliers");
config.MapODataServiceRoute("ODataRoute", null, builder.GetEdmModel());
}
}
}

7.接下来我们分别为Product和Supplier新建ODataController,


我们在上图中我们选择好模型类和数据上下文,
并重复上面两步为Supplier实体也生成对应的ODataController
注意:由于VS2013的OData模板中OData V3版本的模板,
引用的名称空间要从V3
using System.Web.Http;
using System.Web.Http.ModelBinding;
using System.Web.Http.OData;
using System.Web.Http.OData.Routing;
修改为V4
using System.Web.Http;
using System.Web.OData;

到此,我们的OData示例程序已经搭建完成,我们在浏览器里打开这个项目的时候
会出现如下

{
"@odata.context":"http://localhost:8914/$metadata","value":[
{
"name":"Products","kind":"EntitySet","url":"Products"
},{
"name":"Suppliers","kind":"EntitySet","url":"Suppliers"
}
]
}

表示已经搭建成功了

三.怎么使用
由于没有测试数据,我们开始先在数据库表里为Products和Suppliers增加一些测试数据


接下来我们看看一些简单的使用示例
在自动生成的ProductsController和SuppliersController中
已经为我们生成了如下一些Action

所以对于一些增加,修改,删除,更新我就不做过多示例,
这些都是和WebAPI没有什么太多区别,
我主要示例的是查询的使用,不得不说OData已经为我们把查询功能全做完了
示例1:列出所有Product
URL:http://localhost:8914/Products

{
"@odata.context":"http://localhost:8914/$metadata#Products","value":[
{
"Id":1,"Name":"Products1","Price":100.00,"Category":"Test","SupplierId":1
},{
"Id":2,"Name":"Products2","Price":200.00,"Category":"Test","SupplierId":1
},{
"Id":3,"Name":"Products3","Price":300.00,"Category":"Test","SupplierId":1
},{
"Id":4,"Name":"Products4","Price":400.00,"Category":"P1","SupplierId":2
},{
"Id":5,"Name":"Products5","Price":500.00,"Category":"P1","SupplierId":2
},{
"Id":6,"Name":"Products6","Price":600.00,"Category":"P1","SupplierId":2
},{
"Id":7,"Name":"Products7","Price":700.00,"Category":"P1","SupplierId":2
},{
"Id":8,"Name":"Products8","Price":800.00,"Category":"Test","SupplierId":3
},{
"Id":9,"Name":"Products9","Price":900.00,"Category":"P1","SupplierId":3
}
]
}

示例2,查询单个Products
URL:http://localhost:8914/Products(1) 其中(1)为Id

{
"@odata.context":"http://localhost:8914/$metadata#Products/$entity","Id":1,"Name":"Products1","Price":100.00,"Category":"Test","SupplierId":1
}

示例3,查询Products,只列出Name,Price例
URL:http://localhost:8914/Products?$select=Name,Price

{
"@odata.context":"http://localhost:8914/$metadata#Products(Name,Price)","value":[
{
"Name":"Products1","Price":100.00
},{
"Name":"Products2","Price":200.00
},{
"Name":"Products3","Price":300.00
},{
"Name":"Products4","Price":400.00
},{
"Name":"Products5","Price":500.00
},{
"Name":"Products6","Price":600.00
},{
"Name":"Products7","Price":700.00
},{
"Name":"Products8","Price":800.00
},{
"Name":"Products9","Price":900.00
}
]
}

示例5:只列出ID为1的Products,只显示列Name,Price

URL:http://localhost:8914/Products(1)?$select=Name,Price

{
"@odata.context":"http://localhost:8914/$metadata#Products(Name,Price)/$entity","Name":"Products1","Price":100.00
}

示例6:列出Products(只有列Name,Price),包括Supplier
URL:http://localhost:8914/Products?$select=Name,Price&$expand=Supplier

{
"@odata.context":"http://localhost:8914/$metadata#Products(Name,Price,Supplier)","value":[
{
"Name":"Products1","Price":100.00,"Supplier":{
"Id":1,"Name":"Supplier1"
}
},{
"Name":"Products2","Price":200.00,"Supplier":{
"Id":1,"Name":"Supplier1"
}
},{
"Name":"Products3","Price":300.00,"Supplier":{
"Id":1,"Name":"Supplier1"
}
},{
"Name":"Products4","Price":400.00,"Supplier":{
"Id":2,"Name":"Supplier2"
}
},{
"Name":"Products5","Price":500.00,"Supplier":{
"Id":2,"Name":"Supplier2"
}
},{
"Name":"Products6","Price":600.00,"Supplier":{
"Id":2,"Name":"Supplier2"
}
},{
"Name":"Products7","Price":700.00,"Supplier":{
"Id":2,"Name":"Supplier2"
}
},{
"Name":"Products8","Price":800.00,"Supplier":{
"Id":3,"Name":"Supplier3"
}
},{
"Name":"Products9","Price":900.00,"Supplier":{
"Id":3,"Name":"Supplier3"
}
}
]
}

示例7:过滤Products,只显示分类为Test的数据
URL:http://localhost:8914/Products?$filter=Category eq ’Test‘

{
"@odata.context":"http://localhost:8914/$metadata#Products","value":[
{
"Id":1,"Name":"Products1","Price":100.00,"Category":"Test","SupplierId":1
},{
"Id":2,"Name":"Products2","Price":200.00,"Category":"Test","SupplierId":1
},{
"Id":3,"Name":"Products3","Price":300.00,"Category":"Test","SupplierId":1
},{
"Id":8,"Name":"Products8","Price":800.00,"Category":"Test","SupplierId":3
}
]
}

示例8:过滤Products,只显示分类为Test的数据,并排序
URL:http://localhost:8914/Products?$filter=Category eq ’Test‘&$orderby=Price desc

{
"@odata.context":"http://localhost:8914/$metadata#Products","value":[
{
"Id":8,"Name":"Products8","Price":800.00,"Category":"Test","SupplierId":3
},{
"Id":3,"Name":"Products3","Price":300.00,"Category":"Test","SupplierId":1
},{
"Id":2,"Name":"Products2","Price":200.00,"Category":"Test","SupplierId":1
},{
"Id":1,"Name":"Products1","Price":100.00,"Category":"Test","SupplierId":1
}
]
}

下面是$filter的其它的使用方式
1.  http://localhost/Products?$filter=Category eq 'Test'
过滤Category=Test
2.http://localhost/Products?$filter=Price lt 10
过滤Price小于10
3。http://localhost/Products?$filter=Price ge 5 and Price le 15
过滤5<=Price>=15
5,还可以使用数据库函数如:
$filter=substringof('zz',Name)
$filter=year(ReleaseDate) gt 2005

关于排序
$orderby=Price
$orderby=Price desc
$orderby=Category,Price desc

还有一些过滤器如
$skip,$top,$inlinecount等等
所以OData基本上实现我们们想要查询的相关方法
对于CURD程序的查询来说大大提高开发效率

四: 相关引用资源
https://www.asp.net/web-api
https://www.asp.net/web-api/overview/odata-support-in-aspnet-web-api/odata-v4/create-an-odata-v4-endpoint

转载请注明出处:http://giantliu.com

ASP.NET Web API中使用OData的更多相关文章

  1. 在ASP.NET Web API中使用OData

    http://www.alixixi.com/program/a/2015063094986.shtml 一.什么是ODataOData是一个开放的数据协议(Open Data Protocol)在A ...

  2. 在ASP.NET Web API中使用OData的Action和Function

    本篇体验OData的Action和Function功能.上下文信息参考"ASP.NET Web API基于OData的增删改查,以及处理实体间关系".在本文之前,我存在的疑惑包括: ...

  3. [翻译]在ASP.NET Web API中通过OData支持查询和分页

    OData可以通过形如http://localhost/Products?$orderby=Name这样的QueryString传递查询条件.排序等.你可以在任何Web API Controller中 ...

  4. 在ASP.NET Web API中使用OData的Containment

    通常情况下,一个OData的EDM(Entity Data Model)在配置的时候定义了,才可以被查询或执行各种操作.比如如下: builder.EntitySet<SomeModel> ...

  5. 在ASP.NET Web API中使用OData的单例模式

    从OData v4开始增加了对单例模式的支持,我们不用每次根据主键等来获取某个EDM,就像在C#中使用单例模式一样.实现方式大致需要两步: 1.在需要实现单例模式的导航属性上加上[Singleton] ...

  6. ASP.NET Web API中的Controller

    虽然通过Visual Studio向导在ASP.NET Web API项目中创建的 Controller类型默认派生与抽象类型ApiController,但是ASP.NET Web API框架本身只要 ...

  7. ASP.NET Web API 中的异常处理(转载)

    转载地址:ASP.NET Web API 中的异常处理

  8. 【ASP.NET Web API教程】6.2 ASP.NET Web API中的JSON和XML序列化

    谨以此文感谢关注此系列文章的园友!前段时间本以为此系列文章已没多少人关注,而不打算继续下去了.因为文章贴出来之后,看的人似乎不多,也很少有人对这些文章发表评论,而且几乎无人给予“推荐”.但前几天有人询 ...

  9. Asp.Net Web API 2第十三课——ASP.NET Web API中的JSON和XML序列化

    前言 阅读本文之前,您也可以到Asp.Net Web API 2 系列导航进行查看 http://www.cnblogs.com/aehyok/p/3446289.html 本文描述ASP.NET W ...

随机推荐

  1. 在 树莓派上使用 c++ libsockets library

    rpi默认安装的编译器是gcc-4.6.2 而现在最新的c++ libsockets library 需要使用支持c++-11特征的编译器,即需要4.8.2才可以.为此,需要先升级编译器才可以支持编译 ...

  2. "Cannot find entry symbol nable-stdcll-fixup; defaulting to 00401000" 解决方案

    在使用Qt 4.7.3, Qt 4.7.2 ,Qt 4.7.1(mingw 4.6.2 )的时候都会有一个问题无法编译通过,即用Qt Creator 编译的时候会发生一个错误 "Cannot ...

  3. hdu 4308 Saving Princess claire_ BFS

    为了准备算法考试刷的,想明确一点即可,全部的传送门相当于一个点,当遇到一个传送门的时候,把全部的传送门都压入队列进行搜索 贴代码: #include <iostream> #include ...

  4. 国内PaaS概述和EEPlat定位

    2014国内云计算产业进入快速发展阶段.热火多年来,所以云计算的云计算产业迅速进入栈桥的应用.IaaS.PaaS.SaaS各大厂商具有较强的市场布局,所以,云计算应用在这三个层次的访问,以实际使用阶段 ...

  5. SecureCRT 6.7.1 RI和谐 皴 补丁 方法

    它之前被使用SecureCRT 6.5.3 版本号,咋看和谐补丁,即使中国版本也可(现在才发现SecureCRT.6.2.0) 可是换为 6.7.1 后就怎么也注冊不了了.. 没办法试了各种办法: 先 ...

  6. [渣译文] SignalR 2.0 系列: 开始使用SignalR 2.0

    原文:[渣译文] SignalR 2.0 系列: 开始使用SignalR 2.0 英文渣水平,大伙凑合着看吧…… 这是微软官方SignalR 2.0教程Getting Started with ASP ...

  7. 【翻译】要理解Ext JS 5小工具

    原版的:Understanding Widgets in Ext JS 5 在Ext JS 5,引入了新的"widgetcolumn",支持在网格的单元格中放置组件. 同一时候,还 ...

  8. telnet发电子邮件

    无聊今天的工作,想想一个学生被提到最后一次telnet发电子邮件,所以我想试试.最后,成功的实践,这里做个总结. 首先,cmd进telnet打开回话: 下面红色字体为命令. 1.open smtp.1 ...

  9. DOM对象本身也是一个js对象,所以严格来说,并不是操作这个对象慢,而是说操作了这个对象后,会触发一些浏览器行为(转)

    一直都听说DOM很慢,要尽量少的去操作DOM,于是就想进一步去探究下为什么大家都会这样说,在网上学习了一些资料,这边整理出来. 首先,DOM对象本身也是一个js对象,所以严格来说,并不是操作这个对象慢 ...

  10. Unity该插件NGUI得知(9)—— Tween并转换成世界坐标系的大小NGUI尺寸

    在游戏中,还有一种比较常见的动画,这是进球后产生,分数将被显示在游戏,而快速移动,使其失去位置加入.就打算使用NGUI的Tween来制作这样的分数动画效果. 依据 Unity插件之NGUI学习(2), ...