gmane.text.xml.cocoon.documentation

[DAISY] Updated: ExceptionSelector

2008-11-24T12:54:00

A document has been updated: http://cocoon.zones.apache.org/daisy/documentation/931.html Document ID: 931 Branch: main Language: default Name: ExceptionSelector (unchanged) Document Type: Sitemap Component (unchanged) Updated on: 11/24/08 12:53:54 PM Updated by: Felix Knecht A new version has been created, state: publish Parts ===== Long description ---------------- This part has been updated. Mime type: text/xml (unchanged) File name: (unchanged) Size: 1384 bytes (previous version: 1177 bytes) Content diff: (2 equal lines skipped)

Example configuration :

---

<map:selector type="error" src="....ExceptionSelector">
--- <exception class="org.xml.sax.SAXException" name="sax" unroll="true"/> ---
--- <exception name="not-found" +++

<map:components>
+++ <map:selectors>
+++ ...
+++ <map:selector name="error" +++ src="org.apache.cocoon.selection.ExceptionSelector">
+++ <exception class="org.xml.sax.SAXException" name="sax" +++ unroll="true"/>
+++ <exception name="not-found" class="org.apache.cocoon.ResourceNotFoundException"/>
--- <exception class="org.apache.cocoon.ProcessingException" unroll="true"/> +++ <exception class="org.apache.cocoon.ProcessingException" +++ unroll="true"/>
+++ <exception name="denied" class="java.security.SecurityException"/>
--- <exception name="denied" class="java.security.SecurityException"/>
--- <exception name="denied" class="my.comp.auth.AuthenticationFailure"/> ---
--- </map:selector>

+++ <exception name="denied" +++ class="my.comp.auth.AuthenticationFailure"/>
+++ </map:selector>
+++ </map:selectors>
+++ </map:components>

This example shows several features :

(16 equal lines skipped)

[DAISY] Updated: XPathExceptionSelector

2008-11-24T12:52:40

A document has been updated: http://cocoon.zones.apache.org/daisy/documentation/969.html Document ID: 969 Branch: main Language: default Name: XPathExceptionSelector (unchanged) Document Type: Sitemap Component (unchanged) Updated on: 11/24/08 12:52:22 PM Updated by: Felix Knecht A new version has been created, state: publish Parts ===== Long description ---------------- This part has been updated. Mime type: text/xml (unchanged) File name: (unchanged) Size: 1118 bytes (previous version: 913 bytes) Content diff: (7 equal lines skipped)

Example configuration :

---

<map:selector type="error" src="....XPathExceptionSelector">
--- <exception name="denied" class="my.comp.auth.AuthenticationFailure"> +++

<map:components>
+++ <map:selectors>
+++     ...
+++     <map:selector name="error" +++ src="org.apache.cocoon.selection.XPathExceptionSelector">
+++ <exception name="denied" class="my.comp.auth.AuthenticationFailure">
---     <xpath name="PasswordWrong" test="authCode=10"/>
---     <xpath name="PasswordExpired" test="errorCode=11"/>
---     <xpath name="AccessForbidden" test="errorCode>11"/>
--- </exception>
--- </map:selector>

+++         <xpath name="PasswordWrong" test="authCode=10"/>
+++       <xpath name="PasswordExpired" test="errorCode=11"/>
+++         <xpath name="AccessForbidden" test="errorCode>11"/>
+++ </exception>
+++     </map:selector>
+++ </map:selectors>
+++ </map:componets>

This example shows several features:

(9 equal lines skipped)

[DAISY] Updated: Tutorial: A Gentle Introduction to Cocoon Control Flow

2008-11-22T21:07:36

