专栏首页SAP Technical带你了解OData

带你了解OData

What – OData是什么?

OData - Open Data Protocol,是一个设计和使用RESTful API的标准。REST本身只是一个构建web服务的思想和理念,其没有规定一个统一的标准来限制开发人员该如何设计RESTful API。其实我们实际开发中的确也没有遵循某个统一的标准去设计WebAPI。因为大多数场景下,遵循一个统一的标准并不是必要的。但在某些场景下,有这样一个标准却能带来很大的好处。

OData的理想是, 无论哪个组织构建的RESTful API,只要其符合OData标准。其他组织就可以按照OData标准中定义的方式去使用这个API获取/修改资源。这个可以类比SQL标准之于RDBMS关系。无论什么关系型数据库,如果其声称支持SQL 标准,任何人就可以使用标准SQL查询语句来查询数据。

标准化的另一个好处:可以将Odata协议实现到一个通用的类库中,通过这个类库去创建和访问RESTful API可以减少开发人员的工作量。官网上有很多这样的组件。

Who - 谁发布了OData?

该标准由微软发起,前三个版本1.0、2.0、3.0都是微软开放标准。

When - 什么时候成为了工业标准?

第四个版本4.0于2014年3月17日在OASIS投票通过成为开放工业标准

Why – 为什么需要OData?

OData是一个协议,一个标准。所以这个问题等同于为什么我们需要协议。类比TCP协议就可以理解一般。假设你开发的组件必须要和某个第三方组件通信,如果第三方组件不支持TCP而只支持其内部开发的一个私有协议,你就肯定头大了,你必须在你的组件里单独为其实现这个私有协议。如果大家都支持TCP协议,不就省事了么。这就是标准协议的作用:协议和标准用于制定一个统一通用的规则。 我们只需要按照这个协议或标准生产组件,那么这个组件就可以方便的和其他组件集成/协作。而无须根据其他组件的私有标准定制化组件。

前面说到Rest只是一种设计Web服务的思想,不是一种标准化的协议。正由于缺乏标准化,从而导致各家公布的Restful API 统一通用方面的欠缺。OData就是为弥补这种欠缺而被提出来的标准协议。

下面全是延伸阅读可略过。

Web服务有两种实现方式,一是SOAP协议方式,二是REST方式。SOAP是一套完整的实现Web服务的解决方案。这里有必要先简单了解SOAP方式的Web服务,然后对比SOAP方式,我们会发现REST方式欠缺了什么。

SOAP方式的Web服务中的Web服务描述语言(WSDL)和简单对象访问协议(SOAP)一起构成了SOAP方式下的Web服务的结构单元。客户端通过WSDL可以了解Web服务公开了那些可以被执行的方法以及Web服务可以发送或接收的消息格式(解决了公布访问资源方法的问题)。客户端按照SOAP将调用位于远程系统上的服务所需信息序列化为消息(解决了如何调用远程方法的问题)。注意WSDL描述的服务以及SOAP消息都是符合统一标准的,都是机器可读的.

WSDL基于XML格式,用来描述Web服务。WSDL文档可以看成是客户端和服务器之间的一个协约。使用WSDL工具,你可以自动处理这个过程,几乎不用手工编写代码就能够让应用程序整合新的服务。因此WSDL是Web服务体系结构的基础,因为它提供了一个通用语言,用来描述服务和整合这些服务的平台。

SOAP本身提供了与Web服务交换信息的方法。SOAP是序列化调用位于远程系统上的服务所需信息的标准方法,这些信息可以使用一种远程系统能够读懂的格式通过网络发送到远程系统,而不必关心远程系统运行于何种平台或者使用何种语言编写。SOAP以XML格式提供了一个简单、轻量的用于在分散或分布环境中交换结构化和类型信息的机制。实际上它通过提供一个有标准组件的包模型和在模块中编码数据的机制,定义了一个简单的表示应用程序语义的机制。

对照SOAP方式的Web服务,REST中没有用于描述资源(服务)列表,资源元数据的类似于WSDL的东东。所以有人在2009年提出了一个标准WADL去描述REST方式的Web服务,但至今没有被标准化。个人认为使用WSDL/WADL去描述REST方式的Web服务太别扭,这是典型的RPC思路,而REST是一种把服务抽象为资源的架构思想。用描述RPC的WSDL去描述REST方式的Web服务并不合适。我们需要其他策略去代替WSDL实现“公布访问资源方法的问题”。

