Nanorm 0.1.2

Nanorm

适用于 ADO.NET 的小型数据访问帮助库。适合裁剪和原生 AOT。

它支持

• PostgreSQL 通过 Npgsql
• SQLite 通过 Microsoft.Data.SQLite
• 任何 ADO.NET 数据提供程序通过 System.Data.Common

如何使用

Nanorm 支持 .NET 6+，并特别支持 .NET 7+，这得益于 接口上的静态虚拟成员 和源生成器。

入门

1. 安装适合您所使用的 ADO.NET 提供程序（即数据库）的 Nanorm 代码包。在项目目录中使用 dotnet 命令行

   • PostgreSQL

     dotnet add package Nanorm.Npgsql --prerelease
     

   • SQLite

     dotnet add package Nanorm.Sqlite --prerelease
     

   • 所有其他 ADO.NET 提供程序

     dotnet add package Nanorm --prerelease
     

2. 创建一个 class、record 或 struct 来映射数据库查询结果。如果您正在使用 .NET 7 或 .NET 8，可以将其设置为 partial，并用 [DataRecordMapper] 属性进行装饰以启用源生成器，该生成器将为您实现 IDataRecordMapper<T> 接口。

   [DataRecordMapper]
   public partial class Todo
   {
       public int Id { get; set; }
   
       public required string Title { get; set; }
   
       public bool IsComplete { get; set; }
   }
   
   // Generated for you if .NET 7+, otherwise you'll need to write it yourself
   partial class Todo : IDataRecordMapper<Todo>
   {
       public static Todo Map(System.Data.IDataRecord dataRecord) =>
           new()
           {
               Id = dataRecord.GetInt32("Id"),
               Title = dataRecord.GetString("Title"),
               IsComplete = dataRecord.GetBoolean("IsComplete"),
           };
   }
   

3. 创建适当的 IDbConnection 实例并使用 Nanorm 扩展方法之一执行查询。 QueryAsync 方法返回 IAsyncEnumerable，因此您可以使用 await foreach 遍历结果，或者简单地调用 ToListAsync() 以异步方式获取 List<T> 结果

   // Using Npgsql to query a local PostgreSQL instance
   var connectionString = "Server=localhost;Port=5432;Username=postgres;Database=postgres";
   await using var db = new NpgsqlDataSourceBuilder(connectionString).Build();
   
   var todos = db.QueryAsync<Todo>("SELECT * FROM Todos");
   var todosList = await todos.ToListAsync();
   
   if (todosList.Count == 0)
   {
       Console.WriteLine("There are currently no todos!");
   }
   else
   {
       Console.WriteLine($"Found {todosList.Count} todo(s):");
       foreach (var todo in todosList)
       {
           Console.WriteLine($"({todo.Id}) {todo.Title}");
       }
   }
   

使用参数

Nanorm 支持几种向查询传递参数的方式

• 传递由 Nanorm 的 自定义字符串插值处理器处理的字符串插值字符串。这是一种首选方法。查询会自动以优化方式参数化，即没有字符串连接，使用池分配等。

  var title = "Do the dishes";
  var result = db.QueryAsync<Todo>($"SELECT * FROM Todos WHERE Title = {title}")
  

• 传递 ADO.NET 供应商的 DbParameter 实现的实例作为参数，例如

  var title = "Do the dishes";
  var sql = "SELECT * FROM Todos WHERE Title = $1";
  var result = db.QueryAsync<Todo>(sql, new NpgsqlParameter { Value =  title }))
  

• 传递一个回调，它修改 ADO.NET 供应商的参数集合实现，例如

  var title = "Do the dishes";
  var sql = "SELECT * FROM Todos WHERE Title = $1";
  var result = db.QueryAsync<Todo>(sql, parameters => parameters.Add(title))
  

扩展方法

以下扩展方法提供了简化数据库操作的方法

基准测试

Nanorm 旨在作为 ADO.NET 的一层非常薄的层，并支持修剪和本机 AOT。以下是它与原始 ADO.NET 和 Dapper 进行简单的插入和返回操作的处理器的时间消耗和内存分配的比较