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

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.  * $Id: XMLException.hpp,v 1.7 2001/11/30 22:19:56 peiyongz Exp $
  58.  */
  59. #if !defined(EXCEPTION_HPP)
  60. #define EXCEPTION_HPP
  61. #include <util/XercesDefs.hpp>
  62. #include <util/XMLExceptMsgs.hpp>
  63. #include <util/XMLUni.hpp>
  64. #include <framework/XMLErrorReporter.hpp>
  65. // ---------------------------------------------------------------------------
  66. //  This is the base class from which all the XML parser exceptions are
  67. //  derived. The virtual interface is very simple and most of the functionality
  68. //  is in this class.
  69. //
  70. //  Because all derivatives are EXACTLY the same except for the static
  71. //  string that is used to hold the name of the class, a macro is provided
  72. //  below via which they are all created.
  73. // ---------------------------------------------------------------------------
  74. class XMLUTIL_EXPORT XMLException
  75. {
  76. public:
  77.     // -----------------------------------------------------------------------
  78.     //  Virtual Destructor
  79.     // -----------------------------------------------------------------------
  80.     virtual ~XMLException();
  81.     // -----------------------------------------------------------------------
  82.     //  The XML exception virtual interface
  83.     // -----------------------------------------------------------------------
  84.     virtual const XMLCh* getType() const = 0;
  85.     // -----------------------------------------------------------------------
  86.     //  Getter methods
  87.     // -----------------------------------------------------------------------
  88.     XMLExcepts::Codes getCode() const;
  89.     const XMLCh* getMessage() const;
  90.     const char* getSrcFile() const;
  91.     unsigned int getSrcLine() const;
  92.     XMLErrorReporter::ErrTypes getErrorType() const;
  93.     // -----------------------------------------------------------------------
  94.     //  Setter methods
  95.     // -----------------------------------------------------------------------
  96.     void setPosition(const char* const file, const unsigned int line);
  97.     // -----------------------------------------------------------------------
  98.     //  Hidden constructors and operators
  99.     //
  100.     //  NOTE:   Technically, these should be protected, since this is a
  101.     //          base class that is never used directly. However, VC++ 6.0 will
  102.     //          fail to catch via a reference to base class if the ctors are
  103.     //          not public!! This seems to have been caused by the install
  104.     //          of IE 5.0.
  105.     // -----------------------------------------------------------------------
  106.     XMLException();
  107.     XMLException(const char* const srcFile, const unsigned int srcLine);
  108.     XMLException(const XMLException& toCopy);
  109.     void operator=(const XMLException& toAssign);
  110.     // -----------------------------------------------------------------------
  111.     //  Notification that lazy data has been deleted
  112.     // -----------------------------------------------------------------------
  113. static void reinitMsgMutex();
  114. static void reinitMsgLoader();
  115. protected :
  116.     // -----------------------------------------------------------------------
  117.     //  Protected methods
  118.     // -----------------------------------------------------------------------
  119.     void loadExceptText
  120.     (
  121.         const   XMLExcepts::Codes toLoad
  122.     );
  123.     void loadExceptText
  124.     (
  125.         const   XMLExcepts::Codes toLoad
  126.         , const XMLCh* const        text1
  127.         , const XMLCh* const        text2 = 0
  128.         , const XMLCh* const        text3 = 0
  129.         , const XMLCh* const        text4 = 0
  130.     );
  131.     void loadExceptText
  132.     (
  133.         const   XMLExcepts::Codes toLoad
  134.         , const char* const         text1
  135.         , const char* const         text2 = 0
  136.         , const char* const         text3 = 0
  137.         , const char* const         text4 = 0
  138.     );
  139. private :
  140.     // -----------------------------------------------------------------------
  141.     //  Data members
  142.     //
  143.     //  fCode
  144.     //      The error code that this exception represents.
  145.     //
  146.     //  fSrcFile
  147.     //  fSrcLine
  148.     //      These are the file and line information from the source where the
  149.     //      exception was thrown from.
  150.     //
  151.     //  fMsg
  152.     //      The loaded message text for this exception.
  153.     // -----------------------------------------------------------------------
  154.     XMLExcepts::Codes fCode;
  155.     char*               fSrcFile;
  156.     unsigned int        fSrcLine;
  157.     XMLCh*              fMsg;
  158. };
  159. // ---------------------------------------------------------------------------
  160. //  XMLException: Getter methods
  161. // ---------------------------------------------------------------------------
  162. inline XMLExcepts::Codes XMLException::getCode() const
  163. {
  164.     return fCode;
  165. }
  166. inline const XMLCh* XMLException::getMessage() const
  167. {
  168.     return fMsg;
  169. }
  170. inline const char* XMLException::getSrcFile() const
  171. {
  172.     if (!fSrcFile)
  173.         return "";
  174.     return fSrcFile;
  175. }
  176. inline unsigned int XMLException::getSrcLine() const
  177. {
  178.     return fSrcLine;
  179. }
  180. inline XMLErrorReporter::ErrTypes XMLException::getErrorType() const
  181. {
  182.    if ((fCode >= XMLExcepts::W_LowBounds) && (fCode <= XMLExcepts::W_HighBounds))
  183.        return XMLErrorReporter::ErrType_Warning;
  184.    else if ((fCode >= XMLExcepts::F_LowBounds) && (fCode <= XMLExcepts::F_HighBounds))
  185.         return XMLErrorReporter::ErrType_Fatal;
  186.    else if ((fCode >= XMLExcepts::E_LowBounds) && (fCode <= XMLExcepts::E_HighBounds))
  187.         return XMLErrorReporter::ErrType_Error;
  188.    return XMLErrorReporter::ErrTypes_Unknown;
  189. }
  190. // ---------------------------------------------------------------------------
  191. //  This macro is used to create derived classes. They are all identical
  192. //  except the name of the exception, so it crazy to type them in over and
  193. //  over.
  194. // ---------------------------------------------------------------------------
  195. #define MakeXMLException(theType, expKeyword) 
  196. class expKeyword theType : public XMLException 
  197. public: 
  198.  
  199.     theType(const   char* const         srcFile 
  200.             , const unsigned int        srcLine 
  201.             , const XMLExcepts::Codes toThrow) : 
  202.         XMLException(srcFile, srcLine) 
  203.     { 
  204.         loadExceptText(toThrow); 
  205.     } 
  206.  
  207.     theType(const theType& toCopy) : 
  208.  
  209.         XMLException(toCopy) 
  210.     { 
  211.     } 
  212.   
  213.     theType(const   char* const         srcFile 
  214.             , const unsigned int        srcLine 
  215.             , const XMLExcepts::Codes toThrow 
  216.             , const XMLCh* const        text1 
  217.             , const XMLCh* const        text2 = 0 
  218.             , const XMLCh* const        text3 = 0 
  219.             , const XMLCh* const        text4 = 0) : 
  220.         XMLException(srcFile, srcLine) 
  221.     { 
  222.         loadExceptText(toThrow, text1, text2, text3, text4); 
  223.     } 
  224.  
  225.     theType(const   char* const         srcFile 
  226.             , const unsigned int        srcLine 
  227.             , const XMLExcepts::Codes toThrow 
  228.             , const char* const         text1 
  229.             , const char* const         text2 = 0 
  230.             , const char* const         text3 = 0 
  231.             , const char* const         text4 = 0) : 
  232.         XMLException(srcFile, srcLine) 
  233.     { 
  234.         loadExceptText(toThrow, text1, text2, text3, text4); 
  235.     } 
  236.  
  237.     virtual ~theType() {} 
  238.  
  239.     theType& operator=(const theType& toAssign) 
  240.     { 
  241.         XMLException::operator=(toAssign); 
  242.         return *this; 
  243.     } 
  244.  
  245.     virtual XMLException* duplicate() const 
  246.     { 
  247.         return new theType(*this); 
  248.     } 
  249.  
  250.     virtual const XMLCh* getType() const 
  251.     { 
  252.         return XMLUni::fg##theType##_Name; 
  253.     } 
  254.  
  255. private : 
  256.     theType(); 
  257. };
  258. // ---------------------------------------------------------------------------
  259. //  This macros is used to actually throw an exception. It is used in order
  260. //  to make sure that source code line/col info is stored correctly, and to
  261. //  give flexibility for other stuff in the future.
  262. // ---------------------------------------------------------------------------
  263. #define ThrowXML(type,code) throw type(__FILE__, __LINE__, code)
  264. #define ThrowXML1(type,code,p1) throw type(__FILE__, __LINE__, code, p1)
  265. #define ThrowXML2(type,code,p1,p2) throw type(__FILE__, __LINE__, code, p1, p2)
  266. #define ThrowXML3(type,code,p1,p2,p3) throw type(__FILE__, __LINE__, code, p1, p2, p3)
  267. #define ThrowXML4(type,code,p1,p2,p3,p4) throw type(__FILE__, __LINE__, code, p1, p2, p3, p4)
  268. #endif