A document has been updated: http://cocoon.zones.apache.org/daisy/documentation/1241.html Document ID: 1241 Branch: main Language: default Name: Tutorial: A Gentle Introduction to Cocoon Control Flow (unchanged) Document Type: Cocoon Document (unchanged) Updated on: 11/6/08 12:11:46 AM Updated by: David Legg A new version has been created, state: draft Parts ===== Content ------- This part has been updated. Mime type: text/xml (unchanged) File name: (unchanged) Size: 10294 bytes (previous version: 10295 bytes) Content diff: (130 equal lines skipped) while (true) { --- cocoon.sendPageAndWait("guess.jxt", +++ cocoon.sendPageAndWait("guess.jx", { "random" : random, "hint" : hint, (148 equal lines skipped)

[DAISY] Updated: A Simple CForm Example

2008-11-22T21:07:35

A document has been updated: http://cocoon.zones.apache.org/daisy/documentation/478.html Document ID: 478 Branch: main Language: default Name: A Simple CForm Example (previously A Simple Example) Document Type: Cocoon Document (unchanged) Updated on: 10/15/08 4:09:08 PM Updated by: David Legg A new version has been created, state: publish Parts ===== Content ------- This part has been updated. Mime type: text/xml (unchanged) File name: (unchanged) Size: 16511 bytes (previous version: 15359 bytes) Content diff: (3 equal lines skipped)

A simple CForms example

In this example we will show how to create a simple registration form using --- CForms and flowscript. We will follow to following steps:

+++ CForms and flowscript. We will follow the following steps:

Create a block for this sample

Create a block

This has been covered in the tutorial, but it won't hurt to recall this Maven --- goal:

This is covered in the tutorial "Your first Cocoon +++ application using Maven 2", but it won't hurt to repeat it here:

mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create 
--- -DarchetypeGroupId=org.apache.cocoon 
--- -DarchetypeArtifactId=cocoon-22-archetype-block 
--- -DarchetypeVersion=1.0.0-RC2 -DgroupId=com.mycompany 
--- -DartifactId=simple-sample

Choose a suitable parent directory in which to create the following example +++ directory and then run this Maven command:

As of the writing of this page, the Maven archetype plugin --- version has to be specified, due to a bug in the current release of it.

mvn archetype:generate -DarchetypeCatalog=http://cocoon.apache.org
+++

Edit the simple-sample/pom.xml file and add the support for Cocoon --- Forms:

Maven will generate some output and then interactively ask you for some +++ information. You should select item 2 (the cocoon-22-archetype-block):

Choose archetype:
+++ 1: remote -> cocoon-22-archetype-block-plain (Creates an empty Cocoon block; useful
+++  if you want to add another block to a Cocoon application)
+++ 2: remote -> cocoon-22-archetype-block (Creates a Cocoon block containing some small
+++  samples)
+++ 3: remote -> cocoon-22-archetype-webapp (Creates a web application configured to
+++  host Cocoon blocks. Just add the block dependencies)
+++ Choose a number:  (1/2/3): 2
+++

When Maven asks for more details of the block to be created answer as +++ follows:

 Define value for groupId: : com.mycompany
+++ Define value for artifactId: : cformexample
+++ Define value for version:  1.0-SNAPSHOT: : 1.0.0
+++ Define value for package: : com.mycompany.cformexample
+++

A new directory should appear called 'cformexample'.

Change into this directory and edit the pom.xml file by adding a +++ dependency on Cocoon Forms:

<dependency>
---       <groupId>org.apache.cocoon</groupId>
---       <artifactId>cocoon-forms-impl</artifactId>
---       <version>1.0.0-RC1</version>
+++   <groupId>org.apache.cocoon</groupId>
+++   <artifactId>cocoon-forms-impl</artifactId>
+++   <version>1.1.0</version>
    </dependency>

Move in the simple-sample directory and build the block to ensure --- the playing field is set appropriately.

Build the block to ensure everything is set correctly:

mvn install

To access resources hold in the fomrs-impla and ajax-impl blocks, the Servlet --- Service Framework has to be instructed to fine them. Hence, open --- src/main/resources/META-INF/cocoon/spring/servlet-service.xml and add --- the following in the <servlet:context> element:

To access resources held in the cocoon-forms-impl and cocoon-ajax-impl +++ blocks, the Servlet Service Framework has to be told how to find them. Hence, +++ open:

