为 Oracle Database 开发 WCF Data Services 和 OData 应用程序
本教程包含以下部分:
目的 | |
所需时间 | |
概述 | |
先决条件 | |
创建新的网站项目 | |
创建新的 ADO.NET 实体数据模型 | |
使用 EDM 数据创建 WCF 数据服务 | |
总结 |
为 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 数据服务,它利用 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 数据服务
在本部分中,您将创建一个 WCF 数据服务。然后配置该数据服务,使之利用 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 数据服务,并使用 OData 通过修改 URL 来执行各种查询。
- 课程设计人员:Anupama Mandya
- 其他人员:Alex Keh