Open Documentation Menu

Development environment

Groovy code is contained in text files that you can edit with a simple text editor.

For effective development of hooks, however, we recommend using a development environment such as Eclipse, which assists users with functions such as autocompletion of code.

The Java classes of the d.3 server interface and Groovy support as well as the Groovy interpreter are located in the Java archive groovyhook.jar in the d.3 server program directory (by default at C:\d3\d3server.prg). In Eclipse, you can integrate the Java archive at Project Properties > Java Build Path as External JAR.

In this case, install a Groovy plug-in for Ecplise to get the best possible support for syntax highlighting and command autocompletion.

Note

When developing and testing Groovy program code, enable the d.3 config parameter Enable reloading of Groovy hook files on change (RELOAD_ON_CHANGE).

This means that when Groovy hook files are saved, the Groovy hook files are automatically reloaded by the server processes and the code changes are immediately active.

Warning

For security reasons, do not activate the reload option in the live system. Otherwise, changes to the Groovy scripts would become active immediately in your live system.