ASP.NET Core Web API 中使用Oracle数据库和Dapper看这篇就够了

文章地址： https://www.cnblogs.com/yilezhu/p/9276565.html

园子里关于ASP.NET Core Web API的教程很多，但大多都是使用EF+Mysql或者EF+MSSQL的文章。甚至关于ASP.NET Core Web API中使用Dapper+Mysql组合的文章都很少，更别提Oracel+Dapper组合的文章了，那么今天就带着大家一起翻译一篇国外大牛写的关于ASP.NET Core Web API 开发中使用Oracle+Dapper的组合的文章吧。

注：虽然本文内容是翻译，但是楼主刚在2.1环境是使用成功，中间也没有任何阻碍，只是鉴于本人电脑配置太差无法安装Oracle数据库，所以无法进行演示，再者是表示对原作者的尊重，所以在这里只是对原作内容进行翻译然后加上自己的理解稍作改动。应该能对大家使用Oracle+Dapper组合开发ASP.NET Core Web API 有所帮助。

本文的重点是介绍如何使用Dapper ORM+Oracle数据库的组合来创建ASP.NET Core Web API。首先，在这里，我们不使用SQL ，因为互联网上已有很多文章都是使用SQL Server进行演示的。所以，我想写一篇使用Oracle作为数据库的文章。为了降低数据库访问逻辑的复杂性，我们使用Dapper ORM。那么，让我们赶紧开始实战演练吧。

创建一个ASP.NET Core Web API 项目

如果要创建一个新的ASP.NET Core Web API项目的话，只需要打开Visual Studio 2017版本15.3及以上，然后按照以下步骤操作。

打开文件菜单，点击新建>>项目

在新打开的新建项目窗口，首先你需要选择 .NET Framework 4.6及以上版本，然后在左侧面板选择C# ,然后选择 .NET Core

在右侧面板中选择“.NET Core Web 应用程序” 并且选择项目位置，最后点击“确定”

在下一个窗口，在众多模板中选择Web API模板

写如何新建ASP.NET Core Web API 的这些步骤的时候我都嫌累，我想大家应该都知道怎么创建吧！就不上图片了。

设置Oracle表和存储过程

首先要为演示创建数据库以及表，我们这里使用Oracle Developer Tools。因为它非常小巧灵活，可以帮助我们顺利的处理Oracle数据库。
Oracle SQL Developer是一个免费的集成开发环境，可简化传统和云部署中Oracle数据库的开发和管理。SQL Developer提供完整的PL / SQL应用程序端到端开发，运行查询和脚本的工作表，用于管理数据库的DBA控制台，报告界面，完整的数据建模解决方案以及用于迁移第三方数据到Oracle的平台。
创建一个名为“TEST_DB”的数据库名称，并在其中创建一个表名为“EMPLOYEE”。您可以使用以下语法在“TEST_DB”数据库中创建表。

CREATE TABLE "TEST_DB"."EMPLOYEE" ( "ID" NUMBER(10,0) GENERATED BY DEFAULT ON NULL AS IDENTITY MINVALUE 1 MAXVALUE 9999999999999999999999999999 INCREMENT BY 1 START WITH 100 CACHE 20 NOORDER NOCYCLE , "NAME" VARCHAR2(255 BYTE), "SALARY" NUMBER(10,0), "ADDRESS" VARCHAR2(500 BYTE) ) SEGMENT CREATION IMMEDIATE PCTFREE 10 PCTUSED 40 INITRANS 1 MAXTRANS 255 NOCOMPRESS LOGGING STORAGE(INITIAL 65536 NEXT 1048576 MINEXTENTS 1 MAXEXTENTS 2147483645 PCTINCREASE 0 FREELISTS 1 FREELIST GROUPS 1 BUFFER_POOL DEFAULT FLASH_CACHE DEFAULT CELL_FLASH_CACHE DEFAULT) TABLESPACE "TEST_DATA" ;

我们需要在表中添加一些虚拟数据，以便我们可以直接从PostMan获取数据。所以，我们在这里添加四条记录如下。

Insert into TEST_DB.EMPLOYEE (ID,NAME,SALARY,ADDRESS) values (100,'Mukesh',20000,'India'); Insert into TEST_DB.EMPLOYEE (ID,NAME,SALARY,ADDRESS) values (101,'Rion',28000,'US'); Insert into TEST_DB.EMPLOYEE (ID,NAME,SALARY,ADDRESS) values (102,'Mahesh',10000,'India'); Insert into TEST_DB.EMPLOYEE (ID,NAME,SALARY,ADDRESS) values (103,'Banky',20000,'India');

现在我们来创建一个存储过程，用来获取员工记录列表。这里我们使用Cursor返回数据列表作为输出参数。

CREATE OR REPLACE PROCEDURE "TEST_DB"."USP_GETEMPLOYEES" ( EMPCURSOR OUT SYS_REFCURSOR ) AS Begin Open EMPCURSOR For SELECT ID, NAME, SALARY,ADDRESS FROM Employee; End;

下面我们再创建一个存储过程，它根据员工ID获取员工的个人记录

CREATE OR REPLACE PROCEDURE "TEST_DB"."USP_GETEMPLOYEEDETAILS" ( EMP_ID IN INT, EMP_DETAIL_CURSOR OUT SYS_REFCURSOR ) AS BEGIN OPEN EMP_DETAIL_CURSOR FOR SELECT ID, NAME, SALARY,ADDRESS FROM Employee WHERE ID = EMP_ID; END; 安装Dapper ORM

从“工具”菜单的“Nuget包管理器”中打开“包管理器控制台”，然后输入以下命令并按Enter键以安装dapper及其依赖项（如果有）

Install-Package Dapper -Version 1.50.5
当然还有另一个安装方式，具体可以看 [ASP.NET Core WebApi使用Swagger生成api说明文档看这篇就够了][] 中关于安装Swashbuckle.AspNetCore的步骤
安装完成后，你可以查看下项目大的引用中，是否有“Dapper”的引用，如果有的话表示安装正确

为项目安装Oracle Manage Data Access