前言
虽然一直在说“去IOE化”,但是在国企和政府,Oracle的历史包袱实在太重了,甚至很多业务逻辑都是写在Oracle的各种存储过程里面实现的……
我们的系统主要的技术栈是Django / Spring / AspNetCore,Java的不必说对Oracle支持肯定没问题,关键在于Django对Oracle版本有要求,兼容性不是特别好,Oracle版本没办法随意升级的,所以我想到用.Net Core来写个中间层,让其他系统可以方便的使用Oracle的数据和存储过程…
ODP.NET Core是一个ADO.NET驱动程序,提供从Microsoft .NET Core客户端到Oracle数据库的快速数据访问。它可以在Windows和Linux上运行。ODP.NET由一个100%托管代码动态链接库Oracle.ManagedDataAccess.dll组成,可通过NuGet安装获得。
这个 Oracle.ManagedDataAccess.Core 是真的方便,不用安装Oracle客户端,兼容性、便捷性,反正就是开箱即用,一把梭就完事了
简单使用
首先用nuget安装这个 Oracle.ManagedDataAccess.Core ,之后就可以执各类操作了,不过从代码量上看还是比较繁琐的,上代码:
var connStr = $"DATA SOURCE=127.0.0.1/db_name; PASSWORD=password; PERSIST SECURITY INFO=True; USER ID=user_id"; using (var conn = new OracleConnection(connStr)) { using (var command = conn.CreateCommand()) { try { if (conn.State == ConnectionState.Closed) { conn.Open(); } command.BindByName = true; command.CommandText = $"select * from table_name"; using (var reader = command.ExecuteReader()) { while (reader.Read()) { Console.WriteLine(reader.GetString("DEPART_NAME")); } } } catch (Exception ex) { Console.WriteLine(ex.StackTrace); Console.WriteLine(ex.Source); Console.WriteLine(ex.Message); } } }
这就是执行 select * from table_name 这条SQL语句的代码,有点长…… 吐了
再看看执行存储过程的…
var connStr = $"DATA SOURCE=127.0.0.1/db_name; PASSWORD=password; PERSIST SECURITY INFO=True; USER ID=user_id"; using (var conn = new OracleConnection(connStr)) { conn.Open(); var command = new OracleCommand("proc_name", conn) { CommandType = CommandType.StoredProcedure }; // 输入参数 command.Parameters.Add(new OracleParameter("id", "0001")); // 输出参数 var vOut = new OracleParameter("v_out", OracleDbType.Varchar2, 1000, "", ParameterDirection.InputOutput ); command.Parameters.Add(vOut); var affectRows = command.ExecuteNonQuery(); Console.WriteLine(vOut.Value); }
这里去掉了错误处理,显得短一点,不过还是麻烦得不行……
所以这里我们要用Dapper这个轻量级ORM来简化操作
使用Dapper
不多说,首先nuget安装是常规操作,包名就是简单的 Dapper 。
首先是增删改查这类普通的SQL语句:
using Dapper; var connStr = $"DATA SOURCE=127.0.0.1/db_name; PASSWORD=password; PERSIST SECURITY INFO=True; USER ID=user_id"; using var cn = new OracleConnection(connStr); var result = cn.Query("select * from table_name"); foreach (var item in result) { Console.WriteLine(item); }
可以看到引入Dapper之后只要使用 OracleConnection 的扩展方法 Query 来执行SQL就行了~ 返回的结果是 IEnumerable<dynamic> 类型,当然你也可以在 Query 方法的泛型参数里指定返回的类型,我这里为了通用就不指定了
继续看存储过程的,很简单,更上面的差不多,就多一个参数告诉程序我们的SQL类型是啥而已
var connStr = $"DATA SOURCE=127.0.0.1/db_name; PASSWORD=password; PERSIST SECURITY INFO=True; USER ID=user_id"; using var cn = new OracleConnection(connStr); var result = cn.Query("proc_name", commandType: CommandType.StoredProcedure); foreach (var item in result) { Console.WriteLine(item); }
如果是有带参数的存储过程咋办?
很简单(代码来自官方例子)~
var user = cnn.Query<User>("spGetUser", new {Id = 1}, commandType: CommandType.StoredProcedure).SingleOrDefault();
ok,很方便,更多操作看Dapper文档就完事了(我也是第一次接触Dapper,之前都用FreeSQL和EFCore),此文完结~
Dapper项目主页: https://github.com/StackExchange/Dapper
参考资料
.NET Core 使用ODP.NET Core连接操作Oracle数据库: https://www.cjavapy.com/article/271/
元件開箱:Managed ODP.NET for Linux