001    //$HeadURL: svn+ssh://jwilden@svn.wald.intevation.org/deegree/base/branches/2.5_testing/src/org/deegree/framework/xml/XMLParsingException.java $
002    /*----------------------------------------------------------------------------
003     This file is part of deegree, http://deegree.org/
004     Copyright (C) 2001-2009 by:
005       Department of Geography, University of Bonn
006     and
007       lat/lon GmbH
008    
009     This library is free software; you can redistribute it and/or modify it under
010     the terms of the GNU Lesser General Public License as published by the Free
011     Software Foundation; either version 2.1 of the License, or (at your option)
012     any later version.
013     This library is distributed in the hope that it will be useful, but WITHOUT
014     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
015     FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
016     details.
017     You should have received a copy of the GNU Lesser General Public License
018     along with this library; if not, write to the Free Software Foundation, Inc.,
019     59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
020    
021     Contact information:
022    
023     lat/lon GmbH
024     Aennchenstr. 19, 53177 Bonn
025     Germany
026     http://lat-lon.de/
027    
028     Department of Geography, University of Bonn
029     Prof. Dr. Klaus Greve
030     Postfach 1147, 53001 Bonn
031     Germany
032     http://www.geographie.uni-bonn.de/deegree/
033    
034     e-mail: info@deegree.org
035    ----------------------------------------------------------------------------*/
036    package org.deegree.framework.xml;
037    
038    import org.deegree.ogcwebservices.OGCWebServiceException;
039    
040    /**
041     * This exception is thrown when a syntactic or semantic error has been encountered during the parsing process of an XML
042     * document.
043     *
044     * @author <a href="mailto:mschneider@lat-lon.de">Markus Schneider </a>
045     * @version $Revision: 18195 $
046     */
047    public class XMLParsingException extends Exception {
048    
049        private static final long serialVersionUID = -375766555263169888L;
050    
051        private String stackTrace = "<< is empty >>";
052    
053        private OGCWebServiceException wrapped;
054    
055        /**
056         * Creates a new instance of <code>XMLParsingException</code> without detail message.
057         */
058        XMLParsingException() {
059            super( "org.deegree.xml.XMLParsingException" );
060            // package protected constructor
061        }
062    
063        /**
064         * Workaround to beat the "no API change" policy.
065         *
066         * @param wrapException
067         *            ignored parameter, to avoid clashing with the other constructor taking a Throwable.
068         * @param wrapped
069         */
070        public XMLParsingException( boolean wrapException, OGCWebServiceException wrapped ) {
071            this.wrapped = wrapped;
072        }
073    
074        /**
075         * Constructs an instance of <code>XMLParsingException</code> with the specified detail message.
076         *
077         * @param msg
078         *            the detail message
079         */
080        public XMLParsingException( String msg ) {
081            super( msg );
082        }
083    
084        /**
085         * Constructs an instance of <code>XMLParsingException</code> with the specified cause.
086         *
087         * @param cause
088         *            the Throwable that caused this XMLParsingException
089         *
090         */
091        public XMLParsingException( Throwable cause ) {
092            super( "org.deegree.xml.XMLParsingException", cause );
093        }
094    
095        /**
096         * Constructs an instance of <code>XMLParsingException</code> with the specified detail message.
097         *
098         * @param msg
099         *            the detail message.
100         * @param e
101         *            the cause of the exception to be thrown.
102         */
103        public XMLParsingException( String msg, Throwable e ) {
104            this( msg );
105            if ( e != null ) {
106                StackTraceElement[] se = e.getStackTrace();
107                StringBuffer sb = new StringBuffer();
108                for ( int i = 0; i < se.length; i++ ) {
109                    sb.append( se[i].getClassName() + " " );
110                    sb.append( se[i].getFileName() + " " );
111                    sb.append( se[i].getMethodName() + "(" );
112                    sb.append( se[i].getLineNumber() + ")\n" );
113                }
114                stackTrace = e.getMessage() + sb.toString();
115            }
116        }
117    
118        /**
119         * @return the wrapped Throwable
120         */
121        public OGCWebServiceException getWrapped() {
122            return wrapped;
123        }
124    
125        @Override
126        public String toString() {
127            return getMessage() + "\n" + stackTrace;
128        }
129    
130    }