<servlet:connections>
---   <entry key="ajax" value-ref="org.apache.cocoon.ajax.impl.servlet"/>
---   <entry key="forms" value-ref="org.apache.cocoon.forms.impl.servlet"/>
--- </servlet:connections>

src/main/resources/META-INF/cocoon/spring/block-servlet-service.xml +++

Find the following line:

<servlet:context mount-path="/cformexample" context-path="blockcontext:/cformexample/"/>
+++

and change it to look like this:

<servlet:context mount-path="/cformexample" context-path="blockcontext:/cformexample/">
+++   <servlet:connections>
+++     <entry key="ajax" value-ref="org.apache.cocoon.ajax.impl.servlet"/>
+++     <entry key="forms" value-ref="org.apache.cocoon.forms.impl.servlet"/>
+++   </servlet:connections>
+++ </servlet:context>
+++

Create a form definition file

Below the form definition file is displayed, (189 equal lines skipped)

Add some pipelines to the sitemap

The sitemap.xmap has to be modified as well:

The sitemap.xmap has to be modified (located in: src\main\resources\COB-INF): +++

First, an i18n dictionary has to be definied:

First, an i18n dictionary has to be defined:

  <map:components>
        <map:transformers default="xslt">
(39 equal lines skipped)
            <map:generate type="jx" src="resource/internal/registration_success.jx"/>
            <map:serialize/>
          </map:match>
---     </map:pipeline

Note the following things:

In the map:flow tag our flowscript file is NOT declared, since --- Cocoon loads automatically what's in the flow directory.

flow

Then we have the pipelines:

The first two are for managing the flowscript: when someone hits the (9 equal lines skipped) javascript libraries, CSS files and images.
Resources (XSL files, CSS, images, etc.) defined in the forms-impl and ajax-impl blocks are provided to this block by the Servlet Service Framework --- (look at the paramters given to forms-samples-styling.xsl).

forms-samples-styling.xsl

Direct your browser to:

http://localhost:8888/simple-sample/registration
+++ http://localhost:8888/cformexample/registration
    
    
    Try entering incorrect data and see what it does.
(4 equal lines skipped)
    a simple form (though notice you didn't have to write any Java for all of this,
    nor to restart Cocoon), but adding more complexity to the form is now simply a
    matter of adding more widgets, custom validation logic, event handlers, etc. To
--- have a feel for the power of CForms, take a look at the examples included
+++ get a feel for the power of CForms, take a look at the examples included
    included in the Forms block.
    
    
(1 equal lines skipped)

[DAISY] Updated: Your first Cocoon application using Maven 2

2008-11-22T21:07:36

A document has been updated: http://cocoon.zones.apache.org/daisy/documentation/1159.html Document ID: 1159 Branch: main Language: default Name: Your first Cocoon application using Maven 2 (unchanged) Document Type: Cocoon Document (unchanged) Updated on: 10/30/08 12:47:22 PM Updated by: Luca Morandini A new version has been created, state: draft Parts ===== Content ------- This part has been updated. Mime type: text/xml (unchanged) File name: (unchanged) Size: 7822 bytes (previous version: 7533 bytes) Content diff: (37 equal lines skipped)

mvn archetype:generate -DarchetypeCatalog=http://cocoon.apache.org

+++

Due to the vagaries of Maven, as of the 30th of Oct 2008, this +++ will work only if you specify the archetype version. like in: mvn +++ org.apache.maven.plugins:maven-archetype-plugin:2.0-alpha-4:generate +++ -DarchetypeCatalog=http://cocoon.apache.org

+++

Maven will generate some output and then interactively ask you for some information:

(130 equal lines skipped)

[DAISY] Comment added to Tutorial: A Gentle Introduction to Cocoon Control Flow

2008-11-22T21:07:36

A comment has been created. http://cocoon.zones.apache.org/daisy/documentation/1241.html Document ID: 1241 Name: Tutorial: A Gentle Introduction to Cocoon Control Flow Branch: main Language: default Created by: David Legg Created on: 11/6/08 12:14:15 AM Visibility: public Thanks for the correction. I have changed it to guess.jx

