org.mdiutil.xml

Class StopParsingException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.xml.sax.SAXException

org.mdiutil.xml.StopParsingException

All Implemented Interfaces:

Serializable

public class StopParsingException
extends SAXException

Used to stop SAX parsing in the least ugly way. It is impossible to stop SAX parsing without throwing an Exception, so we create a special one which only means "end of parsing". This is used to be able to stop the parsing programmatically by the handler beforethe end of the XML Stream. However, you should think about using Pull-Parsing if you rely on this kind of behavior. Note that this is only useful for SAX parsing, you don't need this kind of class if you use Stax parsing.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
StopParsingException() Create an exception.
StopParsingException(Object additionalContent) Create an exception, with an additional content.

Method Summary

Modifier and Type	Method and Description
Object	getAdditionalContent() Return the exception additional content.

Methods inherited from class org.xml.sax.SAXException

getCause, getException, getMessage, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

StopParsingException

public StopParsingException()

Create an exception.

StopParsingException

public StopParsingException(Object additionalContent)

Create an exception, with an additional content.

Parameters:

additionalContent - the additional content

Method Detail

getAdditionalContent

public Object getAdditionalContent()

Return the exception additional content.

Returns:

the exception additional content