Skip to end of metadata
Go to start of metadata

Tree Based Syntax

Groovy has special syntax support for List and Maps. This is great because it gives a concise representation of the actual object being defined, so its easier to keep track of what a program or script is doing. But what about programs which contain arbitrary nested tree structures. Surely, they are the hardest ones to keep track of what is going on. Isn't that an area where syntactic help will be most beneficial?

The answer is definitely yes and Groovy comes to the party with its builder concept. You can use it for DOM-like APIs or Ant tasks or Jelly tags or Swing widgets or whatever. Each may have their own particular factory mechanism to create the tree of objects - however they can share the same builder syntax to define them - in a concise alternative to XML or lengthy programming code. See How Builders Work


[Note: the syntax in some of these examples is slightly out-dated. See chapter 8 of GINA in the mean-time until these examples are updated.]

Here's an example:

The above invokes a number of methods on the owner class using named-parameter passing syntax. Then the button method would create JButton etc. The { } is used to define a closure which adds its content to the newly created node. Also notice that the action parameter is passed as a closure - which is ideal for working with UI centric listeners etc.

Note that within the 'markup' you can embed normal expressions - i.e. this markup syntax is a normal part of the Groovy language. e.g.

Using this simple mechanism we can easily create any structured tree of data - or provide an event based model too. Note in Groovy you can just overload the invokeMethodname, arguments to have a simple polymorphic tree creation - such as for DOM is structures or Ant tasks or Jelly tags etc.

Here's an example of some HTML using some mixed content which is typically hard to do neatly in some markup languages

Finally here's an example of creating some name-spaced XML structure XSD...

There's a converter from XML to groovy markup so you can try out this new markup language on any XML documents you have already.

Special cases

To output elements or attributes with a '-' in their name, you need to quote the names. For example, to generate a web-app descriptor for a Servlet app:


Read from external variable

Most builder examples are inline usage. To use a builder to build for an external variable, you may use:

Andy Glover introduces builders through an astronomical example

  • No labels

1 Comment

  1. As discussed  on, the HTML example does not work. This does:

    def builder = new groovy.xml.MarkupBuilder()
    builder.html {
    head {
    title "XML encoding with Groovy"
    body {
    h1 "XML encoding with Groovy"
    p "this format can be used as an alternative markup to XML"
    a (href:'', "Groovy")
    p {
    mkp.yield "This is some"
    b "mixed"
    mkp.yield "text. For more see the"
    a(href:'', "Groovy")
    mkp.yield "project."