1. 缘起:
假设我们的订单系统需要管理所有未处理的订单,而客人经常需要查询属于自己的未处理的订单列表。另外,可能客服人员也需要根据订单 ID 迅速地找到对应的未处理订单。基于第一个需求,我们就可以将未处理的订单依据客人的帐号进行分组管理。
我设计了 ESBasic.ObjectManagement.Managers.IGroupingObjectManager 分组对象管理器来完成对对象进行分组管理的功能。
分组对象管理器的形象示意图如下:
2. 适用场合:
当你的需求覆盖以下条件时,就非常合适使用分组对象管理器:
(1) 被管理的每个对象都有唯一的 ID 。
(2) 被管理的对象可以依据某个标志进行分组。
(3) 经常需要根据分组标志来查询符合该标志的对象列表。
(4) 经常需要向管理器中增加 / 移除被分组的对象。
(5) 经常需要根据对象 ID 快速查找对应的对象。
3 .设计思想与实现
IGroupingObjectManager 的接口定义如下:
{
/// <summary>
/// Add如果已经存在同ID的对象,则用新对象替换旧对象。
/// </summary>
void Add(TObjectobj);
void Remove(TObjectKeyobjectID);
/// <summary>
/// Clear清除所有对象与分组。
/// </summary>
void Clear();
TObjectGet(TObjectKeyobjectID);
int TotalObjectCount{ get ;}
/// <summary>
/// GetCountOfGroup获取某个分组中的对象的个数。
/// </summary>
int GetCountOfGroup(TGroupKeygroupID);
/// <summary>
/// GetAllObjectsCopy获取管理器中的所有对象列表。
/// </summary>
IList < TObject > GetAllObjectsCopy();
/// <summary>
/// GetGroupsCopy获取所有的分组标志列表。
/// </summary>
IList < TGroupKey > GetGroupsCopy();
/// <summary>
/// GetObjectsCopy获取某个分组中的所有对象的列表。
/// </summary>
IList < TObject > GetObjectsCopy(TGroupKeygroupID);
}
这个接口包含有三个泛型参数: TGroupKey 、 TObjectKey 和 TObject 。
TObject 是被管理的对象的类型。
TObjectKey 是被管理的对象的 ID 的类型。
TGroupKey 是对被管理的对象进行分组的标志的类型。
另外,该接口的泛型参数还有一个约束,即 TObject 必须从 IGroupingObject 接口继承,以表明自己是一个可以被分组的对象。
IGroupingObject 接口很简单,其定义如下:
{
TObjectKeyID{ get ;}
TGroupKeyGroupID{ get ;}
}
观察这个接口告诉我们,只要一个对象有唯一的 ID ,并且有分组的标志,那么这个对象就可以被对象分组管理器进行管理了。
关于 GroupingObjectManager 的实现要注意以下几点:
(1) GroupingObjectManager 使用了两个字典集合: objectDictionary 、 groupDictionary 。 objectDictionary 用于存储所有被管理的对象。 groupDictionary 用于管理所有的分组,而且 groupDictionary 的 Value 又是另外一个字典,用于存储属于这一分组的所有对象。
(2) GroupingObjectManager 的实现是线程安全的,所以可以在多线程的环境中使用。我们对其内部的两个字典集合都进行了加锁控制。
(3) Add 方法采用的也是覆盖原则――如果同 Key 的对象已经存在,则用新对象覆盖旧的对象。
4. 使用时的注意事项
当调用 Remove 方法删除的是某个分组中的最后一个对象时,在该对象被删除后,对应的分组将也会被删除。所以,管理器中不会存在“空”的历史分组。也就是说, GetGroupsCopy 方法返回的分组标志列表中的每个分组标志在管理器中对应的分组都包含至少一个被分组对象。
5. 扩展
分组对象管理器 IGroupingObjectManager 暂时没有任何扩展。
注:ESBasic源码可到
http://esbasic.codeplex.com/
下载。
ESBasic讨论:37677395
ESBasic开源前言