由于没有类似于SOAP的权威性协议作为规范,因此各个网站的REST实现都自有一套,也正是因为这种各自实现的情况,在性能和可用性上会大大高于SOAP发布的web service,但细节方面有太多没有约束的地方,其统一通用方面远远不及SOAP。

举个例子:假设A组织,B组织都实现了Restful API来通过工号查询人员信息,因为没有统一的规范。

A的API 可能是这样:http://A/api/person/001

B的API 可能是这样:http://A/api/person/id=001

第三方客户端在实现远程调用的时候就必须考虑这些API的差异,分别查看A,B的API文档。

如果有个权威性协议作为规范做指导,规定这个API应该实现成下面这样,那么第三方客户端也只需按照这个标准去调用远程API,而不用查看A,B的API文档:

http://A/api/person/{001}

解释了这么多,就是为了引出:OData是这样的一个设计和使用Restful API 的权威性协议. OData定义了一些标准规则(像一个接口定义一堆方法一样),实现Restful API时候,必须实现这些标准规则(就像实现一个接口必须实现其所有方法一样)。第三方就可以根据Odata协议定义的规则去访问Restful API。

Where –什么样的场景下可以考虑使用OData?

并不是说你创建的所有RESTful API都需要符合OData协议。只有在需要Open Data(开放数据给其他组织)时候,才有必要按照OData协议设计RESTful API。这里的Open Data是指开放数据给第三方使用,并且你并不知道谁是第三方。比如博客园的RSS,谁订阅了RSS,博客园是不清楚的。如果你的数据只被你自家公司的客户端使用, OData就是一个可选项,你完全有理由不按照OData规范去设计RESTful API。

How – 如何使用OData?

首先看一下C#客户端调用符合OData标准的WebApi是多么的方便(官网http://www.odata.org/上也有js的类库)。

第一步,通过Nuget安装OData Client for .Net包。

第二步,安装VS插件:OData v4 Client Code Generator。

第三步:假设存在一个可用的WebApi(后面介绍如何创建) - http://localhost:33189/Odata. 我们修改代码模板中的MetadataDocumentUri如下, 然后保存。T4会访问http://localhost:33189/Odata获得资源的元数据,然后根据元数据生成资源对应的C#类。T4可以怎么做是因为WebApi是按照OData的标准去公布资源列表和资源的元数据。

第四步:在我们的代码中就可以操作CLR对象来消费远程的webAPI了。体验到Odata标准的力量了吧。

接下来看一下C#服务端如何实现上面客户端需要调用的OData的WebAPI,有两种方式,有点细微的差别。

第一步:创建一个空的WebApi项目。

第二步: 通过Nuget引入EF6 和 WebApi 2.2 for OData v4.0. 如下图。

第三步:创建Entity和DbContext类,以及配置数据库连接。并通过enable migration完成数据库的创建,可在Configuration的seed的方法中,添加一些初始化的数据。

第四步:配置WebApiConfig如下

第五步:创建ProductsController

View Code

第六步:F5运行,接着客户端就可以调用了。可以通过访问http://localhost:#/OData/http://localhost:#/OData/$metadata 看看resource list 和元数据长什么样。

另外,我们可以通过VS的OData Controller模板来创建webAPIController(如下)。注意使用这种方式创建webAPIController时,不可以导入WebApi 2.2 for OData v4.0这个类库,否则会出现dll冲突。

本文参与 腾讯云自媒体分享计划 ,欢迎热爱写作的你一起参与!
本文分享自作者个人站点/博客:https://blog.csdn.net/SAPmatinal复制
如有侵权,请联系 cloudcommunity@tencent.com 删除。
登录 后参与评论
0 条评论

