ORM.DataAccess(一)

 

一.通过nuget安装

 

搜索 ORM.DataAccess 安装,建议安装最新版本

需要支持不同数据库,安装不同的ORM.DataAccess对应数据库版本,目前支持Oracle,MSSQLServer,MySQL,PostgreSQL,Doris

framework版本,支持4.7及4.7以上,.netcore支持.net6及以上

二.配置

1.framework,打开web.config或app.config,在 configuration节点下添加

<configSections>
    <section name="RB.DataAccess" type="RB.DataAccess.Configuration.DataAccessConfigSection, RB.DataAccess" />
</configSections>

<!-- defaultContextName:默认数据库上下文名称,必填  -->
<!-- dbLogType:记录sql执行日志方式,目前支持DB(数据库)和Text(文本),选填 -->
<!-- logInterval:记录日志频率,单位秒,选填 -->
<!-- limitDuration:记录日志的最小执行时间,单位秒,选填 -->
<!-- context name:数据库上下问名称,全局唯一,必填 -->
<!-- context enable:是否启用,默认true,选填 -->
<!-- context type:数据库类型,默认Oracle,支持Oracle,MySQL,SqlServer，PostgreSql,选填 -->
<!-- ontext privateKeyPath:非对称加密密钥目录,只有连接字符串用非对称加密才有效,选填 -->
<!-- context connectionString:链接字符串,根据各数据库方式填写完整字符串,支持对称加密和非对称加密,必填 -->

<RB.DataAccess>
    <contexts defaultContextName="DCS" dbLogType="DB" logInterval="30" limitDuration="2">
         <context name="MeetingDB" enable="false" type="MySql" privateKeyPath="C:\DCSConfig\DCS" connectionString="xxxx" />
    </contexts>
</RB.DataAccess>

2.netcore配置,新增一个dbs.json文件

[
  {
    "contextName": "ICS",
    "dbType": "MySQL",
    "connectionString": "xxx",
    "enable": false,
    "desc": "ICS正式区"
  },
  {
    "contextName": "ICS",
    "dbType": "MySQL",
    "connectionString": "xxx",
    "enable": true,
    "desc": "ICS测试区"
  }
]

Ps:具体说明参考上面注释,默认第一个启用的是默认数据上下文

三.项目初始化

.netframework,在Application_Start或Main函数中执行,整个项目启动只需要初始化一次即可

//初始化里面的回调函数,可以为空,ModifyBy/ModifyByName用来自动记录修改人信息
DataContextFactory.InitRB(() =>
{
    return new RBLogDataModel()
    {
        ModifyBy = "工号",
        ModifyByName = "姓名"
    };
});

.netcore中,在Main中执行

//初始化数据库配置文件,第1个参数为配置文件相对路劲,isFormal:配置文件第一条是否是正式区
DataContextFactory.InitRB("/Configs/dbs.json", () =>
{
    return new RBLogDataModel()
    {
        ModifyBy = "工号",
        ModifyByName = "姓名"
    };
}, true);

四.基本使用

1.这里定义3个表对象,学生(Student),课程(Course),学生选的课程(StudentCours)

/// <summary>
/// 学生表
/// </summary>
public class Student
{
    /// <summary>
    /// 学好
    /// </summary>
    public string StuCode { set; get; }

    /// <summary>
    /// 姓名
    /// </summary>
    public string StuName { set; get; }

    /// <summary>
    /// 身高
    /// </summary>
    public float? Height { set; get; }

    /// <summary>
    /// 性别
    /// </summary>
    public SexEnum Sex { set; get; }

    /// <summary>
    /// 出生日期
    /// </summary>
    public DateTime? Birthday { set; get; }
}

/// <summary>
/// 性别枚举
/// </summary>
public enum SexEnum
{
    /// <summary>
    /// 男
    /// </summary>
    Male = 1,

    /// <summary>
    /// 女
    /// </summary>
    Female = 2
}

/// <summary>
/// 课程表
/// </summary>
public class Course
{
    /// <summary>
    /// 课程编号
    /// </summary>
    public string CourseCode { set; get; }

    /// <summary>
    /// 课程名称
    /// </summary>
    public string CourseName { set; get; }
}

/// <summary>
/// 学生与课程关联表
/// </summary>
public class StudentCourse
{
    /// <summary>
    /// 学生学号
    /// </summary>
    public string StuCode { set; get; }

    /// <summary>
    /// 课程编号
    /// </summary>
    public string CourseCode { set; get; }
}

2.定义3个关联数据业务集

/// <summary>
/// 学生表集
/// </summary>
public class StudentSet : RecordSet<Student>
{
}

/// <summary>
/// 课程集合
/// </summary>
public class CourseSet : RecordSet<Course>
{
}

/// <summary>
/// 学生课程表集
/// </summary>
public class StudentCourseSet : RecordSet<StudentCourse>
{
}

3.基本操作(增删改,单表查询)

//所有操作,自动commit提交
//新增一个学生
new StudentSet().Add(new Student()
{
    StuCode = "A0001",
    StuName = "张三",
    Sex = SexEnum.Male,
    Height = 1.73f,
    Birthday = new System.DateTime(1999, 12, 3)
});

//批量新增,返回成功新增的条数
var successAddCount = new StudentSet().BatchAdd(new List<Student>()
{
    new Student(){
        StuCode = "A0002",
        StuName = "李四"
    },
    new Student(){
      StuCode = "A0003",
      StuName = "王老五"
    }
});

//删除学生姓名为"李四"的学生,返回删除成功的条数
var successDeleteCout = new StudentSet().RemoveAll(p => p.StuName == "李四");

//修改学号为"A0001"学生的身高为1.8,返回修改成功的条数
var successUpdateCount= new StudentSet().Update(p => new { Height = 1.8f }, p => p.StuCode == "A0001");

//查询学号为"A0001"的第一条学生数据,如果没有返回默认值
var student = new StudentSet().Where(p => p.StuCode == "A0001").FirstOrDefault();

//查询学号为"A0001"的学生查询的姓名
var studentName = new StudentSet().Where(p => p.StuCode == "A0001").Select(p=>p.StuName).FirstOrDefault();

4.事务方式(基本操作)

//创建一个事务操作
using (var exe = DataContextFactory.CreateExecutor())
{
    //开启事务
    exe.BeginTransaction();
    try
    {
        //新增一个学生,第2个参数事务参数
        new StudentSet().Add(new Student()
        {
            StuCode = "A0001",
            StuName = "张三",
            Sex = SexEnum.Male,
            Height = 1.73f,
            Birthday = new System.DateTime(1999, 12, 3)
        }, exe);

        //删除学生姓名为"李四1"的学生,返回删除成功的条数,第2个参数事务参数
        var successDeleteCout_1 = new StudentSet().RemoveAll(p => p.StuName == "李四1", exe);
        
        //提交事务
        exe.CommitTransaction();
    }
    catch
    {
        //异常时,事务回滚
        exe.RollbackTransaction();
    }
}

5.多表查询

//查询学号为"A00001"的学生课程信息
var stuCous = (from t in new StudentSet().AsQueryable()
               join t1 in new StudentCourseSet().AsQueryable() on t.StuCode equals t1.StuCode
               join t2 in new CourseSet().AsQueryable() on t1.CourseCode equals t2.CourseCode
               where t.StuCode == "A0001"
               select new
               {
                   t.StuCode,
                   t.StuName,
                   t1.CourseCode,
                   t2.CourseName
               }).ToList();

 

未完待续...