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

xml/soap/webservice

开发平台:

C/C++

  1. /*
  2.  * The Apache Software License, Version 1.1
  3.  * 
  4.  * Copyright (c) 1999-2000 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) 1999, 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: NameIdPool.c,v $
  58.  * Revision 1.3  2000/03/02 19:54:42  roddey
  59.  * This checkin includes many changes done while waiting for the
  60.  * 1.1.0 code to be finished. I can't list them all here, but a list is
  61.  * available elsewhere.
  62.  *
  63.  * Revision 1.2  2000/02/06 07:48:02  rahulj
  64.  * Year 2K copyright swat.
  65.  *
  66.  * Revision 1.1.1.1  1999/11/09 01:04:47  twl
  67.  * Initial checkin
  68.  *
  69.  * Revision 1.3  1999/11/08 20:45:10  rahul
  70.  * Swat for adding in Product name and CVS comment log variable.
  71.  *
  72.  */
  73. // ---------------------------------------------------------------------------
  74. //  Includes
  75. // ---------------------------------------------------------------------------
  76. #if defined(XERCES_TMPLSINC)
  77. #include <util/NameIdPool.hpp>
  78. #endif
  79. #include <util/IllegalArgumentException.hpp>
  80. #include <util/NoSuchElementException.hpp>
  81. #include <util/RuntimeException.hpp>
  82. // ---------------------------------------------------------------------------
  83. //  NameIdPoolBucketElem: Constructors and Destructor
  84. // ---------------------------------------------------------------------------
  85. template <class TElem> NameIdPoolBucketElem<TElem>::
  86. NameIdPoolBucketElem(TElem* const                           value
  87.                     , NameIdPoolBucketElem<TElem>* const    next) :
  88.     fData(value)
  89.     , fNext(next)
  90. {
  91. }
  92. template <class TElem> NameIdPoolBucketElem<TElem>::~NameIdPoolBucketElem()
  93. {
  94.     // Nothing to do
  95. }
  96. // ---------------------------------------------------------------------------
  97. //  NameIdPool: Constructors and Destructor
  98. // ---------------------------------------------------------------------------
  99. template <class TElem>
  100. NameIdPool<TElem>::NameIdPool(  const   unsigned int    hashModulus
  101.                                 , const unsigned int    initSize) :
  102.     fBucketList(0)
  103.     , fIdPtrs(0)
  104.     , fIdPtrsCount(initSize)
  105.     , fIdCounter(0)
  106.     , fHashModulus(hashModulus)
  107. {
  108.     if (!fHashModulus)
  109.         ThrowXML(IllegalArgumentException, XMLExcepts::Pool_ZeroModulus);
  110.     // Allocate the bucket list and zero them
  111.     fBucketList = new NameIdPoolBucketElem<TElem>*[fHashModulus];
  112.     for (unsigned int index = 0; index < fHashModulus; index++)
  113.         fBucketList[index] = 0;
  114.     //
  115.     //  Allocate the initial id pointers array. We don't have to zero them
  116.     //  out since the fIdCounter value tells us which ones are valid. The
  117.     //  zeroth element is never used (and represents an invalid pool id.)
  118.     //
  119.     if (!fIdPtrsCount)
  120.         fIdPtrsCount = 256;
  121.     fIdPtrs = new TElem*[fIdPtrsCount];
  122.     fIdPtrs[0] = 0;
  123. }
  124. template <class TElem> NameIdPool<TElem>::~NameIdPool()
  125. {
  126.     //
  127.     //  Delete the id pointers list. The stuff it points to will be cleaned
  128.     //  up when we clean the bucket lists.
  129.     //
  130.     delete [] fIdPtrs;
  131.     // Remove all elements then delete the bucket list
  132.     removeAll();
  133.     delete [] fBucketList;
  134. }
  135. // ---------------------------------------------------------------------------
  136. //  NameIdPool: Element management
  137. // ---------------------------------------------------------------------------
  138. template <class TElem> bool
  139. NameIdPool<TElem>::containsKey(const XMLCh* const key) const
  140. {
  141.     unsigned int hashVal;
  142.     const NameIdPoolBucketElem<TElem>* findIt = findBucketElem(key, hashVal);
  143.     return (findIt != 0);
  144. }
  145. template <class TElem> void NameIdPool<TElem>::removeAll()
  146. {
  147.     // Clean up the buckets first
  148.     for (unsigned int buckInd = 0; buckInd < fHashModulus; buckInd++)
  149.     {
  150.         NameIdPoolBucketElem<TElem>* curElem = fBucketList[buckInd];
  151.         NameIdPoolBucketElem<TElem>* nextElem;
  152.         while (curElem)
  153.         {
  154.             // Save the next element before we hose this one
  155.             nextElem = curElem->fNext;
  156.             delete curElem->fData;
  157.             delete curElem;
  158.             curElem = nextElem;
  159.         }
  160.         // Empty out the bucket
  161.         fBucketList[buckInd] = 0;
  162.     }
  163.     // Reset the id counter
  164.     fIdCounter = 0;
  165. }
  166. // ---------------------------------------------------------------------------
  167. //  NameIdPool: Getters
  168. // ---------------------------------------------------------------------------
  169. template <class TElem> TElem*
  170. NameIdPool<TElem>::getByKey(const XMLCh* const key)
  171. {
  172.     unsigned int hashVal;
  173.     NameIdPoolBucketElem<TElem>* findIt = findBucketElem(key, hashVal);
  174.     if (!findIt)
  175.         return 0;
  176.     return findIt->fData;
  177. }
  178. template <class TElem> const TElem*
  179. NameIdPool<TElem>::getByKey(const XMLCh* const key) const
  180. {
  181.     unsigned int hashVal;
  182.     const NameIdPoolBucketElem<TElem>* findIt = findBucketElem(key, hashVal);
  183.     if (!findIt)
  184.         return 0;
  185.     return findIt->fData;
  186. }
  187. template <class TElem> TElem*
  188. NameIdPool<TElem>::getById(const unsigned int elemId)
  189. {
  190.     // If its either zero or beyond our current id, its an error
  191.     if (!elemId || (elemId > fIdCounter))
  192.         ThrowXML(IllegalArgumentException, XMLExcepts::Pool_InvalidId);
  193.     return fIdPtrs[elemId];
  194. }
  195. template <class TElem>
  196. const TElem* NameIdPool<TElem>::getById(const unsigned int elemId) const
  197. {
  198.     // If its either zero or beyond our current id, its an error
  199.     if (!elemId || (elemId > fIdCounter))
  200.         ThrowXML(IllegalArgumentException, XMLExcepts::Pool_InvalidId);
  201.     return fIdPtrs[elemId];
  202. }
  203. // ---------------------------------------------------------------------------
  204. //  NameIdPool: Setters
  205. // ---------------------------------------------------------------------------
  206. template <class TElem>
  207. unsigned int NameIdPool<TElem>::put(TElem* const elemToAdopt)
  208. {
  209.     // First see if the key exists already. If so, its an error
  210.     unsigned int hashVal;
  211.     if (findBucketElem(elemToAdopt->getKey(), hashVal))
  212.     {
  213.         ThrowXML1
  214.         (
  215.             IllegalArgumentException
  216.             , XMLExcepts::Pool_ElemAlreadyExists
  217.             , elemToAdopt->getKey()
  218.         );
  219.     }
  220.     // Create a new bucket element and add it to the appropriate list
  221.     NameIdPoolBucketElem<TElem>* newBucket = new NameIdPoolBucketElem<TElem>
  222.     (
  223.         elemToAdopt
  224.         , fBucketList[hashVal]
  225.     );
  226.     fBucketList[hashVal] = newBucket;
  227.     //
  228.     //  Give this new one the next available id and add to the pointer list.
  229.     //  Expand the list if that is now required.
  230.     //
  231.     if (fIdCounter + 1 == fIdPtrsCount)
  232.     {
  233.         // Create a new count 1.5 times larger and allocate a new array
  234.         unsigned int newCount = (unsigned int)(fIdPtrsCount * 1.5);
  235.         TElem** newArray = new TElem*[newCount];
  236.         // Copy over the old contents to the new array
  237.         memcpy(newArray, fIdPtrs, fIdPtrsCount * sizeof(TElem*));
  238.         // Ok, toss the old array and store the new data
  239.         delete [] fIdPtrs;
  240.         fIdPtrs = newArray;
  241.         fIdPtrsCount = newCount;
  242.     }
  243.     const unsigned int retId = ++fIdCounter;
  244.     fIdPtrs[retId] = elemToAdopt;
  245.     // Set the id on the passed element
  246.     elemToAdopt->setId(retId);
  247.     // Return the id that we gave to this element
  248.     return retId;
  249. }
  250. // ---------------------------------------------------------------------------
  251. //  NameIdPool: Private methods
  252. // ---------------------------------------------------------------------------
  253. template <class TElem>
  254. NameIdPoolBucketElem<TElem>* NameIdPool<TElem>::
  255. findBucketElem(const XMLCh* const key, unsigned int& hashVal)
  256. {
  257.     // Hash the key
  258.     hashVal = XMLString::hash(key, fHashModulus);
  259.     if (hashVal > fHashModulus)
  260.         ThrowXML(RuntimeException, XMLExcepts::Pool_BadHashFromKey);
  261.     // Search that bucket for the key
  262.     NameIdPoolBucketElem<TElem>* curElem = fBucketList[hashVal];
  263.     while (curElem)
  264.     {
  265.         if (!XMLString::compareString(key, curElem->fData->getKey()))
  266.             return curElem;
  267.         curElem = curElem->fNext;
  268.     }
  269.     return 0;
  270. }
  271. template <class TElem>
  272. const NameIdPoolBucketElem<TElem>* NameIdPool<TElem>::
  273. findBucketElem(const XMLCh* const key, unsigned int& hashVal) const
  274. {
  275.     // Hash the key
  276.     hashVal = XMLString::hash(key, fHashModulus);
  277.     if (hashVal > fHashModulus)
  278.         ThrowXML(RuntimeException, XMLExcepts::Pool_BadHashFromKey);
  279.     // Search that bucket for the key
  280.     const NameIdPoolBucketElem<TElem>* curElem = fBucketList[hashVal];
  281.     while (curElem)
  282.     {
  283.         if (!XMLString::compareString(key, curElem->fData->getKey()))
  284.             return curElem;
  285.         curElem = curElem->fNext;
  286.     }
  287.     return 0;
  288. }
  289. // ---------------------------------------------------------------------------
  290. //  NameIdPoolEnumerator: Constructors and Destructor
  291. // ---------------------------------------------------------------------------
  292. template <class TElem> NameIdPoolEnumerator<TElem>::
  293. NameIdPoolEnumerator(NameIdPool<TElem>* const toEnum) :
  294.     fCurIndex(0)
  295.     , fToEnum(toEnum)
  296. {
  297.     //
  298.     //  Find the next available bucket element in the pool. We use the id
  299.     //  array since its very easy to enumerator through by just maintaining
  300.     //  an index. If the id counter is zero, then its empty and we leave the
  301.     //  current index to zero.
  302.     //
  303.     if (toEnum->fIdCounter)
  304.         fCurIndex = 1;
  305. }
  306. template <class TElem> NameIdPoolEnumerator<TElem>::
  307. NameIdPoolEnumerator(const NameIdPoolEnumerator<TElem>& toCopy) :
  308.     fCurIndex(toCopy.fCurIndex)
  309.     , fToEnum(toCopy.fToEnum)
  310. {
  311. }
  312. template <class TElem> NameIdPoolEnumerator<TElem>::~NameIdPoolEnumerator()
  313. {
  314.     // We don't own the pool being enumerated, so no cleanup required
  315. }
  316. // ---------------------------------------------------------------------------
  317. //  NameIdPoolEnumerator: Public operators
  318. // ---------------------------------------------------------------------------
  319. template <class TElem> NameIdPoolEnumerator<TElem>& NameIdPoolEnumerator<TElem>::
  320. operator=(const NameIdPoolEnumerator<TElem>& toAssign)
  321. {
  322.     if (this == &toAssign)
  323.         return *this;
  324.     fCurIndex   = toAssign.fCurIndex;
  325.     fToEnum     = toAssign.fToEnum;
  326.     return *this;
  327. }
  328. // ---------------------------------------------------------------------------
  329. //  NameIdPoolEnumerator: Enum interface
  330. // ---------------------------------------------------------------------------
  331. template <class TElem> bool NameIdPoolEnumerator<TElem>::
  332. hasMoreElements() const
  333. {
  334.     // If our index is zero or past the end, then we are done
  335.     if (!fCurIndex || (fCurIndex > fToEnum->fIdCounter))
  336.         return false;
  337.     return true;
  338. }
  339. template <class TElem> TElem& NameIdPoolEnumerator<TElem>::nextElement()
  340. {
  341.     // If our index is zero or past the end, then we are done
  342.     if (!fCurIndex || (fCurIndex > fToEnum->fIdCounter))
  343.         ThrowXML(NoSuchElementException, XMLExcepts::Enum_NoMoreElements);
  344.     // Return the current element and bump the index
  345.     return *fToEnum->fIdPtrs[fCurIndex++];
  346. }
  347. template <class TElem> void NameIdPoolEnumerator<TElem>::Reset()
  348. {
  349.     fCurIndex = 0;
  350. }