01: /*
02: * Licensed to the Apache Software Foundation (ASF) under one or more
03: * contributor license agreements. See the NOTICE file distributed with
04: * this work for additional information regarding copyright ownership.
05: * The ASF licenses this file to You under the Apache License, Version 2.0
06: * (the "License"); you may not use this file except in compliance with
07: * the License. You may obtain a copy of the License at
08: *
09: * http://www.apache.org/licenses/LICENSE-2.0
10: *
11: * Unless required by applicable law or agreed to in writing, software
12: * distributed under the License is distributed on an "AS IS" BASIS,
13: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14: * See the License for the specific language governing permissions and
15: * limitations under the License.
16: */
17: package org.apache.wicket.markup.html.form.validation;
18:
19: import org.apache.wicket.IClusterable;
20: import org.apache.wicket.markup.html.form.Form;
21: import org.apache.wicket.markup.html.form.FormComponent;
22:
23: /**
24: * Interface that represents validators that check multiple components. These
25: * validators are added to the form and only executed if all form components
26: * returned by {@link IFormValidator#getDependentFormComponents()} have been
27: * successfully validated before this validator runs.
28: *
29: * TODO post 1.3: remove validate(form) *make IFormValidator extends IValidator
30: * where IValidatable's value is form.modelobject and error reports on form -
31: * that way IBehaviorProvider can extend IValidator
32: *
33: * @author Igor Vaynberg (ivaynberg)
34: */
35: public interface IFormValidator extends IClusterable {
36: /**
37: * @return array of {@link FormComponent}s that this validator depends on
38: */
39: FormComponent[] getDependentFormComponents();
40:
41: /**
42: * This method is ran if all components returned by
43: * {@link IFormValidator#getDependentFormComponents()} are valid.
44: *
45: * @param form
46: * form this validator is added to
47: */
48: void validate(Form form);
49: }
|