Package com.sun.xml.bind.v2.runtime
Class Coordinator
- java.lang.Object
-
- com.sun.xml.bind.v2.runtime.Coordinator
-
- All Implemented Interfaces:
ValidationEventHandler
,ErrorHandler
- Direct Known Subclasses:
UnmarshallingContext
,XMLSerializer
public abstract class Coordinator extends Object implements ErrorHandler, ValidationEventHandler
Object that coordinates the marshalling/unmarshalling.This class takes care of the logic that allows code to obtain
UnmarshallingContext
andXMLSerializer
instances during the unmarshalling/marshalling.This is done by using a
ThreadLocal
. Therefore one unmarshalling/marshalling episode has to be done from the beginning till end by the same thread. (Note that the sameCoordinator
can be then used by a different thread for an entirely different episode.) This class also maintains the user-configured instances ofXmlAdapter
s.This class implements
ErrorHandler
and propages erros to this object as theValidationEventHandler
, which will be implemented in a derived class.- Author:
- Kohsuke Kawaguchi
-
-
Constructor Summary
Constructors Constructor Description Coordinator()
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description static Coordinator
_getInstance()
<T extends XmlAdapter>
booleancontainsAdapter(Class<T> type)
void
error(SAXParseException exception)
void
fatalError(SAXParseException exception)
<T extends XmlAdapter>
TgetAdapter(Class<T> key)
Gets the instance of the adapter.protected abstract ValidationEventLocator
getLocation()
Gets the current location.protected void
popCoordinator()
Called whenever an execution flow exits the realm of thisCoordinator
.protected void
pushCoordinator()
Called whenever an execution flow enters the realm of thisCoordinator
.XmlAdapter
putAdapter(Class<? extends XmlAdapter> c, XmlAdapter a)
void
warning(SAXParseException exception)
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface javax.xml.bind.ValidationEventHandler
handleEvent
-
-
-
-
Method Detail
-
putAdapter
public final XmlAdapter putAdapter(Class<? extends XmlAdapter> c, XmlAdapter a)
-
getAdapter
public final <T extends XmlAdapter> T getAdapter(Class<T> key)
Gets the instance of the adapter.- Returns:
- always non-null.
-
containsAdapter
public <T extends XmlAdapter> boolean containsAdapter(Class<T> type)
-
pushCoordinator
protected final void pushCoordinator()
Called whenever an execution flow enters the realm of thisCoordinator
.
-
popCoordinator
protected final void popCoordinator()
Called whenever an execution flow exits the realm of thisCoordinator
.
-
_getInstance
public static Coordinator _getInstance()
-
getLocation
protected abstract ValidationEventLocator getLocation()
Gets the current location. Used for reporting the error source location.
-
error
public final void error(SAXParseException exception) throws SAXException
- Specified by:
error
in interfaceErrorHandler
- Throws:
SAXException
-
warning
public final void warning(SAXParseException exception) throws SAXException
- Specified by:
warning
in interfaceErrorHandler
- Throws:
SAXException
-
fatalError
public final void fatalError(SAXParseException exception) throws SAXException
- Specified by:
fatalError
in interfaceErrorHandler
- Throws:
SAXException
-
-