Author: ilgrosso
Date: Wed Jun 6 09:43:41 2012
New Revision: 1346801
URL: http://svn.apache.org/viewvc?rev=1346801&view=rev
Log:
Adding site generation
Added:
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/images/
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/images/external.png (with props)
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml (with props)
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml (with props)
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml (with props)
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml (with props)
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml (with props)
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml (with props)
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml (with props)
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml (with props)
cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml (with props)
Modified:
cocoon/subprojects/cocoon-maven-plugin/trunk/pom.xml
Modified: cocoon/subprojects/cocoon-maven-plugin/trunk/pom.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/pom.xml?rev=1346801&r1=1346800&r2=1346801&view=diff
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/pom.xml (original)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/pom.xml Wed Jun 6 09:43:41 2012
@@ -209,6 +209,88 @@
</execution>
</executions>
</plugin>
+
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-site-plugin</artifactId>
+ <version>3.0</version>
+ <configuration>
+ <locales>en</locales>
+ <reportPlugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-project-info-reports-plugin</artifactId>
+ <version>2.4</version>
+ <configuration>
+ <dependencyDetailsEnabled>false</dependencyDetailsEnabled>
+ <dependencyLocationsEnabled>false</dependencyLocationsEnabled>
+ </configuration>
+ <reportSets>
+ <reportSet>
+ <reports>
+ <report>dependencies</report>
+ <report>license</report>
+ <report>summary</report>
+ <report>project-team</report>
+ </reports>
+ </reportSet>
+ </reportSets>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-changes-plugin</artifactId>
+ <version>2.7.1</version>
+ <reportSets>
+ <reportSet>
+ <reports>
+ <report>changes-report</report>
+ </reports>
+ </reportSet>
+ </reportSets>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-javadoc-plugin</artifactId>
+ <version>2.8.1</version>
+ <reportSets>
+ <reportSet>
+ <reports>
+ <report>javadoc</report>
+ </reports>
+ </reportSet>
+ </reportSets>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-plugin-plugin</artifactId>
+ <version>3.0</version>
+ </plugin>
+ </reportPlugins>
+ </configuration>
+ <executions>
+ <execution>
+ <id>attach-descriptor</id>
+ <goals>
+ <goal>attach-descriptor</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
</plugins>
+
+ <resources>
+ <resource>
+ <directory>src/main/resources</directory>
+ <filtering>true</filtering>
+ </resource>
+ <resource>
+ <directory>.</directory>
+ <targetPath>META-INF</targetPath>
+ <includes>
+ <include>LICENSE.txt</include>
+ <include>NOTICE.txt</include>
+ </includes>
+ </resource>
+ </resources>
</build>
</project>
Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/images/external.png
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/images/external.png?rev=1346801&view=auto
==============================================================================
Binary file - no diff available.
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/resources/images/external.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml Wed Jun 6 09:43:41 2012
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<!-- $Id$ -->
+<project xmlns="http://maven.apache.org/DECORATION/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/DECORATION/1.1.0 http://maven.apache.org/xsd/decoration-1.1.0.xsd"
+ name="Cocoon">
+
+ <skin>
+ <groupId>org.apache.cocoon</groupId>
+ <artifactId>cocoon-thien-maven-site-skin</artifactId>
+ <version>1.0.1</version>
+ </skin>
+
+ <body>
+ <menu name="Cocoon Maven 2 Plugin">
+ <item name="Introduction" href="./index.html"/>
+ <item name="Block Prepare (goal)" href="./1359_1_1.html" collapse="true">
+ <item name="Purpose" href="./1359_1_1.html"/>
+ <item name="Using the Reloading Classloader" href="./1297_1_1.html"/>
+ <item name="rcl:properties" href="./1298_1_1.html"/>
+ <item name="XPatch" href="./1360_1_1.html"/>
+ </item>
+ <item name="Deployer (goal)" href="./1361_1_1.html" collapse="true">
+ <item name="Purpose" href="./1361_1_1.html"/>
+ <item name="Using the Cocoon Deployer" href="./1358_1_1.html"/>
+ <item name="Shielded Classloading" href="./1262_1_1.html"/>
+ </item>
+ </menu>
+
+ <menu ref="reports" inherit="bottom"/>
+ </body>
+</project>
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml
------------------------------------------------------------------------------
svn:keywords = Date Revision Author HeadURL Id
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/site.xml
------------------------------------------------------------------------------
svn:mime-type = text/xml
Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml Wed Jun 6 09:43:41 2012
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0" xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon Maven 2 Plugin - Shielded Classloading</title><author email="[email protected]">Apache Cocoon Documentation Team</author></properties><body>
+ <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Shielded Classloading</h1><p>Shielded classloading is an optional feature of the Cocoon deployer-plugin
+for Maven. It helps you in avoiding typical problems with respect to class
+loading. Usually the servlet container sets up a class loader for each web
+application. This class loader works "parent-first" which means that whenever a
+class is loaded it is first searched in the parent class loader of the web
+application class loader and only if its not available there, it is loaded from
+the classes in WEB-INF/classes or the jars in WEB-INF/lib. In general this is a
+useful mechanism which also allows you to share classes between web applications
+by putting them in the parent class loader (refer to the documentation of your
+application server/servlet engine for more information).</p><p>Unfortunately there are some problems with this approach: for example if the
+servlet engine has configured a logging framework like commons logging and
+exposes this in the parent class loader for the web applications, than all web
+applications have to use this configuration and are not able to use their own.
+Even more important is the used XSLT processor (and some other stuff contained
+in the endorsed directory). By default you always use the XSLT processor shipped
+with the JDK; you can override this by specifying one using the endorsed
+mechanism but in many cases you can't use this way. As the XSLT processor
+shipped with the JDK has some bugs it is advisable to use the latest version.
+</p><p>The only reliable way of avoiding all these class loading issues is to use a
+mechanism we call shielded class loading: the web application uses its own class
+loader which works "parent-last". In this case classes are always tried to be
+loaded from the WEB-INF/classes or WEB-INF/lib directory first. Through this
+mechanism you can enforce the use of the XSLT processor you want for your
+application, of the logging configuration you need etc.</p><p>Some application servers provide a configuration for this, but you can also
+use some of the functionality provided by Cocoon: if you are using the Cocoon
+deploy plugin with Maven 2, this plugin rewrites your web.xml to use the
+shielded class loader.</p></div></div>
+ </body></document>
\ No newline at end of file
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml
------------------------------------------------------------------------------
svn:keywords = Date Revision Author HeadURL Id
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1262_1_1.xml
------------------------------------------------------------------------------
svn:mime-type = text/xml
Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml Wed Jun 6 09:43:41 2012
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0" xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon Maven 2 Plugin - Using the Reloading Classloader</title><author email="[email protected]">Apache Cocoon Documentation Team</author></properties><body>
+ <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Using the Reloading Classloader</h1><p>These instructions should work with any Cocoon block. The sample
+configurations are based on the <a href="../../../../2.2/1159_1_1.html">Getting Started guide</a>.
+</p><h1>Step 1: Enable the plugin in pom.xml</h1><p>In the pom.xml you have to add the plugin:</p><pre><project>
+ <build>
+ <plugins>
+ [...]
+ <plugin>
+ <groupId>org.apache.cocoon</groupId>
+ <artifactId>cocoon-maven-plugin</artifactId>
+ <version>1.0.0-M2</version>
+ Â </plugin>
+ [...]
+ </plugins>
+ </build>
+</project>
+</pre><h1>Step 2: Configure the plugin</h1><p>You can also provide configuration properties. Use the
+<a href="prepare-mojo.html">goal documentation</a> generated from the Javadoc
+comments to find out more.</p><p>The central configuration file is rcl.properties which has to be put into the
+root directory of the block that you want to run, e.g.</p><pre><strong>com.mycompany.myBlock1.block%classes-dir</strong>=./target/classes</pre><p>The property names consist of the name of the block servlet which is the
+unique name of the Spring bean + <tt>%classes_dir</tt> . The value is the
+relative or absolute filesystem path.</p><h1>Step 3: Invoke the plugin</h1><p>The Maven 2 plugin can be invoked by calling</p><pre>mvn cocoon:prepare</pre><p>This creates a web application into<tt> ./target/rcl/webapp</tt> for your
+block.</p><p>If you want to avoid this additional step, you can invoke it automatically,
+e.g. by</p><p>If you want to invoke it automatically, add it to the execution section of
+your plugin definition, e.g.</p><pre><plugin>
+ <groupId>org.apache.cocoon</groupId>
+ <artifactId>cocoon-maven-plugin</artifactId>
+ <version>1.0.0-M2</version>
+ <executions>
+ <execution>
+ <phase>compile</phase>
+ <goals>
+ <goal>prepare</goal>
+ </goals>
+ </execution>
+ </executions>
+</plugin>
+</pre><h1>Step 4: Create Eclipse project files</h1><p>Move to <tt>getting-started-app/ </tt>and invoke</p><pre>mvn eclipse:eclipse</pre><p>and import the new Eclipse project into your Eclipse workspace.</p><h1>Step 5: Start the servlet container</h1><section name="Alternative A: The Maven Jetty plugin" style="background:none;padding:0;"/><p>Now you can configure the Maven 2 Jetty plugin to use the web application
+that was created by the block in <tt>target/rcl/webapp</tt>:</p><pre><project>
+ <build>
+ <plugins>
+ [...]
+ <plugin>
+ <groupId>org.mortbay.jetty</groupId>
+ <artifactId>maven-jetty-plugin</artifactId>
+ <version>6.1.7</version>
+ <configuration>
+ <connectors>
+ <connector implementation="org.mortbay.jetty.nio.SelectChannelConnector">
+ <port>8888</port>
+ <maxIdleTime>30000</maxIdleTime>
+ </connector>
+ </connectors>
+ <webAppSourceDirectory>${project.build.directory}/rcl/webapp</webAppSourceDirectory>
+ <contextPath>/</contextPath>
+ <systemProperties>
+ <systemProperty>
+ <name>org.apache.cocoon.mode</name>
+ <value>dev</value>
+ </systemProperty>
+ </systemProperties>
+ </configuration>
+ </plugin>
+ [...]
+ </plugins>
+ </build>
+</project> Â </pre><p>Call mvn <tt>jetty:run</tt> and point your browser to
+<tt>http://localhost:8888/block1/</tt> in your browser.</p><section name="Alternative B: Use the Eclipse Jetty plugin" style="background:none;padding:0;"/><p>There is a <a href="../../../../1301_1_1.html">tutorial</a> that describes how to debug
+Cocoon.</p><h1>Step 6: Change a class file</h1><p>Now it's time to see the reloading classloader in action. Open
+<tt>getting-started-app/myBlock1/src/main/java/com/mycompany/???</tt> and change
+it. Refresh your browser and you should see the changed values there.</p></div></div>
+ </body></document>
\ No newline at end of file
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml
------------------------------------------------------------------------------
svn:keywords = Date Revision Author HeadURL Id
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1297_1_1.xml
------------------------------------------------------------------------------
svn:mime-type = text/xml
Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml Wed Jun 6 09:43:41 2012
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0" xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon Maven 2 Plugin - rcl.properties</title><author email="[email protected]">Apache Cocoon Documentation Team</author></properties><body>
+ <div id="contentBody"><div id="bodyText"><h1 class="docTitle">rcl.properties</h1><h1>Location</h1><p>The default location of <tt>rcl.properties</tt> is at the root directory of
+your block, next to <tt>pom.xml.</tt></p><h1>What can be configured?</h1><section name="Classes directories of blocks" style="background:none;padding:0;"/><h3>Syntax</h3><p><tt>[name-of-the-block]%classes-dir=[path-to-a-blocks-classes-dir]</tt></p><h3>Examples</h3><ul>
+<li><tt>com.mycompany.app.block%classes-dir=./target/classes</tt></li>
+<li><tt>com.mycompany.app.block2%classes-dir=C:/test/block2/target/classes</tt>
+</li>
+</ul><section name="Classes directories of libraries that are NOT blocks" style="background:none;padding:0;"/><h3>Syntax</h3><tt>%classes-dir=[path-to-a-library]<br/>
+%exclude-lib=[groupId]:[artifactId]</tt><h3>Example</h3><tt>%classes-dir=</tt><tt><tt>C:</tt></tt><tt>/test/mylib/target/classes</tt>
+<div class="note"><div><strong>Note: </strong>You can use the <tt>%classes-dir </tt>and <tt>%exclude-lib</tt>
+properties as often as you need in your properties file</div></div><section name="Cocoon properties and Spring bean configurator properties" style="background:none;padding:0;"/><p>All other properties are either interpreted as <a href="../../../../subprojects/configuration/1.0/spring-configurator/2.0/1310_1_1.html">Cocoon
+properties</a> or <a href="../../../../subprojects/configuration/1.0/spring-configurator/2.0/1312_1_1.html">Spring bean properties</a>. The
+differenciation is done whether the property contains a "/" character. If so, it
+is considered as Spring bean configurator property.</p><h1>Variables interpolation and includes</h1><p>As this configuration file is managed by
+<a href="http://commons.apache.org/configuration/">Apache Commons
+Configuration</a> you can benefit from all the features it provides. The two
+most important ones are
+<a href="http://commons.apache.org/configuration/howto_properties.html#Variable_Interpolation">variables
+interpolation</a> and
+<a href="http://commons.apache.org/configuration/howto_properties.html#Includes">includes</a>.
+</p></div></div>
+ </body></document>
\ No newline at end of file
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml
------------------------------------------------------------------------------
svn:keywords = Date Revision Author HeadURL Id
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1298_1_1.xml
------------------------------------------------------------------------------
svn:mime-type = text/xml
Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml Wed Jun 6 09:43:41 2012
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0" xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon Maven 2 Plugin - Using the Cocoon Deployer</title><author email="[email protected]">Apache Cocoon Documentation Team</author></properties><body>
+ <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Using the Cocoon Deployer</h1><h1>Step 1: Basics</h1><p>In order to use the Cocoon Deployer, you need a Cocoon web application, e.g.
+one that is generated as described in the <a href="../../../../2.2/1159_1_1.html">Getting Started
+Tutorial</a>. Expressed in terms of Maven 2, it mean that the <tt>packaging
+type</tt> in your pom.xml is <tt>war</tt>.</p><h1>Step 2: Enabling the deployer</h1><p>Enable the Cocoon Maven plugin in your pom.xml:</p><pre><project>
+ <build>
+ <plugins>
+ [...]
+ <plugin>
+ <groupId>org.apache.cocoon</groupId>
+ <artifactId>cocoon-maven-plugin</artifactId>
+ <version>1.0.0-M2</version>
+ <configuration>
+ [...]
+ </configuraiton>
+ </plugin>
+ [...]
+ </plugins>
+ </build>
+</project> </pre><h1>Step 3: Configuration</h1><p>You can also provide configuration properties. Use the
+<a href="deploy-mojo.html">goal documentation</a> generated from the Javadoc
+comments to find out more.</p><h1>Step 4: Invoke the deployer</h1><p>Finally you have to invoke the plugin. If you want to do this manually, enter
+</p><pre><tt>mvn cocoon:deploy</tt></pre><p>or</p><pre><tt>mvn cocoon:deploy-wa</tt>r</pre></div></div>
+ </body></document>
\ No newline at end of file
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml
------------------------------------------------------------------------------
svn:keywords = Date Revision Author HeadURL Id
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1358_1_1.xml
------------------------------------------------------------------------------
svn:mime-type = text/xml
Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml Wed Jun 6 09:43:41 2012
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0" xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon Maven 2 Plugin - Purpose</title><author email="[email protected]">Apache Cocoon Documentation Team</author></properties><body>
+ <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Purpose</h1><p>If you develop your Cocoon applications based on blocks, you will come to the
+point that you want to run it while you are working on its resources. The
+reloading classloader goal creates a minimal web application that you can use in
+any servlet container.</p><p>This web application <strong>automatically detects changes</strong> in</p><ul>
+<li><tt>src/main/java</tt></li>
+<li><tt>src/main/resources</tt></li>
+<li><tt>src/main/resources/COB-INF</tt></li>
+<li><tt>src/main/resources/META-INF</tt></li>
+</ul>This means that any changes in<ul>
+<li>Cocoon resources (sitemaps, templates, form definitions, flowscripts, etc.)
+</li>
+<li>Java classes and resources</li>
+<li>Components (Spring beans and Avalon concepts)</li>
+</ul>are detected and will take effect nearly immediatly. Because of the use of
+the Jakarta Commons JCI, you can also change the signatures of your classes and
+methods.The plugin also enables you to <strong>use other blocks</strong> in a the
+reloading mode together with the block that you apply the reloading classloader
+plugin on.Finally, the plugin also supports the <strong>patching mechanism</strong>
+that comes with the deployer goal. By using it, your blocks can contain parts of
+the web.xml, e.g. a servlet configuration.</div></div>
+ </body></document>
\ No newline at end of file
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml
------------------------------------------------------------------------------
svn:keywords = Date Revision Author HeadURL Id
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1359_1_1.xml
------------------------------------------------------------------------------
svn:mime-type = text/xml
Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml Wed Jun 6 09:43:41 2012
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0" xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon Maven 2 Plugin - XPatch</title><author email="[email protected]">Apache Cocoon Documentation Team</author></properties><body>
+ <div id="contentBody"><div id="bodyText"><h1 class="docTitle">XPatch</h1><p>The xpatch mechanism enables you to split up your web.xml and put the
+snippets into the block it belongs too. It takes all *.xweb files from
+<tt>src/main/resources/META-INF/cocoon/xpatch</tt> and applies them to the
+generated <tt>web.xml</tt> file that you will find in
+<tt>target/rcl/webapp/WEB-INF/web.xml</tt>.</p><p>Here is an example of an xweb file:</p><pre><xweb <strong>xpath</strong>="/web-app"
+ <strong>unless</strong>="comment()[contains(., 'Xindice XML-RPC Server servlet configuration')]"
+ <strong>insert-after</strong>="servlet[last()]">
+
+ <!-- XMLDB Block, Xindice XML-RPC Server servlet configuration -->
+ <servlet>
+ <servlet-name>Xindice</servlet-name>
+ <display-name>Xindice XML-RPC Server</display-name>
+ <servlet-class>org.apache.xindice.server.XindiceServlet</servlet-class>
+ <init-param>
+ <param-name>xindice.configuration</param-name>
+ <param-value>WEB-INF/xindice.xml</param-value>
+ </init-param>
+ <load-on-startup>1</load-on-startup>
+ </servlet>
+
+</xweb>
+</pre><p>This xweb file adds the Xindice-RPC Server servlet to your web.xml.</p><h3>Syntax</h3><table class="bodyTable">
+<tbody>
+<tr class="a">
+<th/>
+<th>
+<p>description</p>
+</th>
+</tr>
+<tr class="b">
+<th>
+<p>xweb</p>
+</th>
+<td>
+<p>That's the root element. Everything it contains will be applied.</p>
+</td>
+</tr>
+<tr class="a">
+<th>
+<p>@xpath</p>
+</th>
+<td>
+<p>The xpatch within web.xml where the xweb snippet should be applied to.</p>
+</td>
+</tr>
+<tr class="b">
+<th>
+<p>@unless</p>
+</th>
+<td>
+<p>A condition when the patch should NOT be applied.</p>
+</td>
+</tr>
+<tr class="a">
+<th>
+<p>@insert-after</p>
+</th>
+<td>
+<p>Define the exact position within result of the xpath.</p>
+</td>
+</tr>
+</tbody>
+</table></div></div>
+ </body></document>
\ No newline at end of file
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml
------------------------------------------------------------------------------
svn:keywords = Date Revision Author HeadURL Id
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1360_1_1.xml
------------------------------------------------------------------------------
svn:mime-type = text/xml
Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml Wed Jun 6 09:43:41 2012
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0" xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon Maven 2 Plugin - Purpose</title><author email="[email protected]">Apache Cocoon Documentation Team</author></properties><body>
+ <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Purpose</h1><p>The Cocoon Deployer goal provides two features that rewrite a web application
+in order to add functionality that comes from</p><ul>
+<li><strong>reversing the classloader hierarchy</strong><br/>
+By reversing the classloader hierarchy you can make sure that the dependencies
+you define are found first before the classpath of the application server is
+searched.</li>
+<li><strong>patching your web.xml</strong><br/>
+If your blocks contain <tt>/META-INF/cocoon/xpatch/*.xweb</tt> files, they are
+applied to the <tt>/WEB-INF/web.xml</tt> of the resulting web archive.</li>
+</ul></div></div>
+ </body></document>
\ No newline at end of file
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml
------------------------------------------------------------------------------
svn:keywords = Date Revision Author HeadURL Id
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/1361_1_1.xml
------------------------------------------------------------------------------
svn:mime-type = text/xml
Added: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml?rev=1346801&view=auto
==============================================================================
--- cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml (added)
+++ cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml Wed Jun 6 09:43:41 2012
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?><!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ --><document xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/XDOC/2.0" xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"><properties><title>Cocoon Maven 2 Plugin - Introduction</title><author email="[email protected]">Apache Cocoon Documentation Team</author></properties><body>
+ <div id="contentBody"><div id="bodyText"><h1 class="docTitle">Introduction</h1><p>The Cocoon Maven 2 plugin provides some goals that make the developer's life
+easier. Currently it contains</p><ul>
+<li><a href="1297_1_1.html">Cocoon Block preparation goal<br/>
+</a></li>
+<li><a href="1358_1_1.html">Cocoon Deployer goal</a></li>
+</ul><h1>Cocoon Block preparation goal</h1>The purpose of the <a href="1297_1_1.html">block preparation goal</a> is making
+a block runnable as web application and enabling <strong>rapid application
+development</strong>. It uses the
+<a href="http://commons.apache.org/jci/">Apache Commons JCI</a>
+library which provides a reloading classloader. As the names already promises,
+it is able to watch resources (e.g. <tt>.class</tt> files) for changes. In such
+a case the classloader will use the latest version of the resources in the
+future.Some Java servlet containers already provide the automatic reload of loaded
+servlet contexts in the case of changes but this comes with the downside that
+you might lose the application state and that you are not allowed to change the
+signatures of classes and methods.<h1>Cocoon Deployer goal</h1><p>The <a href="1358_1_1.html">Cocoon Deployer goal </a>provides two features that
+rewrite a web application in order to add functionality that comes from</p><ul>
+<li>reversing the classloader hierarchy</li>
+<li>patching your web.xml</li>
+</ul></div></div>
+ </body></document>
\ No newline at end of file
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml
------------------------------------------------------------------------------
svn:keywords = Date Revision Author HeadURL Id
Propchange: cocoon/subprojects/cocoon-maven-plugin/trunk/src/site/xdoc/index.xml
------------------------------------------------------------------------------
svn:mime-type = text/xml
lmpx.com only provides a reader for public news (NNTP) servers. It is not
affiliated with the servers or forums shown here and is not responsible for
the content of articles, which is written by their respective authors.