com.fasterxml.aalto.in
Class InputBootstrapper

java.lang.Object
  com.fasterxml.aalto.in.InputBootstrapper

All Implemented Interfaces:

XmlConsts

Direct Known Subclasses:

ByteSourceBootstrapper, CharSourceBootstrapper

public abstract class InputBootstrapper
extends java.lang.Object
implements XmlConsts

Abstract base class that defines shared functionality between different bootstrappers (byte stream, char Readers, block input)

Field Summary

protected int	_inputProcessed Current number of input units (bytes or chars) that were processed in previous blocks, before contents of current input buffer.
protected int	_inputRow Current row location of current point in input buffer, using zero-based counting.
protected int	_inputRowStart Current index of the first character of the current row in input buffer.
protected static java.lang.String	ERR_XMLDECL_END_MARKER
protected static java.lang.String	ERR_XMLDECL_EXP_ATTRVAL
protected static java.lang.String	ERR_XMLDECL_EXP_EQ
protected static java.lang.String	ERR_XMLDECL_EXP_SPACE
protected static java.lang.String	ERR_XMLDECL_KW_ENCODING
protected static java.lang.String	ERR_XMLDECL_KW_STANDALONE
protected static java.lang.String	ERR_XMLDECL_KW_VERSION

Fields inherited from interface com.fasterxml.aalto.XmlConsts

CHAR_CR, CHAR_LF, CHAR_NULL, CHAR_SPACE, MAX_UNICODE_CHAR, STAX_DEFAULT_OUTPUT_ENCODING, STAX_DEFAULT_OUTPUT_VERSION, XML_DECL_KW_ENCODING, XML_DECL_KW_STANDALONE, XML_DECL_KW_VERSION, XML_SA_NO, XML_SA_YES, XML_V_10, XML_V_10_STR, XML_V_11, XML_V_11_STR, XML_V_UNKNOWN

Constructor Summary

protected

InputBootstrapper(ReaderConfig cfg)

Method Summary

XmlScanner	bootstrap() Main bootstrapping method, which will try to open the underlying input source, check its encoding, read xml declaration if there is one, and finally create a scanner for actual parsing.
protected abstract int	checkKeyword(java.lang.String exp)
abstract XmlScanner	doBootstrap()
protected abstract javax.xml.stream.Location	getLocation()
protected abstract int	getNext()
protected abstract int	getNextAfterWs(boolean reqWs)
protected abstract void	pushback()
protected abstract int	readQuotedValue(char[] kw, int quoteChar)
protected void	readXmlDeclaration() Method that will parse xml declaration, which at this point is known to exist.
protected void	reportEof()
protected void	reportNull()
protected void	reportPseudoAttrProblem(java.lang.String attrName, java.lang.String got, java.lang.String expVal1, java.lang.String expVal2)
protected void	reportUnexpectedChar(int i, java.lang.String msg)
protected void	reportXmlProblem(java.lang.String msg)

Methods inherited from class java.lang.Object

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

Field Detail

ERR_XMLDECL_KW_VERSION

protected static final java.lang.String ERR_XMLDECL_KW_VERSION

See Also:

Constant Field Values

ERR_XMLDECL_KW_ENCODING

protected static final java.lang.String ERR_XMLDECL_KW_ENCODING

See Also:

Constant Field Values

ERR_XMLDECL_KW_STANDALONE

protected static final java.lang.String ERR_XMLDECL_KW_STANDALONE

See Also:

Constant Field Values

ERR_XMLDECL_END_MARKER

protected static final java.lang.String ERR_XMLDECL_END_MARKER

See Also:

Constant Field Values

ERR_XMLDECL_EXP_SPACE

protected static final java.lang.String ERR_XMLDECL_EXP_SPACE

See Also:

Constant Field Values

ERR_XMLDECL_EXP_EQ

protected static final java.lang.String ERR_XMLDECL_EXP_EQ

See Also:

Constant Field Values

ERR_XMLDECL_EXP_ATTRVAL

protected static final java.lang.String ERR_XMLDECL_EXP_ATTRVAL

See Also:

Constant Field Values

_inputProcessed

protected int _inputProcessed

Current number of input units (bytes or chars) that were processed in previous blocks, before contents of current input buffer.

Note: includes possible BOMs, if those were part of the input.

_inputRow

protected int _inputRow

Current row location of current point in input buffer, using zero-based counting.

_inputRowStart

protected int _inputRowStart

Current index of the first character of the current row in input buffer. Needed to calculate column position, if necessary; benefit of not having column itself is that this only has to be updated once per line.

Constructor Detail

InputBootstrapper

protected InputBootstrapper(ReaderConfig cfg)

Method Detail

bootstrap

public final XmlScanner bootstrap()
                           throws javax.xml.stream.XMLStreamException

Main bootstrapping method, which will try to open the underlying input source, check its encoding, read xml declaration if there is one, and finally create a scanner for actual parsing.

Throws:

javax.xml.stream.XMLStreamException

doBootstrap

public abstract XmlScanner doBootstrap()
                                throws java.io.IOException,
                                       javax.xml.stream.XMLStreamException

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

readXmlDeclaration

protected void readXmlDeclaration()
                           throws java.io.IOException,
                                  javax.xml.stream.XMLStreamException

Method that will parse xml declaration, which at this point is known to exist.

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

pushback

protected abstract void pushback()

getNext

protected abstract int getNext()
                        throws java.io.IOException,
                               javax.xml.stream.XMLStreamException

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

getNextAfterWs

protected abstract int getNextAfterWs(boolean reqWs)
                               throws java.io.IOException,
                                      javax.xml.stream.XMLStreamException

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

checkKeyword

protected abstract int checkKeyword(java.lang.String exp)
                             throws java.io.IOException,
                                    javax.xml.stream.XMLStreamException

Returns:

First character that does not match expected, if any; CHAR_NULL if match succeeded

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

readQuotedValue

protected abstract int readQuotedValue(char[] kw,
                                       int quoteChar)
                                throws java.io.IOException,
                                       javax.xml.stream.XMLStreamException

Throws:

java.io.IOException

javax.xml.stream.XMLStreamException

getLocation

protected abstract javax.xml.stream.Location getLocation()

reportXmlProblem

protected void reportXmlProblem(java.lang.String msg)
                         throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

reportNull

protected void reportNull()
                   throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

reportEof

protected void reportEof()
                  throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

reportUnexpectedChar

protected void reportUnexpectedChar(int i,
                                    java.lang.String msg)
                             throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

reportPseudoAttrProblem

protected final void reportPseudoAttrProblem(java.lang.String attrName,
                                             java.lang.String got,
                                             java.lang.String expVal1,
                                             java.lang.String expVal2)
                                      throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException