[DAISY] Updated: Usage

[daisy]

A document has been updated:

http://cocoon.zones.apache.org/daisy/documentation/1297.html

Document ID: 1297
Branch: main
Language: default
Name: Usage (unchanged)
Document Type: Cocoon Document (unchanged)
Updated on: 12/27/06 7:35:25 PM
Updated by: Reinhard Pötz

A new version has been created, state: publish

Parts
=====

Content
-------
This part has been updated.
Mime type: text/xml (unchanged)
File name:  (unchanged)
Size: 3187 bytes (previous version: 1465 bytes)
Content diff:
(2 equal lines skipped)
    
    <p class="note">Note: The Spring application context isn't refreshed. This 
means
    that changes to Spring appliation context configurations and beans of the 
scope
--- "prototype" still need a reload of the web application context.</p>
+++ <tt>prototype</tt> still need a reload of the web application context.</p>
    
    <h1>Step 1: Provide the configuration</h1>
    
    <p>If you want to use the reloading classloader plugin, you have to provide 
a
    properties file like this:</p>
    
--- <pre>...</pre>
+++ <pre>com.mycompany.myBlock.block%classes-dir=./target/classes</pre>
    
    <p>The property names consist of the block name (more exactly, the name of 
the
--- Spring bean that represents a block) + <tt>%CLASSES_DIR</tt> (e.g.
--- <tt>org.mycompany.myBlock.block%CLASSES_DIR</tt>). The value is the 
relative or
--- absolute filesystem path.</p>
+++ Spring bean that represents a block) + <tt>%CLASSES_DIR</tt> . The value is 
the
+++ relative or absolute filesystem path.</p>
    
    <h1>Step 2: Enable the plugin in pom.xml</h1>
    
    <p>In the pom.xml you have to add the plugin:</p>
    
--- <pre>...
+++ <pre>&lt;project&gt;
+++   &lt;build&gt;
+++     &lt;plugins&gt;
+++       [...]
+++       &lt;plugin&gt;
+++         &lt;groupId&gt;org.apache.cocoon&lt;/groupId&gt;
+++         &lt;artifactId&gt;cocoon-rcl-plugin&lt;/artifactId&gt;
+++         &lt;version&gt;1.0.0-M1-SNAPSHOT&lt;/version&gt;
+++       &lt;/plugin&gt;
+++       [...]
+++     &lt;/plugins&gt;
+++   &lt;/build&gt;
+++ &lt;/project&gt;   
    </pre>
    
+++ <p class="note">For now you have to build the plugin yourself since it 
hasn't
+++ been released yet. For this you have to checkout Cocoon trunk and run 
<tt>mvn
+++ install</tt>.</p>
+++ 
    <h1>Step 3: Invoke the plugin</h1>
    
    <p>The Maven 2 plugin can be invoked by calling</p>
(8 equal lines skipped)
    <p>Now you can configure the Maven 2 Jetty plugin to use this web 
application:
    </p>
    
--- <pre>...
--- </pre>
+++ <pre>&lt;project&gt;
+++   &lt;build&gt;
+++     &lt;plugins&gt;
+++       [...]
+++       &lt;plugin&gt;
+++         &lt;groupId&gt;org.mortbay.jetty&lt;/groupId&gt;
+++         &lt;artifactId&gt;maven-jetty-plugin&lt;/artifactId&gt;
+++         &lt;version&gt;6.0.2&lt;/version&gt;
+++         &lt;configuration&gt;
+++           &lt;connectors&gt;
+++             &lt;connector 
implementation="org.mortbay.jetty.nio.SelectChannelConnector"&gt;
+++               &lt;port&gt;8888&lt;/port&gt;
+++               &lt;maxIdleTime&gt;30000&lt;/maxIdleTime&gt;
+++             &lt;/connector&gt;
+++           &lt;/connectors&gt;
+++           
&lt;webAppSourceDirectory&gt;${project.build.directory}/rcl/webapp&lt;/webAppSourceDirectory&gt;
+++           &lt;contextPath&gt;/&lt;/contextPath&gt;
+++           &lt;systemProperties&gt;
+++             &lt;systemProperty&gt;
+++               &lt;name&gt;org.apache.cocoon.mode&lt;/name&gt;
+++               &lt;value&gt;dev&lt;/value&gt;
+++             &lt;/systemProperty&gt;            
+++           &lt;/systemProperties&gt;           
+++         &lt;/configuration&gt;
+++       &lt;/plugin&gt;
+++       [...]
+++     &lt;/plugins&gt;
+++   &lt;/build&gt;
+++ &lt;/project&gt;   </pre>
    
    <p class="note">Unfortunatly, under certain (still unknown) circumstances 
there
    seems to be a problem with the reloading classloader which can only be 
worked
    around by starting your JVM in debug mode from within your IDE.</p>
    
+++ <p>Call <tt>http://localhost:8888/[block-name]/</tt> in  your browser!</p>
+++ 
    <h1>Alternative step 4: Use Jetty in 'debug mode' within Eclipse</h1>
    
    <p>TODO</p>
(3 equal lines skipped)