Package groovy.xml
Class MarkupBuilder
java.lang.Object
groovy.lang.GroovyObjectSupport
groovy.util.BuilderSupport
groovy.xml.MarkupBuilder
- All Implemented Interfaces:
groovy.lang.GroovyObject
public class MarkupBuilder
extends groovy.util.BuilderSupport
A helper class for creating XML or HTML markup.
The builder supports various 'pretty printed' formats.
Example:
new MarkupBuilder().root {
a( a1:'one' ) {
b { mkp.yield( '3 < 5' ) }
c( a2:'two', 'blah' )
}
}
Will print the following to System.out:
<root>
<a a1='one'>
<b>3 < 5</b>
<c a2='two'>blah</c>
</a>
</root>
Notes:
mkpis a special namespace used to escape away from the normal building mode of the builder and get access to helper markup methods such as 'yield' and 'yieldUnescaped'. See the javadoc forgetMkp()for further details.- Note that tab, newline and carriage return characters are escaped within attributes, i.e. will become 	, and respectively
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classMarkupBuilder.CharFilterstatic classMarkupBuilder.DefaultXmlEscapingFunction -
Constructor Summary
Constructors Constructor Description MarkupBuilder()Prints markup to System.outMarkupBuilder(groovy.util.IndentPrinter out)Sends markup to the given IndentPrinter.MarkupBuilder(PrintWriter pw)Sends markup to the given PrintWriterMarkupBuilder(Writer writer)Sends markup to the given Writer but first wrapping it in a PrintWriter -
Method Summary
Modifier and Type Method Description protected ObjectcreateNode(Object name)protected ObjectcreateNode(Object name, Object value)protected ObjectcreateNode(Object name, Map attributes)protected ObjectcreateNode(Object name, Map attributes, Object value)List<Function<Character,Optional<String>>>getAdditionalFilters()booleangetDoubleQuotes()Returnstrueif attribute values are output with double quotes;falseif single quotes are used.MarkupBuilderHelpergetMkp()Property that may be called from within your builder closure to access helper methods, namelyMarkupBuilderHelper.yield(String),MarkupBuilderHelper.yieldUnescaped(String),MarkupBuilderHelper.pi(Map),MarkupBuilderHelper.xmlDeclaration(Map)andMarkupBuilderHelper.comment(String).protected ObjectgetName(String methodName)protected groovy.util.IndentPrintergetPrinter()booleanisEscapeAttributes()Returns the escapeAttributes property value.booleanisExpandEmptyElements()Whether empty elements are expanded from <tagName/> to <tagName></tagName>.booleanisOmitEmptyAttributes()Determine whether empty attributes will appear in the produced markup.booleanisOmitNullAttributes()Determine whether null attributes will appear in the produced markup.protected voidnodeCompleted(Object parent, Object node)protected voidprint(Object node)voidsetAdditionalFilters(List<Function<Character,Optional<String>>> additionalFilters)voidsetDoubleQuotes(boolean useDoubleQuotes)Sets whether the builder outputs attribute values in double quotes or single quotes.voidsetEscapeAttributes(boolean escapeAttributes)Defaults to true. If set to false then you must escape any special characters within attribute values such as '&', '<', CR/LF, single and double quotes etc. manually as needed.voidsetExpandEmptyElements(boolean expandEmptyElements)Whether empty elements are expanded from <tagName/> to <tagName></tagName>.voidsetOmitEmptyAttributes(boolean omitEmptyAttributes)Allows empty attributes to be removed from the generated markup.voidsetOmitNullAttributes(boolean omitNullAttributes)Allows null attributes to be removed from the generated markup.protected voidsetParent(Object parent, Object child)Methods inherited from class groovy.util.BuilderSupport
doInvokeMethod, getCurrent, invokeMethod, invokeMethod, postNodeCompletion, setClosureDelegate, setCurrentMethods inherited from class groovy.lang.GroovyObjectSupport
getMetaClass, setMetaClassMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface groovy.lang.GroovyObject
getProperty, setProperty
-
Constructor Details
-
MarkupBuilder
public MarkupBuilder()Prints markup to System.out- See Also:
IndentPrinter()
-
MarkupBuilder
Sends markup to the given PrintWriter- Parameters:
pw- the PrintWriter to use- See Also:
IndentPrinter(Writer)
-
MarkupBuilder
Sends markup to the given Writer but first wrapping it in a PrintWriter- Parameters:
writer- the writer to use- See Also:
IndentPrinter(Writer)
-
MarkupBuilder
public MarkupBuilder(groovy.util.IndentPrinter out)Sends markup to the given IndentPrinter. Use this option if you want to customize the indent used or provide your own IndentPrinter.- Parameters:
out- the IndentPrinter to use
-
-
Method Details
-
getAdditionalFilters
-
setAdditionalFilters
-
isEscapeAttributes
public boolean isEscapeAttributes()Returns the escapeAttributes property value.- Returns:
- the escapeAttributes property value
- See Also:
setEscapeAttributes(boolean)
-
setEscapeAttributes
public void setEscapeAttributes(boolean escapeAttributes)Defaults to true. If set to false then you must escape any special characters within attribute values such as '&', '<', CR/LF, single and double quotes etc. manually as needed. The builder will not guard against producing invalid XML when in this mode and the output may not be able to be parsed/round-tripped but it does give you full control when producing for instance HTML output.- Parameters:
escapeAttributes- the new value
-
getDoubleQuotes
public boolean getDoubleQuotes()Returnstrueif attribute values are output with double quotes;falseif single quotes are used. By default, single quotes are used.- Returns:
- true if double quotes are used for attributes
-
setDoubleQuotes
public void setDoubleQuotes(boolean useDoubleQuotes)Sets whether the builder outputs attribute values in double quotes or single quotes.- Parameters:
useDoubleQuotes- If this parameter istrue, double quotes are used; otherwise, single quotes are.
-
isOmitNullAttributes
public boolean isOmitNullAttributes()Determine whether null attributes will appear in the produced markup.- Returns:
true, if null attributes will be removed from the resulting markup.
-
setOmitNullAttributes
public void setOmitNullAttributes(boolean omitNullAttributes)Allows null attributes to be removed from the generated markup.- Parameters:
omitNullAttributes- iftrue, null attributes will not be included in the resulting markup. Iffalsenull attributes will be included in the markup as empty strings regardless of the omitEmptyAttribute setting. Defaults tofalse.
-
isOmitEmptyAttributes
public boolean isOmitEmptyAttributes()Determine whether empty attributes will appear in the produced markup.- Returns:
true, if empty attributes will be removed from the resulting markup.
-
setOmitEmptyAttributes
public void setOmitEmptyAttributes(boolean omitEmptyAttributes)Allows empty attributes to be removed from the generated markup.- Parameters:
omitEmptyAttributes- iftrue, empty attributes will not be included in the resulting markup. Defaults tofalse.
-
isExpandEmptyElements
public boolean isExpandEmptyElements()Whether empty elements are expanded from <tagName/> to <tagName></tagName>.- Returns:
true, if empty elements will be represented by an opening tag followed immediately by a closing tag.
-
setExpandEmptyElements
public void setExpandEmptyElements(boolean expandEmptyElements)Whether empty elements are expanded from <tagName/> to <tagName></tagName>.- Parameters:
expandEmptyElements- iftrue, empty elements will be represented by an opening tag followed immediately by a closing tag. Defaults tofalse.
-
getPrinter
protected groovy.util.IndentPrinter getPrinter() -
setParent
- Specified by:
setParentin classgroovy.util.BuilderSupport
-
getMkp
Property that may be called from within your builder closure to access helper methods, namelyMarkupBuilderHelper.yield(String),MarkupBuilderHelper.yieldUnescaped(String),MarkupBuilderHelper.pi(Map),MarkupBuilderHelper.xmlDeclaration(Map)andMarkupBuilderHelper.comment(String).- Returns:
- this MarkupBuilder
-
createNode
- Specified by:
createNodein classgroovy.util.BuilderSupport
-
createNode
- Specified by:
createNodein classgroovy.util.BuilderSupport
-
createNode
- Specified by:
createNodein classgroovy.util.BuilderSupport
-
createNode
- Specified by:
createNodein classgroovy.util.BuilderSupport
-
nodeCompleted
- Overrides:
nodeCompletedin classgroovy.util.BuilderSupport
-
print
-
getName
- Overrides:
getNamein classgroovy.util.BuilderSupport
-