blob: 085cbf8abc1c74e3b6b7d91d3f03aca581a7827a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
/*
@VaadinApache2LicenseForJavaFiles@
*/
package com.vaadin.data;
import java.io.Serializable;
import java.util.Collection;
/**
* <p>
* Interface for validatable objects. Defines methods to verify if the object's
* value is valid or not, and to add, remove and list registered validators of
* the object.
* </p>
*
* @author Vaadin Ltd.
* @since 3.0
* @see com.vaadin.data.Validator
*/
public interface Validatable extends Serializable {
/**
* <p>
* Adds a new validator for this object. The validator's
* {@link Validator#validate(Object)} method is activated every time the
* object's value needs to be verified, that is, when the {@link #isValid()}
* method is called. This usually happens when the object's value changes.
* </p>
*
* @param validator
* the new validator
*/
void addValidator(Validator validator);
/**
* <p>
* Removes a previously registered validator from the object. The specified
* validator is removed from the object and its <code>validate</code> method
* is no longer called in {@link #isValid()}.
* </p>
*
* @param validator
* the validator to remove
*/
void removeValidator(Validator validator);
/**
* <p>
* Lists all validators currently registered for the object. If no
* validators are registered, returns <code>null</code>.
* </p>
*
* @return collection of validators or <code>null</code>
*/
public Collection<Validator> getValidators();
/**
* <p>
* Tests the current value of the object against all registered validators.
* The registered validators are iterated and for each the
* {@link Validator#validate(Object)} method is called. If any validator
* throws the {@link Validator.InvalidValueException} this method returns
* <code>false</code>.
* </p>
*
* @return <code>true</code> if the registered validators concur that the
* value is valid, <code>false</code> otherwise
*/
public boolean isValid();
/**
* <p>
* Checks the validity of the validatable. If the validatable is valid this
* method should do nothing, and if it's not valid, it should throw
* <code>Validator.InvalidValueException</code>
* </p>
*
* @throws Validator.InvalidValueException
* if the value is not valid
*/
public void validate() throws Validator.InvalidValueException;
/**
* <p>
* Checks the validabtable object accept invalid values.The default value is
* <code>true</code>.
* </p>
*
*/
public boolean isInvalidAllowed();
/**
* <p>
* Should the validabtable object accept invalid values. Supporting this
* configuration possibility is optional. By default invalid values are
* allowed.
* </p>
*
* @param invalidValueAllowed
*
* @throws UnsupportedOperationException
* if the setInvalidAllowed is not supported.
*/
public void setInvalidAllowed(boolean invalidValueAllowed)
throws UnsupportedOperationException;
}
|
