http://xml.apache.org/http://www.apache.org/http://www.w3.org/

Home

Readme
Release Info

Installation
Download
Build

FAQs
Samples
API Docs

DOM C++ Binding
Programming
Migration Guide

Feedback
Bug-Reporting
PDF Document

CVS Repository
Mail Archive

API Docs for SAX and DOM
 

Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members  

SAXException.hpp

Go to the documentation of this file.
00001 /*
00002  * The Apache Software License, Version 1.1
00003  *
00004  * Copyright (c) 1999-2000 The Apache Software Foundation.  All rights
00005  * reserved.
00006  *
00007  * Redistribution and use in source and binary forms, with or without
00008  * modification, are permitted provided that the following conditions
00009  * are met:
00010  *
00011  * 1. Redistributions of source code must retain the above copyright
00012  *    notice, this list of conditions and the following disclaimer.
00013  *
00014  * 2. Redistributions in binary form must reproduce the above copyright
00015  *    notice, this list of conditions and the following disclaimer in
00016  *    the documentation and/or other materials provided with the
00017  *    distribution.
00018  *
00019  * 3. The end-user documentation included with the redistribution,
00020  *    if any, must include the following acknowledgment:
00021  *       "This product includes software developed by the
00022  *        Apache Software Foundation (http://www.apache.org/)."
00023  *    Alternately, this acknowledgment may appear in the software itself,
00024  *    if and wherever such third-party acknowledgments normally appear.
00025  *
00026  * 4. The names "Xerces" and "Apache Software Foundation" must
00027  *    not be used to endorse or promote products derived from this
00028  *    software without prior written permission. For written
00029  *    permission, please contact apache\@apache.org.
00030  *
00031  * 5. Products derived from this software may not be called "Apache",
00032  *    nor may "Apache" appear in their name, without prior written
00033  *    permission of the Apache Software Foundation.
00034  *
00035  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
00036  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
00037  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
00038  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
00039  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
00040  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
00041  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
00042  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
00043  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00044  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
00045  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
00046  * SUCH DAMAGE.
00047  * ====================================================================
00048  *
00049  * This software consists of voluntary contributions made by many
00050  * individuals on behalf of the Apache Software Foundation, and was
00051  * originally based on software copyright (c) 1999, International
00052  * Business Machines, Inc., http://www.ibm.com .  For more information
00053  * on the Apache Software Foundation, please see
00054  * <http://www.apache.org/>.
00055  */
00056 
00057 /*
00058  * $Log: SAXException.hpp,v $
00059  * Revision 1.6  2003/12/01 23:23:26  neilg
00060  * fix for bug 25118; thanks to Jeroen Witmond
00061  *
00062  * Revision 1.5  2003/08/13 15:43:24  knoaman
00063  * Use memory manager when creating SAX exceptions.
00064  *
00065  * Revision 1.4  2003/05/15 18:27:05  knoaman
00066  * Partial implementation of the configurable memory manager.
00067  *
00068  * Revision 1.3  2002/12/06 13:17:29  tng
00069  * [Bug 9083] Make SAXNotSupportedException and SAXNotRecognizedException to be exportable
00070  *
00071  * Revision 1.2  2002/11/04 14:56:26  tng
00072  * C++ Namespace Support.
00073  *
00074  * Revision 1.1.1.1  2002/02/01 22:22:08  peiyongz
00075  * sane_include
00076  *
00077  * Revision 1.8  2000/09/07 23:55:02  andyh
00078  * Fix SAXException assignment operator.  Now non-virtual, and
00079  * SAXParseException invokes base class operator.
00080  *
00081  * Revision 1.7  2000/08/09 22:06:04  jpolast
00082  * more functionality to SAXException and its children.
00083  * msgs are now functional for SAXNotSupportedEx and
00084  * SAXNotRecognizedEx
00085  *
00086  * Revision 1.6  2000/08/02 18:04:02  jpolast
00087  * include SAXNotSupportedException and
00088  * SAXNotRecognizedException needed for sax2
00089  *
00090  * Revision 1.5  2000/02/24 20:12:55  abagchi
00091  * Swat for removing Log from API docs
00092  *
00093  * Revision 1.4  2000/02/09 19:15:17  abagchi
00094  * Inserted documentation for new APIs
00095  *
00096  * Revision 1.3  2000/02/06 07:47:58  rahulj
00097  * Year 2K copyright swat.
00098  *
00099  * Revision 1.2  1999/12/18 00:21:23  roddey
00100  * Fixed a small reported memory leak
00101  *
00102  * Revision 1.1.1.1  1999/11/09 01:07:47  twl
00103  * Initial checkin
00104  *
00105  * Revision 1.2  1999/11/08 20:45:02  rahul
00106  * Swat for adding in Product name and CVS comment log variable.
00107  *
00108  */
00109 
00110 
00111 #ifndef SAXEXCEPTION_HPP
00112 #define SAXEXCEPTION_HPP
00113 
00114 #include <xercesc/util/XMLString.hpp>
00115 #include <xercesc/util/XMLUni.hpp>
00116 #include <xercesc/util/XMemory.hpp>
00117 
00118 XERCES_CPP_NAMESPACE_BEGIN
00119 
00120 
00140 class  SAXException : public XMemory
00141 {
00142 public:
00149     SAXException(MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager) :
00150 
00151         fMsg(XMLString::replicate(XMLUni::fgZeroLenString, manager))
00152         , fMemoryManager(manager)
00153     {
00154     }
00155 
00163     SAXException(const XMLCh* const msg,
00164                  MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager) :
00165 
00166         fMsg(XMLString::replicate(msg, manager))
00167         , fMemoryManager(manager)
00168     {
00169     }
00170 
00178     SAXException(const char* const msg,
00179                  MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager) :
00180 
00181         fMsg(XMLString::transcode(msg, manager))
00182         , fMemoryManager(manager)
00183     {
00184     }
00185 
00191     SAXException(const SAXException& toCopy) :
00192 
00193         fMsg(XMLString::replicate(toCopy.fMsg, toCopy.fMemoryManager))
00194         , fMemoryManager(toCopy.fMemoryManager)
00195     {
00196     }
00197 
00199     virtual ~SAXException()
00200     {
00201         fMemoryManager->deallocate(fMsg);//delete [] fMsg;
00202     }
00203 
00205 
00206 
00214     SAXException& operator=(const SAXException& toCopy)
00215     {
00216         if (this == &toCopy)
00217             return *this;
00218 
00219         fMemoryManager->deallocate(fMsg);//delete [] fMsg;
00220         fMsg = XMLString::replicate(toCopy.fMsg, toCopy.fMemoryManager);
00221         fMemoryManager = toCopy.fMemoryManager;
00222         return *this;
00223     }
00225 
00232     virtual const XMLCh* getMessage() const
00233     {
00234         return fMsg;
00235     }
00237 
00238 
00239 protected :
00240     // -----------------------------------------------------------------------
00241     //  Protected data members
00242     //
00243     //  fMsg
00244     //      This is the text of the error that is being thrown.
00245     // -----------------------------------------------------------------------
00246     XMLCh*  fMsg;
00247     MemoryManager* fMemoryManager;
00248 };
00249 
00250 class  SAXNotSupportedException : public SAXException
00251 {
00252 
00253 public:
00254     SAXNotSupportedException(MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
00255 
00263     SAXNotSupportedException(const XMLCh* const msg,
00264                              MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
00265 
00273     SAXNotSupportedException(const char* const msg,
00274                              MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
00275 
00281     SAXNotSupportedException(const SAXException& toCopy);
00282 };
00283 
00284 class  SAXNotRecognizedException : public SAXException
00285 {
00286 public:
00287     SAXNotRecognizedException(MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
00288 
00296     SAXNotRecognizedException(const XMLCh* const msg,
00297                               MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
00298 
00306     SAXNotRecognizedException(const char* const msg,
00307                               MemoryManager* const manager = XMLPlatformUtils::fgMemoryManager);
00308 
00314     SAXNotRecognizedException(const SAXException& toCopy);
00315 };
00316 
00317 XERCES_CPP_NAMESPACE_END
00318 
00319 #endif


Copyright © 2004 The Apache Software Foundation. All Rights Reserved.