public class Stax2FilteredEventReader extends Object implements XMLEventReader2, XMLStreamConstants
Some notes about implemention:
ATTRIBUTE, CDATA, CHARACTERS, COMMENT, DTD, END_DOCUMENT, END_ELEMENT, ENTITY_DECLARATION, ENTITY_REFERENCE, NAMESPACE, NOTATION_DECLARATION, PROCESSING_INSTRUCTION, SPACE, START_DOCUMENT, START_ELEMENT
Constructor and Description |
---|
Stax2FilteredEventReader(XMLEventReader2 r,
EventFilter f) |
Modifier and Type | Method and Description |
---|---|
void |
close() |
String |
getElementText() |
Object |
getProperty(String name) |
boolean |
hasNext() |
boolean |
hasNextEvent()
Method that is similar to
XMLEventReader.hasNext() , except that it can
throw a XMLStreamException . |
boolean |
isPropertySupported(String name)
Method similar to
XMLInputFactory.isPropertySupported(java.lang.String) , used
to determine whether a property is supported by the Reader
instance. |
Object |
next() |
XMLEvent |
nextEvent() |
XMLEvent |
nextTag() |
XMLEvent |
peek()
This is bit tricky to implement, but it should filter out
events just as nextEvent() would.
|
void |
remove()
Note: only here because we implement Iterator interface
|
boolean |
setProperty(String name,
Object value)
Method that can be used to set per-reader properties; a subset of
properties one can set via matching
XMLInputFactory2
instance. |
public Stax2FilteredEventReader(XMLEventReader2 r, EventFilter f)
public void close() throws XMLStreamException
close
in interface XMLEventReader
XMLStreamException
public String getElementText() throws XMLStreamException
getElementText
in interface XMLEventReader
XMLStreamException
public Object getProperty(String name)
getProperty
in interface XMLEventReader
public boolean hasNext()
hasNext
in interface Iterator
hasNext
in interface XMLEventReader
public XMLEvent nextEvent() throws XMLStreamException
nextEvent
in interface XMLEventReader
XMLStreamException
public XMLEvent nextTag() throws XMLStreamException
nextTag
in interface XMLEventReader
XMLStreamException
public XMLEvent peek() throws XMLStreamException
peek
in interface XMLEventReader
XMLStreamException
public void remove()
public boolean hasNextEvent() throws XMLStreamException
XMLEventReader2
XMLEventReader.hasNext()
, except that it can
throw a XMLStreamException
. This is important distinction,
since the underlying stream reader is NOT allowed to throw such an
exception when its
hasNext()
gets called; but the underlying parser
may well need to advance the input stream and in doing so may
encounter an exception. This exception should be propagated to
the caller, as it may signal a problem with the input stream
or xml content.hasNextEvent
in interface XMLEventReader2
XMLStreamException
public boolean isPropertySupported(String name)
XMLEventReader2
XMLInputFactory.isPropertySupported(java.lang.String)
, used
to determine whether a property is supported by the Reader
instance. This means that this method may return false
for some properties that the input factory does support: specifically,
it should only return true if the value is mutable on per-instance
basis. False means that either the property is not recognized, or
is not mutable via reader instance.isPropertySupported
in interface XMLEventReader2
public boolean setProperty(String name, Object value)
XMLEventReader2
XMLInputFactory2
instance. Exactly which methods are mutable is implementation
specific.setProperty
in interface XMLEventReader2
name
- Name of the property to setvalue
- Value to set property to.Copyright © 2012-2015 fasterxml.com. All Rights Reserved.