HQU Start Editing
After a simple scaffold creation, you can immediately start editing 2 files to see results:
| app/FreezerController.groovy | Holds logic for finding and interacting with the backend |
| views/freezer/index.gsp | Chunk of HTML, which is generated in conjunction with the controller |
The HQU Workcycle
You can immediately start editing the above files and seeing results in HQ. A typical HQU workcycle looks like this:
- Edit any file within the plugin (.groovy, .gsp, .properties, etc.)
- ant hqu-redeploy-plugin -Dplugin=cool
- <reload browser>
The hqu-redeploy-plugin task simply deletes the plugin directory from {JBOSS_HOME}/server/default/deploy/hq.ear/hq.war/hqu_plugins, and copies the new plugin back into its place.
Development Plugins
HQ ships with tools which aid plugin development.
- The GConsole - allows direct intraction with HQ through a web console
- Plugin Mon - used to detach views and delete plugins
Developing Views
You may find it useful to use the Plugin Mon when changing your plugin's attach points. Simply delete your plugin and redeploy it to add or change views.
Making changes to rendit_sys or backend classes
The HQ package which acts as a bridge into HQU Groovy-land is called rendit_sys. This directory houses libraries available to all HQU plugins. Changes to these files requires a special type of redeployment. ant hqu-redeploy-plugin -Dcool does not update rendit_sys.
In order to redeploy changes to rendit_sys, execute:
ant hqu-undeploy && sleep 5 && ant hqu-deploy
This will redeploy rendit_sys, and all deployed plugins.