Class IllegalAnnotationException

  • All Implemented Interfaces:
    Serializable

    public class IllegalAnnotationException
    extends JAXBException
    Signals an incorrect use of JAXB annotations.
    Since:
    JAXB 2.0 EA1
    Author:
    Kohsuke Kawaguchi (kk@kohsuke.org)
    See Also:
    Serialized Form
    • Method Detail

      • getSourcePos

        public List<List<Location>> getSourcePos()
        Returns a read-only list of Location that indicates where in the source code the problem has happened.

        Normally, an annotation error happens on one particular annotation, in which case this method returns a list that contains another list, which in turn contains the location information that leads to the error location (IOW, [ [pos1,pos2,...,posN] ])

        Sometimes, an error could occur because of two or more conflicting annotations, in which case this method returns a list that contains many lists, where each list contains the location information that leads to each of the conflicting annotations (IOW, [ [pos11,pos12,...,pos1N],[pos21,pos22,...,pos2M], ... ])

        Yet some other time, the runtime can fail to provide any error location, in which case this method returns an empty list. (IOW, []). We do try hard to make sure this won't happen, so please let us know if you see this behavior.

        List of Location

        Each error location is identified not just by one Location object, but by a sequence of Locations that shows why the runtime is led to the place of the error. This list is sorted such that the most specific Location comes to the first in the list, sort of like a stack trace.

        For example, suppose you specify class Foo to JAXBContext, Foo derives from Bar, Bar has a field pea that points to Zot, Zot contains a gum property, and this property has an errornous annotation. Then when this exception is thrown, the list of Locations will look something like [ "gum property", "Zot class", "pea property", "Bar class", "Foo class" ]

        Returns:
        can be empty when no source position is available, but never null. The returned list will never contain null nor length-0 List.