ASP.NET Web API中使用OData
在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的更多相关文章
- 在ASP.NET Web API中使用OData
http://www.alixixi.com/program/a/2015063094986.shtml 一.什么是ODataOData是一个开放的数据协议(Open Data Protocol)在A ...
- 在ASP.NET Web API中使用OData的Action和Function
本篇体验OData的Action和Function功能.上下文信息参考"ASP.NET Web API基于OData的增删改查,以及处理实体间关系".在本文之前,我存在的疑惑包括: ...
- [翻译]在ASP.NET Web API中通过OData支持查询和分页
OData可以通过形如http://localhost/Products?$orderby=Name这样的QueryString传递查询条件.排序等.你可以在任何Web API Controller中 ...
- 在ASP.NET Web API中使用OData的Containment
通常情况下,一个OData的EDM(Entity Data Model)在配置的时候定义了,才可以被查询或执行各种操作.比如如下: builder.EntitySet<SomeModel> ...
- 在ASP.NET Web API中使用OData的单例模式
从OData v4开始增加了对单例模式的支持,我们不用每次根据主键等来获取某个EDM,就像在C#中使用单例模式一样.实现方式大致需要两步: 1.在需要实现单例模式的导航属性上加上[Singleton] ...
- ASP.NET Web API中的Controller
虽然通过Visual Studio向导在ASP.NET Web API项目中创建的 Controller类型默认派生与抽象类型ApiController,但是ASP.NET Web API框架本身只要 ...
- ASP.NET Web API 中的异常处理(转载)
转载地址:ASP.NET Web API 中的异常处理
- 【ASP.NET Web API教程】6.2 ASP.NET Web API中的JSON和XML序列化
谨以此文感谢关注此系列文章的园友!前段时间本以为此系列文章已没多少人关注,而不打算继续下去了.因为文章贴出来之后,看的人似乎不多,也很少有人对这些文章发表评论,而且几乎无人给予“推荐”.但前几天有人询 ...
- 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 ...
随机推荐
- 在 树莓派上使用 c++ libsockets library
rpi默认安装的编译器是gcc-4.6.2 而现在最新的c++ libsockets library 需要使用支持c++-11特征的编译器,即需要4.8.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 ...
- hdu 4308 Saving Princess claire_ BFS
为了准备算法考试刷的,想明确一点即可,全部的传送门相当于一个点,当遇到一个传送门的时候,把全部的传送门都压入队列进行搜索 贴代码: #include <iostream> #include ...
- 国内PaaS概述和EEPlat定位
2014国内云计算产业进入快速发展阶段.热火多年来,所以云计算的云计算产业迅速进入栈桥的应用.IaaS.PaaS.SaaS各大厂商具有较强的市场布局,所以,云计算应用在这三个层次的访问,以实际使用阶段 ...
- SecureCRT 6.7.1 RI和谐 皴 补丁 方法
它之前被使用SecureCRT 6.5.3 版本号,咋看和谐补丁,即使中国版本也可(现在才发现SecureCRT.6.2.0) 可是换为 6.7.1 后就怎么也注冊不了了.. 没办法试了各种办法: 先 ...
- [渣译文] SignalR 2.0 系列: 开始使用SignalR 2.0
原文:[渣译文] SignalR 2.0 系列: 开始使用SignalR 2.0 英文渣水平,大伙凑合着看吧…… 这是微软官方SignalR 2.0教程Getting Started with ASP ...
- 【翻译】要理解Ext JS 5小工具
原版的:Understanding Widgets in Ext JS 5 在Ext JS 5,引入了新的"widgetcolumn",支持在网格的单元格中放置组件. 同一时候,还 ...
- telnet发电子邮件
无聊今天的工作,想想一个学生被提到最后一次telnet发电子邮件,所以我想试试.最后,成功的实践,这里做个总结. 首先,cmd进telnet打开回话: 下面红色字体为命令. 1.open smtp.1 ...
- DOM对象本身也是一个js对象,所以严格来说,并不是操作这个对象慢,而是说操作了这个对象后,会触发一些浏览器行为(转)
一直都听说DOM很慢,要尽量少的去操作DOM,于是就想进一步去探究下为什么大家都会这样说,在网上学习了一些资料,这边整理出来. 首先,DOM对象本身也是一个js对象,所以严格来说,并不是操作这个对象慢 ...
- Unity该插件NGUI得知(9)—— Tween并转换成世界坐标系的大小NGUI尺寸
在游戏中,还有一种比较常见的动画,这是进球后产生,分数将被显示在游戏,而快速移动,使其失去位置加入.就打算使用NGUI的Tween来制作这样的分数动画效果. 依据 Unity插件之NGUI学习(2), ...