这是一个轻量的映射工具,不可与ORM做比较。它不参与到DB。一般用来配合SqlHelper来使用。目前实现的功能有:DataReader到List的映射、
DataReader到T的映射、List到List的映射、T到T的映射、T到数据库参数的映射。以上这些都是平时操作数据库工作量最大的部分,而且都是重
复的没有含量的工作。其实真正写SQL并不占用多少工作量。
下面来说下如何使用,并写几个各个功能下的使用示例。
首先下载:Assionsoft.AssionMapper 程序集,所有映射功能全部在这个程序集下面。不需要进行XML的配置。
1、我们不采取XML配置的映射形式,而是在实体类上标上特性的方式。通过元数据标识映射。比如下面的学生实体:
[ResultMap("SysNo")]//参与单体DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ResultsMap("SysNo")]//参与集合DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ObjectMap]//参与对象映射
[ParameterMap]//参与数据库参数映射
public int SysNo { get; set; }
[ResultMap("Name")]//参与单体DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ResultsMap("Name")]//参与集合DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ObjectMap]//参与对象映射
[ParameterMap("Name")]//参与数据库参数映射
public string Name { get; set; }
[ResultMap("Gender")]//参与单体DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ResultsMap("Gender")]//参与集合DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ObjectMap]//参与对象映射
[ParameterMap]//参与数据库参数映射
public bool Gender { get; set; }
[ResultMap("Age")]//参与单体DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ResultsMap("Age")]//参与集合DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ObjectMap]//参与对象映射
[ParameterMap]//参与数据库参数映射
public int Age { get; set; }
[ResultMap("Birthday")]//参与单体DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ResultsMap("Birthday")]//参与集合DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ObjectMap]//参与对象映射
[ParameterMap]//参与数据库参数映射
public DateTime Birthday { get; set; }
[ResultsMap("SysNo")]//参与集合DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ObjectMap]//参与对象映射
[ParameterMap]//参与数据库参数映射
public int SysNo { get; set; }
[ResultMap("Name")]//参与单体DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ResultsMap("Name")]//参与集合DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ObjectMap]//参与对象映射
[ParameterMap("Name")]//参与数据库参数映射
public string Name { get; set; }
[ResultMap("Gender")]//参与单体DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ResultsMap("Gender")]//参与集合DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ObjectMap]//参与对象映射
[ParameterMap]//参与数据库参数映射
public bool Gender { get; set; }
[ResultMap("Age")]//参与单体DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ResultsMap("Age")]//参与集合DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ObjectMap]//参与对象映射
[ParameterMap]//参与数据库参数映射
public int Age { get; set; }
[ResultMap("Birthday")]//参与单体DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ResultsMap("Birthday")]//参与集合DataReader返回映射,如果[ResultMap]无参则默认已属性名匹配
[ObjectMap]//参与对象映射
[ParameterMap]//参与数据库参数映射
public DateTime Birthday { get; set; }
2、数据库插入增、删、改的参数映射,我们通过委托把Common.Parameter.AddWithValue传给方法进行与student的映射。
Student student = new Student() { Name = "张三", Gender = true, Age = 25, Birthday = DateTime.Now };
SqlConnection conn = new SqlConnection("server=ASSIONYANG-PCJ\\SQLEXPRESS;uid=sa;pwd=123;database=Testing");
conn.Open();
SqlCommand cmd = new SqlCommand();
cmd.Connection = conn;
cmd.CommandText = "INSERT INTO ([Name],[Gender],[Age],[Birthday]) VALUES (@Name,@Gender,@Age,@Birthday)";
ParameterMap.SqlParameterMap<Student>(cmd.Parameters.AddWithValue, student);//生成数据库参数
cmd.ExecuteNonQuery();
cmd.Parameters.Clear();
conn.Close();
SqlConnection conn = new SqlConnection("server=ASSIONYANG-PCJ\\SQLEXPRESS;uid=sa;pwd=123;database=Testing");
conn.Open();
SqlCommand cmd = new SqlCommand();
cmd.Connection = conn;
cmd.CommandText = "INSERT INTO ([Name],[Gender],[Age],[Birthday]) VALUES (@Name,@Gender,@Age,@Birthday)";
ParameterMap.SqlParameterMap<Student>(cmd.Parameters.AddWithValue, student);//生成数据库参数
cmd.ExecuteNonQuery();
cmd.Parameters.Clear();
conn.Close();
3、DataReader返回集合的映射
IList<Student> studentList = new List<Student>();
SqlConnection conn = new SqlConnection("server=ASSIONYANG-PCJ\\SQLEXPRESS;uid=sa;pwd=123;database=Testing");
conn.Open();
SqlCommand cmd = new SqlCommand();
cmd.Connection = conn;
cmd.CommandText = "SELECT [SysNo],[Name],[Gender],[Age],[Birthday] FROM Student ORDER BY [SysNo] DESC";
SqlDataReader dataReader = cmd.ExecuteReader();
studentList = ResultMap.GetIList<Student>(dataReader);//从DataReader返回实体集合
dataReader.Close();
conn.Close();
SqlConnection conn = new SqlConnection("server=ASSIONYANG-PCJ\\SQLEXPRESS;uid=sa;pwd=123;database=Testing");
conn.Open();
SqlCommand cmd = new SqlCommand();
cmd.Connection = conn;
cmd.CommandText = "SELECT [SysNo],[Name],[Gender],[Age],[Birthday] FROM Student ORDER BY [SysNo] DESC";
SqlDataReader dataReader = cmd.ExecuteReader();
studentList = ResultMap.GetIList<Student>(dataReader);//从DataReader返回实体集合
dataReader.Close();
conn.Close();
4、DataReader 返回实体的映射
Student student = new Student();
SqlConnection conn = new SqlConnection("server=ASSIONYANG-PCJ\\SQLEXPRESS;uid=sa;pwd=123;database=Testing");
conn.Open();
SqlCommand cmd = new SqlCommand();
cmd.Connection = conn;
cmd.CommandText = "SELECT [SysNo],[Name],[Gender],[Age],[Birthday] FROM Student WHERE [SysNo]=@SysNo";
ParameterMap.SqlParameterMap<Student>(cmd.Parameters.AddWithValue, student);
SqlDataReader dataReader = cmd.ExecuteReader();
student = ResultMap.Load<Student>(dataReader);//从DataReader返回单个实体
dataReader.Close();
conn.Close();
SqlConnection conn = new SqlConnection("server=ASSIONYANG-PCJ\\SQLEXPRESS;uid=sa;pwd=123;database=Testing");
conn.Open();
SqlCommand cmd = new SqlCommand();
cmd.Connection = conn;
cmd.CommandText = "SELECT [SysNo],[Name],[Gender],[Age],[Birthday] FROM Student WHERE [SysNo]=@SysNo";
ParameterMap.SqlParameterMap<Student>(cmd.Parameters.AddWithValue, student);
SqlDataReader dataReader = cmd.ExecuteReader();
student = ResultMap.Load<Student>(dataReader);//从DataReader返回单个实体
dataReader.Close();
conn.Close();
5、集合TO 集合的映射
IList<Student> studentList = new List<Student>();
IList<Student> studentResultList = new List<Student>();
studentResultList = ResultMap.GetIList<Student, Student>(studentList);//从集合返回集合
IList<Student> studentResultList = new List<Student>();
studentResultList = ResultMap.GetIList<Student, Student>(studentList);//从集合返回集合
6、实体TO 实体的映射
Student student = new Student();
Student studentResult = new Student();
studentResult = ResultMap.Load<Student, Student>(student);//从实体返回实体
Student studentResult = new Student();
studentResult = ResultMap.Load<Student, Student>(student);//从实体返回实体