|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: REQUIRED | OPTIONAL | DETAIL: ELEMENT |
@Retention(value=RUNTIME) @Target(value={FIELD,METHOD}) public @interface XmlLocation
Marks a property that receives a location from which the object is unmarshalled.
The @XmlLocation can be specified on:
Locator
, or
Locator
as the sole parameter
When a class that contains such a field/method is unmarshalled by the JAXB RI,
such a field/method will receive an immutable Locator
object that describes
the location in the XML document where the object is unmarshalled from.
If the unmarshaller does not know the source location information, the locator will not be set. For example, this happens when it is unmarshalling from a DOM tree. This also happens if you use JAXB implementations other than the JAXB RI.
This information can be used by applications, for example to provide user-friendly error information.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: REQUIRED | OPTIONAL | DETAIL: ELEMENT |