nanoxml.XMLParseException Maven / Gradle / Ivy
/* XMLParseException.java NanoXML/Lite
*
* This file is part of NanoXML 2 Lite.
* Copyright (C) 2000-2002 Marc De Scheemaecker, All Rights Reserved.
*
* This software is provided 'as-is', without any express or implied warranty.
* In no event will the authors be held liable for any damages arising from the
* use of this software.
*
* Permission is granted to anyone to use this software for any purpose,
* including commercial applications, and to alter it and redistribute it
* freely, subject to the following restrictions:
*
* 1. The origin of this software must not be misrepresented; you must not
* claim that you wrote the original software. If you use this software in
* a product, an acknowledgment in the product documentation would be
* appreciated but is not required.
*
* 2. Altered source versions must be plainly marked as such, and must not be
* misrepresented as being the original software.
*
* 3. This notice may not be removed or altered from any source distribution.
*/
package nanoxml;
/**
* An XMLParseException is thrown when an error occures while parsing an XML
* string.
*
* @see nanoxml.XMLElement
*
* @author Marc De Scheemaecker
*/
public class XMLParseException
extends RuntimeException
{
/**
* Indicates that no line number has been associated with this exception.
*/
public static final int NO_LINE = -1;
/**
* The line number in the source code where the error occurred, or
* NO_LINE
if the line number is unknown.
*
*
- Invariants:
-
*
lineNr > 0 || lineNr == NO_LINE
*
*/
private int lineNr;
/**
* Creates an exception.
*
* @param name The name of the element where the error is located.
* @param message A message describing what went wrong.
*
* - Preconditions:
-
*
message != null
*
*
* - Postconditions:
-
*
- getLineNr() => NO_LINE
*
*/
public XMLParseException(String name,
String message)
{
super("XML Parse Exception during parsing of "
+ ((name == null) ? "the XML definition"
: ("a " + name + " element"))
+ ": " + message);
this.lineNr = XMLParseException.NO_LINE;
}
/**
* Creates an exception.
*
* @param name The name of the element where the error is located.
* @param lineNr The number of the line in the input.
* @param message A message describing what went wrong.
*
*
- Preconditions:
-
*
message != null
* lineNr > 0
*
*
* - Postconditions:
-
*
- getLineNr() => lineNr
*
*/
public XMLParseException(String name,
int lineNr,
String message)
{
super("XML Parse Exception during parsing of "
+ ((name == null) ? "the XML definition"
: ("a " + name + " element"))
+ " at line " + lineNr + ": " + message);
this.lineNr = lineNr;
}
/**
* Where the error occurred, or NO_LINE
if the line number is
* unknown.
*
* @see nanoxml.XMLParseException#NO_LINE
*/
public int getLineNr()
{
return this.lineNr;
}
}