[DAISY] Updated: Using the Reloading Classloader

2008-11-22T21:07:36

A document has been updated: http://cocoon.zones.apache.org/daisy/documentation/1297.html Document ID: 1297 Branch: main Language: default Name: Using the Reloading Classloader (unchanged) Document Type: Cocoon Document (unchanged) Updated on: 10/30/08 8:00:54 PM Updated by: Luca Morandini A new version has been created, state: draft Parts ===== Content ------- This part has been updated. Mime type: text/xml (unchanged) File name: (unchanged) Size: 4143 bytes (unchanged) Content diff: (15 equal lines skipped) <plugin> <groupId>org.apache.cocoon</groupId> <artifactId>cocoon-maven-plugin</artifactId> --- <version>1.0.0-M2</version> +++ <version>1.0.0-M3</version> </plugin> [...] </plugins> (109 equal lines skipped)

[DAISY] Comment added to Tutorial: A Gentle Introduction to Cocoon Control Flow

2008-11-22T21:07:36

A comment has been created. http://cocoon.zones.apache.org/daisy/documentation/1241.html Document ID: 1241 Name: Tutorial: A Gentle Introduction to Cocoon Control Flow Branch: main Language: default Created by: eleison Created on: 11/5/08 10:56:11 AM Visibility: public There is actually an error in the example right now: In the game.js there is a reference to guess.jxt this should be without the t After adjusting this minor error it worked for me.

[DAISY] Updated: Using the Reloading Classloader

2008-11-22T21:07:35

A document has been updated: http://cocoon.zones.apache.org/daisy/documentation/1297.html Document ID: 1297 Branch: main Language: default Name: Using the Reloading Classloader (unchanged) Document Type: Cocoon Document (unchanged) Updated on: 10/18/08 10:55:11 PM Updated by: Ross Gardler A new version has been created, state: publish Parts ===== Content ------- This part has been updated. Mime type: text/xml (unchanged) File name: (unchanged) Size: 4143 bytes (previous version: 4175 bytes) Content diff: (25 equal lines skipped)

Step 2: Configure the plugin

---

You can also provide configuration properties. Use the --- goal documentation generated from the Javadoc --- comments to find out more.

+++

You can also provide configuration properties. Use the goal documentation +++ generated from the Javadoc comments to find out more.

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.

(98 equal lines skipped)

[DAISY] Updated: Using the Reloading Classloader

2008-11-21T18:12:08

A document has been updated: http://cocoon.zones.apache.org/daisy/documentation/1297.html Document ID: 1297 Branch: main Language: default Name: Using the Reloading Classloader (unchanged) Document Type: Cocoon Document (unchanged) Updated on: 10/18/08 10:55:11 PM Updated by: Ross Gardler A new version has been created, state: publish Parts ===== Content ------- This part has been updated. Mime type: text/xml (unchanged) File name: (unchanged) Size: 4143 bytes (previous version: 4175 bytes) Content diff: (25 equal lines skipped)

Step 2: Configure the plugin

---

You can also provide configuration properties. Use the --- goal documentation generated from the Javadoc --- comments to find out more.

+++

You can also provide configuration properties. Use the goal documentation +++ generated from the Javadoc comments to find out more.

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.

(98 equal lines skipped)

[DAISY] Updated: Using the Reloading Classloader

2008-11-21T18:12:08

[DAISY] Comment added to Tutorial: A Gentle Introduction to Cocoon Control Flow

2008-11-21T18:12:09

A comment has been created. http://cocoon.zones.apache.org/daisy/documentation/1241.html Document ID: 1241 Name: Tutorial: A Gentle Introduction to Cocoon Control Flow Branch: main Language: default Created by: eleison Created on: 11/5/08 10:56:11 AM Visibility: public There is actually an error in the example right now: In the game.js there is a reference to guess.jxt this should be without the t After adjusting this minor error it worked for me.

