com.sun.xml.bind.unmarshaller

Class SAXUnmarshallerHandlerImpl

java.lang.Object

com.sun.xml.bind.unmarshaller.SAXUnmarshallerHandlerImpl

All Implemented Interfaces:

SAXUnmarshallerHandler, UnmarshallingContext, UnmarshallerHandler, ValidationEventHandler, NamespaceContext, ValidationContext, ContentHandler

Deprecated.

in JAXB1.0.1

public class SAXUnmarshallerHandlerImpl
extends Object
implements SAXUnmarshallerHandler, UnmarshallingContext

Implementation of UnmarshallerHandler. This object converts SAX events into unmarshaller events and cooridnates the entire unmarshalling process.

Since:

JAXB1.0

Author:

Constructor Summary

Constructors

Constructor and Description
SAXUnmarshallerHandlerImpl(UnmarshallerImpl _parent, TypeRegistry _reg) Deprecated.

Method Summary

Methods

Modifier and Type	Method and Description
void	addPatcher(Runnable job) Deprecated. Adds a job that will be executed at the last of the unmarshalling.
String	addToIdTable(String id) Deprecated. Adds the object which is currently being unmarshalled to the ID table.
void	characters(char[] buf, int start, int len) Deprecated.
void	consumeAttribute(int idx) Deprecated. Fires an attribute event for the specified attribute.
protected void	consumeText(String str, boolean ignorable) Deprecated.
void	endDocument() Deprecated.
void	endElement(String uri, String local, String qname) Deprecated.
void	endPrefixMapping(String prefix) Deprecated. Removes a namespace declaration.
int	getAttribute(String uri, String local) Deprecated. Gets the index of the attribute with the specified name.
String	getBaseUri() Deprecated. Returns the base URI of the context.
UnmarshallingEventHandler	getCurrentEventHandler() Deprecated. Gets the current handler.
ContentHandlerEx	getCurrentHandler() Deprecated.
Locator	getLocator() Deprecated. Gets the current source location information.
String	getNamespaceURI(String prefix) Deprecated.
UnmarshallableObject	getObjectFromId(String id) Deprecated. Looks up the ID table and gets associated object.
String	getPrefix(String uri) Deprecated.
Iterator	getPrefixes(String uri) Deprecated.
Object	getResult() Deprecated.
Tracer	getTracer() Deprecated. Gets a tracer object.
TypeRegistry	getTypeRegistry() Deprecated. Obtains a reference to the current type registry.
Attributes	getUnconsumedAttributes() Deprecated. Gets all the unconsumed attributes.
boolean	handleEvent(ValidationEvent event) Deprecated.
void	ignorableWhitespace(char[] buf, int start, int len) Deprecated.
boolean	isNotation(String s) Deprecated. Checks if a notation is declared with the specified name.
boolean	isUnparsedEntity(String s) Deprecated. Checks if an unparsed entity is declared with the specified name.
void	popAttributes() Deprecated. Discards the previously stored attribute set.
void	popContentHandler() Deprecated. Pops a content handler from the stack and registers it as the current content handler.
void	processingInstruction(String target, String data) Deprecated.
void	pushAttributes(Attributes atts) Deprecated. Stores a new attribute set.
void	pushContentHandler(UnmarshallingEventHandler handler, int memento) Deprecated. Pushes the current content handler into the stack and registers the newly specified content handler so that it can receive SAX events.
void	reportAndThrow(UnreportedException e) Deprecated.
String	resolveNamespacePrefix(String prefix) Deprecated. Resolves a namespace prefix to the corresponding namespace URI.
void	setDocumentLocator(Locator loc) Deprecated.
void	setTracer(Tracer t) Deprecated.
void	skippedEntity(String name) Deprecated.
void	startDocument() Deprecated.
void	startElement(String uri, String local, String qName, Attributes atts) Deprecated.
void	startPrefixMapping(String prefix, String uri) Deprecated. Adds a new namespace declaration.

Methods inherited from class java.lang.Object

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

Constructor Detail

SAXUnmarshallerHandlerImpl

public SAXUnmarshallerHandlerImpl(UnmarshallerImpl _parent,
                          TypeRegistry _reg)

Deprecated.

Method Detail

getTypeRegistry

public TypeRegistry getTypeRegistry()

Deprecated.

Description copied from interface: UnmarshallingContext

Obtains a reference to the current type registry.

Specified by:

getTypeRegistry in interface UnmarshallingContext

startDocument

