关于orm框架设计,还有必要说的或许就是Model解析了,也是重要的一个环节,在实现上还是相对比较简单的.
Model解析,主要用到的技术是反射了,即:把类的属性与表的字段做映射. 把自己的设计及实现思路写出来也希望能有人给很好的优化建议,同时也给新手一点启发吧.
首先先给Model属性定义特性,先普及一下"特性"的概念和为什么用特性(Attribute).
简单来说,特性是给一个类,或方法,或属性 打上一个标记(或者叫附加信息),具体理解还是看例子比较好吧,
在做类与表之间映射时,我们需要知道某字段的是什么类型,长度,是否主键,自增长,非空,等信息,最简单较直观的方法或许就是特性(Attribute)了,
首先我们定义一个特性,它就是一个类而已,它必须继承自Attribute,我所写的orm比较轻量级,仅几个比较关键属性,
代码如下:
public class ModelAttribute : Attribute { /// <summary> /// 是否主键 /// </summary> public bool IsPrimaryKey { set; get; } /// <summary> /// 主键是否自动增长 /// </summary> public bool IsIdentity { set; get; } /// <summary> /// 是否非空字段 /// </summary> public bool IsNotNull { set; get; } /// <summary> /// 列名 /// </summary> public string ColumnName { set; get; } }
下面是一个实体类使用特性的例子,它指明了Id的列名是:"Id",不允许为空的,是自增长的,是主键:
public class Test1 : ModelBase { [ModelAttribute(IsPrimaryKey = true, IsIdentity = true, IsNotNull = false, ColumnName = "Id")] public int Id { set; get; } public string Name { set; get; } public string Age { set; get; } public string Remark { set; get; } }
下面是通过反射把Model特性解析出来,先把核心代码贴出来:
/// <summary> /// 通过解析获得Model的对象的参数,Key:为类的属性名 /// </summary> /// <param name="model">model对象</param> /// <returns>返回model参数</returns> protected override Dictionary<string, ModelAttribute> GetModelParam<TModel>() { var list = new Dictionary<string, ModelAttribute>(); PropertyInfo[] pros = ReflectionHelper.GetPropertyInfo<TModel>(); foreach (PropertyInfo item in pros) { var attr = ReflectionHelper.GetCustomAttribute<ModelAttribute>(item); if (attr == null) { //如果实体没定义属性则创建一个新的 attr = new ModelAttribute(); attr.ColumnName = item.Name; } else { //如果列名没有赋值,则将列名定义和属性名一样的值 if (string.IsNullOrEmpty(attr.ColumnName)) { attr.ColumnName = item.Name; } } list.Add(item.Name, attr); } return list; }
因考虑反射应该是共同方法,不仅限于Model解析,所以把反射相关的方法提出来了,以下是根据"类型T"获取自定义属性的两个方法:
/// <summary> /// 获得指定成员的特性对象 /// </summary> /// <typeparam name="T">要获取属性的类型</typeparam> /// <param name="pInfo">属性原型</param> /// <returns>返回T对象</returns> public static T GetCustomAttribute<T>(PropertyInfo pInfo) where T : Attribute, new() { Type attributeType = typeof(T); Attribute attrObj = Attribute.GetCustomAttribute(pInfo, attributeType); T rAttrObj = attrObj as T; return rAttrObj; }
/// <summary> /// 获得对象的所有公共属性信息 /// </summary> /// <typeparam name="T">类型</typeparam> /// <param name="obj">获得的对象</param> /// <returns>返回属性信息</returns> public static PropertyInfo[] GetPropertyInfo<T>() where T : class { Type t = typeof(T); PropertyInfo[] proInfo = t.GetProperties(); return proInfo; }
解析特性我们不需要知道该类的具体实例,所以这里用了泛型,只需要知道Model类型即可,我的框架仅限于类的属性,这里只获取属性的"特性对象".
返回类型Dictionary<string,ModelAttribute> Key:为属性名,ModelAttribute 对象,
到这里解析的实现其实就完成,后面我又做了一些优化,我们想到反射时通常会联想到效率问题,而且既然是解析一个类的特性,那么我们并不关心它的实例对象,
这里把解析出来的对象放到了缓存,即:只有第一次对该类进行反射,以后都是直接访问缓存数据.
解析Model是一个类,那么需要做到全局缓存,我这里用到了一个静态变量,该变量是不允许被外部更改的,所以设置为私有的了.
代码如下:
static object _LockObj1 = new object(); static object _LockObj2 = new object(); /// <summary> /// 实体类缓存,静态变量是保存为了减少反射次数 /// </summary> static Dictionary<Type, Dictionary<string, ModelAttribute>> _ModelAttributeCache; /// <summary> /// 实体类缓存,静态变量是保存为了减少反射次数 /// </summary> protected Dictionary<Type, Dictionary<string, ModelAttribute>> ModelAttributeCache { get { if (_ModelAttributeCache == null) { lock (_LockObj1) { if (_ModelAttributeCache == null) { _ModelAttributeCache = new Dictionary<Type, Dictionary<string, ModelAttribute>>(); } } } return _ModelAttributeCache; } } /// <summary> /// 获取Model的属性对象,获取第一次后会放入一个缓存列表中 /// 即只反射一次 /// </summary> public Dictionary<string, ModelAttribute> GetModelAttribute<T>() where T : ModelBase, new() { Type t = typeof(T); if (!ModelAttributeCache.ContainsKey(t)) { lock (_LockObj2) { if (!ModelAttributeCache.ContainsKey(t)) { var attrs = GetModelParam<T>(); ModelAttributeCache.Add(t, attrs); } } } return ModelAttributeCache[t]; }
这里缓存列表为: Dictionary<Type, Dictionary<string, ModelAttribute>> ,Type即Model类的类型.
解释一下加LockObj的意义,
我先声明一下,这个orm框架虽然比较轻量级,但我也不是共享的一个设计阶段或者或测试阶段的代码,也是经过几个小项目使用磨合过的.
_LockObj 是在一次多线程操作时发现的bug,当多个线程访问一个"全局对象"时,不加锁会访问冲突的问题.
Model解析类的路径:ZhCun.Framework.Common.Models.TableModel
下载了代码的可以去看下具体实现的详细方法.
在设计DalBase 时考虑了它应依赖抽象的理念,虽然没有想好关于Model解析除了反射还是否会有其它方法,但还是把它定义成了抽象.
到这已经完成了Model解析的功能.会再生成sql语句的时候用到它.
有了以下方法示例,估计sql文的生成就能实现了吧.
//得到Model对象(第一次会反射,再次调用时是从缓存获取) Dictionary<string, ModelAttribute> modelAttr = _ModelAnaly.GetModelAttribute<T>(); //key:字段名(属性名) foreach (string item in modelAttr.Keys) { //得到列名(如果特性没有指定ColumnName值,则与属性名一样) string colName = modelAttr[item].ColumnName; //是否字增长 bool isIdentity = modelAttr[item].IsIdentity; //是否主键 bool isPrimaryKey = modelAttr[item].IsPrimaryKey; }
关于Model解析类的实现 相对设计来说比较简单.
如果有大神有啥好的建议,或有什么不足,希望能 探讨,指正 .