[DAISY] Updated: Tutorial: A Gentle Introduction to Cocoon Control Flow

2008-11-21T18:12:09

[DAISY] Comment added to Tutorial: A Gentle Introduction to Cocoon Control Flow

2008-11-21T18:12:09

[DAISY] Updated: A Simple CForm Example

2008-11-21T18:12:07

A simple CForms example

In this example we will show how to create a simple registration form using --- CForms and flowscript. We will follow to following steps:

+++ CForms and flowscript. We will follow the following steps:

Create a block for this sample

Create a block

This has been covered in the tutorial, but it won't hurt to recall this Maven --- goal:

This is covered in the tutorial "Your first Cocoon +++ application using Maven 2", but it won't hurt to repeat it here:

mvn org.apache.maven.plugins:maven-archetype-plugin:1.0-alpha-7:create 
--- -DarchetypeGroupId=org.apache.cocoon 
--- -DarchetypeArtifactId=cocoon-22-archetype-block 
--- -DarchetypeVersion=1.0.0-RC2 -DgroupId=com.mycompany 
--- -DartifactId=simple-sample

Choose a suitable parent directory in which to create the following example +++ directory and then run this Maven command:

As of the writing of this page, the Maven archetype plugin --- version has to be specified, due to a bug in the current release of it.

mvn archetype:generate -DarchetypeCatalog=http://cocoon.apache.org
+++

Edit the simple-sample/pom.xml file and add the support for Cocoon --- Forms:

Maven will generate some output and then interactively ask you for some +++ information. You should select item 2 (the cocoon-22-archetype-block):

Choose archetype:
+++ 1: remote -> cocoon-22-archetype-block-plain (Creates an empty Cocoon block; useful
+++  if you want to add another block to a Cocoon application)
+++ 2: remote -> cocoon-22-archetype-block (Creates a Cocoon block containing some small
+++  samples)
+++ 3: remote -> cocoon-22-archetype-webapp (Creates a web application configured to
+++  host Cocoon blocks. Just add the block dependencies)
+++ Choose a number:  (1/2/3): 2
+++

When Maven asks for more details of the block to be created answer as +++ follows:

 Define value for groupId: : com.mycompany
+++ Define value for artifactId: : cformexample
+++ Define value for version:  1.0-SNAPSHOT: : 1.0.0
+++ Define value for package: : com.mycompany.cformexample
+++

A new directory should appear called 'cformexample'.

Change into this directory and edit the pom.xml file by adding a +++ dependency on Cocoon Forms:

<dependency>
---       <groupId>org.apache.cocoon</groupId>
---       <artifactId>cocoon-forms-impl</artifactId>
---       <version>1.0.0-RC1</version>
+++   <groupId>org.apache.cocoon</groupId>
+++   <artifactId>cocoon-forms-impl</artifactId>
+++   <version>1.1.0</version>
    </dependency>

Move in the simple-sample directory and build the block to ensure --- the playing field is set appropriately.

Build the block to ensure everything is set correctly:

mvn install

To access resources held in the cocoon-forms-impl and cocoon-ajax-impl +++ blocks, the Servlet Service Framework has to be told how to find them. Hence, +++ open:

<servlet:connections>
---   <entry key="ajax" value-ref="org.apache.cocoon.ajax.impl.servlet"/>
---   <entry key="forms" value-ref="org.apache.cocoon.forms.impl.servlet"/>
--- </servlet:connections>

src/main/resources/META-INF/cocoon/spring/block-servlet-service.xml +++

Find the following line:

<servlet:context mount-path="/cformexample" context-path="blockcontext:/cformexample/"/>
+++

and change it to look like this:

<servlet:context mount-path="/cformexample" context-path="blockcontext:/cformexample/">
+++   <servlet:connections>
+++     <entry key="ajax" value-ref="org.apache.cocoon.ajax.impl.servlet"/>
+++     <entry key="forms" value-ref="org.apache.cocoon.forms.impl.servlet"/>
+++   </servlet:connections>
+++ </servlet:context>
+++

