在.NET开发面向Oracle数据库的应用程序

其实这个不是一个什么新的话题。但是之前在多次项目中，总是遇到大家针对Oracle数据库的访问时，会有各种各样的问题，最基本的就是要在客户端安装各种client，版本不一样的话还有各种问题。

静下心来看看，其实也没有那么难。我这里总结一下，如何在.NET应用程序中，简单优雅地使用Oracle数据库。

第一个原则：不要依赖

最好的情况就是，程序自己就可以完成数据访问，不需要额外地安装所谓的Oracle Client，那是一个很麻烦而且痛苦的事情。

我们首先看看，如果不装任何东西，是否可以实现Oracle数据库访问？

其实，.NET本身是自带了针对Oracle数据库访问的组件的，就是下面这个System.Data.OracleClient

我们的代码如下(这是最原始的ADO.NET代码，只是做演示）

using System;
using System.Data.OracleClient;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            var connectionString = "user id=system;password=password;data source=192.168.56.101:1521/orcl";

            using (var connection = new OracleConnection(connectionString))
            {
                var cmd = connection.CreateCommand();
                cmd.CommandText = "select * from sys.dba_all_tables";
                connection.Open();
                var reader = cmd.ExecuteReader();
                while (reader.Read())
                {
                    Console.WriteLine(reader.GetString(0));

                }

                reader.Close();
                connection.Close();

            }
           
        }
    }
}

 

看起来应该是没有问题的，运行起来却会报错

Additional information: System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.

这里的提示就是说，需要有Oracle Client。

这不是我们希望看到的结果。实际上原理上说，我们这么理解吧，可能是这个组件只是一个wrapper，它实际去操作数据库，还需要通过Oracle Client才能实现。

 

使用Oracle提供的组件

更好的建议就是，使用Oracle 官方提供的托管代码组件。Oracle.ManagedDataAccess.dll

只要添加了这个Nuget Package，代码几乎不需要任何改动，直接就可以复用。

using System;
using Oracle.ManagedDataAccess.Client;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            var connectionString = "user id=system;password=password;data source=192.168.56.101:1521/orcl";

            using (var connection = new OracleConnection(connectionString))
            {
                var cmd = connection.CreateCommand();
                cmd.CommandText = "select * from sys.dba_all_tables";
                connection.Open();
                var reader = cmd.ExecuteReader();
                while (reader.Read())
                {
                    Console.WriteLine(reader.GetString(0));

                }

                reader.Close();
                connection.Close();

            }
           
        }
    }
}

 

当然比较理想的情况是将连接字符串之类的，可以放在配置文件中去。这个很简单，这里就不说明了。

 

结合Entity Framework使用

Entity Framework 出来已经好多年了，几乎成了所有.NET应用程序中的标配（不管有没有用到）。现在的最新版本应该是 6.1.3 .同时，需要注意的是，以后会有一个所谓的Entity Framework Core ，而且开源了 https://github.com/aspnet/EntityFramework

回到正题，之前的代码写法其实还是比较原始的，那么如何结合Entity Framework进行Oracle数据库方面的编程呢？

首先，安装下面的这个组件：Oracle.ManagedDataAccess.EntityFramework

然后，可以使用Code first的方式编写如下代码

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
using System.Data.Entity;

namespace ConsoleApplication
{
    public class OracleContext : DbContext
    {
        public OracleContext() : base("OracleDbContext")
        {

        }

        public DbSet<Employee> Employees { get; set; }

    }

    [Table("EMPLOYEES", Schema = "SYSTEM")]
    public class Employee
    {
        [Key()]
        [Column("EMPLOYEEID")]
        public int EmployeeID { get; set; }

        [Column("FIRSTNAME")]
        public string FirstName { get; set; }
        [Column("LASTNAME")]
        public string LastName { get; set; }
    }
}

 

 

这里的代码没有什么出奇的。配置文件需要有如下的设置（一般在添加Oracle.ManagedDataAccess.EntityFramework 这个组件的时候，会自动修改配置文件）

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="oracle.manageddataaccess.client" type="OracleInternal.Common.ODPMSectionHandler, Oracle.ManagedDataAccess, Version=4.121.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342" />
    <section name="entityFramework" type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
    <!-- For more information on Entity Framework configuration, visit http://go.microsoft.com/fwlink/?LinkID=237468 -->
  </configSections>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2" />
  </startup>
  <oracle.manageddataaccess.client>
    <version number="*">
      <dataSources>
        <dataSource alias="oracle" descriptor="(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=192.168.56.101)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCL))) " />
             </dataSources>
    </version>
  </oracle.manageddataaccess.client>
  <connectionStrings>
    <add name="OracleDbContext" connectionString="user id=system;password=password;data source=oracle" providerName="Oracle.ManagedDataAccess.Client" />
  </connectionStrings>
  <system.data>
    <DbProviderFactories>
      <remove invariant="Oracle.ManagedDataAccess.Client" />
      <add name="ODP.NET, Managed Driver" invariant="Oracle.ManagedDataAccess.Client" description="Oracle Data Provider for .NET, Managed Driver" type="Oracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess, Version=4.121.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342" />
    </DbProviderFactories>
  </system.data>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <publisherPolicy apply="no" />
        <assemblyIdentity name="Oracle.ManagedDataAccess" publicKeyToken="89b483f429c47342" culture="neutral" />
        <bindingRedirect oldVersion="4.121.0.0 - 4.65535.65535.65535" newVersion="4.121.2.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
  <entityFramework>
    <defaultConnectionFactory type="System.Data.Entity.Infrastructure.LocalDbConnectionFactory, EntityFramework">
      <parameters>
        <parameter value="v13.0" />
      </parameters>
    </defaultConnectionFactory>
    <providers>
      <provider invariantName="Oracle.ManagedDataAccess.Client" type="Oracle.ManagedDataAccess.EntityFramework.EFOracleProviderServices, Oracle.ManagedDataAccess.EntityFramework, Version=6.121.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342" />
      <provider invariantName="System.Data.SqlClient" type="System.Data.Entity.SqlServer.SqlProviderServices, EntityFramework.SqlServer" />
    </providers>
  </entityFramework>
</configuration>

后台数据库的表格设计也是很简单。

需要注意的是，经过实验，我发现目前这个Entity Framework要求所操作的表必须要有主键，而且主键必须是一个identity column（即自己绑定一个序列，实现自动增长），否则会报错

实际上后台会通过一个触发器来实现这个功能

create or replace TRIGGER EMPLOYEES_TRG
BEFORE INSERT ON EMPLOYEES
FOR EACH ROW
BEGIN
  <<COLUMN_SEQUENCES>>
  BEGIN
    IF INSERTING AND :NEW.EMPLOYEEID IS NULL THEN
      SELECT EMPLOYEES_SEQ.NEXTVAL INTO :NEW.EMPLOYEEID FROM SYS.DUAL;
    END IF;
  END COLUMN_SEQUENCES;
END;

 

接下来在前端程序中就简单多了，下面是一个代码片段

var ctx = new OracleContext();

ctx.Employees.Add(new Employee() {FirstName = "ares", LastName = "chen" });
ctx.SaveChanges();

var query = ctx.Employees.ToArray();
foreach (var item in query)
{
    Console.WriteLine(item);
}

 

需要注意的是，如果需要使用Entity Frmaework的Database first或Model first的功能，还是需要安装Oracle Client，或者准确地说应该是ODAC组件

http://www.oracle.com/technetwork/developer-tools/visual-studio/downloads/index.html