cocoon
cocoon copied to clipboard
Mirror of Apache Cocoon
This is some quick info about the Mavenization (m10n) of Cocoon 2.2.
There are also some Daisy documentation pages about this, for more "stable" information:
http://cocoon.zones.apache.org/daisy/documentation/g2/756.html http://cocoon.zones.apache.org/daisy/documentation/g1/798.html
PREREQUISITES
You need a JDK, 1.8.x or later. (Note, currently a JRE won't do) When experimenting with trunk, 11.x is probably the best bet.
Maven 3 must be installed.
MAVEN REPOSITORY MIRRORS
Using a Maven mirror isn't necessary anymore.
HOW TO BUILD THE COCOON WEBAPP
Since Cocoon release 2.2, Cocoon relies on Maven for its build process.
To build Cocoon, use the following command:
$ ./build.sh install
In case of any failures, repeat command as necessary till you see the message:
BUILD SUCCESSFUL
If you have consistent build failures due to a missing cocoon-rcl artefact, then run first
$ cd ../tools $ mvn clean install
If you have build failures due to out-of-memory conditions, increase the JVM maximum memory limit in build.sh:
$ MAVEN_OPTS="-Xmx256m"
HOW TO MOUNT THE PROJECTS IN ECLIPSE
from /trunk, run
$ ./build.sh eclipse:clean eclipse:eclipse
Next go to eclipse, and make sure you haven't got trunk mounted as a project already. Also remove .classpath and .project files possibly remaining in /trunk from a previous project mount. Do File-Import->Existing projects into workspace, then point to your trunk directory and it should detect the newly created blocks as projects.
Note that you need to declare the M2_REPO classpath variable in your workspace, it should point to your local m2 repository.
You can also get eclipse to download the sources of the dependent libraries and attach them to the jars in eclipse :
$ mvn -Declipse.downloadSources=true eclipse:eclipse
For further information about the maven eclipse plugin visit
http://maven.apache.org/plugins/maven-eclipse-plugin/
HOW TO MOUNT THE PROJECTS IN INTELLIJ
In IntelliJ select File - Open Project... Navigate to the root directory and select that.
HOW TO START THE COCOON WEBAPP
Checkout complete trunk and build it. If clean rebuild is desired, use command:
$ ./build.sh clean install
Call this until you get "BUILD SUCCESSFUL" - sometimes downloads from maven repositories are temporarily unaccessible and cause the build to fail.
To start Cocoon within Jetty, use command:
$ cocoon.sh
Point your browser to http://localhost:8888/
(Don't use jetty:run-exploded as in this case the jetty6 plugin will alter the webapp build by the Cocoon deployer again!)
HOW TO DEBUG THE COCOON WEBAPP
To start Cocoon with JVM debug enabled, use command:
$ cocoon.sh debug
Then tell your IDE to connect to JVM debug on port localhost:5005.