ObjectBuilder 项目中 Utility 文件夹 — StrategyList 类(未)

  1using System;
  2using System.Collections.Generic;
  3
  4namespace Microsoft.Practices.ObjectBuilder
  5{
  6    /**//// <summary>
  7    /// 分阶段存储 "创建
  8    /// 策略" 的自定义集
  9    /// 合类。当调用 MakeStrategyChain 
 10    /// 和 MakeReverseStrategyChain
 11    /// 函数创建 "策略链" 
 12    /// 时，同一个 "创建
 13    /// 阶段" 的 "策略" 
 14    /// 之间的位置是连续
 15    /// 着的。
 16    /// </summary>
 17    /// <typeparam name="TStageEnum">
 18    ///  "创建阶段" 枚举
 19    /// 的类型。
 20    /// </typeparam>
 21    /// <remarks>
 22    /// 注意：一个 "创建
 23    /// 阶段" 可以包含若
 24    /// 干个 "创建策略"。
 25    /// </remarks>
 26    public class StrategyList<TStageEnum>
 27    {
 28
 29        字段#region 字段
 30        private Dictionary<TStageEnum, List<IBuilderStrategy>> stages = new Dictionary<TStageEnum, List<IBuilderStrategy>>();
 31        private object lockObject = new object();
 32        #endregion
 33
 34        常量#region 常量
 35        private readonly static Array stageValues = Enum.GetValues(typeof(TStageEnum));
 36        #endregion
 37
 38        构造函数#region 构造函数
 39        /**//// <summary>
 40        /// 初始化 <see cref="StrategyList{T}"/> 类新实例。
 41        /// </summary>
 42        public StrategyList()
 43        {
 44            foreach (TStageEnum stage in stageValues)
 45            {
 46                stages[stage] = new List<IBuilderStrategy>();
 47            }
 48        }
 49        #endregion
 50
 51        公有方法#region 公有方法
 52        /**//// <summary>
 53        /// 将 "策略" 添加到
 54        ///  "策略列表"。
 55        /// </summary>
 56        /// <param name="strategy">
 57        /// 要添加的 "策略"。
 58        /// </param>
 59        /// <param name="stage">
 60        /// 要在该 "创建阶段" 
 61        /// 中添加 "创建策略"。
 62        /// </param>
 63        public void Add(
 64            IBuilderStrategy strategy,
 65            TStageEnum stage)
 66        {
 67            lock (lockObject)
 68            {
 69                /**//* 
 70                 * 这里不会引发 NullReferenceException
 71                 * 异常，因为如果不
 72                 * 包含该 "创建阶段"，
 73                 * 则引发 KeyNotFoundException 
 74                 * 异常。
 75                 */
 76                stages[stage].Add(strategy);
 77            }
 78        }
 79        /**//// <summary>
 80        /// 创建一个新的 "策
 81        /// 略" 并添加到 "策
 82        /// 略列表"。
 83        /// </summary>
 84        /// <param name="stage">
 85        /// 要在该 "创建阶段" 
 86        /// 中添加 "创建策略"。
 87        /// </param>
 88        /// <typeparam name="TStrategy">
 89        /// 要创建的 "策略类
 90        /// 型" 。该 "策略" 
 91        /// 的类型必须具有缺
 92        /// 省的构造函数。
 93        /// </typeparam>
 94        public void AddNew<TStrategy>(TStageEnum stage) where TStrategy : IBuilderStrategy, new()
 95        {
 96            lock (lockObject)
 97            {
 98                /**//* 
 99                 * 这里不会引发 NullReferenceException
100                 * 异常，因为如果不
101                 * 包含该 "创建阶段"，
102                 * 则引发 KeyNotFoundException 
103                 * 异常。
104                 */
105                stages[stage].Add(new TStrategy());
106            }
107        }
108        /**//// <summary>
109        /// 根据当前 "策略列
110        ///  表" 中的 "策略" 
111        /// 创建一个"策略链"。
112        /// </summary>
113        /// <returns>
114        /// 新创建的 "策略链"。
115        /// </returns>
116        /// <remarks>
117        /// 该函数在使用 "OB 
118        /// 块" 创建一个对象
119        /// 时调用。
120        /// </remarks>
121        public IBuilderStrategyChain MakeStrategyChain()
122        {
123            lock (lockObject)
124            {
125                BuilderStrategyChain result = new BuilderStrategyChain();
126
127                /**//* 
128                 * 每一个 "阶段" 可
129                 * 以有若干个 "策略"。
130                 */
131                foreach (TStageEnum stage in stageValues)
132                {
133                    result.AddRange(stages[stage]);
134                }
135
136                return result;
137            }
138        }
139        /**//// <summary>
140        /// 根据当前 "策略列
141        ///  表" 中的 "策略" 
142        /// 创建一个顺序相反
143        /// 的 "策略链"。
144        /// </summary>
145        /// <returns>
146        /// 新创建的 "策略链"。
147        /// </returns>
148        /// <remarks>
149        /// 该函数在使用 "OB 
150        /// 块" 销毁一个对象
151        /// 时调用（以相反的
152        /// 顺序调用 "策略"）。
153        /// </remarks>
154        public IBuilderStrategyChain MakeReverseStrategyChain()
155        {
156            lock (lockObject)
157            {
158                List<IBuilderStrategy> tempList = new List<IBuilderStrategy>();
159
160                /**//* 
161                 * 每一个 "阶段" 可
162                 * 以有若干个 "策略"。
163                 */
164                foreach (TStageEnum stage in stageValues)
165                {
166                    tempList.AddRange(stages[stage]);
167                }
168
169                tempList.Reverse();
170                BuilderStrategyChain result = new BuilderStrategyChain();
171                result.AddRange(tempList);
172
173                return result;
174            }
175        }
176        /**//// <summary>
177        /// 清空 "策略列表"。
178        /// </summary>
179        public void Clear()
180        {
181            lock (lockObject)
182            {
183                foreach (TStageEnum stage in stageValues)
184                {
185                    stages[stage].Clear();
186                }
187            }
188        }
189        #endregion
190
191    }
192}
193