io.dylemma.spac.xml
This package provides extensions to the core "spac" library which allow for the handling of XML data.
Rather than creating explicit classes that extend Parser
, Transformer
, and Splitter
, this package provides type aliases and implicit extensions. For example, XmlParser[A]
is just a type alias for Parser[XmlEvent, A]
, and XmlParser
is just a call to Parser[XmlEvent]
.
Three main Parser methods are added to Parser[XmlEvent]
via the XmlParserApplyOps
implicit class:
XmlParser.forText
- for capturing raw textXmlParser.attr
- for capturing mandatory attributes from elementsXmlParser.attrOpt
- for capturing optional attributes from elements
One main Splitter constructor method is added to Splitter
via the XmlSplitterApplyOps
implicit class:
Splitter.xml
- for creating splitters based on an inspection of an "element stack"
Three main Splitter member methods are added to Splitter[XmlEvent, C]
via the XmlSplitterOps
implicit class:
.attr
- alias for.joinBy(XmlParser.attr(...))
.attrOpt
- alias for.joinBy(XmlParser.attrOpt(...))
.text
- alias for.joinBy(XmlParser.forText)
A DSL for creating xml-specific ContextMatchers is provided to make it more convenient to call Splitter.xml
. For example:
Splitter.xml("things" \ "thing").attr("foo").parseToList
Can be used to capture a list of the "foo" attributes in the <thing>
elements in
<things>
<thing foo="hello" />
<thing foo="Goodbye">
<extra>junk</extra>
</thing>
</thing>
Attributes
Members list
Packages
Type members
Classlikes
Adapter for various representations of QName
Adapter for various representations of QName
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
Spac's internal representation of XML "events". Third-party xml streaming classes like javax.xml.stream
or fs2-data
can be supported by providing an AsXmlEvent
implementation which converts the third-party event type into this type.
Spac's internal representation of XML "events". Third-party xml streaming classes like javax.xml.stream
or fs2-data
can be supported by providing an AsXmlEvent
implementation which converts the third-party event type into this type.
Attributes
- Companion
- object
- Supertypes
-
trait HasLocationclass Objecttrait Matchableclass Any
- Known subtypes
XML-specific Parser constructor methods, for example XmlParser.attr
and XmlParser.text
XML-specific Parser constructor methods, for example XmlParser.attr
and XmlParser.text
Attributes
- Supertypes
-
class AnyValtrait Matchableclass Any
SpacException subtype for XML-specific exceptions
SpacException subtype for XML-specific exceptions
Attributes
- Companion
- object
- Supertypes
-
class SpacException[Self]trait NoStackTraceclass Exceptionclass Throwabletrait Serializableclass Objecttrait Matchableclass AnyShow all
Contains the actual XmlSpacException
subtypes
Contains the actual XmlSpacException
subtypes
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
XmlSpacException.type
Adds Splitter.xml
, for constructing element matcher-based XmlSplitters.
Adds Splitter.xml
, for constructing element matcher-based XmlSplitters.
Attributes
- Supertypes
-
class AnyValtrait Matchableclass Any
XML-specific Splitter member methods, for example: attr
, attrOpt
, and text
,
XML-specific Splitter member methods, for example: attr
, attrOpt
, and text
,
Attributes
- Supertypes
-
class Objecttrait Matchableclass Any
Types
Attributes
Attributes
Type alias for a Parser
whose input type is XmlEvent
.
Type alias for a Parser
whose input type is XmlEvent
.
Attributes
Attributes
Attributes
Deprecated types
Attributes
- Deprecated
- true
Attributes
- Deprecated
- true
Value members
Concrete methods
Context matcher that extracts the given attribute from the element at the head of the stack.
Context matcher that extracts the given attribute from the element at the head of the stack.
Type parameters
- N
-
The name type - usually
String
, but can be any member of the[[AsQName]]
typeclass. Note that forjavax.xml.namespace.QName
you will need to include the "spac-javax" support library.
Value parameters
- attrName
-
The name of the attribute to extract
Attributes
Context matcher that extracts the given optional attribute from the element at the head of the stack. If the attribute is missing from the head element, this matcher will succeed with a result of None, as opposed to the attr
matcher which would fail.
Context matcher that extracts the given optional attribute from the element at the head of the stack. If the attribute is missing from the head element, this matcher will succeed with a result of None, as opposed to the attr
matcher which would fail.
Type parameters
- N
-
The name type - usually
String
, but can be any member of the[[AsQName]]
typeclass. Note that forjavax.xml.namespace.QName
you will need to include the "spac-javax" support library.
Value parameters
- attrName
-
The name of the attribute to extract
Attributes
Context matcher that extracts the (local) name of the element at the head of the stack. Acts as a convenience for extractElemQName[String]
Context matcher that extracts the (local) name of the element at the head of the stack. Acts as a convenience for extractElemQName[String]
Attributes
Context matcher that extracts the (qualified) name of the element at the head of the stack. The type-level representation of the name is chosen by the caller
Context matcher that extracts the (qualified) name of the element at the head of the stack. The type-level representation of the name is chosen by the caller
Type parameters
- N
-
The representation of the element's qualified name. This could be
String
, but in that case you should useextractElemName
instead. For QName types such as the one fromjavax.xml
, you must import a corresponding support package.
Attributes
Concrete fields
Context matcher that matches any single element at the head of the tag stack.
Context matcher that matches any single element at the head of the tag stack.
Attributes
Context matcher that matches any number of elements from the head of the tag stack.
Context matcher that matches any number of elements from the head of the tag stack.
Attributes
Context matcher that always matches without consuming any of the tag stack.
Context matcher that always matches without consuming any of the tag stack.
Attributes
Like the Parser
companion object, but only for creating Parsers whose input type is XmlEvent
.
Like the Parser
companion object, but only for creating Parsers whose input type is XmlEvent
.
Attributes
- See also
Attributes
Attributes
Deprecated fields
Attributes
- Deprecated
- true
Implicits
Implicits
XML-specific Parser constructor methods, for example XmlParser.attr
and XmlParser.text
XML-specific Parser constructor methods, for example XmlParser.attr
and XmlParser.text
Attributes
Adds Splitter.xml
, for constructing element matcher-based XmlSplitters.
Adds Splitter.xml
, for constructing element matcher-based XmlSplitters.
Attributes
XML-specific Splitter member methods, for example: attr
, attrOpt
, and text
,
XML-specific Splitter member methods, for example: attr
, attrOpt
, and text
,
Attributes
Context matcher that matches the element at the head of the stack as long as its name matches the given elemName
Context matcher that matches the element at the head of the stack as long as its name matches the given elemName
This is normally called implicitly, e.g. with Splitter.xml("foo" \ "bar")
, but of course can be called explicitly, e.g. val matcher = elem("foo") \ elem("bar")
Type parameters
- N
-
The name type - usually
String
, but can be any member of the[[AsQName]]
typeclass. Note that forjavax.xml.namespace.QName
you will need to include the "spac-javax" support library.
Value parameters
- elemName
-
The name of the element.