{"id":858,"date":"2009-11-21T19:28:04","date_gmt":"2009-11-22T04:28:04","guid":{"rendered":"https:\/\/www.kellyrob99.com\/blog\/?p=858"},"modified":"2009-11-21T19:28:04","modified_gmt":"2009-11-22T04:28:04","slug":"different-flavors-of-embedded-groovy-in-java-apps-or-how-to-make-your-java-groovier","status":"publish","type":"post","link":"https:\/\/www.kellyrob99.com\/blog\/2009\/11\/21\/different-flavors-of-embedded-groovy-in-java-apps-or-how-to-make-your-java-groovier\/","title":{"rendered":"Different Flavors of Embedded Groovy in Java Apps or “How To Make your Java Groovier!”"},"content":{"rendered":"

Lately I’ve been thinking about all the different ways to bring Groovy into a pure Java or command line environment, and ended up diving into some code to explore the various options. Turns out there’s definitely a good variety of options for running Groovy dynamically inside and out of a Java application. I started out on this page from the Groovy site<\/a>.
\nIn particular for the environments I’ve been working in lately it’s been important to be able to run the same code both from within a Java application and from the command line. It’s also been a ‘nice to have’ to be able to package a jar with a bunch of the same scripts compiled together. Using maven as a harness also has the benefit of allowing for testing compiled scripts directly through instantiation even though the intended usage is from within a Java app using one of these methods. Source code is available here on github<\/a>.<\/p>\n

<\/p>\n

Groovy on the command line<\/h3>\n

The quickest and simplest way to run a Groovy Script or Class, command line arguments are automatically marshalled into an ‘args’ String array. Please note that due to a problem I’m having with my syntax highlighter plugin the process execution is shown here in single quotes; the actual code requires a GString(double quoted) in order to do the replacement for the inline variable. &quot;<\/code> THAT WordPress!<\/p>\n

\r\n\/\/the script\r\nmyArgs = args\r\nresult = args.join(' ')\r\nprintln result\r\nprintln myArgs\r\n\r\n\/\/...and the test\r\n    void testGroovyCall()\r\n    {\r\n        def proc = 'groovy $groovyScriptOne Hello World'.execute()\r\n        proc.waitFor()\r\n        def result = proc.text.split()\r\n        assert result[0] == 'Hello'\r\n        assert result[1] == 'World'\r\n    }\r\n\r\n<\/pre>\n
<\/p>\n
GroovyShell<\/h3>\n
This is the basis of Groovy script execution. The GroovyShell<\/a> allows for executing scripts, passing in a particular Binding context that allows for bi-directional communication between the script and the calling code. Parameters can be passed into the executing script in the Binding and results can be stored there to be returned to the calling context. GroovyShell also allows for running a class from the ‘main’ method, passing in String arguments. It will also execute implementers of Runnable and test files for  JUnit or TestNG. Script text can also be declared inline and executed in the same way as files on disk. All in all, pretty bloody handy. Here’s a straightforward example of running a dirt simple Groovy script and inspecting the results. Note that this isn’t executable as shown, but I’ll provide the full source code on github for anyone who wants a closer look. Note that I’m also passing in an ‘out’ variable in the Binding, which effectively redirect System.out to a specified Writer implementation – a nice touch for inspecting output.<\/p>\n
\r\n\/\/the script\r\nmyArgs = args\r\nresult = args.join(' ')\r\nprintln result\r\nprintln myArgs\r\n\r\n \/\/...and the test\r\n    void testGroovyShell()\r\n    {\r\n        Binding binding = helper.createBinding()\r\n        def shell = new GroovyShell(binding)\r\n        shell.evaluate(new File(groovyScriptOne))\r\n        helper.assertBinding(binding)\r\n    }\r\n\r\n\/\/...and the Binding creation\/assertion\r\n     def static args = ['Hello', 'World'].asImmutable()\r\n     \/**\r\n     * Create a Binding with a single parameter to be passed to scripts and an 'out' Writer to redirect console output.\r\n     *\/\r\n    private Binding createBinding()\r\n    {\r\n        Binding binding = new Binding()\r\n        def sWriter = new StringWriter()\r\n        def pWriter = new PrintWriter(sWriter)\r\n        binding.setVariable ('args', new ArrayList(args))\r\n        binding.setVariable ('out', pWriter)\r\n        return binding\r\n    }\r\n\r\n    \/**\r\n     * Assert that the expected 'common' actions are done with the Binding by each of the use cases.\r\n     * The original 'args' should be as expected.\r\n     * A copy of 'args' should have been placed in the Binding during execution.\r\n     * The 'result' should be the concatentation of 'args' separated by spaces.\r\n     *\/\r\n    private def assertBinding(Binding binding)\r\n    {\r\n        assert binding.variables.size() == 4\r\n        assert binding.variables.args.value[0].toString() == args[0]\r\n        assert binding.variables.args.value[1].toString() == args[1]\r\n        assert binding.variables.result.value.toString() == args.join(' ')\r\n        assert binding.variables.myArgs.value[0].toString() == args[0]\r\n        assert binding.variables.myArgs.value[1].toString() == args[1]\r\n    }\r\n<\/pre>\n
<\/p>\n
GroovyScriptEngine<\/h3>\n
The GroovyScriptEngine<\/a> enables dynamically running Groovy sources located in a fixed set of content roots,  complete with reloading modified scripts in between executions. Running a Groovy script this way is essentially the same as using GroovyShell.<\/p>\n
\r\n    void testGroovyScriptEngine()\r\n    {\r\n        Binding binding = helper.createBinding()\r\n        def gse = new GroovyScriptEngine(new File('.').toURL())\r\n        gse.run(groovyScriptOne, binding)\r\n        helper.assertBinding(binding)\r\n    }\r\n<\/pre>\n
<\/p>\n
GroovyClassLoader<\/h3>\n
An extension to URLClassLoader that enables parsing Groovy sources into Class representations. Once a Class object is created, instances of the class can be created easily and either cast to a known type or manipulated through convention by use of the standard Groovy ‘invokeMethod’.  This works equally well on Groovy and Java btw. Here’s an example of running a Java class using GroovyClassLoader<\/a>. In this case the Java file has a field called ‘binding’ and implements a ‘run’ method.<\/p>\n
\r\n    \/**\r\n     * Dynamically compile, instantiate, inspect and call methods on a POJO.\r\n     *\/\r\n    void testGroovyClassLoaderOnJava()\r\n    {\r\n        GroovyClassLoader loader = new GroovyClassLoader();\r\n        Class javaClass = loader.parseClass(new File(javaFileOne));\r\n\r\n        def groovyObject = javaClass.newInstance();\r\n        def binding = helper.createBinding()\r\n        groovyObject.binding = binding\r\n        if(groovyObject.metaClass.respondsTo(groovyObject, 'run'))\r\n        {\r\n            groovyObject.invokeMethod('run', null);\r\n            helper.assertBinding(binding)\r\n        }\r\n        if(groovyObject.metaClass.respondsTo(groovyObject, 'main'))\r\n        {\r\n            groovyObject.invokeMethod('main', new ArrayList(helper.args) as String[]);\r\n        }\r\n    }\r\n<\/pre>\n
<\/p>\n
(Groovy)Console<\/h3>\n
The Console<\/a> can be embedded in Java or Groovy code to provide a dynamic interactive Swing environment. This is the same UI spawned from the command line invocation of ‘groovyConsole’. Internally it uses GroovyShell for actual execution, and so can do everything that GroovyShell can do – plus a couple of additions. For one, you can add jars and\/or directories to the classpath used when executing your scripts.
\n\"Groovy<\/a><\/p>\n
<\/p>\n
The Best of Both Worlds – at Least for my use case<\/h3>\n
In actual practice these patterns can be used a lot more successfully by observing standard Java practices, like casting classes parsed using GroovyClassLoader to a known interface before interacting with them, or by using Classes to organize business logic inside of a Script that essentially functions as a ‘main’ method.  This example defines two dependent internal classes, marshals parameters to them and then returns the results attached to the originally passed in Binding.<\/p>\n
\r\n\/**\r\n * Classes inside of a Script.\r\n *\/\r\nclass TestableClass\r\n{\r\n    Binding binding\r\n\r\n    def run()\r\n    {\r\n        binding.with\r\n        {\r\n            setVariable('myArgs', getVariable('args'))\r\n            setVariable('result', getVariable('args')?.join(' '))\r\n        }\r\n        return binding\r\n    }\r\n}\r\n\r\nclass TestableClass2\r\n{\r\n    Binding binding\r\n\r\n    public TestableClass2(Binding binding)\r\n    {\r\n        this.binding = binding;\r\n    }\r\n\r\n    def run()\r\n    {\r\n        return new TestableClass(binding: binding).run()\r\n    }\r\n}\r\n\r\nif (args)\r\n{\r\n    def internalBinding = new Binding()\r\n    internalBinding.setVariable('args', new ArrayList(args))\r\n    internalBinding = new TestableClass2(internalBinding).run()\r\n    args = internalBinding.args\r\n    myArgs = internalBinding.myArgs\r\n    result = internalBinding.result  \/\/return value from script\r\n}\r\nelse\r\n{\r\n    println 'no args!!'\r\n}\r\n<\/pre>\n[table \u201c1\u201d not found \/]
\n\n
\"Reblog<\/a>