Last updated by 2 years ago
Page: STS Integration, Version:19
The STS and Groovy team have recently announced the release of some basic Grails support in STS. In this tutorial, I am going to introduce this support and describe how to create your first Grails project in STS. This includes how to install Grails support, how to create a new Grails project, how to import an existing Grails project, and how to use the Grails tooling to execute Grails commands.Grails tooling requires Groovy-Eclipse, so feel free to explore that as well.
InstallTo begin, install the latest STS, which is freely available for download here. After installing and running, you will be greeted with a welcome screen. This is the dashboard view which can also be brought up with Help -> Dashboard. (Please note that screenshots may be slightly different than what you see in your install since these shots were taken from STS 2.2.0.)At the bottom, you will see the Extensions tab:You will find several available STS extensions, including Groovy and Grails support:Choose Groovy and Grails support. Then follow the steps to install and restart STS (requires an internet connection). After restarting, you will now have Groovy and Grails tooling support available.
Project creationTo create a new Grails project click on:
And find the Grails Project wizard Click Next : Uh oh...we don't have any Grails installations configured. No worries. Let's do that now. Specify a Project name, select Configure Grails Installations ; click Add and choose a Grails installation folder. You can choose the Grails installation that comes with STS, or you can choose your own version:Click Finish and wait for the Grails command to be completed. You have now created your first Grails project!
File -> New -> Other
Importing an Existing Grails ProjectTo import an existing Grails project, use the standard Eclipse import wizard for existing projects. One way that you can find it by right clicking anywhere in the Package Explorer and selecting Import... :Choose Existing Projects into Workspace :Select the root directory containing your Grails project or projects (the import wizard can be used to import multiple projects at once):Then click Finish . Your project will be imported. Uh oh, there are errors:This is because, the Grails tooling support for Eclipse is not configured properly when a Grails app is created (we expect to have this fixed in future releases). You must explicitly add the Grails nature to the project. Right click on the project or projects you imported and select (in the Configure sub-menu):And now you have successfully imported your project into Eclipse.
Using Grails ToolingIf you haven't already done so, you must point Eclipse to a Grails runtime. You can do this in the Eclipse preferences page:All Grails projects are also Groovy projects. So, open any Groovy file in your Grails project and you will see the Groovy support. Syntax highlighting, content assist, outline views are all available:To execute a Grails command, go to the Navigate menu:Or, while in a Groovy file press CTRL+ALT+G (or CMD+ALT+G on Macs). Now the Grails command prompt appears:Content assist is available CTRL-Space (or CMD-Space on Macs):Completing the command and pressing enter will kick off a the Grails command in the console (this particular command created a domain class):After Grails completes the execution of the command, the workspace will be refreshed and your new domain class (or whatever you have just created) is available for editing:Grails tooling will manage your classpath. The classpath is refreshed automatically when the project is created or imported. However, when the Grails classpath changes, such as when you add or remove plugins, you must explicitly schedule an Eclipse classpath refresh (Right click project for menu) :
Running and TestingSTS supports you in running your Grails apps. Execute the
run-appcommand:And the console will run the app for you, providing you with a URL that you can navigate to:Similarly, for testing, executing the
test-appcommand will execute all of your project's unit and integration tests:
Closing wordsAnd that is Grails support in Eclipse. We will be working hard on enhancing Grails support in future versions of STS. There are quite a few features that we will be providing in the future. This includes gsp editing support, Grails-specific content assist and quick fixes in the Groovy editor, fully automated management of plugins, and a more tightly integrated Grails shell.Here is the support information:
- For questions about Grails support, please visit our http://forum.springsource.org/forumdisplay.php?f=32. A
- Bug reports and feature requests can be created in the STS jira: https://issuetracker.springsource.com/browse/STS
- In particular, https://issuetracker.springsource.com/browse/STS-487 is the issue for Grails enhancements and requirements.
- Questions on Groovy support in Eclipse can be sent to the mailing list.