nanoxml.XMLParseException Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of microemulator
MicroEmulator one jar assembly for distribution
The newest version!
/* 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;
   }
   
}