XMLStreamException (Java SE 25 & JDK 25)
Description: declaration: module: java.xml, package: javax.xml.stream, class: XMLStreamException
Keywords: javax.xml.stream.XMLStreamException class

# Class XMLStreamException

java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.xml.stream.XMLStreamException

All Implemented Interfaces:
  `Serializable`

public class XMLStreamException extends Exception
The base exception for unexpected processing errors. This Exception class is used to report well-formedness errors as well as unexpected processing conditions.

Since:
  1.6
See Also:
  - Serialized Form

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `protected Location`
  `location`
  The location of the error.
  `protected Throwable`
  `nested`
  The nested exception.

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `XMLStreamException()`
  Default constructor
  `XMLStreamException(String msg)`
  Construct an exception with the associated message.
  `XMLStreamException(String msg, Throwable th)`
  Construct an exception with the associated message and exception
  `XMLStreamException(String msg, Location location)`
  Construct an exception with the associated message, exception and location.
  `XMLStreamException(String msg, Location location, Throwable th)`
  Construct an exception with the associated message, exception and location.
  `XMLStreamException(Throwable th)`
  Construct an exception with the associated exception

- ## Method Summary

  Modifier and Type
  Method
  Description
  `Location`
  `getLocation()`
  Gets the location of the exception
  `Throwable`
  `getNestedException()`
  Gets the nested exception.

  ### Methods declared in class Throwable

  `addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString`

  ### Methods declared in class Object

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

- ## Field Details

  - ### nested

    protected Throwable nested
    The nested exception.

  - ### location

    protected Location location
    The location of the error.

- ## Constructor Details

  - ### XMLStreamException

    public XMLStreamException()
    Default constructor

  - ### XMLStreamException

    public XMLStreamException(String msg)
    Construct an exception with the associated message.
    Parameters:
      `msg` - the message to report

  - ### XMLStreamException

    public XMLStreamException(Throwable th)
    Construct an exception with the associated exception
    Parameters:
      `th` - a nested exception

  - ### XMLStreamException

    public XMLStreamException(String msg, Throwable th)
    Construct an exception with the associated message and exception
    Parameters:
      `msg` - the message to report
      `th` - a nested exception

  - ### XMLStreamException

    public XMLStreamException(String msg, Location location, Throwable th)
    Construct an exception with the associated message, exception and location.
    Parameters:
      `msg` - the message to report
      `location` - the location of the error
      `th` - a nested exception

  - ### XMLStreamException

    public XMLStreamException(String msg, Location location)
    Construct an exception with the associated message, exception and location.
    Parameters:
      `msg` - the message to report
      `location` - the location of the error

- ## Method Details

  - ### getNestedException

    public Throwable getNestedException()
    Gets the nested exception.
    Returns:
      Nested exception

  - ### getLocation

    public Location getLocation()
    Gets the location of the exception
    Returns:
      the location of the exception, may be null if none is available