Create a form definition file

Below the form definition file is displayed, (189 equal lines skipped)

Add some pipelines to the sitemap

The sitemap.xmap has to be modified as well:

The sitemap.xmap has to be modified (located in: src\main\resources\COB-INF): +++

First, an i18n dictionary has to be definied:

First, an i18n dictionary has to be defined:

  <map:components>
        <map:transformers default="xslt">
(39 equal lines skipped)
            <map:generate type="jx" src="resource/internal/registration_success.jx"/>
            <map:serialize/>
          </map:match>
---     </map:pipeline

Note the following things:

In the map:flow tag our flowscript file is NOT declared, since --- Cocoon loads automatically what's in the flow directory.

flow

Then we have the pipelines:

The first two are for managing the flowscript: when someone hits the (9 equal lines skipped) javascript libraries, CSS files and images.
Resources (XSL files, CSS, images, etc.) defined in the forms-impl and ajax-impl blocks are provided to this block by the Servlet Service Framework --- (look at the paramters given to forms-samples-styling.xsl).

forms-samples-styling.xsl

Direct your browser to:

http://localhost:8888/simple-sample/registration
+++ http://localhost:8888/cformexample/registration
    
    
    Try entering incorrect data and see what it does.
(4 equal lines skipped)
    a simple form (though notice you didn't have to write any Java for all of this,
    nor to restart Cocoon), but adding more complexity to the form is now simply a
    matter of adding more widgets, custom validation logic, event handlers, etc. To
--- have a feel for the power of CForms, take a look at the examples included
+++ get a feel for the power of CForms, take a look at the examples included
    included in the Forms block.
    
    
(1 equal lines skipped)

[DAISY] Updated: Your first Cocoon application using Maven 2

2008-11-21T18:12:08

mvn archetype:generate -DarchetypeCatalog=http://cocoon.apache.org

+++

Maven will generate some output and then interactively ask you for some information:

(130 equal lines skipped)

[DAISY] Comment added to Tutorial: A Gentle Introduction to Cocoon Control Flow

2008-11-21T00:17:07

A comment has been created. http://cocoon.zones.apache.org/daisy/documentation/1241.html Document ID: 1241 Name: Tutorial: A Gentle Introduction to Cocoon Control Flow Branch: main Language: default Created by: eleison Created on: 11/5/08 10:56:11 AM Visibility: public There is actually an error in the example right now: In the game.js there is a reference to guess.jxt this should be without the t After adjusting this minor error it worked for me.

[DAISY] Updated: Your first Cocoon application using Maven 2

2008-11-21T00:17:07

mvn archetype:generate -DarchetypeCatalog=http://cocoon.apache.org

+++

Maven will generate some output and then interactively ask you for some information:

(130 equal lines skipped)

[DAISY] Comment added to Tutorial: A Gentle Introduction to Cocoon Control Flow

2008-11-21T00:17:07

[DAISY] Updated: Using the Reloading Classloader

2008-11-21T00:17:07

A document has been updated: http://cocoon.zones.apache.org/daisy/documentation/1297.html Document ID: 1297 Branch: main Language: default Name: Using the Reloading Classloader (unchanged) Document Type: Cocoon Document (unchanged) Updated on: 10/18/08 10:55:11 PM Updated by: Ross Gardler A new version has been created, state: publish Parts ===== Content ------- This part has been updated. Mime type: text/xml (unchanged) File name: (unchanged) Size: 4143 bytes (previous version: 4175 bytes) Content diff: (25 equal lines skipped)

Step 2: Configure the plugin

---

You can also provide configuration properties. Use the --- goal documentation generated from the Javadoc --- comments to find out more.

+++

You can also provide configuration properties. Use the goal documentation +++ generated from the Javadoc comments to find out more.

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.

(98 equal lines skipped)

[DAISY] Updated: Tutorial: A Gentle Introduction to Cocoon Control Flow

2008-11-21T00:17:07