Module XSLForms.Fields
Interpretation of field collections from sources such as HTTP request parameter
dictionaries.
Copyright (C) 2005 Paul Boddie <paul@boddie.org.uk>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
--------
Classes which process field collections, producing instance documents. Each
field entry consists of a field name mapped to a string value, where the field
name may have the following formats:
/name1$n1/name2
/name1$n1/name2$n2/name3
/name1$n1/name2$n2/name3$n3/name4
...
The indexes n1, n2, n3, ... indicate the position of elements (starting from 1)
in the entire element list, whose elements may have different names. For
example:
/zoo$1/name
/zoo$1/cage$1/name
/zoo$1/cage$2/name
/zoo$1/funding$3/contributor$1/name
Where multiple values can be collected for a given field, the following notation
is employed:
/package$1/categories$1/category$$value
Some fields may contain the "=" string. This string is reserved and all text
following it is meant to specify a path into a particular document. For example:
_action_add_animal=/zoo$1/cage$2
Classes |
FieldProcessor |
A class which converts fields in the documented form to XML instance
documents. |
Fields |
A class which converts fields in the documented form to XML instance
documents. |
Form |
A collection of documents processed from form fields. |