01: /**
02: * Spoon - http://spoon.gforge.inria.fr/
03: * Copyright (C) 2006 INRIA Futurs <renaud.pawlak@inria.fr>
04: *
05: * This software is governed by the CeCILL-C License under French law and
06: * abiding by the rules of distribution of free software. You can use,
07: * modify and/or redistribute the software under the terms of the
08: * CeCILL-C
09: * license as circulated by CEA, CNRS and INRIA at the following URL:
10: * http://www.cecill.info.
11: *
12: * This program is distributed in the hope that it will be useful, but
13: * WITHOUT ANY WARRANTY; without even the implied warranty of
14: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the CeCILL-C
15: * License for more details.
16: *
17: * The fact that you are presently reading this means that you have had
18: * knowledge of the CeCILL-C license and that you accept its terms.
19: */package spoon.aval.annotation.value;
20:
21: import java.lang.annotation.Retention;
22: import java.lang.annotation.RetentionPolicy;
23:
24: import spoon.aval.annotation.Implementation;
25: import spoon.aval.annotation.structure.AValTarget;
26: import spoon.aval.annotation.structure.Type;
27: import spoon.aval.support.validator.MatchesValidator;
28: import spoon.aval.support.validator.problemFixer.RemoveThisAnnotation;
29: import spoon.processing.ProblemFixer;
30: import spoon.processing.Severity;
31: import spoon.reflect.declaration.CtField;
32:
33: /**
34: * Validator that checks that the value of an attribute of type string matches
35: * to a given regular expression
36: * <p>
37: * For example, if the <code>value()<code> of an annotation <code>@A<code/> must either be "collection"
38: * or "singleton", the definition of <code>@A</code> must be:
39: *
40: * <p>
41: * <pre>
42: * public @interface A{
43: * @Matches("(collection|singleton)") String value();
44: * }
45: * </pre>
46: * </p>
47: *
48: * @see spoon.aval.support.validator.MatchesValidator
49: *
50: */
51: @Retention(RetentionPolicy.RUNTIME)
52: @AValTarget(CtField.class)
53: @Implementation(MatchesValidator.class)
54: @Type(CharSequence.class)
55: public @interface Matches {
56: /**
57: * A Java 1.4 regular expression.
58: *
59: * @see java.util.regex.Pattern
60: */
61: String value();
62:
63: /**
64: * Message to report when validation fails
65: */
66: String message() default "Value \"?val\" does not match ?regExp";
67:
68: /**
69: * Severity of the validation faliure
70: */
71: Severity severity() default Severity.WARNING;
72:
73: /**
74: * The list of {@link ProblemFixer}s to propose
75: * when the validation fails.
76: */
77: Class<? extends ProblemFixer>[] fixers() default { RemoveThisAnnotation.class };
78:
79: }
|