Reference Manual for Gracelets - 2.0.0.RC2

2.19 - Tutorial : Writing Gracelet Components

When writing a library, you may want to provide automatic resolution for certain variables inside view scripts and other libraries. You can do this with ScriptBindings. You can define this inside the same library as the other components previously discussed.

As an example, here is the JBossPCComponentLibrary that comes with the optional JBoss library. It automatically detects via class lookup if we are possibly in a JBoss EJB3 environment. Then if so it sets up script bindings so that the persistence contexts are automatically available in session context via their real names and puts a wrapper in the session context.

Toggle Line Numbers

1 
package org.ponder.gracelets.libraries.jboss 
2 
 
3 
namespace = "http://gracelets.api.extension/jboss" 
4 
 
5 
def exists = false; 
6 
try { 
7 
    exists = Class.forName("org.jboss.ejb3.PersistenceUnitRegistry", false, Thread.currentThread().contextClassLoader) != null; 
8 
    log.info("Enabling JBoss EJB3 Persistence Context Resolution") 
9 
    ejb = ScriptBindings( 
10 
        resolve: { name -> 
11 
            if (name == "ejb3PCWrappers") return null; 
12 
            if (ejb3PCWrappers == null) sessionContext.set("ejb3PCWrappers", [:]) 
13 
            if (!exists) return null; 
14 
            if (ejb3PCWrappers[name] != null) return ejb3PCWrappers[name] 
15 
            if (JBossEql.storageNames.contains(name)) return ejb3PCWrappers[name] = new JBossEql(name); 
16 
        } 
17 
    ) 
18 
} catch (t) { 
19 
    exists = false; 
20 
    log.info("Disabling JBoss EJB3 Persistence Context Resolution") 
21 
}

As can be seen above you can define a closure called 'resolve'. This will work for lazy initialization. You can also define one called apply. The apply closure should return a map of string -> object relationships which will automatically be initialized on each Binding for each script, library and so forth.

^{Generated by Gracelets Documentation Generator - 08/27/2009 08:28PM CDT}