如何將 OData v3 升級為 OData v4

ASP.NET Web API 支援最高版本 OData 是 v4，但只能透過手動的方式建立，OData v3 就支援利用 scaffolding 來長出各個 table 的 OData endpoint ，加上 OData v3 到 OData v4 就連 namespace 都變了，NuGet package 也不同，無法單純升級 NuGet package 就可以搞定的，雖然可以手動慢慢建立也是解法，但身為一個高效工程師，一個個手動新增這種苦工絕對不是我們的作風，就來看看可以怎麼快速地將 OData v3 升級為 OData v4

前提設定

已經使用 EntityFramework 設定與 DB 連線，並透過預設 scaffolding template 建立 ASP.NET Web API OData v3 controller

升級作法

安裝 Microsoft.AspNet.OData 套件
這是專屬 OData v4 的套件名稱
修改 controller
- 使用 odata v4 namespace
  - 原語法
```
using System.Web.Http.OData;
```
  - 新語法
```
using System.Web.OData;
```
- 調整為 odata v4 寫法
  - 原語法
    用於 Put 與 Patch
```
Validate(patch.GetEntity());
```
  - 新語法
```
Validate(patch);
```

修改 WebApiConfig OData 註冊

使用 odata v4 namespace

原語法

using System.Web.Http.OData.Builder;
using System.Web.Http.OData.Extensions;

新語法

using System.Web.OData.Builder;
using System.Web.OData.Extensions;

調整為 odata v4 註冊語法

原語法

config.Routes.MapODataServiceRoute("odata", "odata", builder.GetEdmModel());

新語法

config.MapODataServiceRoute("odata", "odata", builder.GetEdmModel());

可能出現： The entity 'xxx' does not have a key defined.

錯誤訊息

The entity 'Orders' does not have a key defined.
        
Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code. 
        
Exception Details: System.InvalidOperationException: The entity 'Orders' does not have a key defined.
        
Source Error: 
            
Line 47: 
Line 48:             
Line 49:             config.MapODataServiceRoute("odata", "odata", builder.GetEdmModel());
Line 50:         }
Line 51:     }
        
Source File: C:\Users\YowkoTsai\Documents\Visual Studio 2017\Projects\TestNLog\TestOData3\App_Start\WebApiConfig.cs    Line: 49