You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@cocoon.apache.org by da...@cocoon.zones.apache.org on 2005/10/14 15:53:59 UTC
[DAISY] Updated: How to develop Web Applications
A document has been updated:
http://cocoon.zones.apache.org/daisy/legacydocs/631.html
Document ID: 631
Branch: main
Language: default
Name: How to develop Web Applications (unchanged)
Document Type: Document (unchanged)
Updated on: 10/14/05 1:53:37 PM
Updated by: Helma van der Linden
A new version has been created, state: publish
Parts
=====
Content
-------
This part has been updated.
Mime type: text/xml (unchanged)
File name: (unchanged)
Size: 46339 bytes (previous version: 46293 bytes)
Content diff:
(27 equal lines skipped)
webapp as per the installation instructions (<tt>build webapp</tt>) then you can
see this tutorial in action via the Samples pages.</p>
+++ <p class="note">Screenshots are <a href="daisy:633">here</a>.</p>
+++
<h2>Separating Concerns</h2>
<p>Cocoon is designed to allow Developers, Business Analysts, Designers, and
(132 equal lines skipped)
the <tt><map:pipelines></tt> tag. Next, you will add an entry in the same
location that looks like this:</p>
--- <pre>
---
+++ <pre>
<map:pipeline>
<map:match pattern="">
<map:redirect-to uri="home.html"/>
(56 equal lines skipped)
<p>Our home page is going to be really simple: a list of links that take us to
the main pages.</p>
--- <pre>
---
+++ <pre>
<document>
<header>
<title>Home Page</title>
(54 equal lines skipped)
<p>Our first form is the "Create a Department" form. The website specification
is missing the tags for form building, we will provide an example here:</p>
--- <pre>
---
+++ <pre>
<document>
<header>
<title>Department</title>
(37 equal lines skipped)
database tables and place constraints on the parameters. For the Department form
group, it will look like this:</p>
--- <pre>
---
+++ <pre>
<root>
<!-
The "parameter" elements identify the root constraints for
(73 equal lines skipped)
has to be able to know how to reference the Actions we want. To do that, alter
the "map:actions" section to list all the actions we need:</p>
--- <pre>
---
+++ <pre>
<map:actions>
<map:action name="dbAdd"
src="org.apache.cocoon.acting.DatabaseAddAction"/>
(14 equal lines skipped)
parameter. For our purposes, the action set we are defining is listed below
(defined in the sitemap):</p>
--- <pre>
---
+++ <pre>
<map:action-sets>
<map:action-set name="process">
<map:act type="form" action="Create Department">
(13 equal lines skipped)
<p>Now that we have defined the actions we want, with the parameters that
control them during run-time, we can use it in our pipeline.</p>
--- <pre>
---
+++ <pre>
<map:match pattern="*-dept.html">
<map:act set="process">
<map:parameter name="descriptor"
(39 equal lines skipped)
document called "xsp:page" declaring the XSP namespace. The change will look
like this:</p>
--- <pre>
---
+++ <pre>
<xsp:page xmlns:xsp="http://apache.org/xsp">
<!-- The original document will be embedded here -->
</xsp:page>
(4 equal lines skipped)
we know what we are dealing with at a glance. Create a new file called
"confirm.xsp" with the following contents:</p>
--- <pre>
---
+++ <pre>
<xsp:page xmlns:xsp="http://apache.org/xsp">
<document>
<header>
(17 equal lines skipped)
namespace declaration to the "xsp:page" element. The final form page will look
like this:</p>
--- <pre>
---
+++ <pre>
<xsp:page xmlns:xsp="http://apache.org/xsp"
xmlns:xsp-formval="http://apache.org/xsp/form-validator/2.0">
<document>
(36 equal lines skipped)
accomplish with the ESQL Logicsheet. Again, when you use the ESQL logicsheet,
you lose some of your separation of concerns.</p>
--- <pre>
---
+++ <pre>
<xsp:page xmlns:xsp="http://apache.org/xsp"
xmlns:xsp-formval="http://apache.org/xsp/form-validator/2.0"
xmlns:esql="http://apache.org/cocoon/SQL/v2">
(144 equal lines skipped)
Actions. When an Action is specified in the sitemap, it uses the following
syntax:</p>
--- <pre>
---
+++ <pre>
<map:act type="my-action">
<map:generate src="{source}"/>
<map:transform src="doc2{theme}"/>
(54 equal lines skipped)
<p>The resulting XML looks like this:</p>
--- <pre>
---
+++ <pre>
<?xml version="1.0"?>
<directory xmlns="http://apache.org/cocoon/directory/2.0"
(71 equal lines skipped)
<p>This generator converts the Request object into an XML representation. It is
best used for debugging purposes. The resulting XML follows:</p>
--- <pre>
---
+++ <pre>
<request xmlns="http://apache.org/cocoon/request/2.0"
target="index.html" source="context://docs/index.xml">
(28 equal lines skipped)
interpreter to generate valid XML. If you add language support, you will have to
embed the following configuration information:</p>
--- <pre>
---
+++ <pre>
<add-languages>
<!-- repeat the following for each language: -->
<language name="kawa-scheme"
(25 equal lines skipped)
<p>The StatusGenerator is another debug tool. It provides status information for
the Cocoon engine. The resultant XML is in the following format:</p>
--- <pre>
---
+++ <pre>
<statusinfo xmlns="http://apache.org/cocoon/status/2.0"
xmlns:xlink="http://www.w3.org/1999/xlink"
host="johnny-bravo.infoplanning.com"
(57 equal lines skipped)
sitemap so you can include the results of processed XSP pages. An example
follows:</p>
--- <pre>
---
+++ <pre>
<document xmlns:ci="http://apache.org/cocoon/include/1.0">
<ci:include src="cocoon://my-resource.xml"
element="body"
(50 equal lines skipped)
the "i18n:text" element, or the attribute name inside the "i18n:attr" attribute.
</p>
--- <pre>
---
+++ <pre>
<document xmlns:i18n="http://apache.org/cocoon/i18n/2.0">
<body>
<s1 title="Test Title" i18n:attr="title">
(33 equal lines skipped)
<p>Below is the root element of all sitemaps:</p>
--- <pre>
---
+++ <pre>
<map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0">
</map:sitemap>
(6 equal lines skipped)
what they do. Before we begin, I must state that every component is declared in
the "map:components" element of the Sitemap:</p>
--- <pre>
---
+++ <pre>
<map:components>
</map:components>
(4 equal lines skipped)
<p>All generators are declared within the "map:generators" element that is a
child of the "map:components" element:</p>
--- <pre>
---
+++ <pre>
<map:generators>
<map:generator name="file"
src="org.apache.cocoon.generation.FileGenerator"/>
(16 equal lines skipped)
Fields
======
no changes
Links
=====
no changes
Custom Fields
=============
no changes
Collections
===========
no changes