leisaupei/creeper

.NetStandard2.1轻量级ORM

Creeper介绍

1. 基于.NetStandard2.1的轻量级ORM框架。
2. 适配多种支持的不同种类数据库开发场景。
3. 自带Entity生成器，一键即可生成数据库模型代码。
4. 支持单条记录的自定义数据库缓存，可自定义缓存策略。
5. 支持一主多从数据库策略，自由切换主从。
6. 所有查询支持异步方法。
7. 使用指南

---

如何开始？

安装

配置DbContext

Startup

public void ConfigureServices(IServiceCollection services)
{
    services.AddCreeper(options =>
    {
        //PostgreSqlContext可由生成器生成或继承CreeperContextBase实现即可
        options.AddPostgreSqlContext<PostgreSqlContext>(context =>
        {
            context.UseCache<RedisDbCache>();
            //数据库主从策略 从库优先,没有会报错/从库优先,没有会使用主库/只使用主库
            context.UseStrategy(DataBaseTypeStrategy.MainIfSecondaryEmpty);
            //添加主库配置
            context.UseConnectionString("MainDbConnectionString");
            //添加多个从库配置
            context.UseSecondaryConnectionString(new[] { "SecondaryDbConnectionStrings" });
        });
        //此处可添加多种数据库配置, 使用DbContext的对象名称作区分
        //options.AddMySqlContext<MySqlSqlContext>(t =>
        //{
        //    context.UseCache<RedisDbCache>();
        //    //数据库主从策略 从库优先,没有会报错/从库优先,没有会使用主库/只使用主库
        //    context.UseStrategy(DataBaseTypeStrategy.MainIfSecondaryEmpty);
        //    //添加主库配置
        //    context.UseConnectionString("MainDbConnectionString");
        //    //添加多个从库配置
        //    context.UseSecondaryConnectionString(new[] { "SecondaryDbConnectionStrings" });
        //});
    });
}

context.UseCache<DbCache>()参阅数据库缓存

PostgreSqlContext参阅DbContext说明

Controller或其他注入类

public class SomeController : Controller
{
    //如果此处使用多个DbContext, 直接使用DbContext名称或使用以下调用方式也行
    //private readonly Creeper.Driver.ICreeperContext _context;
    //public SomeController(IEnumerable<Creeper.Driver.ICreeperContext> contexts)
    //{
    //    _context = contexts.FirstOrDefault(c => c is PostgreSqlContext);
    //}
    private readonly Creeper.Driver.ICreeperContext _context;
    public SomeController(Creeper.Driver.ICreeperContext context)
    {
        _context = context;
    }

    [HttpGet]
    public DbModel SomeAction()
    {
        return _context.Select<DbModel>().Where(a => a.DbField == SomeValue).ToOne();
    }
}