rave-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r790249 - /websites/staging/rave/trunk/content/rave/source.html
Date Mon, 30 May 2011 20:59:07 GMT
Author: buildbot
Date: Mon May 30 20:59:06 2011
New Revision: 790249

Staging update by buildbot


Modified: websites/staging/rave/trunk/content/rave/source.html
--- websites/staging/rave/trunk/content/rave/source.html (original)
+++ websites/staging/rave/trunk/content/rave/source.html Mon May 30 20:59:06 2011
@@ -126,7 +126,6 @@ any directory/folder.</p>
 <li>Install <a href="http://download.eclipse.org/webtools/downloads/">Eclipse
for Java EE</a></li>
 <li>Install M2Eclipse from the <a href="http://m2eclipse.sonatype.org/sites/m2e">Update
 <li>Install <a href="http://subclipse.tigris.org/update_1.6.x/">Subclipse</a></li>
-<li>Install M2Eclipse-extras from the <a href="http://m2eclipse.sonatype.org/sites/m2e-extras">Update
 <li>File -&gt; Import -&gt; Maven -&gt; Check Out maven project from SCM<ul>
 <li>select SVN</li>
 <li>URL is https://svn.apache.org/repos/asf/incubator/rave/trunk</li>
@@ -144,34 +143,68 @@ any directory/folder.</p>
     performance drain (Update Maven projects on startup being the
-<p>Now the application is building you probably want to be able to run
-Rave inside of Eclispe. This gives a faster turnaround in the
-edit/build/deploy cycle. This is possible, but it is less than optimal.</p>
-<p>We recommend the use of JRebel rather than WTP. It's just
-better. However, it is not free. If you are a committer you can get a
-free licence, but if not you wither need to buy your own licence (you
-can get a free 30 day trial licence) or you need to use the adequate, but
-less functional Eclipse WTP.</p>
-<p>For those of you using Eclipse WTP you need to follow these steps:</p>
-<p>For those of you using Eclipse WTP you need to follow these steps:</p>
-<li>Right click on the rave-shindig project and select Properties</li>
-<li>Open the "Deployment Assembly" property</li>
-<li>Press Add, select Directive Type "Folder", and select the target/rave-shindig-0.1-incubating-SNAPSHOT
folder. I had to do a "mvn install" in rave-project for this to be ava$</li>
-<li>configure the correct Context root paths for rave-portal
-    ("portal") and rave-shindig ("/") in their Eclipse project
-    properties under "Web Project Settings"</li>
-<p>Now we need to add the the two webapps to the server:</p>
-<li>Windows-&gt;Show View-&gt;Other...</li>
-<li>In the servers view right click your chosen server and slect Add and Remove...</li>
-<li>Add rave-shindig and rave-portal</li>
-<li>Start the server</li>
-<li>Now see the instructions above for logging into the server</li>
+<p>Now the application is building you probably want to be able to develop and debug
+Rave from inside Eclipse. This gives a faster turnaround in the
+edit/build/deploy cycle.</p>
+<p>There are a few different ways to do this:</p>
+<h4 id="using_remote_debugging_and_the_eclipse_filesync_plugin">Using Remote debugging
and the Eclipse FileSync plugin</h4>
+<p>The OSS <a href="http://andrei.gmxhome.de/filesync/index.html">Eclipse FileSync</a>
plugin can automatically synchronize (re)source changes
+(e.g. .jsp, .css, .js) made in the Eclipse IDE directly to the runtime tomcat deployment
+started (separately) through maven cargo:start. And you can attach the Eclipse debugger
+to the cargo started Tomcat instance (see above) as remote application on default port 8000.</p>
+<p>The <a href="http://code.google.com/p/mavenfilesync/">maven-filesync-plugin</a>
is pre-configured to generate default Eclipse FileSync
+configurations for the rave-shindig and rave-portal projects, mapping their source folders
+src/main/webapps and src/main/resources to synchronize (copy) changes to the Tomcat deployment
+environment under rave-portal/target/Tomcat6x, so this will work out-of-the-box.</p>
+<p>Prerequisite: install the Eclipse FileSync plugin from its <a href="http://andrei.gmxhome.de/eclipse/">Update
+<p>The first time you build the Rave project with maven, the maven-filesync-plugin
+will generate this default FileSync configuration for the FileSync plugin.
+Afterwards you only have to refresh the Eclipse projects once to have them recognize this.
+Thereafter you can customize the synchronization configuration manually within Eclipse through
+the project properties dialog.
+Note: manual changes will not be overridden anymore by the maven-filesync-plugin once they
+exist. Furthermore, if you are not using Eclipse, this plugin will simply skip its execution.</p>
+<p>If you have "Build automatically" enabled within Eclipse, the FileSync plugin will
+changes automatically after you saved them in Eclipse. Otherwise you can force a manual
+synchronization from the project (rave-portal or rave-shindig) its context menu actions.</p>
+<h4 id="using_remote_debugging_with_the_jrebel_plugin">Using Remote debugging with
the JRebel plugin</h4>
+<p>Using <a href="http://www.zeroturnaround.com/jrebel/how-to-install-jrebel-for-eclipse/">JRebel</a>
provides one the best remote debugging and runtime code change synchronizing
+solutions, as well as can handle resource (non-code) change synchronization.</p>
+<p>However, JRebel is not free. If you are a committer you can get a free licence,
but if not you
+will need to buy your own licence (you can try out a free 30 day trial licence first).</p>
+<p>Setting up and configuring JRebel is not pre-configured for the Rave project but
by following
+the instructions from the JRebel manual this should be relatively easy to do.</p>
+<p>Note: using both the Eclipse FileSync plugin for (only) resources synchronization
and JRebel 
+for the hot-code replacement probably will provide the best combination with the least
+configuration overhead.</p>
+<h4 id="using_eclipse_wtp">Using Eclipse WTP</h4>
+<p>The Rave project can also be deployed through Eclipse WTP, and might be adequate
for some, but it
+it is less functional and sometimes a bit quirky. Furthermore, because of (current) limitations
+of the m2eclipse WTP integration for maven war overlays (which the rave-shindig project uses),
+you'll need to use some workarounds to make it workable.</p>
+<p>Prerequisite: Install m2eclipse-wtp integration from the m2eclipse-extras <a
href="http://m2eclipse.sonatype.org/sites/m2e-extras">Update Site</a></p>
+<p>If you already imported the Rave projects in Eclipse, first remove them (but don't
need to delete them)
+and then (re)import the Rave project as Maven projects to get the m2eclipse-wtp integration
enabled. </p>
+<p>Then you need to follow these steps:</p>
+<div class="codehilite"><pre><span class="o">*</span> <span class="n">Right</span>
<span class="n">click</span> <span class="n">on</span> <span class="n">the</span>
<span class="n">rave</span><span class="o">-</span><span class="n">shindig</span>
<span class="n">project</span> <span class="ow">and</span> <span
class="nb">select</span> <span class="n">Properties</span>
+<span class="o">*</span> <span class="n">Open</span> <span class="n">the</span>
<span class="s">&quot;Deployment Assembly&quot;</span> <span class="n">property</span>
+<span class="o">*</span> <span class="n">Press</span> <span class="n">Add</span><span
class="p">,</span> <span class="nb">select</span> <span class="n">Directive</span>
<span class="n">Type</span> <span class="s">&quot;Folder&quot;</span><span
class="p">,</span> <span class="ow">and</span> <span class="nb">select</span>
<span class="n">the</span>
+  <span class="n">target</span><span class="o">/</span><span class="n">rave</span><span
class="o">-</span><span class="n">shindig</span><span class="o">-</span><span
class="mf">0.1</span><span class="o">-</span><span class="n">incubating</span><span
class="o">-</span><span class="n">SNAPSHOT</span> <span class="n">folder</span><span
+  <span class="p">(</span><span class="k">do</span> <span class="n">a</span>
<span class="s">&quot;mvn install&quot;</span> <span class="n">in</span>
<span class="n">rave</span><span class="o">-</span><span class="n">project</span>
<span class="n">first</span> <span class="k">for</span> <span class="n">this</span>
<span class="n">folder</span> <span class="n">to</span> <span class="n">be</span>
<span class="n">available</span><span class="p">)</span>
+<span class="o">*</span> <span class="n">configure</span> <span
class="n">the</span> <span class="n">correct</span> <span class="n">Context</span>
<span class="n">root</span> <span class="n">paths</span> <span
class="k">for</span> <span class="n">rave</span><span class="o">-</span><span
+  <span class="p">(</span><span class="s">&quot;portal&quot;</span><span
class="p">)</span> <span class="ow">and</span> <span class="n">rave</span><span
class="o">-</span><span class="n">shindig</span> <span class="p">(</span><span
class="s">&quot;/&quot;</span><span class="p">)</span> <span
class="n">in</span> <span class="n">their</span> <span class="n">Eclipse</span>
<span class="n">project</span>
+  <span class="n">properties</span> <span class="n">under</span>
<span class="s">&quot;Web Project Settings&quot;</span>
+<span class="n">Now</span> <span class="n">we</span> <span class="n">need</span>
<span class="n">to</span> <span class="n">add</span> <span class="n">the</span>
<span class="n">the</span> <span class="n">two</span> <span class="n">webapps</span>
<span class="n">to</span> <span class="n">a</span> <span class="n">pre</span><span
class="o">-</span><span class="n">setup</span> <span class="p">(</span><span
class="n">Tomcat</span> <span class="mi">6</span><span class="p">)</span>
<span class="n">server:</span>
+<span class="o">*</span> <span class="n">Windows</span><span class="o">-&gt;</span><span
class="n">Show</span> <span class="n">View</span><span class="o">-&gt;</span><span
class="n">Other</span><span class="o">...</span>
+<span class="o">*</span> <span class="n">Server</span><span class="o">-&gt;</span><span
+<span class="o">*</span> <span class="n">OK</span>
+<span class="o">*</span> <span class="n">In</span> <span class="n">the</span>
<span class="n">servers</span> <span class="n">view</span> <span
class="n">right</span> <span class="n">click</span> <span class="n">your</span>
<span class="n">chosen</span> <span class="n">server</span> <span
class="ow">and</span> <span class="n">slect</span> <span class="n">Add</span>
<span class="ow">and</span> <span class="n">Remove</span><span
+<span class="o">*</span> <span class="n">Add</span> <span class="n">rave</span><span
class="o">-</span><span class="n">shindig</span> <span class="ow">and</span>
<span class="n">rave</span><span class="o">-</span><span class="n">portal</span>
+<span class="o">*</span> <span class="n">Start</span> <span class="n">the</span>
<span class="n">server</span>
+<span class="o">*</span> <span class="n">Now</span> <span class="n">see</span>
<span class="n">the</span> <span class="n">instructions</span> <span
class="n">above</span> <span class="k">for</span> <span class="n">logging</span>
<span class="n">into</span> <span class="n">the</span> <span class="n">server</span>
   <div id="footer">

View raw message