OSHashTable 分析

DSS 定义了几个通用的较为复杂的数据结构，它们都以类的方式封装。这些数据结构不但贯穿于DSS的所有源代码，而且由于其封装的十分好，读者可以在看懂源代码 的基础上很容易的将它们从DSS的工程中抽取出来，构建自己的基础类库，为将来的开发工作打下良好的基础。另外，对这些基础数据结构源代码的研究将提高我 们对于面向对象技术的掌握和领会。

最主要的数据结构有四种：哈希表（OSHashTable）、队列（OSQueue）、堆（OSHeap）和对象引用表（OSRef）。前三种是我们在编 程中大量使用的数据结构，而对象引用表则是类似于COM/DCOM组件编程中IUNKOWN接口功能的数据结构，它首先为每个对象建立了一个字符串形式的 ID，以便于通过这个ID找到对象（类似于QueryInte*ce）；另外OSRef类还为每个对象实例建立了引用计数，只有一个对象不再被任何人引 用，才可能被释放（类似于AddRef和Release）。

鉴于这几个类在结构上有相似之处，下面我们将分析OSHashTable的源代码，以便能够帮助读者更好的理解其他几个类。OSHashTable的代码如下：

template<class T, class K>
class OSHashTable {
/*提示：OSHashTable被设计成为一个类模版，两个输入参数分别为：class T：实际的对象类；class K：用于为class T计算哈希表键值的功能类。*/
1 public:
2 OSHashTable( UInt32 size ) //构造函数，入参是哈希表中对象的最大个数
3 {
4 fHashTable = new ( T*[size] )； //申请分配size个哈希对象class T的空间
5 Assert( fHashTable )；
6 memset( fHashTable, 0, sizeof(T*) * size )； //初始化
7 fSize = size；
/*下面的代码决定用哪种方式为哈希表的键值计算索引；
如果哈希表的大小不是2的幂，只好采用对fSize求余的方法；
否则可以直接用掩码的方式，这种方式相对速度更快*/
8 fMask = fSize - 1；
9 if ((fMask & fSize) != 0) //fSize不是2的幂
10 fMask = 0；
11 fNumEntries = 0； //当前对象数
12 }
13 ~OSHashTable() //析构函数
14 {
15 delete [] fHashTable； //释放空间
16 }
//下面介绍向哈希表中添加一个class T对象的源代码
17 void Add( T* entry ) {
18 Assert( entry->fNextHashEntry == NULL )；
/*利用功能类class K，计算class T对象的哈希键值，其计算方法由用户在class K中定义*/
19 K key( entry )；
20 UInt32 theIndex = ComputeIndex( key.GetHashKey() )；//利用键值计算索引
21 entry->fNextHashEntry = fHashTable[ theIndex ]； //在新加对象中存储索引值
22 fHashTable[ theIndex ] = entry； //将该对象插入到索引指定的位置
23 fNumEntries++； /
24 }
//下面介绍从哈希表中删除一个class T对象的源代码
25 void Remove( T* entry )
26 {
//首先从哈希表中找到待删除的对象
//1、计算哈希键值和其对应的对象索引
27 key( entry )；
28 UInt32 theIndex = ComputeIndex( key.GetHashKey() )；
29 T* elem = fHashTable[ theIndex ]；
30 T* last = NULL；
/*2、通过对象索引查找对象，如果不是要找的对象，接着找下一个，直到找到为止。这是因为，存放的时候就是按照这种模式计算索引的。*/
31 while (elem && elem != entry) {
32 last = elem；
33 elem = elem->fNextHashEntry；
34 }
//找到该对象，将其删除
35 if ( elem )
36 {
37 Assert(elem)；
38 if (last)
39 last->fNextHashEntry = elem->fNextHashEntry；
40 else //elem在头部
41 fHashTable[ theIndex ] = elem->fNextHashEntry；
42 elem->fNextHashEntry = NULL；
43 fNumEntries--；
44 }
45 }
//下面介绍从哈希表中查找一个class T对象的方法
46 T* Map( K* key ) //入参为哈希键值
47 {
48 UInt32 theIndex = ComputeIndex( key->GetHashKey() )； //计算索引
49 T* elem = fHashTable[ theIndex ]； //找到索引对应的对象
50 while (elem) {
51 K elemKey( elem )；
52 if (elemKey =*key) //检查是否找对
53 break；
54 elem = elem->fNextHashEntry； //如果不是，继续找下一个
55 }
56 return elem；
57 }
//以下略…
}

以上介绍了哈希表的构造以及三种基本*作：添加、删除和查询。另外，DSS还定义了OSHashTableIter类用于枚举OSHashTable中的class T对象；其中主要的*作有First和Next等，限于篇幅，此处就不再详述。