Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<p>The 2.5.1 release is coming about a month after the 2.5.0 release.  Despite the short release cycle, we have included a number of new enhancements to Groovy-Eclipse's DSLD support.</p>

<p>You can use the following update site to install this release:</p>

<table class="wysiwyg-macro" data-macro-name="info" data-macro-parameters="title=Groovy-Eclipse update site for Eclipse 3.7 and 3.6" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2luZm86dGl0bGU9R3Jvb3Z5LUVjbGlwc2UgdXBkYXRlIHNpdGUgZm9yIEVjbGlwc2UgMy43IGFuZCAzLjZ9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body">
<p>For Eclipse 3.7:<br />
<code><a href="http://dist.springsource.org/release/GRECLIPSE/e3.7/">http://dist.springsource.org/release/GRECLIPSE/e3.7/</a></code></p>

<p>For Eclipse 3.6:<br />
<code><a href="http://dist.springsource.org/release/GRECLIPSE/e3.6/">http://dist.springsource.org/release/GRECLIPSE/e3.6/</a></code></p></td></tr></table>

<p>And a zipped version of the update site is available at:</p>

<table class="wysiwyg-macro" data-macro-name="info" data-macro-parameters="title=Zipped Groovy-Eclipse update site for Eclipse 3.7 and 3.6" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2luZm86dGl0bGU9WmlwcGVkIEdyb292eS1FY2xpcHNlIHVwZGF0ZSBzaXRlIGZvciBFY2xpcHNlIDMuNyBhbmQgMy42fQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body">
<p>For Eclipse 3.7:<br />
<code><a href="http://dist.springsource.org/release/GRECLIPSE/e3.7/archive-2.5.1.xx-20110628-1600-e37.zip">http://dist.springsource.org/release/GRECLIPSE/e3.7/archive-2.5.1.xx-20110628-1600-e37.zip</a></code></p>

<p>For Eclipse 3.6:<br />
<code><a href="http://dist.springsource.org/release/GRECLIPSE/e3.6/archive-2.5.1.xx-20110627-1300-e36.zip">http://dist.springsource.org/release/GRECLIPSE/e3.6/archive-2.5.1.xx-20110627-1300-e36.zip</a></code></p>

<p>You can install from the zip by pointing your Eclipse update manager to the downloaded zip file and following the installation instructions.</p></td></tr></table>

<h3>Outline</h3>
<img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e3RvYzptYXhMZXZlbD00fGluZGVudD0yMHB4fHN0eWxlPWRpc2N8ZXhjbHVkZT1PdXRsaW5lfQ&amp;locale=en_GB&amp;version=2" data-macro-name="toc" data-macro-parameters="exclude=Outline|indent=20px|maxLevel=4|style=disc">

<h3>Eclipse 3.7 support</h3>

<p>With the 2.5.1 release, Eclipse 3.7 has become the main development branch.  Although we have been releasing 3.7-based versions of Groovy-Eclipse for a while, it has not been our primary release until now.  We will continue to support the Eclipse 3.6-based version of Groovy-Eclipse, but it will no longer be the main branch of our development.</p>

<h3>groovy-eclipse-compiler for Maven</h3>

<p>We have released the groovy-eclipse-compiler for Maven that let's you use the Groovy-Eclipse compiler in your maven projects. This provides a more robust way of compiling mixed Groovy-Java projects with Maven than previous approaches have allowed.  See all the documentation at the <a class="confluence-link" href="/display/GROOVY/Groovy-Eclipse+compiler+plugin+for+Maven" data-linked-resource-id="193888332" data-linked-resource-type="page" data-linked-resource-default-alias="Groovy-Eclipse compiler plugin for Maven" data-base-url="http://docs.codehaus.org">Groovy-Eclipse compiler plugin for Maven</a> page.</p>

<h3>DSL Descriptor enhancements</h3>

<p>Most of the <a class="confluence-link" href="/display/GROOVY/DSL+Descriptors+for+Groovy-Eclipse" data-linked-resource-id="204275718" data-linked-resource-type="page" data-linked-resource-default-alias="DSL Descriptors for Groovy-Eclipse" data-base-url="http://docs.codehaus.org">DSLD</a> enhancements are centered around sharing DSLD files among multiple projects in the workspace.  For those of you unfamiliar with DSLDs, please read the <a href="http://blog.springsource.com/2011/05/08/better-dsl-support-in-groovy-eclipse/">Better DSL Support in Groovy-Eclipse</a> blog post.</p>

