OrmTxcSql 2.1.0

OrmTxcSql

O/R mapping, Transaction control, SQL

Overview

OrmTxcSql is a lightweight O/R mapping, transaction control, and SQL execution library for .NET applications.

Packages

• OrmTxcSql - Core library
• OrmTxcSql.Npgsql - PostgreSQL support
• OrmTxcSql.SqlClient - SQL Server support
• OrmTxcSql.DB2 - IBM DB2/iSeries support

Supported Frameworks

• .NET 10.0
• .NET 8.0
• .NET 6.0
• .NET Framework 4.8

Installation

# PostgreSQL
dotnet add package OrmTxcSql.Npgsql

# SQL Server
dotnet add package OrmTxcSql.SqlClient

# IBM DB2/iSeries
dotnet add package OrmTxcSql.DB2

Basic Usage

Entity Definition

[Table("products")]
public class ProductEntity : BaseNpgsqlEntity
{
    [Column("product_code"), PrimaryKey]
    public string ProductCode { get; set; }
    [Column("description")]
    public string Description { get; set; }
}

DAO Implementation

public class ProductDao : BaseNpgsqlDao<ProductEntity>
{
    public override ProductEntity[] Select(ProductEntity entity)
    {
        // table name
        string tableName = EntityUtils.GetTableName<ProductEntity>();
        // column names
        string[] columnNames = EntityUtils.GetColumnAttributes<ProductEntity>()
            .Select(prop => new
            {
                PropertyInfo = prop,
                ColumnName = prop.GetCustomAttribute<ColumnAttribute>(false)?.ColumnName ?? String.Empty
            })
            .Where(src => !String.IsNullOrEmpty(src.ColumnName))
            .Select(src => src.ColumnName)
            .ToArray();
        //
        // sql
        var builder = new StringBuilder();
        builder.Append(" select");
        builder.Append(String.Join(",", columnNames.Select(columnName => String.Format(" x.{0}", columnName))));
        builder.Append(this.GetCommonFieldForSelect("x"));
        builder.Append(" from ").Append(tableName).Append(" as x");
        builder.Append(" where");
        builder.Append("   x.product_code like @parameter_product_code_prefix || '%'");
        builder.Append(this.GetCommonFieldForSelectCondition("x", true));
        //
        // set up command text
        NpgsqlCommand command = this.Command;
        command.CommandText = builder.ToString();
        // set up command parameters
        NpgsqlServer.AddParameterOrReplace(command, "@parameter_product_code_prefix", NpgsqlDbType.Varchar, entity.ProductCode);
        //
        // prepara command
        command.Prepare();
        //
        // return result
        DataTable dt = this.GetDataTable(command);
        ProductEntity[] result = dt.AsEnumerable<ProductEntity>().ToArray();
        return result;
    }
}

Data Source Configuration

// PostgreSQL
var dataSource = new NpgsqlDataSource("Host=localhost;Database=mydb;Username=user;Password=pass");

// SQL Server
var dataSource = new SqlClientDataSource("Server=localhost;Database=mydb;Integrated Security=true");

Key Features

• Simple O/R mapping
• Automatic transaction management
• Parameterized query support
• Multiple database support
• Lightweight and high performance

License

MIT License

Repository

https://github.com/tanoue13/OrmTxcSql