Apache » Cocoon »

Cocoon 3 homepage

Cocoon 3

Cocoon 3 is still alpha software. Please read our alpha software warning message before using it.

Download

Cocoon 3.0.0-alpha-3

Maven 2 artifacts

Cocoon pipelines

The 'cocoon-pipeline' library was designed to be used stand-alone without any other dependencies than Apache Commons Logging: 

<dependency>
  <groupId>org.apache.cocoon.pipeline</groupId>
  <artifactId>cocoon-pipeline</artifactId>
  <version>3.0.0-alpha-3</version>
</dependency>

In order to use the other Cocoon 3 modules (web applications, REST support, etc.), we highly recommend to start off with the archetypes listed below.

Maven 2 archetypes

Some issues were identified in the 3.0.0-alpha-3 artifacts that prevent the generated projects to work properly; as a temporary workaround, you will need to apply the following changes to the generated pom.xml files:

  1. replace any 3.0.0-alpha-3-SNAPSHOT occurrency with 3.0.0-alpha-3
  2. add
    <version>1.0.0</version>

    right below

    <artifactId>cocoon-maven-plugin</artifactId>

Create a Cocoon 3 block that contains the samples. After running the archetype plugin, change to the base directory of the new module and enter 'mvn jetty:run' and point your browser at http://localhost:8888: If you use Eclipse, run 'mvn eclipse:eclipse' before and import the project into your workspace. Your resources but also the Java files are reloaded at runtime. 

mvn archetype:create \
    -DarchetypeGroupId=org.apache.cocoon.archetype-sample \
    -DarchetypeArtifactId=cocoon-archetype-sample \
    -DarchetypeVersion=3.0.0-alpha-3 \
    -DgroupId=com.mycompany \ 
    -DartifactId=mysample

Create an empty Cocoon 3 block in order to create your own Cocoon 3 web application. 

mvn archetype:create \
    -DarchetypeGroupId=org.apache.cocoon.archetype-block \
    -DarchetypeArtifactId=cocoon-archetype-block \
    -DarchetypeVersion=3.0.0-alpha-3 \
    -DgroupId=com.mycompany \
    -DartifactId=mysite

Create an empty Java web application project. After that add your Cocoon block as dependency.

mvn archetype:create \
    -DarchetypeGroupId=org.apache.cocoon.archetype-webapp \
    -DarchetypeArtifactId=cocoon-archetype-webapp \
    -DarchetypeVersion=3.0.0-alpha-3 \
    -DgroupId=com.mycompany \
    -DartifactId=mywebapp

Create a parent module for your Cocoon project.

mvn archetype:create \
    -DarchetypeGroupId=org.apache.cocoon.archetype-parent \
    -DarchetypeArtifactId=cocoon-archetype-parent \
    -DarchetypeVersion=3.0.0-alpha-3 \
    -DgroupId=com.mycompany \
    -DartifactId=myparent