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來通過工號查詢人員資訊，因為沒有統一的規範。

第三方客戶端在實現遠端呼叫的時候就必須考慮這些API的差異，分別檢視A，B的API文件。

如果有個權威性協議作為規範做指導，規定這個API應該實現成下面這樣，那麼第三方客戶端也只需按照這個標準去呼叫遠端API，而不用檢視A，B的API文件：

解釋了這麼多，就是為了引出：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

using System;
using System.Collections.Generic;
using System.Data;
using System.Data.Entity;
using System.Data.Entity.Infrastructure;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Threading.Tasks;
using System.Web.Http;
using System.Web.Http.ModelBinding;
using ODataAPI.Models;
using System.Web.OData;

namespace ODataAPI.Controllers
{
    /*
    To add a route for this controller, merge these statements into the Register method of the WebApiConfig class. Note that OData URLs are case sensitive.

    using System.Web.Http.OData.Builder;
    using ODataAPI.Models;
    ODataConventionModelBuilder builder = new ODataConventionModelBuilder();
    builder.EntitySet<Product>("Products");
    config.Routes.MapODataRoute("odata", "odata", builder.GetEdmModel());
    */
    public class ProductsController : ODataController
    {
        private ODataAPIContext db = new ODataAPIContext();

        // GET odata/Products
        //[Queryable]
        [EnableQuery]
        public IQueryable<Product> GetProducts()
        {
            return db.Products;
        }

        // GET odata/Products(5)
        //[Queryable]
        [EnableQuery]
        public SingleResult<Product> GetProduct([FromODataUri] int key)
        {
            return SingleResult.Create(db.Products.Where(product => product.ID == key));
        }

        // PUT odata/Products(5)
        public async Task<IHttpActionResult> Put([FromODataUri] int key, Product product)
        {
            if (!ModelState.IsValid)
            {
                return BadRequest(ModelState);
            }

            if (key != product.ID)
            {
                return BadRequest();
            }

            db.Entry(product).State = EntityState.Modified;

            try
            {
                await db.SaveChangesAsync();
            }
            catch (DbUpdateConcurrencyException)
            {
                if (!ProductExists(key))
                {
                    return NotFound();
                }
                else
                {
                    throw;
                }
            }

            return Updated(product);
        }

        // POST odata/Products
        public async Task<IHttpActionResult> Post(Product product)
        {
            if (!ModelState.IsValid)
            {
                return BadRequest(ModelState);
            }

            db.Products.Add(product);
            await db.SaveChangesAsync();

            return Created(product);
        }

        // PATCH odata/Products(5)
        [AcceptVerbs("PATCH", "MERGE")]
        public async Task<IHttpActionResult> Patch([FromODataUri] int key, Delta<Product> patch)
        {
            if (!ModelState.IsValid)
            {
                return BadRequest(ModelState);
            }

            Product product = await db.Products.FindAsync(key);
            if (product == null)
            {
                return NotFound();
            }

            patch.Patch(product);

            try
            {
                await db.SaveChangesAsync();
            }
            catch (DbUpdateConcurrencyException)
            {
                if (!ProductExists(key))
                {
                    return NotFound();
                }
                else
                {
                    throw;
                }
            }

            return Updated(product);
        }

        // DELETE odata/Products(5)
        public async Task<IHttpActionResult> Delete([FromODataUri] int key)
        {
            Product product = await db.Products.FindAsync(key);
            if (product == null)
            {
                return NotFound();
            }

            db.Products.Remove(product);
            await db.SaveChangesAsync();

            return StatusCode(HttpStatusCode.NoContent);
        }

        protected override void Dispose(bool disposing)
        {
            if (disposing)
            {
                db.Dispose();
            }
            base.Dispose(disposing);
        }

        private bool ProductExists(int key)
        {
            return db.Products.Count(e => e.ID == key) > 0;
        }
    }
}

另外，我們可以通過VS的OData Controller模板來建立webAPIController（如下）。注意使用這種方式建立webAPIController時，不可以匯入WebApi 2.2 for OData v4.0這個類庫，否則會出現dll衝突。