| <?xml version="1.0"?> |
| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| |
| <!-- CVS: $Id$ --> |
| |
| <samples xmlns:xlink="http://www.w3.org/1999/xlink" name="simple form handling"> |
| |
| <group name="Simple Form Handling"> |
| <note> |
| Apache Cocoon contains several approaches to forms. The one demonstrated |
| here is probably the simplest but also the weakest. Please also consider |
| Cocoon Forms in the Forms block. |
| </note> |
| <note> |
| This samples group demonstrates the use for the simple form handling |
| in Apache Cocoon. Simple form handling consists of four parts: |
| validating user input, filling forms with submitted data, displaying |
| validation results, and filling forms with default values. This |
| corresponds largely to the involved Cocoon components: a validating |
| action, an XSP logicsheet helping to display validation results, a |
| transformer to fill in submitted data and display validation results, |
| and a transformer to extract default values. |
| </note> |
| <sample name="Logicsheet" href="one/index"> |
| On an XSP page two logicsheets are used to redisplay submitted data |
| and indicate validation results. |
| </sample> |
| <sample name="One Transformer" href="two/index"> |
| On a static XML page a form is displayed, submitted data is filled in, |
| and validation results are displayed by the use of the |
| SimpleFormTransformer. |
| </sample> |
| <sample name="Default Values" href="three/index"> |
| On a static XML page, form elements are separated from the default |
| values. The SimpleFormInstanceTransformer is used to extract the data |
| and the SimpleFormTransformer is used to pre-fill the form. No |
| validation is performed. |
| </sample> |
| <sample name="Transformer Sample" href="four/index"> |
| This sample combines the two samples above into one. |
| </sample> |
| </group> |
| |
| </samples> |