Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

The <a href="http://en.wikipedia.org/wiki/Delegation_pattern">Delegation Pattern</a> is a technique where an object's behavior (public methods) is implemented by delegating responsibility to one or more associated objects.

Groovy allows the traditional style of applying the delegation pattern, e.g. see <a class="confluence-link" href="/display/GROOVY/Replace+Inheritance+with+Delegation" data-linked-resource-id="78709" data-linked-resource-type="page" data-linked-resource-default-alias="Replace Inheritance with Delegation" data-base-url="http://docs.codehaus.org">Replace Inheritance with Delegation</a>.

<h1>Implement Delegation Pattern using ExpandoMetaClass </h1>
The <a class="confluence-link" href="/display/GROOVY/ExpandoMetaClass" data-linked-resource-id="79517" data-linked-resource-type="page" data-linked-resource-default-alias="ExpandoMetaClass" data-base-url="http://docs.codehaus.org">ExpandoMetaClass</a> allows usage of this pattern to be encapsulated in a library. This allows Groovy to emulate similar libraries available for the Ruby language.

Consider the following library class:

<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
class Delegator {
 private targetClass
 private delegate
 Delegator(targetClass, delegate) {
 this.targetClass = targetClass
 this.delegate = delegate
 }
 def delegate(String methodName) {
 delegate(methodName, methodName)
 }
 def delegate(String methodName, String asMethodName) {
 targetClass.metaClass."$asMethodName" = delegate.&amp;"$methodName"
 }
 def delegateAll(String[] names) {
 names.each { delegate(it) }
 }
 def delegateAll(Map names) {
 names.each { k, v -> delegate(k, v) }
 }
 def delegateAll() {
 delegate.class.methods*.name.each { delegate(it) }
 }
}
</pre></td></tr></table>

With this in your classpath, you can now apply the delegation pattern dynamically as shown in the following examples. First, consider we have the following classes:

class MortgageLender {
    def borrowAmount(amount) {
       "borrow \$$amount"
    }
    def borrowFor(thing) {
       "buy $thing"
    }
}

def lender = new MortgageLender()

def delegator = new Delegator(Person, lender)
</pre></td></tr></table>

We can now use the delegator to automatically borrow methods from the lender object to extend the Person class. We can borrow the methods as is or with a rename:

def p = new Person()

println p.borrowFor('present') // => buy present
println p.getMoney(50) // => borrow $50
</pre></td></tr></table>

The first line above, adds the borrowFor method to the Person class by delegating to the lender object. The second line adds a getMoney method to the Person class by delegating to the lender object's borrowAmount method.

Alternatively, we could borrow multiple methods like this:

Which adds these two methods to the Person class.

Or if we want all the methods, like this:

Which will make all the methods in the delegate object available in the Person class.

Alternatively, we can use a map notation to rename multiple methods:

<h1>Implement Delegation Pattern using @Delegate annotation </h1>
Since version 1.6 you can use the built-in delegation mechanism which is based on AST transformation. 
This make delegation even easier:

class MortgageLender {
    def borrowAmount(amount) {
       "borrow \$$amount"
    }
    def borrowFor(thing) {
       "buy $thing"
    }
}

def p = new Person()

assert "buy present" == p.borrowFor('present')
assert "borrow $50" == p.borrowAmount(50)
 
</pre></td></tr></table>