org.wildfly.client.config

Interface ConfigurationXMLStreamReader

All Superinterfaces:

AutoCloseable, XMLStreamConstants, XMLStreamReader

public interface ConfigurationXMLStreamReader
extends XMLStreamReader, AutoCloseable

Author:

David M. Lloyd

Field Summary

Fields

Modifier and Type	Field and Description
static char[]	EMPTY_CHARS

Fields inherited from interface javax.xml.stream.XMLStreamConstants

ATTRIBUTE, CDATA, CHARACTERS, COMMENT, DTD, END_DOCUMENT, END_ELEMENT, ENTITY_DECLARATION, ENTITY_REFERENCE, NAMESPACE, NOTATION_DECLARATION, PROCESSING_INSTRUCTION, SPACE, START_DOCUMENT, START_ELEMENT

Method Summary

Modifier and Type	Method and Description
void	close()
static String	eventToString(int type)
default boolean	getBooleanAttributeValue(int index) Get an attribute value as a boolean.
default String	getElementText()
XMLLocation	getIncludedFrom()
default int	getIntAttributeValue(int index) Get the value of an attribute as an integer.
default int[]	getIntListAttributeValue(int index) Get the value of an attribute as an integer list.
default List<String>	getListAttributeValue(int index) Get the value of an attribute as a space-delimited string list.
default String[]	getListAttributeValueAsArray(int index) Get the value of an attribute as a space-delimited string list, as an array.
default Iterator<String>	getListAttributeValueAsIterator(int index) Get the value of an attribute as a space-delimited string list, as an iterator.
XMLLocation	getLocation()
default long	getLongAttributeValue(int index) Get the value of an attribute as a long.
default long[]	getLongListAttributeValue(int index) Get the value of an attribute as a long integer list.
default Object	getProperty(String name)
int	getTextCharacters(int sourceStart, char[] target, int targetStart, int length)
URI	getUri()
XMLInputFactory	getXmlInputFactory()
default boolean	hasName()
boolean	hasNext()
default boolean	hasText()
default boolean	isCharacters()
default boolean	isEndElement()
default boolean	isStandalone()
default boolean	isStartElement()
default boolean	isWhiteSpace()
default ConfigXMLParseException	missingRequiredAttribute(String namespaceUri, String localName) Return a throwable exception explaining that a required attribute with the given namespace and local name was missing.
default ConfigXMLParseException	missingRequiredElement(String namespaceUri, String localName) Return a throwable exception explaining that a required element with the given namespace and local name was missing.
int	next()
default int	nextTag()
static ConfigurationXMLStreamReader	openUri(URI uri, XMLInputFactory xmlInputFactory)
static ConfigurationXMLStreamReader	openUri(URI uri, XMLInputFactory xmlInputFactory, InputStream inputStream)
default void	require(int type, String namespaceURI, String localName)
default void	skipContent()
default boolean	standaloneSet()
default ConfigXMLParseException	unexpectedAttribute(int i) Return a throwable exception explaining that the attribute at the current position with the given index was not expected.
default ConfigXMLParseException	unexpectedElement() Return a throwable exception explaining that the element at the current position was not expected.

Methods inherited from interface javax.xml.stream.XMLStreamReader

getAttributeCount, getAttributeLocalName, getAttributeName, getAttributeNamespace, getAttributePrefix, getAttributeType, getAttributeValue, getAttributeValue, getCharacterEncodingScheme, getEncoding, getEventType, getLocalName, getName, getNamespaceContext, getNamespaceCount, getNamespacePrefix, getNamespaceURI, getNamespaceURI, getNamespaceURI, getPIData, getPITarget, getPrefix, getText, getTextCharacters, getTextLength, getTextStart, getVersion, isAttributeSpecified

Field Detail

EMPTY_CHARS

static final char[] EMPTY_CHARS

Method Detail

openUri

static ConfigurationXMLStreamReader openUri(URI uri,
                                            XMLInputFactory xmlInputFactory)
                                     throws ConfigXMLParseException

Throws:

ConfigXMLParseException

openUri

static ConfigurationXMLStreamReader openUri(URI uri,
                                            XMLInputFactory xmlInputFactory,
                                            InputStream inputStream)
                                     throws ConfigXMLParseException

Throws:

ConfigXMLParseException

getUri

URI getUri()

getXmlInputFactory

XMLInputFactory getXmlInputFactory()

getIncludedFrom

XMLLocation getIncludedFrom()

hasNext

boolean hasNext()
         throws ConfigXMLParseException

Specified by:

hasNext in interface XMLStreamReader

Throws:

ConfigXMLParseException

next

int next()
  throws ConfigXMLParseException

Specified by:

next in interface XMLStreamReader

Throws:

ConfigXMLParseException

nextTag

default int nextTag()
             throws ConfigXMLParseException

Specified by:

nextTag in interface XMLStreamReader

Throws:

ConfigXMLParseException

getElementText

default String getElementText()
                       throws ConfigXMLParseException

Specified by:

getElementText in interface XMLStreamReader

Throws:

ConfigXMLParseException

require

default void require(int type,
                     String namespaceURI,
                     String localName)
              throws ConfigXMLParseException

Specified by:

require in interface XMLStreamReader

Throws:

ConfigXMLParseException

isStartElement

default boolean isStartElement()

Specified by:

isStartElement in interface XMLStreamReader

isEndElement

default boolean isEndElement()

Specified by:

isEndElement in interface XMLStreamReader

isCharacters

default boolean isCharacters()

Specified by:

isCharacters in interface XMLStreamReader

isWhiteSpace

default boolean isWhiteSpace()

Specified by:

isWhiteSpace in interface XMLStreamReader

eventToString

static String eventToString(int type)

getProperty

default Object getProperty(String name)
                    throws IllegalArgumentException

Specified by:

getProperty in interface XMLStreamReader

Throws:

IllegalArgumentException

hasText

default boolean hasText()

Specified by:

hasText in interface XMLStreamReader

isStandalone

default boolean isStandalone()

Specified by:

isStandalone in interface XMLStreamReader

standaloneSet

default boolean standaloneSet()

Specified by:

standaloneSet in interface XMLStreamReader

hasName

default boolean hasName()

Specified by:

hasName in interface XMLStreamReader

getLocation

XMLLocation getLocation()

Specified by:

getLocation in interface XMLStreamReader

getTextCharacters

int getTextCharacters(int sourceStart,
                      char[] target,
                      int targetStart,
                      int length)
               throws ConfigXMLParseException

Specified by:

getTextCharacters in interface XMLStreamReader

Throws:

ConfigXMLParseException

close

void close()
    throws ConfigXMLParseException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface XMLStreamReader

Throws:

ConfigXMLParseException

skipContent

default void skipContent()
                  throws ConfigXMLParseException

Throws:

ConfigXMLParseException

unexpectedElement

default ConfigXMLParseException unexpectedElement()

Return a throwable exception explaining that the element at the current position was not expected.

Returns:

the exception

unexpectedAttribute

default ConfigXMLParseException unexpectedAttribute(int i)

Return a throwable exception explaining that the attribute at the current position with the given index was not expected.

Parameters:

i - the attribute index

Returns:

the exception

missingRequiredElement

default ConfigXMLParseException missingRequiredElement(String namespaceUri,
                                                       String localName)

Return a throwable exception explaining that a required element with the given namespace and local name was missing.

Parameters:

namespaceUri - the namespace URI

localName - the local element name

Returns:

the exception

missingRequiredAttribute

default ConfigXMLParseException missingRequiredAttribute(String namespaceUri,
                                                         String localName)

Return a throwable exception explaining that a required attribute with the given namespace and local name was missing.

Parameters:

namespaceUri - the namespace URI (or null if it is a local name)

localName - the local attribute name

Returns:

the exception

getIntAttributeValue

default int getIntAttributeValue(int index)
                          throws ConfigXMLParseException

Get the value of an attribute as an integer.

Parameters:

index - the index of the attribute

Returns:

the integer value

Throws:

ConfigXMLParseException - if an error occurs

getIntListAttributeValue

default int[] getIntListAttributeValue(int index)
                                throws ConfigXMLParseException

Get the value of an attribute as an integer list.

Parameters:

index - the index of the attribute

Returns:

the integer values

Throws:

ConfigXMLParseException - if an error occurs

getListAttributeValueAsIterator

default Iterator<String> getListAttributeValueAsIterator(int index)
                                                  throws ConfigXMLParseException

Get the value of an attribute as a space-delimited string list, as an iterator.

Parameters:

index - the index of the attribute

Returns:

the values

Throws:

ConfigXMLParseException - if an error occurs

getListAttributeValue

default List<String> getListAttributeValue(int index)
                                    throws ConfigXMLParseException

Get the value of an attribute as a space-delimited string list.

Parameters:

index - the index of the attribute

Returns:

the values

Throws:

ConfigXMLParseException - if an error occurs

getListAttributeValueAsArray

default String[] getListAttributeValueAsArray(int index)
                                       throws ConfigXMLParseException

Get the value of an attribute as a space-delimited string list, as an array.

Parameters:

index - the index of the attribute

Returns:

the values

Throws:

ConfigXMLParseException - if an error occurs

getLongAttributeValue

default long getLongAttributeValue(int index)
                            throws ConfigXMLParseException

Get the value of an attribute as a long.

Parameters:

index - the index of the attribute

Returns:

the long value

Throws:

ConfigXMLParseException - if an error occurs

getLongListAttributeValue

default long[] getLongListAttributeValue(int index)
                                  throws ConfigXMLParseException

Get the value of an attribute as a long integer list.

Parameters:

index - the index of the attribute

Returns:

the long values

Throws:

ConfigXMLParseException - if an error occurs

getBooleanAttributeValue

default boolean getBooleanAttributeValue(int index)

Get an attribute value as a boolean. Only the string "true" (case-insensitive) is recognized as a true value; all other strings are considered false.

Parameters:

index - the attribute index

Returns:

the attribute value