Parsing - scalawag/sdom GitHub Wiki

SDOM's parser uses SAX, which means that you can parse XML from any InputSource SAX supports. The default parser builds a DOM that models the XML such that it contains the entire document (comments, whitespace, etc.). You can always trim it down after parsing.

Validation is distinct from parsing in SDOM, so it should be used against a DOM after the parsing is complete.

Parsing a string with the default Parser (XML) is as simple as calling the "parse" method:

import org.scalawag.sdom._
val xml1 = XML.parse("""<outer><inner/></outer>""")

// -> Document(<outer><inner/></outer>)

If you're concerned about the performance of creating a DOM only to trim it down later (or you care for other reasons), you can instantiate your own Parser and give it a BuilderConfiguration to tell it what information it's OK to lose.

Instantiating a Parser with a different configuration is pretty straightforward:

import org.scalawag.sdom._
val s = """<outer><inner/><?pi something?><!-- blah --></outer>"""
XML.parse(s)

// -> Document(<outer><inner/><?pi something?><!-- blah --></outer>)

val parser = new Parser(BuilderConfiguration.Truest.copy(discardProcessingInstructions = true,discardComments = true))
parser.parse(s)

// -> Document(<outer><inner/></outer>)