<h4>Groovy DSL Support classpath container</h4>

<p>All Groovy projects will have the <em>Groovy DSL Support</em> classpath container added automatically.  No production code is in the classpath container.  It is only meant to contain DSLD files.  Inside, there are two class folders: <code>global_dsld_support</code> and <code>plugin_dsld_support</code>, described below.</p>

<h5>Global DSLDs</h5>

<p>The <code>global_dsld_support</code> folder points to <code>${user.home}/.groovy/greclipse/global_dsld_support</code>.  It is meant to contain DSLDs that should be shared amongst all projects in the workspace.  You can place any DSLD files here and it will be picked up by Groovy-Eclipse.  Actually, it's not that easy...because of Eclipse <a href="https://bugs.eclipse.org/346928">Bug 346928</a>, you must go to Preferences -&gt; Groovy -&gt; DSLD and click <em>Recompile</em> before the new scripts will be found:</p>

<p><img class="confluence-embedded-image confluence-content-image-border image-center" src="/download/attachments/231082329/recompile.png?version=1&amp;modificationDate=1371637804158" data-image-src="/download/attachments/231082329/recompile.png?version=1&amp;modificationDate=1371637804158" data-linked-resource-id="231377106" data-linked-resource-type="attachment" data-linked-resource-default-alias="recompile.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082329" title="null > recompile.png"></p>

<h5>Plugin DSLDs</h5>

<p>The <code>plugin_dsld_support</code> folder points to <code>${eclipse.home}/plugins/org.codehaus.groovy${active.groovy.version</code>}/plugin_dsld_support.  This folder contains the DSLD files that are shipped with this installation of Groovy-Eclipse.  Since these files will be changed and updated on each upgrade, it is not recommended that users edit these files.</p>

<h5>Controlling the Classpath container</h5>

<p>It is possible to manually add and remove the <em>Groovy DSL Support</em> classpath container by clicking on a groovy project and selecting add/remove <em>Groovy DSL Support</em>:</p>

<p><img class="confluence-embedded-image confluence-content-image-border image-center" src="/download/attachments/231082329/remove_dsld_support.png?version=1&amp;modificationDate=1371637804154" data-image-src="/download/attachments/231082329/remove_dsld_support.png?version=1&amp;modificationDate=1371637804154" data-linked-resource-id="231377105" data-linked-resource-type="attachment" data-linked-resource-default-alias="remove_dsld_support.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082329" title="null > remove_dsld_support.png"></p>

<p>Alternatively, if you do not want the classpath container added automatically to any project, you can disable this in the Eclipse preferences -&gt; Groovy -&gt; DSLD:</p>

<h4>Multiple DSLDs of same name</h4>

<p>In order to support an eco-system of DSLDs and be able to gracefully handle the conflicts that could occur when multiple versions of a single DSLD exist in a project, Groovy-Eclipse now uses the following heuristics when looking for DSLDs:</p>

<ol>
	<li>All DSLDs with the same name are considered the same, regardless of which folder or jar they are located in.</li>
	<li>DSLDs that exist in the project (i.e., not in a jar file and not coming from a binary class folder) take precedence.</li>
	<li>After that, the classpath ordering takes precedence.  In other words, a DSLD located in a jar at the beginning of the classpath will take precedence over a DSLD located in a jar at the end of the classpath.</li>
	<li>If multiple versions of a single DSLD file is located in the project or in a single classpath entry, then an arbitrary one is chosen.  The others are ignored.</li>
</ol>

<h4>Disabling DSLD support</h4>

<p>It is possible to completely disable DSLD support.  You can do this from the preferences -&gt; Groovy -&gt; DSLD page:</p>

<p><img class="confluence-embedded-image confluence-content-image-border image-center" src="/download/attachments/231082329/disable_dslds.png?version=1&amp;modificationDate=1371637804132" data-image-src="/download/attachments/231082329/disable_dslds.png?version=1&amp;modificationDate=1371637804132" data-linked-resource-id="231377103" data-linked-resource-type="attachment" data-linked-resource-default-alias="disable_dslds.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082329" title="null > disable_dslds.png"></p>

<h3>Built-in AST transforms recognized in the editor</h3>

