RefHash3KeysIdPool.c
上传用户:huihehuasu
上传日期:2007-01-10
资源大小:6948k
文件大小:15k
源码类别:

xml/soap/webservice

开发平台:

C/C++

  1. /*
  2.  * The Apache Software License, Version 1.1
  3.  *
  4.  * Copyright (c) 2001 The Apache Software Foundation.  All rights
  5.  * reserved.
  6.  *
  7.  * Redistribution and use in source and binary forms, with or without
  8.  * modification, are permitted provided that the following conditions
  9.  * are met:
  10.  *
  11.  * 1. Redistributions of source code must retain the above copyright
  12.  *    notice, this list of conditions and the following disclaimer.
  13.  *
  14.  * 2. Redistributions in binary form must reproduce the above copyright
  15.  *    notice, this list of conditions and the following disclaimer in
  16.  *    the documentation and/or other materials provided with the
  17.  *    distribution.
  18.  *
  19.  * 3. The end-user documentation included with the redistribution,
  20.  *    if any, must include the following acknowledgment:
  21.  *       "This product includes software developed by the
  22.  *        Apache Software Foundation (http://www.apache.org/)."
  23.  *    Alternately, this acknowledgment may appear in the software itself,
  24.  *    if and wherever such third-party acknowledgments normally appear.
  25.  *
  26.  * 4. The names "Xerces" and "Apache Software Foundation" must
  27.  *    not be used to endorse or promote products derived from this
  28.  *    software without prior written permission. For written
  29.  *    permission, please contact apache@apache.org.
  30.  *
  31.  * 5. Products derived from this software may not be called "Apache",
  32.  *    nor may "Apache" appear in their name, without prior written
  33.  *    permission of the Apache Software Foundation.
  34.  *
  35.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  36.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  37.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  38.  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  39.  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  40.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  41.  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  42.  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  43.  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  44.  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  45.  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  46.  * SUCH DAMAGE.
  47.  * ====================================================================
  48.  *
  49.  * This software consists of voluntary contributions made by many
  50.  * individuals on behalf of the Apache Software Foundation, and was
  51.  * originally based on software copyright (c) 2001, International
  52.  * Business Machines, Inc., http://www.ibm.com .  For more information
  53.  * on the Apache Software Foundation, please see
  54.  * <http://www.apache.org/>.
  55.  */
  56. /**
  57.  * $Log: RefHash3KeysIdPool.c,v $
  58.  * Revision 1.4  2001/07/19 18:43:18  peiyongz
  59.  * fix: detect null poiniter in enumerator's ctor.
  60.  *
  61.  * Revision 1.3  2001/06/04 13:45:04  tng
  62.  * The "hash" argument clashes with STL hash.  Fixed by Pei Yong Zhang.
  63.  *
  64.  * Revision 1.2  2001/05/11 13:26:29  tng
  65.  * Copyright update.
  66.  *
  67.  * Revision 1.1  2001/03/21 21:56:12  tng
  68.  * Schema: Add Schema Grammar, Schema Validator, and split the DTDValidator into DTDValidator, DTDScanner, and DTDGrammar.
  69.  *
  70.  */
  71. // ---------------------------------------------------------------------------
  72. //  Include
  73. // ---------------------------------------------------------------------------
  74. #if defined(XERCES_TMPLSINC)
  75. #include <util/RefHash3KeysIdPool.hpp>
  76. #endif
  77. #include <util/NullPointerException.hpp>
  78. // ---------------------------------------------------------------------------
  79. //  RefHash3KeysIdPool: Constructors and Destructor
  80. // ---------------------------------------------------------------------------
  81. template <class TVal> RefHash3KeysIdPool<TVal>::RefHash3KeysIdPool(
  82.               const unsigned int modulus
  83.             , const bool adoptElems
  84.             , const unsigned int    initSize) :
  85.  fAdoptedElems(adoptElems)
  86.     , fBucketList(0)
  87.     , fHashModulus(modulus)
  88.     , fIdPtrs(0)
  89.     , fIdPtrsCount(initSize)
  90.     , fIdCounter(0)
  91. {
  92.     initialize(modulus);
  93.     // create default hasher
  94.     fHash = new HashXMLCh();
  95.     //
  96.     //  Allocate the initial id pointers array. We don't have to zero them
  97.     //  out since the fIdCounter value tells us which ones are valid. The
  98.     //  zeroth element is never used (and represents an invalid pool id.)
  99.     //
  100.     if (!fIdPtrsCount)
  101.         fIdPtrsCount = 256;
  102.     fIdPtrs = new TVal*[fIdPtrsCount];
  103.     fIdPtrs[0] = 0;
  104. }
  105. template <class TVal> RefHash3KeysIdPool<TVal>::RefHash3KeysIdPool(
  106.               const unsigned int modulus
  107.             , const bool adoptElems
  108.             , HashBase* hashBase
  109.             , const unsigned int    initSize) :
  110.  fAdoptedElems(adoptElems)
  111.     , fBucketList(0)
  112.     , fHashModulus(modulus)
  113.     , fIdPtrs(0)
  114.     , fIdPtrsCount(initSize)
  115.     , fIdCounter(0)
  116. {
  117.     initialize(modulus);
  118.     // set hasher
  119.     fHash = hashBase;
  120.     //
  121.     //  Allocate the initial id pointers array. We don't have to zero them
  122.     //  out since the fIdCounter value tells us which ones are valid. The
  123.     //  zeroth element is never used (and represents an invalid pool id.)
  124.     //
  125.     if (!fIdPtrsCount)
  126.         fIdPtrsCount = 256;
  127.     fIdPtrs = new TVal*[fIdPtrsCount];
  128.     fIdPtrs[0] = 0;
  129. }
  130. template <class TVal> RefHash3KeysIdPool<TVal>::RefHash3KeysIdPool(const unsigned int modulus
  131.             , const unsigned int    initSize) :
  132.  fAdoptedElems(true)
  133.     , fBucketList(0)
  134.     , fHashModulus(modulus)
  135.     , fIdPtrs(0)
  136.     , fIdPtrsCount(initSize)
  137.     , fIdCounter(0)
  138. {
  139.     initialize(modulus);
  140.     // create default hasher
  141.     fHash = new HashXMLCh();
  142.     //
  143.     //  Allocate the initial id pointers array. We don't have to zero them
  144.     //  out since the fIdCounter value tells us which ones are valid. The
  145.     //  zeroth element is never used (and represents an invalid pool id.)
  146.     //
  147.     if (!fIdPtrsCount)
  148.         fIdPtrsCount = 256;
  149.     fIdPtrs = new TVal*[fIdPtrsCount];
  150.     fIdPtrs[0] = 0;
  151. }
  152. template <class TVal> void RefHash3KeysIdPool<TVal>::initialize(const unsigned int modulus)
  153. {
  154. if (modulus == 0)
  155.         ThrowXML(IllegalArgumentException, XMLExcepts::HshTbl_ZeroModulus);
  156.     // Allocate the bucket list and zero them
  157.     fBucketList = new RefHash3KeysTableBucketElem<TVal>*[fHashModulus];
  158.     for (unsigned int index = 0; index < fHashModulus; index++)
  159.         fBucketList[index] = 0;
  160. }
  161. template <class TVal> RefHash3KeysIdPool<TVal>::~RefHash3KeysIdPool()
  162. {
  163.     removeAll();
  164.     // Then delete the bucket list & hasher & id pointers list
  165.     delete [] fIdPtrs;
  166.     delete [] fBucketList;
  167.     delete fHash;
  168. }
  169. // ---------------------------------------------------------------------------
  170. //  RefHash3KeysIdPool: Element management
  171. // ---------------------------------------------------------------------------
  172. template <class TVal> bool RefHash3KeysIdPool<TVal>::isEmpty() const
  173. {
  174.     // Just check the bucket list for non-empty elements
  175.     for (unsigned int buckInd = 0; buckInd < fHashModulus; buckInd++)
  176.     {
  177.         if (fBucketList[buckInd] != 0)
  178.             return false;
  179.     }
  180.     return true;
  181. }
  182. template <class TVal> bool RefHash3KeysIdPool<TVal>::
  183. containsKey(const void* const key1, const int key2, const int key3) const
  184. {
  185.     unsigned int hashVal;
  186.     const RefHash3KeysTableBucketElem<TVal>* findIt = findBucketElem(key1, key2, key3, hashVal);
  187.     return (findIt != 0);
  188. }
  189. template <class TVal> void RefHash3KeysIdPool<TVal>::removeAll()
  190. {
  191.     // Clean up the buckets first
  192.     for (unsigned int buckInd = 0; buckInd < fHashModulus; buckInd++)
  193.     {
  194.         // Get the bucket list head for this entry
  195.         RefHash3KeysTableBucketElem<TVal>* curElem = fBucketList[buckInd];
  196.         RefHash3KeysTableBucketElem<TVal>* nextElem;
  197.         while (curElem)
  198.         {
  199.             // Save the next element before we hose this one
  200.             nextElem = curElem->fNext;
  201.             // If we adopted the data, then delete it too
  202.             //    (Note:  the userdata hash table instance has data type of void *.
  203.             //    This will generate compiler warnings here on some platforms, but they
  204.             //    can be ignored since fAdoptedElements is false.
  205.             if (fAdoptedElems)
  206.                 delete curElem->fData;
  207.             // Then delete the current element and move forward
  208.             delete curElem;
  209.             curElem = nextElem;
  210.         }
  211.         // Clean out this entry
  212.         fBucketList[buckInd] = 0;
  213.     }
  214.     // Reset the id counter
  215.     fIdCounter = 0;
  216. }
  217. // ---------------------------------------------------------------------------
  218. //  RefHash3KeysIdPool: Getters
  219. // ---------------------------------------------------------------------------
  220. template <class TVal> TVal*
  221. RefHash3KeysIdPool<TVal>::getByKey(const void* const key1, const int key2, const int key3)
  222. {
  223.     unsigned int hashVal;
  224.     RefHash3KeysTableBucketElem<TVal>* findIt = findBucketElem(key1, key2, key3, hashVal);
  225.     if (!findIt)
  226.         return 0;
  227.     return findIt->fData;
  228. }
  229. template <class TVal> const TVal*
  230. RefHash3KeysIdPool<TVal>::getByKey(const void* const key1, const int key2, const int key3) const
  231. {
  232.     unsigned int hashVal;
  233.     const RefHash3KeysTableBucketElem<TVal>* findIt = findBucketElem(key1, key2, key3, hashVal);
  234.     if (!findIt)
  235.         return 0;
  236.     return findIt->fData;
  237. }
  238. template <class TVal> TVal*
  239. RefHash3KeysIdPool<TVal>::getById(const unsigned int elemId)
  240. {
  241.     // If its either zero or beyond our current id, its an error
  242.     if (!elemId || (elemId > fIdCounter))
  243.         ThrowXML(IllegalArgumentException, XMLExcepts::Pool_InvalidId);
  244.     return fIdPtrs[elemId];
  245. }
  246. template <class TVal> const TVal*
  247. RefHash3KeysIdPool<TVal>::getById(const unsigned int elemId) const
  248. {
  249.     // If its either zero or beyond our current id, its an error
  250.     if (!elemId || (elemId > fIdCounter))
  251.         ThrowXML(IllegalArgumentException, XMLExcepts::Pool_InvalidId);
  252.     return fIdPtrs[elemId];
  253. }
  254. // ---------------------------------------------------------------------------
  255. //  RefHash3KeysIdPool: Putters
  256. // ---------------------------------------------------------------------------
  257. template <class TVal> unsigned int
  258. RefHash3KeysIdPool<TVal>::put(void* key1, int key2, int key3, TVal* const valueToAdopt)
  259. {
  260.     // First see if the key exists already
  261.     unsigned int hashVal;
  262.     RefHash3KeysTableBucketElem<TVal>* newBucket = findBucketElem(key1, key2, key3, hashVal);
  263.     //
  264.     //  If so,then update its value. If not, then we need to add it to
  265.     //  the right bucket
  266.     //
  267.     if (newBucket)
  268.     {
  269.         if (fAdoptedElems)
  270.             delete newBucket->fData;
  271.         newBucket->fData = valueToAdopt;
  272.         newBucket->fKey1 = key1;
  273.         newBucket->fKey2 = key2;
  274.         newBucket->fKey3 = key3;
  275.     }
  276.      else
  277.     {
  278.         newBucket = new RefHash3KeysTableBucketElem<TVal>(key1, key2, key3, valueToAdopt, fBucketList[hashVal]);
  279.         fBucketList[hashVal] = newBucket;
  280.     }
  281.     //
  282.     //  Give this new one the next available id and add to the pointer list.
  283.     //  Expand the list if that is now required.
  284.     //
  285.     if (fIdCounter + 1 == fIdPtrsCount)
  286.     {
  287.         // Create a new count 1.5 times larger and allocate a new array
  288.         unsigned int newCount = (unsigned int)(fIdPtrsCount * 1.5);
  289.         TVal** newArray = new TVal*[newCount];
  290.         // Copy over the old contents to the new array
  291.         memcpy(newArray, fIdPtrs, fIdPtrsCount * sizeof(TVal*));
  292.         // Ok, toss the old array and store the new data
  293.         delete [] fIdPtrs;
  294.         fIdPtrs = newArray;
  295.         fIdPtrsCount = newCount;
  296.     }
  297.     const unsigned int retId = ++fIdCounter;
  298.     fIdPtrs[retId] = valueToAdopt;
  299.     // Set the id on the passed element
  300.     valueToAdopt->setId(retId);
  301.     // Return the id that we gave to this element
  302.     return retId;
  303. }
  304. // ---------------------------------------------------------------------------
  305. //  RefHash3KeysIdPool: Private methods
  306. // ---------------------------------------------------------------------------
  307. template <class TVal> RefHash3KeysTableBucketElem<TVal>* RefHash3KeysIdPool<TVal>::
  308. findBucketElem(const void* const key1, const int key2, const int key3, unsigned int& hashVal)
  309. {
  310.     // Hash the key
  311.     hashVal = fHash->getHashVal(key1, fHashModulus);
  312.     if (hashVal > fHashModulus)
  313.         ThrowXML(RuntimeException, XMLExcepts::HshTbl_BadHashFromKey);
  314.     // Search that bucket for the key
  315.     RefHash3KeysTableBucketElem<TVal>* curElem = fBucketList[hashVal];
  316.     while (curElem)
  317.     {
  318. if (fHash->equals(key1, curElem->fKey1) && (key2==curElem->fKey2) && (key3==curElem->fKey3))
  319.             return curElem;
  320.         curElem = curElem->fNext;
  321.     }
  322.     return 0;
  323. }
  324. template <class TVal> const RefHash3KeysTableBucketElem<TVal>* RefHash3KeysIdPool<TVal>::
  325. findBucketElem(const void* const key1, const int key2, const int key3, unsigned int& hashVal) const
  326. {
  327.     // Hash the key
  328.     hashVal = fHash->getHashVal(key1, fHashModulus);
  329.     if (hashVal > fHashModulus)
  330.         ThrowXML(RuntimeException, XMLExcepts::HshTbl_BadHashFromKey);
  331.     // Search that bucket for the key
  332.     const RefHash3KeysTableBucketElem<TVal>* curElem = fBucketList[hashVal];
  333.     while (curElem)
  334.     {
  335.         if (fHash->equals(key1, curElem->fKey1) && (key2==curElem->fKey2) && (key3==curElem->fKey3))
  336.             return curElem;
  337.         curElem = curElem->fNext;
  338.     }
  339.     return 0;
  340. }
  341. // ---------------------------------------------------------------------------
  342. //  RefHash3KeysIdPoolEnumerator: Constructors and Destructor
  343. // ---------------------------------------------------------------------------
  344. template <class TVal> RefHash3KeysIdPoolEnumerator<TVal>::
  345. RefHash3KeysIdPoolEnumerator(RefHash3KeysIdPool<TVal>* const toEnum, const bool adopt)
  346. : fAdoptedElems(adopt), fCurIndex(0), fToEnum(toEnum)
  347. {
  348.     if (!toEnum)  
  349.         ThrowXML(NullPointerException, XMLExcepts::CPtr_PointerIsZero);        
  350.     //
  351.     //  Find the next available bucket element in the pool. We use the id
  352.     //  array since its very easy to enumerator through by just maintaining
  353.     //  an index. If the id counter is zero, then its empty and we leave the
  354.     //  current index to zero.
  355.     //
  356.     if (toEnum->fIdCounter)
  357.         fCurIndex = 1;
  358. }
  359. template <class TVal> RefHash3KeysIdPoolEnumerator<TVal>::~RefHash3KeysIdPoolEnumerator()
  360. {
  361.     if (fAdoptedElems)
  362.         delete fToEnum;
  363. }
  364. // ---------------------------------------------------------------------------
  365. //  RefHash3KeysIdPoolEnumerator: Enum interface
  366. // ---------------------------------------------------------------------------
  367. template <class TVal> bool RefHash3KeysIdPoolEnumerator<TVal>::hasMoreElements() const
  368. {
  369.     // If our index is zero or past the end, then we are done
  370.     if (!fCurIndex || (fCurIndex > fToEnum->fIdCounter))
  371.         return false;
  372.     return true;
  373. }
  374. template <class TVal> TVal& RefHash3KeysIdPoolEnumerator<TVal>::nextElement()
  375. {
  376.     // If our index is zero or past the end, then we are done
  377.     if (!fCurIndex || (fCurIndex > fToEnum->fIdCounter))
  378.         ThrowXML(NoSuchElementException, XMLExcepts::Enum_NoMoreElements);
  379.     // Return the current element and bump the index
  380.     return *fToEnum->fIdPtrs[fCurIndex++];
  381. }
  382. template <class TVal> void RefHash3KeysIdPoolEnumerator<TVal>::Reset()
  383. {
  384.     fCurIndex = 0;
  385. }