public void startDocument()
                   throws SAXException

Deprecated.

Specified by:

startDocument in interface ContentHandler

Throws:

SAXException

endDocument

public void endDocument()
                 throws SAXException

Deprecated.

Specified by:

endDocument in interface ContentHandler

Throws:

SAXException

startElement

public void startElement(String uri,
                String local,
                String qName,
                Attributes atts)
                  throws SAXException

Deprecated.

Specified by:

startElement in interface ContentHandler

Throws:

SAXException

endElement

public final void endElement(String uri,
              String local,
              String qname)
                      throws SAXException

Deprecated.

Specified by:

endElement in interface ContentHandler

Throws:

SAXException

getResult

public Object getResult()
                 throws UnmarshalException

Deprecated.

Specified by:

getResult in interface UnmarshallerHandler

Throws:

UnmarshalException

pushContentHandler

public void pushContentHandler(UnmarshallingEventHandler handler,
                      int memento)

Deprecated.

Description copied from interface: UnmarshallingContext

Pushes the current content handler into the stack and registers the newly specified content handler so that it can receive SAX events.

Specified by:

pushContentHandler in interface UnmarshallingContext

memento - When this newly specified handler will be removed from the stack, the leaveChild event will be fired to the parent handler with this memento.

popContentHandler

public void popContentHandler()
                       throws UnreportedException

Deprecated.

Description copied from interface: UnmarshallingContext

Pops a content handler from the stack and registers it as the current content handler.

This method will also fire the leaveChild event with the associated memento.

Specified by:

popContentHandler in interface UnmarshallingContext

Throws:

UnreportedException

getCurrentHandler

public ContentHandlerEx getCurrentHandler()

Deprecated.

Description copied from interface: UnmarshallingContext

Gets the current handler.

Returns the same object as the getCurrentEventHandler but in a different type.

Specified by:

getCurrentHandler in interface UnmarshallingContext

getCurrentEventHandler

public UnmarshallingEventHandler getCurrentEventHandler()

Deprecated.

Description copied from interface: UnmarshallingContext

Gets the current handler.

Specified by:

getCurrentEventHandler in interface UnmarshallingContext

consumeText

protected void consumeText(String str,
               boolean ignorable)
                    throws UnreportedException

Deprecated.

Throws:

UnreportedException

characters

public final void characters(char[] buf,
              int start,
              int len)

Deprecated.

Specified by:

characters in interface ContentHandler

ignorableWhitespace

public final void ignorableWhitespace(char[] buf,
                       int start,
                       int len)

Deprecated.

Specified by:

ignorableWhitespace in interface ContentHandler

startPrefixMapping

public void startPrefixMapping(String prefix,
                      String uri)

Deprecated.

Description copied from interface: UnmarshallingContext

Adds a new namespace declaration. This method should be called by the generated code.

Specified by:

startPrefixMapping in interface UnmarshallingContext

Specified by:

startPrefixMapping in interface ContentHandler

endPrefixMapping

public void endPrefixMapping(String prefix)

Deprecated.

Description copied from interface: UnmarshallingContext

Removes a namespace declaration. This method should be called by the generated code.

Specified by:

endPrefixMapping in interface UnmarshallingContext

Specified by:

endPrefixMapping in interface ContentHandler

resolveNamespacePrefix

public String resolveNamespacePrefix(String prefix)

Deprecated.

Description copied from interface: ValidationContext

Resolves a namespace prefix to the corresponding namespace URI. This method is used for validating the QName type, for example.

If the prefix is "" (empty string), it indicates an unprefixed value. The callee should resolve it as for an unprefixed element, rather than for an unprefixed attribute.

If the prefix is "xml", then the callee must resolve this prefix into "http://www.w3.org/XML/1998/namespace", as defined in the XML Namespaces Recommendation.

Specified by:

resolveNamespacePrefix in interface ValidationContext

Returns:

namespace URI of this prefix. If the specified prefix is not declared, the implementation must return null.

getPrefixes

public Iterator getPrefixes(String uri)

Deprecated.

Specified by:

getPrefixes in interface NamespaceContext

getPrefix

public String getPrefix(String uri)

Deprecated.

Specified by:

getPrefix in interface NamespaceContext

getNamespaceURI

public String getNamespaceURI(String prefix)

Deprecated.

Specified by:

getNamespaceURI in interface NamespaceContext

pushAttributes

public void pushAttributes(Attributes atts)

Deprecated.