<p>Groovy-Eclipse now ships with several built-in DSLD files that handle some built-in AST transforms like <code>@Delegate</code>, <code>@Mixin</code>, and <code>@Singleton</code>.  Additionally, support exists for Swing Builder.  The <em>Groovy DSL Support</em> classpath container must be added to your project in order for this support to be available.  For example. here is the singleton transform in use:</p>

<p><img class="confluence-embedded-image confluence-content-image-border image-center" src="/download/attachments/231082329/singleton.png?version=1&amp;modificationDate=1371637804119" data-image-src="/download/attachments/231082329/singleton.png?version=1&amp;modificationDate=1371637804119" data-linked-resource-id="231377102" data-linked-resource-type="attachment" data-linked-resource-default-alias="singleton.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082329" title="null > singleton.png"></p>

<p>And here is swing builder in use:</p>

<p><img class="confluence-embedded-image confluence-content-image-border image-center" src="/download/attachments/231082329/swing_builder.png?version=1&amp;modificationDate=1371637804103" data-image-src="/download/attachments/231082329/swing_builder.png?version=1&amp;modificationDate=1371637804103" data-linked-resource-id="231377101" data-linked-resource-type="attachment" data-linked-resource-default-alias="swing_builder.png" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231082329" title="null > swing_builder.png"></p>

<p>All hovers over swing builder components have links to full documentation.</p>

<h4>What to expect for the future of DSLDs</h4>

<p>As we gain more experience with DSLDs, we are learning more about the areas of DSLDs that need improvements.  As we make changes to DSLD support, we will try hard to maintain backwards compatibility as well as be clear about which parts of the language have been deprecated.  There are a number of things that we will be working on.</p>

<ul>
	<li>Pointcut changes: we are realizing that a number of pointcuts are poorly named and there are others that are ambiguous or superfluous.  Expect some changes with the names of available pointcuts.  We will try to keep old pointcuts available, but just mark them as deprecated.</li>
	<li>Compatibility changes: IntelliJ's GDSLs solve a similar problem that DSLDs solve.  However, the syntax is different.  We are in discussion with the IntelliJ's Groovy team to see if there is a way of unifying the syntax of the two languages.  This is a long-term goal and may not be ready for the 2.5.2 release.  This will require some more significant changes to the syntax, but as much as possible, we will try to ensure that the old syntax still works.</li>
</ul>

<h3>Launch configurations</h3>

<p>The Groovy Script launcher is now more robust.  Upgrading Groovy-Eclipse versions will not break existing launch configurations.  Furthermore, these launch configurations can be saved as files in a project and committed into a VCS to be shared between developers.</p>

<h3>Compatibility</h3>

<p>Groovy-Eclipse 2.5.1 includes Groovy 1.7.10 by default.  <a class="confluence-link" href="/display/GROOVY/Compiler+Switching+within+Groovy-Eclipse" data-linked-resource-id="133923519" data-linked-resource-type="page" data-linked-resource-default-alias="Compiler Switching within Groovy-Eclipse" data-base-url="http://docs.codehaus.org">Groovy 1.8.0 can be optionally installed.</a>  Groovy-Eclipse is installable on STS 2.7.0, Eclipse 3.7.0, 3.6.0, 3.6.1, or 3.6.2.  There are different update sites for Groovy-Eclipse targeting Eclipse 3.6 and 3.7.  See above for the update sites.</p>

<h3>Bug fixes</h3>

<p>There have been 30 bug fixes in this release.  You can see all of them in the <a href="https://jira.codehaus.org/secure/IssueNavigator.jspa?reset=true&amp;jqlQuery=project+%3D+GRECLIPSE+AND+resolution+in+%28Fixed%2C+%22Won%27t+Fix%22%2C+Duplicate%2C+Incomplete%29+AND+fixVersion+%3D+17186+ORDER+BY+priority+DESC">Codehaus issue tracker</a>.</p>

<p>We appreciate all community support and feedback.  If you wish to join the discussion about Groovy-Eclipse then please sign up for the <a href="http://xircles.codehaus.org/manage_email/eclipse-plugin-user@groovy.codehaus.org">mailing list</a>.  For any issues you have (or enhancements you would like to see), please raise them in our <a href="http://jira.codehaus.org/browse/GRECLIPSE">issue tracker</a>.  If there is an existing bug fix or enhancement that you require are not seeing any movement on, please make some noise on it (and get your friends to do the same).  We respond to community feedback, and we can make the most improvements to Groovy-Eclipse when we hear directly from the community.  So, please speak up!</p>