KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > hammurapi > Waiver


1 /*
2  * Hammurapi
3  * Automated Java code review system.
4  * Copyright (C) 2004 Hammurapi Group
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19  *
20  * URL: http://www.hammurapi.org
21  * e-Mail: support@hammurapi.biz
22  */

23
24 package org.hammurapi;
25
26 import java.util.Collection JavaDoc;
27 import java.util.Date JavaDoc;
28
29 /**
30  * Waiver is a way to suppress a particular violation.
31  * @author Pavel Vlasov
32  * @version $Revision: 1.4 $
33  */

34 public interface Waiver {
35     
36     static final String JavaDoc DATE_FORMAT = "yyyy/MM/dd";
37     
38     /**
39      *
40      * @return Inspector name to which this waiver applies
41      */

42     String JavaDoc getInspectorName();
43     
44     /**
45      * @param violation Violation to waive
46      * @param peek If true waiver doesn't change it state.
47      * @return true if Violation shall be waived
48      */

49     boolean waive(Violation violation, boolean peek);
50     
51     Date JavaDoc getExpirationDate();
52     
53     /**
54      * @return Description why waiver was given.
55      */

56     String JavaDoc getReason();
57     
58     /**
59      * @return true if waiver can waive violations
60      */

61     boolean isActive();
62
63     /**
64      * @return Collection of signatures waived by this inspector. Can be null.
65      */

66     Collection JavaDoc getSignatures();
67 }
68
Popular Tags