Module org.glassfish.jaxb.core

Package org.glassfish.jaxb.core.unmarshaller

Class DOMScanner

java.lang.Object

org.glassfish.jaxb.core.unmarshaller.DOMScanner

All Implemented Interfaces:

InfosetScanner<Node>, LocatorEx, Locator

public class DOMScanner
extends Object
implements LocatorEx, InfosetScanner<Node>

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

This class is just intended to be used by AbstractUnmarshallerImpl. The jakarta.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 org.glassfish.jaxb.core.v2.runtime.unmarshaller.LocatorEx

LocatorEx.Snapshot

Constructor Summary

Constructors

Constructor	Description
DOMScanner()

Method Summary

Modifier and Type	Method	Description
int	getColumnNumber()
ContentHandler	getContentHandler()
Node	getCurrentElement()	Gets the current element we are parsing.
Node	getCurrentLocation()	The same as getCurrentElement() but better typed.
int	getLineNumber()
jakarta.xml.bind.ValidationEventLocator	getLocation()	Gets the current location in a ValidationEventLocator object.
LocatorEx	getLocator()
String	getPublicId()
String	getSystemId()
void	parse(Element e, ContentHandler handler)	Deprecated, for removal: This API element is subject to removal in a future version. in JAXB 2.0 Use scan(Element)
void	parseWithContext(Element e, ContentHandler handler)	Deprecated, for removal: This API element is subject to removal in a future version. in JAXB 2.0 Use scan(Element)
void	scan(Document doc)
void	scan(Element e)
void	scan(Node 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(Node 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<Node>

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

@Deprecated(since="2.0",
            forRemoval=true)
public void parse(Element e,
                  ContentHandler handler)
           throws SAXException

Deprecated, for removal: This API element is subject to removal in a future version.

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

@Deprecated(since="2.0",
            forRemoval=true)
public void parseWithContext(Element e,
                             ContentHandler handler)
                      throws SAXException

Deprecated, for removal: This API element is subject to removal in a future version.

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 Node 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<Node>

Returns:

never return null.

getLocator

public LocatorEx getLocator()

Specified by:

getLocator in interface InfosetScanner<Node>

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<Node>

getContentHandler

public ContentHandler getContentHandler()

Specified by:

getContentHandler in interface InfosetScanner<Node>

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 jakarta.xml.bind.ValidationEventLocator getLocation()

Description copied from interface: LocatorEx

Gets the current location in a ValidationEventLocator object.

Specified by:

getLocation in interface LocatorEx