ObjectBuilder 项目中 Utility 文件夹 — DependencyResolutionLocatorKey 类

DependencyResolutionLocatorKey 用来唯一标识在 ObjectBuilder 中存储的对象。ObjectBuilder 中会使用一种叫做“定位器”的对象（内部通过一个哈希表来存储对象）来存储需要被缓存的对象。当我们要创建的是一个可以被重复使用的对象（例如：设计模式中的“单件模式”），则应该第一次使用 ObjectBuilder 创建该对象后将其缓存，当下次再使用 ObjectBuidler 创建该对象时将直接返回上次创建的那个对象。

这个 DependencyResolutionLocatorKey 实际上就是一个用于标识对象关键字，ObjectBuilder 使用“类型/名称”对来标识一个对象，这样有利于“插件式”的开发。开发人员可以为某类插件定义一个所有该类型的“插件”都必

  1using System;
  2
  3namespace Microsoft.Practices.ObjectBuilder
  4{
  5    /**//// <summary>
  6    /// 表示一个 "类型/
  7    /// 标识" 对，该类用
  8    /// 于标识 "定位器" 
  9    /// 中的对象。
 10    /// </summary>
 11    /// <remarks>
 12    /// 该类实际上是用来
 13    /// 标识一个 "依赖对
 14    /// 象" 的，而 "依赖
 15    /// 对象" 一般是保存
 16    /// 在 "定位器" 中的。
 17    /// </remarks>
 18    public sealed class DependencyResolutionLocatorKey
 19    {
 20
 21        字段#region 字段
 22        private Type _type;
 23        private string _id;
 24        #endregion
 25
 26        属性#region 属性
 27        /**//// <summary>
 28        /// 要创建对象的字符
 29        /// 串标识。
 30        /// </summary>
 31        public string ID
 32        {
 33            get
 34            {
 35                return _id;
 36            }
 37        }
 38        /**//// <summary>
 39        /// 要创建对象的类型。
 40        /// </summary>
 41        public Type Type
 42        {
 43            get
 44            {
 45                return _type;
 46            }
 47        }
 48        #endregion
 49
 50        构造函数#region 构造函数
 51        /**//// <summary>
 52        /// 初始化 <see cref="DependencyResolutionLocatorKey"/> 类新实例。
 53        /// </summary>
 54        public DependencyResolutionLocatorKey() : this(null, null){}
 55        /**//// <summary>
 56        /// 初始化 <see cref="DependencyResolutionLocatorKey"/> 类新实例。
 57        /// </summary>
 58        /// <param name="type">
 59        /// 类型。
 60        /// </param>
 61        /// <param name="id">
 62        /// 字符串标识。
 63        /// </param>
 64        public DependencyResolutionLocatorKey(
 65            Type type,
 66            string id)
 67        {
 68            _id = id;
 69            _type = type;
 70        }
 71        #endregion
 72
 73        公有方法#region 公有方法
 74        /**//// <summary>
 75        /// 重写该代码可以使 
 76        /// "类型/标识" 对在
 77        /// 哈希表中正确地工
 78        /// 作。
 79        /// </summary>
 80        public override bool Equals(object obj)
 81        {
 82            DependencyResolutionLocatorKey other = obj as DependencyResolutionLocatorKey;
 83
 84            if (other == null)
 85            {
 86                return false;
 87            }
 88
 89            return (Equals(_type, other._type) && Equals(_id, other._id));
 90        }
 91        /**//// <summary>
 92        /// 重写该代码可以使 
 93        /// "类型/标识" 对在
 94        /// 哈希表中正确地工
 95        /// 作。
 96        /// </summary>
 97        public override int GetHashCode()
 98        {
 99            int hashForID = (_id == null) ? 0 : _id.GetHashCode();
100            int hashForType = (_type == null) ? 0 : _type.GetHashCode();
101            return hashForID ^ hashForType;
102        }
103        #endregion
104
105    }
106}

须继承的基类（或接口），然后为每个“插件实现”指定一个名称。当我们需要创建该“插件”的对象时，只需要使用这个基类型（或接口类型）和为该“插件实现”指定的名称，就可以马上确定要创建的是哪个插件了。