HiSql 开源项目教程

HiSql 开源项目教程

HiSqlHiSql 新一代无实体ORM框架 为低代码而生的ORM框架项目地址:https://gitcode.com/gh_mirrors/hi/HiSql

项目介绍

HiSql 是一个基于 .NET 的低代码数据库操作库，旨在简化数据库操作流程，提高开发效率。它支持多种数据库，包括但不限于 SQL Server、MySQL、Oracle 等，并提供了一套简洁的 API 来执行常见的数据库操作，如查询、插入、更新和删除。

项目快速启动

安装 HiSql

首先，通过 NuGet 安装 HiSql 包：

dotnet add package HiSql

初始化 HiSql

在你的项目中初始化 HiSql：

using HiSql;

class Program
{
    static void Main(string[] args)
    {
        // 配置数据库连接
        var connectionConfig = new ConnectionConfig
        {
            DbType = DatabaseType.SqlServer,
            ConnectionString = "your_connection_string",
            Schema = "dbo"
        };

        // 初始化 HiSql
        var hisql = new HiSqlClient(connectionConfig);
    }
}

执行查询

使用 HiSql 执行一个简单的查询：

var result = hisql.Query("YourTableName")
                  .Select("Column1, Column2")
                  .Where("Column1", "=", "Value")
                  .ToDynamic();

应用案例和最佳实践

应用案例

假设我们有一个名为 Users 的表，包含 Id, Name, 和 Email 字段。我们可以使用 HiSql 进行以下操作：

1. 查询用户

   var users = hisql.Query("Users")
                    .Select("Id, Name, Email")
                    .Where("Name", "like", "John%")
                    .ToDynamic();
   

2. 插入用户

   hisql.Insert("Users", new Dictionary<string, object>
   {
       { "Name", "John Doe" },
       { "Email", "john.doe@example.com" }
   }).ExecCommand();
   

3. 更新用户

   hisql.Modi("Users", new Dictionary<string, object>
   {
       { "Email", "new.email@example.com" }
   }).Where("Id", "=", 1).ExecCommand();
   

4. 删除用户

   hisql.Delete("Users").Where("Id", "=", 1).ExecCommand();
   

最佳实践

• 使用参数化查询：避免 SQL 注入攻击。
• 合理使用事务：对于涉及多个操作的场景，使用事务确保数据一致性。
• 缓存常用查询：对于频繁执行的查询，考虑使用缓存提高性能。

典型生态项目

HiSql 可以与以下项目结合使用，以构建更强大的应用：

1. ASP.NET Core：用于构建 Web 应用。
2. Entity Framework Core：用于 ORM 映射。
3. Hangfire：用于后台任务处理。
4. Serilog：用于日志记录。

通过这些生态项目的结合，可以构建出高效、稳定且易于维护的应用系统。

HiSqlHiSql 新一代无实体ORM框架 为低代码而生的ORM框架项目地址:https://gitcode.com/gh_mirrors/hi/HiSql