為 Oracle Database 開發 WCF Data Services 和 OData 應用程式

標籤：

為 Oracle Database 開發 WCF Data Services 和 OData 應用程式

本教程包含以下部分：

	目的
	所需時間
	概述
	先決條件
	建立新的網站項目
	建立新的 ADO.NET 實體資料模型
	使用 EDM 資料建立 WCF Data Services
	總結

為 Oracle Database 開發 WCF Data Services 和 OData 應用程式目的

本教程介紹如何使用 Visual Studio 為 Oracle Database 開發 WCF Data Services 和開放資料協議 (OData) 應用程式。

所需時間

大約 15 分鐘

概述

Microsoft WCF Data Services 支援建立和使用 Web 資料服務。為此，它使用 OData 將資料公開為可通過 URI 定址的資源，如網站 URL。應用於 Microsoft Entity Framework 的實體資料模型 (EDM) 可以通過 WCF Data Services 和 OData 來公開資料，以使 EDM 得到更廣泛的使用。

在本教程中，您將瞭解如何通過 Oracle 的 Entity Framework 支援來利用 WCF Data Services 和 OData 公開 Oracle 資料庫資料。

首先從 HR 模式建立一個新的 EDM。接下來，建立一個 WCF Data Services，它利用 OData 通過 Web 來公開這個 EDM。最後，運行 Web 應用程式並執行 URL 查詢從資料庫中檢索資料。

先決條件

開始本教程之前，您應該：

1.	安裝 Microsoft Visual Studio 2010 以及 .NET Framework 4 或更高版本。
2.	安裝 Oracle Database 10.2 或更高版本，或者安裝 Oracle Database XE。
3.	從 OTN 安裝 Oracle 11g Oracle Data Access Components (ODAC) 11.2.0.2.30 或更高版本。ODAC 下載包括本教程中將使用的 Oracle Developer Tools for Visual Studio 和 ODP.NET。
4.	安裝 Internet Explorer 7 或更高版本，或任何支援現代 Web 協議的瀏覽器。
5.	將這些檔案解壓縮到工作目錄中。

建立新的網站項目

1.	開啟 Visual Studio。單擊 File。選擇 New > Web Site。
2.	選擇 ASP.NET Web Site 並單擊 OK。現在已經建立了一個新的 ASP.NET Web Site 項目。

建立新的 ADO.NET 實體資料模型

要通過 WCF Data Services 公開 Oracle 資料，需要一個 EDM。在本部分中，您將使用 Entity Data Model Wizard 基於 HR 模式中的 EMPLOYEES 表建立一個 EDM。

1.	在 Solution Explorer 中，按右鍵新建立的網站項目。選擇 Add New Item。
2.	選擇 ADO.NET Entity Data Model 並單擊 Add。
3.	單擊對話方塊中的 Yes。
4.	在 Entity Data Model Wizard 中，選擇 Generate from database 並單擊 Next。
5.	如果您還沒有 HR 資料連線，則單擊 New Connection。選擇一個可用的資料來源名稱，如 ORCL。輸入 HR 作為 User Name，並輸入口令。單擊 OK。 如果已經有了 HR 串連，則選擇該資料連線，如螢幕中所示的 HR.ORCL。選擇 Yes, include the sensitive data in the connection string。單擊 Next。
6.	選擇要映射到 EDM 的 Oracle 表。展開 Tables 節點，選擇 EMPLOYEES。單擊 Finish。
7.	將顯示 Model.edmx 頁面，其中包含新建立的 EDM。

使用 EDM 資料建立 WCF Data Services

在本部分中，您將建立一個 WCF Data Services。然後配置該資料服務，使之利用 EDM 從資料庫中檢索 EMPLOYEES 資料。最後，通過修改 URL 來執行查詢，從而利用瀏覽器來檢索 Oracle 資料。使用 OData 支援資料訪問。

1.	在 Solution Explorer 視窗中按右鍵，選擇 Add New Item。
2.	在 Online Templates 中選擇 WCF Data Service，然後單擊 Add。
3.	配置 WcfDataService.cs 字碼頁，檢索資料並提供存取權限。要為 WCFDataService :DataService 檢索資料，需要將 < /* TODO:put your data source class name here */> 替換為 <Model.Entities>。它是您剛建立的 EDM。 取消對 config.SetEntitySetAccessRule 的注釋，並將 "MyEntitySet" 替換為 "*"。單擊  運行應用程式。
4.	網站已開啟，地址欄顯示以下 URL：http://localhost:<連接埠名>/<網站項目名稱>/
5.	在 URL 中，在網站名稱的後面輸入 /WcfDataService.svc，就可以查看已經包含的實體了。
6.	在通過 URL 執行查詢前，確保已禁用了 Internet Explorer 的源閱讀檢視。否則，瀏覽器將把返回的 AtomPub 編碼文檔作為 XML 摘要，而不是顯示原始 XML 資料。 為此，執行以下步驟： 選擇 Tools > Internet Options
7.	選擇 Content 選項卡。從 Feeds and Web Slices 部分選擇 Settings。
8.	取消選中 Turn on feed reading view，然後單擊 OK。
9.	要通過 URL 執行一些查詢樣本，可以在您的工作目錄中開啟 Sample Queries - HR.txt。其中的連接埠號碼和網站項目名稱可能與您的項目不同。因此，這些查詢樣本只能用作指南，不能直接複製並粘貼到瀏覽器中。 要查詢 EMPLOYEES 實體，需要在 URL 中添加 /EMPLOYEES。網站將執行如下所示的查詢。
10.	要執行 EMPLOYEE_ID = 100 查詢，從 Sample Queries - HR.txt 複製 /EMPLOYEES(100M) 並粘貼到 URL 中。網站將執行如下所示的查詢。
11.	要查詢 EMPLOYEE_ID = 100 的 FIRST_NAME，從 Sample Queries - HR.txt 中複製/EMPLOYEES(100M)/FIRST_NAME 並粘貼到 URL 中。網站將執行如下所示的查詢。
12.	要查詢總行數，從 Sample Queries - HR.txt 中複製 /EMPLOYEES/$count 並粘貼到 URL 中。網站將執行如下所示的查詢。
13.	要查詢前兩名員工，從 Sample Queries - HR.txt 複製 /EMPLOYEES?$top=2 並粘貼到 URL 中。網站將執行如下所示的查詢。
14.	要查詢 LAST_NAME = KING 的 EMPLOYEES，從 Sample Queries - HR.txt 複製 /EMPLOYEES?$filter=LAST_NAME eq ‘King‘ 並粘貼到 URL 中。網站將執行如下所示的查詢。
15.	要查詢每個工資周期的工資超過 10000 的 EMPLOYEES，從 Sample Queries - HR.txt 複製 EMPLOYEES?$filter=SALARY gt 10000 並粘貼到 URL 中。網站將執行如下所示的查詢。

總結

在本教程中，您學習了如何：

• 在 Visual Studio 中建立新網站項目。
• 從 Oracle 模式建立新的 ADO.NET 實體資料項目。
• 使用 EDM 資料建立一個 Oracle WCF Data Services，並使用 OData 通過修改 URL 來執行各種查詢。

 

• 課程設計人員：Anupama Mandya
• 其他人員：Alex Keh

為 Oracle Database 開發 WCF Data Services 和 OData 應用程式