这是一个轻量的映射工具,不可与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); // 从实体返回实体
水文结束!