001 //$HeadURL: https://svn.wald.intevation.org/svn/deegree/base/branches/2.3_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 }