相关文章

  • OData – the best way to REST–实例讲解ASP.NET WebAPI OData (V4) Service & Client

    一、概念介绍 1.1,什么是OData? 还是看OData官网的简单说明: An open protocol to allow the creation and...

    用户1177503
  • 微软大力支持开放数据协议(OData)

    InfoQ有篇文章OData是应用程序协作的通用语言吗?,文章中提到了什么是OData:开放数据协议(OData)是一个查询和更新数据的Web协议。OData应...

    张善友
  • Asp.Net Web API 2第十八课——Working with Entity Relations in OData

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

    aehyok
  • Asp.Net Web API 2第十七课——Creating an OData Endpoint in ASP.NET Web API 2(OData终结点)

      很久没更新博客了,加上刚过年,现在准备重新开战,继续自己的学习之路。本文已同步到Web API2系列文章中http://www.cnblogs.com/ae...

    aehyok
  • 在FPGA中何时用组合逻辑或时序逻辑

    本系列将带来FPGA的系统性学习,从最基本的数字电路基础开始,最详细操作步骤,最直白的言语描述,手把手的“傻瓜式”讲解,让电子、信息、通信类专业学生、初入职场小...

    FPGA技术江湖
  • PGA零基础学习:FPGA在FPGA中何时用组合逻辑或时序逻辑

    本系列将带来FPGA的系统性学习,从最基本的数字电路基础开始,最详细操作步骤,最直白的言语描述,手把手的“傻瓜式”讲解,让电子、信息、通信类专业学生、初入职场小...

    FPGA技术江湖
  • 基于FPGA的多路选择器设计(附代码)

    大侠好,欢迎来到FPGA技术江湖。本系列将带来FPGA的系统性学习,从最基本的数字电路基础开始,最详细操作步骤,最直白的言语描述,手把手的“傻瓜式”讲解,让电子...

    FPGA技术江湖
  • FPGA零基础学习:基于FPGA的多路选择器设计(附代码)

    大侠好,欢迎来到FPGA技术江湖。本系列将带来FPGA的系统性学习,从最基本的数字电路基础开始,最详细操作步骤,最直白的言语描述,手把手的“傻瓜式”讲解,让电子...

    FPGA技术江湖
  • SAP C/4HANA Sales Cloud使用OData服务和第三方系统集成的一个具体例子

    以前Jerry曾经介绍过SAP C/4HANA的五朵云到底包含哪些具体产品,其实在SAP官网上有更权威的中文解释:

    Jerry Wang
  • SAP C/4HANA Sales Cloud使用OData服务和第三方系统集成的一个具体例子

    以前Jerry曾经介绍过SAP C/4HANA的五朵云到底包含哪些具体产品,其实在SAP官网上有更权威的中文解释:

    Jerry Wang
  • python json.dumps中文乱码问题解决

    json.dumps(var,ensure_ascii=False)并不能解决中文乱码的问题

    砸漏
  • ASP.NET Web API对OData的支持

    在SOA的世界中,最重要的一个概念就是契约(contract)。在云计算的世界中,有关通信的最重要的概念也是契约。XML具有强大对数据的描述能力,Atom格式和...

    张善友
  • 使用SAP API portal进行SAP SuccessFactors的API测试

    登录api.sap.com, 根据关键字SuccessFactors找到对应的API目录:

    Jerry Wang
  • 【API架构】REST API 行业辩论:OData vs GraphQL vs ORDS

    本文比较了标准 API 和服务,以通过 Internet 查询数据以进行分析、集成和数据管理。

    首席架构师智库
  • 使用OData协议查询Windows日志

    OData开放数据协议是微软针对Google的GData推出的,旨在推广Web程序数据库格式标准化的开放数据协议,微软将 OData 定义为基于 HTTP、A...

    张善友
  • 使用SAP API portal进行SAP SuccessFactors的API测试

    登录api.sap.com, 根据关键字SuccessFactors找到对应的API目录:

    Jerry Wang
  • WCF Data Service QuickStart

    开放数据协议(OData)是一个查询和更新数据的Web协议。OData是基于诸如HTTP和AtomPub的国际标准创建的,它提供了一个跨平台的数据通信的方案。O...

    张善友
  • 使用SAP OData服务创建销售订单

    以SAP Cloud for Customer的OData服务为例。尽管我们可以直接用SAP提供的标准OData服务,这个链接能看到SAP C4C提供的所有...

    Jerry Wang
  • 重新带你了解React.js

    走进 前端学习 React.js,你了解吗? 在进入react.js的讲解之前吗,我们现在了解下2018年react.js的发展趋势吧。 React Nativ...

    企鹅号小编

扫码关注云+社区

领取腾讯云代金券