0d448ffaecc1ff5505c9fb3ea60f15098cc409b5
[mir.git] / lib / struts / validation_1_1.dtd
1 <!--\r
2     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
3     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
4     \r
5      Refer to the below DTD Instead:\r
6     \r
7     <!DOCTYPE form-validation PUBLIC\r
8           "-//Apache Software Foundation//DTD Commons Validator Rules Configuration 1.0//EN"\r
9           "http://jakarta.apache.org/commons/dtds/validator_1_0.dtd">\r
10 \r
11 \r
12     $Id: validation_1_1.dtd,v 1.5 2002/11/14 20:33:13 rleland Exp $\r
13 -->\r
14 \r
15 \r
16 <!--\r
17     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
18     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
19     The "form-validation" element is the root of the configuration file\r
20      hierarchy, and contains nested elements for all of the other\r
21      configuration settings.\r
22 -->\r
23 <!ELEMENT form-validation (global*, formset+)>\r
24 \r
25 \r
26 <!--\r
27     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
28     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
29     Global "constants" may be defined for use of other elements.\r
30 -->\r
31 <!ELEMENT global (constant*)>\r
32 \r
33 \r
34 <!--\r
35     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
36     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
37      The "constant" element defines a static value that can be used as\r
38      replacement parameters within "field" elements. The "constant-name" and\r
39      "constant-value" elements define the constant's reference id and\r
40      replacement value.\r
41 -->\r
42 <!ELEMENT constant (constant-name, constant-value)>\r
43 <!ELEMENT constant-name  (#PCDATA)>\r
44 <!ELEMENT constant-value (#PCDATA)>\r
45 \r
46 \r
47 <!--\r
48     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
49     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
50       The "formset" element defines a set of forms for a locale. Formsets for\r
51       specific locales can override only those fields that change. The\r
52       localization is properly scoped, so that a formset can override just the\r
53       language, or just the country, or both.\r
54 -->\r
55 <!ELEMENT formset (constant*, form+)>\r
56 <!ATTLIST formset language     CDATA #IMPLIED\r
57                   country      CDATA #IMPLIED >\r
58 \r
59 \r
60 <!--\r
61     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
62     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
63      The "form" element defines a set of fields to be validated. The name\r
64      corresponds to the identifer the application assigns to the form. In the\r
65      case of the Struts framework, this is the attribute property from\r
66      the ActionMapping. Struts also offers the alternative of using the\r
67      the path property as the Validator form name.\r
68 -->\r
69 <!ELEMENT form    (field+ )>\r
70 <!ATTLIST form    name CDATA #REQUIRED>\r
71 \r
72 \r
73 <!--\r
74     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
75     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
76      The "field" element defines the properties to be validated. In a\r
77      web application, a field would also correspond to a control on\r
78      a HTML form. To validate the properties, the validator works through\r
79      a JavaBean representation, like a Struts ActionForm. The field element\r
80      can accept up to 4 attributes:\r
81 \r
82      property        The property on the JavaBean corresponding to this\r
83                      field element.\r
84 \r
85      depends         The comma-delimited list of validators to apply against\r
86                      this field. For the field to succeed, all the\r
87                      validators must succeed.\r
88 \r
89      page            The JavaBean corresponding to this form may include\r
90                      a page property. Only fields with a "page" attribute\r
91                      value that is equal to or less than the page property\r
92                      on the form JavaBean are processed. This is useful when\r
93                      using a "wizard" approach to completing a large form,\r
94                      to ensure that a page is not skipped.\r
95                      [0]\r
96 \r
97      indexedListProperty\r
98                      The "indexedListProperty" is the method name that will\r
99                      return an array or a Collection used to retrieve the\r
100                      list and then loop through the list performing the\r
101                      validations for this field.\r
102 \r
103      fieldOrder      [:FIXME: is this still supported?]\r
104 -->\r
105 <!ELEMENT field   (msg?, arg0?, arg1?, arg2?, arg3?, var* )>\r
106 <!ATTLIST field   property CDATA #REQUIRED\r
107                   depends  CDATA #IMPLIED\r
108                   page     CDATA #IMPLIED\r
109                   indexedListProperty CDATA #IMPLIED >\r
110 \r
111 \r
112 <!--\r
113     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
114     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
115      The "msg" element defines a custom message key to use when one of the\r
116      validators for this field fails. Each validator has a default message\r
117      property that is used when a corresonding field msg is not specified.\r
118      Each validator applied to a field may have its own msg element.\r
119      The msg element accepts up to three attributes.\r
120 \r
121       name        The name of the validator corresponding to this msg.\r
122 \r
123       key         The key that will return the message template from a\r
124                   resource bundle.\r
125 \r
126       resource    If set to "false", the key is taken to be a literal\r
127                   value rather than a bundle key.\r
128                   [true]\r
129 -->\r
130 <!ELEMENT msg     EMPTY>\r
131 <!ATTLIST msg     name     CDATA #IMPLIED\r
132                   key      CDATA #IMPLIED\r
133                   resource CDATA #IMPLIED >\r
134 \r
135 \r
136 <!--\r
137     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
138     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
139      The "arg0" element defines the first replacement value to use with the\r
140      message template for this validator or this field.\r
141      The arg0 element accepts up to three attributes.\r
142 \r
143       name        The name of the validator corresponding to this msg.\r
144 \r
145       key         The key that will return the message template from a\r
146                   resource bundle.\r
147 \r
148       resource    If set to "false", the key is taken to be a literal\r
149                   value rather than a bundle key.\r
150                   [true]\r
151 -->\r
152 <!ELEMENT arg0    EMPTY>\r
153 <!ATTLIST arg0    name     CDATA #IMPLIED\r
154                   key      CDATA #IMPLIED\r
155                   resource CDATA #IMPLIED >\r
156 \r
157 \r
158 <!--\r
159     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
160     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
161      The "arg1" element defines the second replacement value to use with the\r
162      message template for this validator or this field.\r
163      The arg1 element accepts up to three attributes.\r
164 \r
165       name        The name of the validator corresponding to this msg.\r
166 \r
167       key         The key that will return the message template from a\r
168                   resource bundle.\r
169 \r
170       resource    If set to "false", the key is taken to be a literal\r
171                   value rather than a bundle key.\r
172                   [true]\r
173 -->\r
174 <!ELEMENT arg1    EMPTY>\r
175 <!ATTLIST arg1    name     CDATA #IMPLIED\r
176                   key      CDATA #IMPLIED\r
177                   resource CDATA #IMPLIED >\r
178 \r
179 \r
180 <!--\r
181     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
182     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
183      The "arg2" element defines the third replacement value to use with the\r
184      message template for this validator or this field.\r
185      The arg2 element accepts up to three attributes.\r
186 \r
187       name        The name of the validator corresponding to this msg.\r
188 \r
189       key         The key that will return the message template from a\r
190                   resource bundle.\r
191 \r
192       resource    If set to "false", the key is taken to be a literal\r
193                   value rather than a bundle key.\r
194                   [true]\r
195 -->\r
196 <!ELEMENT arg2    EMPTY>\r
197 <!ATTLIST arg2    name     CDATA #IMPLIED\r
198                   key      CDATA #IMPLIED\r
199                   resource CDATA #IMPLIED >\r
200 \r
201 <!--\r
202     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
203     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
204      The "arg3" element defines the fourth replacement value to use with the\r
205      message template for this validator or this field.\r
206      The arg0 element accepts up to three attributes.\r
207 \r
208       name        The name of the validator corresponding to this msg.\r
209 \r
210       key         The key that will return the message template from a\r
211                   resource bundle.\r
212 \r
213       resource    If set to "false", the key is taken to be a literal\r
214                   value rather than a bundle key.\r
215                   [true]\r
216 -->\r
217 <!ELEMENT arg3    EMPTY>\r
218 <!ATTLIST arg3    name     CDATA #IMPLIED\r
219                   key      CDATA #IMPLIED\r
220                   resource CDATA #IMPLIED >\r
221 \r
222 \r
223 <!--\r
224     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
225     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
226      The "var" element can set parameters that a field may need to pass to\r
227      one of its validators, such as the minimum and maximum values in a\r
228      range validation. These parameters may also be referenced by one of the\r
229      arg? elements using a shell syntax: ${var:var-name}.\r
230 -->\r
231 <!ELEMENT var (var-name, var-value)>\r
232 \r
233 \r
234 \r
235 <!--\r
236     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
237     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
238      The name of the var parameter to provide to a field's validators.\r
239 -->\r
240 <!ELEMENT var-name  (#PCDATA)>\r
241 \r
242 \r
243 \r
244 <!--\r
245     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED\r
246     DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED ** DEPRECATED \r
247      The value of the var parameter to provide to a field's validators.\r
248 -->\r
249 <!ELEMENT var-value (#PCDATA)>\r
250 \r
251 <!-- eof -->