PREREQUISITES ------------- . You need a JDK 1.6.0 or higher. . Maven 2 must be installed (at least 2.0.9). HOW TO BUILD COCOON 3 --------------------- To build Cocoon 3 use following command mvn install HOW TO RUN THE COCOON 3 SAMPLE ------------------------------ Move into ./cocoon-sample and use following command mvn jetty:run and open your favorite browser and enter http://localhost:8888 into the location bar. HOW TO EXPERIMENT WITH THE COCOON 3 SAMPLE ------------------------------------------ Move into ./cocoon-sample and use one of the following commands: mvn eclipse:eclipse mvn idea:idea Then import the cocoon-sample project into your IDE workspace. When the sample are running in Jetty (see 'How to run the Cocoon sample' above), you can edit any Java files or resources and the changes will take effect immediatly. HOW TO DEVELOP COCOON 3 ----------------------- Depending on what IDE you use, use one of the following commands: mvn eclipse:eclipse -P all mvn idea:idea -P all Then import all cocoon-* projects into your IDE workspace. The Eclipse and the Idea Maven plugins take care that the project dependencies are set correctly. HOW TO ADD TESTS ---------------- Every module has a ./src/test directory that contains its unit tests. The cocoon-sample-webapp project also has such a directory but the tests there are different. These are integration tests that use HTMLUnit to run tests against a running servlet container. If you want to add new integration tests, add the test classes to cocoon-sample-webapp, and the test cases to cocoon-sample. HOW TO TEST AT DEVELOPEMENT TIME -------------------------------- The simplest way is using your IDE (Eclipse or Idea). Since the unit tests and the integration tests are based on JUnit 4.4 and Eclipse and Idea offer decent JUnit support, just run the tests as you are used to do. The integration tests of course need the sample running (see 'How to experiment with the Cocoon sample'). HOW TO RUN ALL TESTS IN ONE GO ------------------------------ Use the following command: mvn clean install -P it -Dhtmlunit.base-url=http://localhost:8888 This will run all unit tests and all integration tests.