Description copied from interface: UnmarshallingContext

Stores a new attribute set. This method should be called by the generated code when it "eats" an enterElement event.

Specified by:

pushAttributes in interface UnmarshallingContext

popAttributes

public void popAttributes()

Deprecated.

Description copied from interface: UnmarshallingContext

Discards the previously stored attribute set. This method should be called by the generated code when it "eats" a leaveElement event.

Specified by:

popAttributes in interface UnmarshallingContext

getUnconsumedAttributes

public Attributes getUnconsumedAttributes()

Deprecated.

Description copied from interface: UnmarshallingContext

Gets all the unconsumed attributes. If you need to find attributes based on more complex filter, you need to use this method.

Specified by:

getUnconsumedAttributes in interface UnmarshallingContext

getAttribute

public int getAttribute(String uri,
               String local)

Deprecated.

Description copied from interface: UnmarshallingContext

Gets the index of the attribute with the specified name. This is usually faster when you only need to test with a simple name.

Specified by:

getAttribute in interface UnmarshallingContext

Returns:

-1 if not found.

consumeAttribute

public void consumeAttribute(int idx)
                      throws UnreportedException

Deprecated.

Description copied from interface: UnmarshallingContext

Fires an attribute event for the specified attribute.

Specified by:

consumeAttribute in interface UnmarshallingContext

Throws:

UnreportedException

addPatcher

public void addPatcher(Runnable job)

Deprecated.

Description copied from interface: UnmarshallingContext

Adds a job that will be executed at the last of the unmarshalling. This method is used to support ID/IDREF feature, but it can be used for other purposes as well.

Specified by:

addPatcher in interface UnmarshallingContext

Parameters:

job - The run method of this object is called.

addToIdTable

public String addToIdTable(String id)

Deprecated.

Description copied from interface: UnmarshallingContext

Adds the object which is currently being unmarshalled to the ID table.

Specified by:

addToIdTable in interface UnmarshallingContext

Returns:

Returns the value passed as the parameter. This is a hack, but this makes it easier for ID transducer to do its job.

getObjectFromId

public UnmarshallableObject getObjectFromId(String id)

Deprecated.

Description copied from interface: UnmarshallingContext

Looks up the ID table and gets associated object.

Specified by:

getObjectFromId in interface UnmarshallingContext

Returns:

If there is no object associated with the given id, this method returns null.

skippedEntity

public void skippedEntity(String name)

Deprecated.

Specified by:

skippedEntity in interface ContentHandler

processingInstruction

public void processingInstruction(String target,
                         String data)

Deprecated.

Specified by:

processingInstruction in interface ContentHandler

setDocumentLocator

public void setDocumentLocator(Locator loc)

Deprecated.

Specified by:

setDocumentLocator in interface ContentHandler

getLocator

public Locator getLocator()

Deprecated.

Description copied from interface: UnmarshallingContext

Gets the current source location information.

Specified by:

getLocator in interface UnmarshallingContext

handleEvent

public boolean handleEvent(ValidationEvent event)

Deprecated.

Specified by:

handleEvent in interface ValidationEventHandler

reportAndThrow

public void reportAndThrow(UnreportedException e)
                    throws SAXException

Deprecated.

Throws:

SAXException

getBaseUri

public String getBaseUri()

Deprecated.

Description copied from interface: ValidationContext

Returns the base URI of the context. The null string may be returned if no base URI is known.

Specified by:

getBaseUri in interface ValidationContext

isUnparsedEntity

public boolean isUnparsedEntity(String s)

Deprecated.

Description copied from interface: ValidationContext

Checks if an unparsed entity is declared with the specified name.

Specified by:

isUnparsedEntity in interface ValidationContext

Returns:

true if the DTD has an unparsed entity declaration for the specified name. false otherwise.

isNotation

public boolean isNotation(String s)

Deprecated.

Description copied from interface: ValidationContext

Checks if a notation is declared with the specified name.

Specified by:

isNotation in interface ValidationContext

Returns:

true if the DTD has a notation declaration for the specified name. false otherwise.

setTracer

public void setTracer(Tracer t)

Deprecated.

getTracer

public Tracer getTracer()

Deprecated.

Description copied from interface: UnmarshallingContext

Gets a tracer object. Tracer can be used to trace the unmarshalling behavior. Note that to debug the unmarshalling process, you have to configure XJC so that it will emit trace codes in the unmarshaller.

Specified by:

getTracer in interface UnmarshallingContext