advertisement
javaboutique
Search Tips
Articles  |   Tutorials  |   Reviews  |   Tools  |   by Category  |   by Date  |   by Name  |   Submit  |   Source  |   Forums  |  
javaboutique
Browse DevX


Partners & Affiliates











advertisement

Tutorials : The Anatomy Of A Groovy Builder :

Builders in Groovy

Builders are, pardon the pun, a built-in language feature of Groovy. Closures and meta-programming support allow a level of flexibility in the language that would be simply impossible in Java, at present. The Groovy alternative to the Java example above, using the native builder support, looks like this:
GScreenBuilder b = new GScreenBuilder()

b.screen {
    title( "My Page" )
    navigation {
        navItem( name: "Home", focus: true, visible: true )
        navItem( name: "Admin", focus: false, visible: false )
        navItem( name: "Logout", focus: false, visible: true )
    }
    content {
        table ()
    }
    footer( "Our Footer Text" )
}

Screen screen = b.build()

Pretend Methods

Groovy builders allow you to define a tree-like structure in your code that represents complex object hierarchies. Each of the structure's nodes is represented by a method call that can take a closure as its last argument. All method calls within a closure represent a child node of the method that receives the closure. The first line of your tree structure definition invokes a method, called screen, on your builder. It then passes the contents of the subsequent code block as a closure:
b.screen {...}
There is no screen method on the GScreenBuilder. Instead, Groovy uses meta-programming to handle missing method invocation. Later on, you will see the rules that Groovy builders use to map the nodes to method calls—that you can override. For now, take a look at how Groovy deals with those missing methods.

The first revelation is that all Groovy classes, once compiled down to Java byte code, will extend the GroovyObject interface. This is the base Groovy interface that provides the first part of Groovy's meta-programming support. The interface defines the following methods:

public Object invokeMethod(String name, Object args);
public Object	getProperty(String property);
public void setProperty(String property, Object newValue);
public MetaClass getMetaClass();
public void setMetaClass(MetaClass metaClass);
Suppose you override the invokeMethod method. You could then handle all method calls made to the object where the method does not actually exist. The following example and test shows this in action:
class PretendMethod {

    def title( data ) {
        println "A title is created with some data: ${data}"
        return data
    }

    public Object invokeMethod(String name, Object args) {
        return name
    }
}

@Test
public void methodPretention() {

    PretendMethod b = new PretendMethod()

    assertEquals( "screen", b.screen() )
    assertEquals( "My Title", b.title( "My Title" ) )
}
The PretendMethod class simply returns the method name of any method that is executed through the invokeMethod path—the test asserts that you can call a non-existent screen method on the class. Be aware that when you override invokeMethod, you are not able to intercept methods that have actually been implemented on the class—only handle calls on the class for methods that have not been implemented.

For example, when you call the title method on an instance of the PretendMethod class, invokeMethod will not be executed, only the title method will run because it has an implementation. Whereas any other method call, screen in the example, will be handled by invokeMethod because there is no screen method implementation. A full discussion of Groovy meta-programming is outside of the scope of this article. If you are interested in more information, I fully recommend the excellent book, Groovy In Action.

Home / Articles / The Anatomy Of A Groovy Builder / 1 / 2 / Next Page

How to Add Java Applets to Your Site

New on the Java Boutique:

New Review:

Time Management Made Easy with the Quartz Enterprise Job Scheduler
Why not just use the Java timer API? This open source scheduling API boasts simplicity, ease-of-integration, a well-rounded feature set, and it's free!

New Applet:

Reverse Complement
Reverse Complement is a simple applet that converts DNA or RNA sequences into three useful formats.

Elsewhere on internet.com:

WebDeveloper Java
Lots of Java information on webdeveloper.com

WDVL Java
Thorough Java resource at the Web Developer's Virtual Library.

ScriptSearch Java
Hundreds of free Java code files to download.

jGuru: Your View of the Java Universe
Customizable portal with online training, FAQs, regular news updates, and tutorials.

 Avaya Developer Showcase
 MSDN Spotlight
 PHP for Windows Showcase
XML error: undefined entity at line 34
advertisement
Receive Articles via our XML/RSS feed
Receive Articles via our XML/RSS feed

JavaBytes
Internet Cyclone
This powerful, easy-to-use, internet optimizer is for Windows 95, 98, ME, NT, 2000 and XP. It's designed to automatically optimize your Windows settings, boosting your Internet connection up to 200%.

IBM Brings Developers Into the Cloud
Apache at 10: You Can't Buy Us
Microsoft's CodePlex Foundation Moving Forward
Apple Claims 100,000 Apps, Google Analyzes Them
Nokia Latest to Play Opera Mobile 10 Browser
PayPal Opens Up Payment Platform to Devs
Ubuntu Linux 9.10 'Karmic Koala' Starts Its Climb
IBM Links Rational Developer Tools, Tivoli Apps
Libraries Give Vista Apps a Windows 7 Look
Ubuntu: The 'Default Alternative' to Windows?

Delivering Web-based Embedded Fonts in CSS 3
Adobe Helps PHP Developers Create Rich Internet Applications
Java Developers Finding a Home at Adobe Flex
Virtualization Delivers a Dynamic Infrastructure
Consuming XML Web Services in iPhone Applications
Build a More Agile Business with IBM
POJO-Based Solutions for LDAP Access: One Good, One Better
IBM Offers Enhanced Measurement and Management for Energy Usage
IBM Helps Transformation to an Information-Based Enterprise
Top Five Touch UI-Related Design Guidelines

Advertising Info  |   Member Services  |   Contact Us  |   Help  |   Feedback  |   Site Map  |   Network Map  |   About

internet.commediabistro.comJusttechjobs.comGraphics.com

Search:

WebMediaBrands Corporate Info

Legal Notices, Licensing, Reprints, Permissions, Privacy Policy.
Advertise | Newsletters | Shopping | E-mail Offers | Freelance Jobs