[jbosstools-commits] JBoss Tools SVN: r41100 - in trunk/documentation/whatsnew: maven and 1 other directory.

Author: fbricon Date: 2012-05-16 18:59:55 -0400 (Wed, 16 May 2012) New Revision: 41100 Added: trunk/documentation/whatsnew/images/m2e-apt-central.png trunk/documentation/whatsnew/images/m2e-apt-prefs.png trunk/documentation/whatsnew/images/m2e-apt.png Modified: trunk/documentation/whatsnew/maven/maven-news-3.3.0.Beta3.html Log: JBIDE-11761 : Maven Integration in JBT 3.3.0 Beta 3 N&N Added: trunk/documentation/whatsnew/images/m2e-apt-central.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/whatsnew/images/m2e-apt-central.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: trunk/documentation/whatsnew/images/m2e-apt-prefs.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/whatsnew/images/m2e-apt-prefs.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: trunk/documentation/whatsnew/images/m2e-apt.png =================================================================== (Binary files differ) Property changes on: trunk/documentation/whatsnew/images/m2e-apt.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Modified: trunk/documentation/whatsnew/maven/maven-news-3.3.0.Beta3.html =================================================================== --- trunk/documentation/whatsnew/maven/maven-news-3.3.0.Beta3.html 2012-05-16 22:54:22 UTC (rev 41099) +++ trunk/documentation/whatsnew/maven/maven-news-3.3.0.Beta3.html 2012-05-16 22:59:55 UTC (rev 41100) @@ -37,8 +37,28 @@ <td valign="top" align="left"> <a name="itemname1" id="itemname1"></a><b>Annotation Processing support</b></td> <td valign="top"> - <p>TODO Fred</p> - <small> + <p> + m2e-apt is a m2e plugin allowing automatic configuration of Eclipse JDT's built-in Annotation Processing Toolkit (APT) based on your maven project's pom.xml configuration.<br/> + m2e-apt is preinstalled with JBoss Developer Studio 5.0.0.Beta3. For JBoss Tools 3.0.0.Beta3 users, m2e-apt can be installed via the Software/Update tab in JBoss Central : + </p> + <img src="../images/m2e-apt-central.png" /> + <p> + With m2e-apt, you can now automatically enable annotation processing support for maven projects, based on their classpath dependencies (Requires Java &gt;= 1.6). <br/> + <br/>m2e-apt supports both annotation processing set on the maven-compiler-plugin or the <a href="http://code.google.com/p/maven-annotation-plugin/">mav... + (the latter takes precedence over the former). <br/><br/> + For example, to enable the JPA modelgen annotation processor, you can either set : <br/><br/> + + &lt;plugin&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;artifactId&gt;maven-compiler-plugin&lt;/artifactId&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;version&gt;2.4&lt;/version&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;configuration&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;source&gt;1.6&lt;/source&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;target&gt;1.6&lt;/target&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;/configuration&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;dependencies&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;dependency&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;groupId&gt;org.hibernate&lt;/groupId&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;artifactId&gt;hibernate-jpamodelgen&lt;/artifactId&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;version&gt;1.2.0.Final&lt;/ve! rsion&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/dependency&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;/dependencies&gt;&nbsp;<br/>&lt;/plugin&gt;&nbsp;<br/><br/>or&nbsp;<br/><br/>&lt;plugin&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;artifactId&gt;maven-compiler-plugin&lt;/artifactId&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;version&gt;2.4&lt;/version&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;configuration&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;source&gt;1.6&lt;/source&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;target&gt;1.6&lt;/target&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;compilerArgument&gt;-proc:none&lt;/compilerArgument&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;/configuration&gt;&nbsp;<br/>&lt;/plugin&gt;&nbsp;<br/>&lt;plugin&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;groupId&gt;org.bsc.maven&lt;/groupId&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;artifactId&gt;maven-process! or-plugin&lt;/artifactId&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp! ;&lt;ver sion&gt;2.0.5&lt;/version&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;executions&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;execution&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;id&gt;process&lt;/id&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;goals&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;goal&gt;process&lt;/goal&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/goals&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;phase&gt;generate-sources&lt;/phase&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/execution&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;/executions&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;dependencies&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;dependency&gt! ;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;groupId&gt;org.hibernate&lt;/groupId&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;artifactId&gt;hibernate-jpamodelgen&lt;/artifactId&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;version&gt;1.2.0.Final&lt;/version&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/dependency&gt;&nbsp;<br/>&nbsp;&nbsp;&nbsp;&nbsp;&lt;/dependencies&gt;&nbsp;<br/>&lt;/plugin&gt;&nbsp; + + </p> + <p>The generated source folders (target/generated-sources/annotation for maven-compiler-plugin; target/generated-sources/apt for maven-processor-plugin) are automatically added to the project classpath. </p> + <img src="../images/m2e-apt.png" /> + <p> + Since Annotation Processing is managed by Eclipse JDT APT by default, a change in your source classes triggers incremental processing automatically. The downside of using JDT APT is, there's no separation between main and test classes (the way maven-processor-plugin handles them). To mitigate that limitation, you can change the workspace or project preferences to delegate annotation processing to maven, instead of JDT APT (Note this only works when using maven-processor-plugin). This will result in slower incremental builds (all classes will be processed) but will provide identical results to maven command line builds. <br/><br/>Automatic Annotation Processing configuration from the maven pom.xml can also be disabled altogether. In this case, your manual settings for Eclipse JDT APT will remain untouched. <br/><br/>Go to Window &gt; Preferences &gt; Maven &gt; Annotation processing or right-click on your project &gt; Properties &gt; Maven &gt; Annotation processing ! to select the Annotation Processing strategy of your choice. + </p> + <img src="../images/m2e-apt-prefs.png" /> + + <small> See <a href="https://issues.jboss.org/browse/JBIDE-8208">JBIDE-8208... for more details. </small></p> </td>