com.sun.xml.bind.unmarshaller

Class DOMScanner

java.lang.Object

com.sun.xml.bind.unmarshaller.DOMScanner

All Implemented Interfaces:

InfosetScanner, LocatorEx, Locator

public class DOMScanner
extends Object
implements LocatorEx, InfosetScanner

Visits a W3C DOM tree and generates SAX2 events from it.

This class is just intended to be used by AbstractUnmarshallerImpl. The javax.xml.bind.helpers package is generally a wrong place to put classes like this.

Since:

JAXB 1.0

Author:

• Kohsuke Kawaguchi, Sun Microsystems, Inc.

Nested Class Summary

Nested classes/interfaces inherited from interface com.sun.xml.bind.v2.runtime.unmarshaller.LocatorEx

LocatorEx.Snapshot

Constructor Summary

Constructors

Constructor and Description
DOMScanner()

Method Summary

Methods

Modifier and Type	Method and Description
int	getColumnNumber()
ContentHandler	getContentHandler()
Object	getCurrentElement() Gets the current element we are parsing.
Node	getCurrentLocation() The same as getCurrentElement() but better typed.
int	getLineNumber()
ValidationEventLocator	getLocation() Gets the current location in a ValidationEventLocator object.
LocatorEx	getLocator()
String	getPublicId()
String	getSystemId()
void	parse(Element e, ContentHandler handler) Deprecated. in JAXB 2.0 Use scan(Element)
void	parseWithContext(Element e, ContentHandler handler) Deprecated. in JAXB 2.0 Use scan(Element)
void	scan(Document doc)
void	scan(Element e)
void	scan(Object node) Parses the given DOM-ish element/document and generates SAX events.
void	setContentHandler(ContentHandler handler) Sets the ContentHandler.
void	setLocator(Locator loc) Configures the locator object that the SAX ContentHandler will see.
void	visit(Element e) Visits an element and its subtree.

Methods inherited from class java.lang.Object

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

Constructor Detail

DOMScanner

public DOMScanner()

Method Detail

setLocator

public void setLocator(Locator loc)

Configures the locator object that the SAX ContentHandler will see.

scan

public void scan(Object node)
          throws SAXException

Description copied from interface: InfosetScanner

Parses the given DOM-ish element/document and generates SAX events.

Specified by:

scan in interface InfosetScanner

Throws:

SAXException - If the ContentHandler throws a SAXException. Do not throw an exception just because the scanner failed (if that can happen we need to change the API.)

scan

public void scan(Document doc)
          throws SAXException

Throws:

SAXException

scan

public void scan(Element e)
          throws SAXException

Throws:

SAXException

parse

public void parse(Element e,
         ContentHandler handler)
           throws SAXException

Deprecated. in JAXB 2.0 Use scan(Element)

Parses a subtree starting from the element e and reports SAX2 events to the specified handler.

Throws:

SAXException

parseWithContext

public void parseWithContext(Element e,
                    ContentHandler handler)
                      throws SAXException

Deprecated. in JAXB 2.0 Use scan(Element)

Similar to the parse method but it visits the ancestor nodes and properly emulate the all in-scope namespace declarations.

Throws:

SAXException

visit

public void visit(Element e)
           throws SAXException

Visits an element and its subtree.

Throws:

SAXException

getCurrentLocation

public Node getCurrentLocation()

The same as getCurrentElement() but better typed.

getCurrentElement

public Object getCurrentElement()

Description copied from interface: InfosetScanner

Gets the current element we are parsing.

This method could be called from the ContentHandler.startElement(String, String, String, Attributes) or ContentHandler.endElement(String, String, String).

Otherwise the behavior of this method is undefined.

Specified by:

getCurrentElement in interface InfosetScanner

Returns:

never return null.

getLocator

public LocatorEx getLocator()

Specified by:

getLocator in interface InfosetScanner

setContentHandler

public void setContentHandler(ContentHandler handler)

Description copied from interface: InfosetScanner

Sets the ContentHandler. This handler receives the SAX events.

Specified by:

setContentHandler in interface InfosetScanner

getContentHandler

public ContentHandler getContentHandler()

Specified by:

getContentHandler in interface InfosetScanner

getPublicId

public String getPublicId()

Specified by:

getPublicId in interface Locator

getSystemId

public String getSystemId()

Specified by:

getSystemId in interface Locator

getLineNumber

public int getLineNumber()

Specified by:

getLineNumber in interface Locator

getColumnNumber

public int getColumnNumber()

Specified by:

getColumnNumber in interface Locator

getLocation

public ValidationEventLocator getLocation()

Description copied from interface: LocatorEx

Gets the current location in a ValidationEventLocator object.

Specified by:

getLocation in interface LocatorEx