Insql 1.1.0 正式版发布,轻量级.NET ORM类库

栏目: 软件资讯 · 发布时间: 5年前

内容简介:Insql 是一个轻量级的.NET ORM类库。对象映射基于Dapper, Sql配置灵感来自于Mybatis。 1.1.0版包含的功能特点: 支持 DoNet Core 2.0+ & DotNet Framework 4.6.1+ 支持依赖注入系统 MyBatis sql xml 语法 多数据库...

Insql 是一个轻量级的.NET ORM类库。对象映射基于Dapper, Sql配置灵感来自于Mybatis。

1.1.0版包含的功能特点:

  • 支持 DoNet Core 2.0+ & DotNet Framework 4.6.1+

  • 支持依赖注入系统

  • MyBatis sql xml 语法

  • 多数据库支持

  • 灵活扩展性

  • 使用简单

基本用法:

添加Insql

public void ConfigureServices(IServiceCollection services)
{
    services.AddInsql();

    services.AddInsqlDbContext<UserDbContext>(options =>
    {
      //options.UseSqlServer(this.Configuration.GetConnectionString("sqlserver"));
      options.UseSqlite(this.Configuration.GetConnectionString("sqlite"));
    });
}

    创建 DbContext 

    public class UserDbContext : Insql.DbContext  
    {
        public UserDbContext(Insql.DbContextOptions<UserDbContext> options) 
    		: base(options)
        {
        }
    
        public IEnumerable<UserInfo> GetUserList(string userName)
        {
            //sqlId = "GetUserList"
            //sqlParam is PlainObject or IDictionary<string,object>
            return this.Query<UserInfo>(nameof(GetUserList), new { userName, userGender = Gender.W });
        }
    
        public void InsertUser(UserInfo info)
        {
            var userId = this.ExecuteScalar<int>(nameof(InsertUser),info);
    
            info.UserId = userId;
        }
    
        public void UpdateUserSelective(UserInfo info)
        {
            this.Execute(nameof(UpdateUserSelective), info);
        }
    }
    	
    //user model
    public class UserInfo
    {
        public int UserId { get; set; }
    
        public string UserName { get; set; }
    
        public Gender? UserGender { get; set; }
    }
    
    public enum Gender
    {
        M,
        W
    }

    创建 DbContext.insql.xml

    创建 UserDbContext.insql.xml 文件并且修改这个文件的属性为嵌入式文件类型 . insql type 与 UserDbContext 类型对应.

    <insql type="Example.Domain.Contexts.UserDbContext,Example.Domain" >
      
        <sql id="selectUserColumns">
          select user_id as UserId,user_name as UserName,user_gender as UserGender from user_info
        </sql>
    
        <select id="GetUserList">
          <include refid="selectUserColumns" />
          <where>
            <if test="userName != null">
              <bind name="likeUserName" value="'%' + userName + '%'" />
              user_name like @likeUserName
            </if>
            <if test="userGender != null and userGender != 'M' ">
              and user_gender = @userGender
            </if>
          </where>
          order by  user_id
        </select>
    
        <insert id="InsertUser">
          insert into user_info (user_name,user_gender) values (@UserName,@UserGender);
          select last_insert_rowid() from user_info;
        </insert>
    
        <update id="UpdateUserSelective">
          update user_info
          <set>
            <if test="UserName != null">
              user_name=@UserName,
            </if>
            <if test="UserGender != null">
              user_gender=@UserGender
            </if>
          </set>
          where user_id = @UserId
        </update>
    	
    </insql>

    使用 DbContext

    使用 UserDbContext 在Domain Service中或者Web Controller中

    public class ValuesController : ControllerBase
    {
        private readonly UserDbContext userDbContext;
    
        public ValuesController(UserDbContext userDbContext)
        {
            this.userDbContext = userDbContext;
        }
    
        [HttpGet]
        public ActionResult<IEnumerable<string>> Get()
        {
            //可以这样使用事务
            this.userDbContext.DoWithTransaction(() =>
            {
                var userInfo = new Domain.UserInfo
                {
                    UserName = "loveW",
                    UserGender = Domain.Gender.M
                };
    
                this.userDbContext.InsertUser(userInfo);
    
                this.userDbContext.UpdateUserSelective(new Domain.UserInfo
                {
                    UserId = userInfo.UserId,
                    UserName = "loveWWW",
                });
            });
    
            var list = this.userDbContext.GetUserList("love");
    	//todo return
        }
    }

    多数据库脚本用法:

    多数据库支持为默认启用,使用时也很简单。

    xxx.insql.xml中如果当前使用的是SqlServer数据库,则会优先使用InsertUser.SqlServer,如果未找到后缀是.SqlServer的配置节,则使用默认的InsertUser

    <insert id="InsertUser">
      insert into user_info (user_name,user_gender) values (@UserName,@UserGender);
      select last_insert_rowid() from user_info;
    </insert>
    
    <insert id="InsertUser.SqlServer">
      insert into user_info (user_name,user_gender) values (@UserName,@UserGender);
      select SCOPE_IDENTITY();
    </insert>

    更多其他功能可看文档:说明文档


    以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网

    查看所有标签

    猜你喜欢:

    本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

    大师之路

    大师之路

    赵鹏 / 人民邮电出版社 / 2007-12 / 79.00元

    《大师之路:Photoshop中文版完全解析》以介绍Photoshop选区、图层、路径3大基础为主线,从色彩原理入手,注重基础知识,辅以大量实例,全面剖析了Photoshop的应用。对于其他内容,如色彩调整和各类工具的应用,也均采用与实际操作相结合的方式进行讲解。另外,还简单明了地介绍了扩展应用的领域。所附教学光盘的内容可自成一套独立的视频教学体系。本书完全按照初学者的认知角度编写,重点介绍图像原......一起来看看 《大师之路》 这本书的介绍吧!

    在线进制转换器
    在线进制转换器

    各进制数互转换器

    图片转BASE64编码
    图片转BASE64编码

    在线图片转Base64编码工具

    UNIX 时间戳转换
    UNIX 时间戳转换

    UNIX 时间戳转换