1 <?xml version="1.0"?> |
|
2 <!DOCTYPE module PUBLIC |
|
3 "-//Puppy Crawl//DTD Check Configuration 1.2//EN" |
|
4 "http://www.puppycrawl.com/dtds/configuration_1_2.dtd"> |
|
5 |
|
6 <!-- |
|
7 |
|
8 Checkstyle configuration that checks the sun coding conventions from: |
|
9 |
|
10 - the Java Language Specification at |
|
11 http://java.sun.com/docs/books/jls/second_edition/html/index.html |
|
12 |
|
13 - the Sun Code Conventions at http://java.sun.com/docs/codeconv/ |
|
14 |
|
15 - the Javadoc guidelines at |
|
16 http://java.sun.com/j2se/javadoc/writingdoccomments/index.html |
|
17 |
|
18 - the JDK Api documentation http://java.sun.com/j2se/docs/api/index.html |
|
19 |
|
20 - some best practices |
|
21 |
|
22 Checkstyle is very configurable. Be sure to read the documentation at |
|
23 http://checkstyle.sf.net (or in your downloaded distribution). |
|
24 |
|
25 Most Checks are configurable, be sure to consult the documentation. |
|
26 |
|
27 To completely disable a check, just comment it out or delete it from the file. |
|
28 |
|
29 Finally, it is worth reading the documentation. |
|
30 |
|
31 --> |
|
32 |
|
33 <module name="Checker"> |
|
34 <!-- |
|
35 If you set the basedir property below, then all reported file |
|
36 names will be relative to the specified directory. See |
|
37 http://checkstyle.sourceforge.net/5.x/config.html#Checker |
|
38 --> |
|
39 <property name="basedir" value="/home/beem/"/> |
|
40 |
|
41 <property name="severity" value="warning"/> |
|
42 |
|
43 <!-- Checks that a package-info.java file exists for each package. --> |
|
44 <!-- See http://checkstyle.sf.net/config_javadoc.html#JavadocPackage --> |
|
45 <module name="JavadocPackage"> |
|
46 <property name="allowLegacy" value="true"/> |
|
47 </module> |
|
48 |
|
49 <!-- Checks whether files end with a new line. --> |
|
50 <!-- See http://checkstyle.sf.net/config_misc.html#NewlineAtEndOfFile --> |
|
51 <module name="NewlineAtEndOfFile"> |
|
52 <property name="severity" value="error"/> |
|
53 </module> |
|
54 |
|
55 <!-- Checks that property files contain the same keys. --> |
|
56 <!-- See http://checkstyle.sf.net/config_misc.html#Translation --> |
|
57 <module name="Translation"> |
|
58 <property name="severity" value="error"/> |
|
59 </module> |
|
60 |
|
61 <!-- Checks for Size Violations. --> |
|
62 <!-- See http://checkstyle.sf.net/config_sizes.html --> |
|
63 <module name="FileLength"/> |
|
64 |
|
65 <!-- Checks for whitespace --> |
|
66 <!-- See http://checkstyle.sf.net/config_whitespace.html --> |
|
67 <!-- we want tab |
|
68 <module name="FileTabCharacter"/> |
|
69 --> |
|
70 |
|
71 <!-- Miscellaneous other checks. --> |
|
72 <!-- See http://checkstyle.sf.net/config_misc.html --> |
|
73 <module name="RegexpSingleline"> |
|
74 <property name="severity" value="error"/> |
|
75 <property name="format" value="\s+$"/> |
|
76 <property name="minimum" value="0"/> |
|
77 <property name="maximum" value="0"/> |
|
78 <property name="message" value="Line has trailing spaces."/> |
|
79 </module> |
|
80 |
|
81 <module name="StrictDuplicateCode"/> |
|
82 |
|
83 <module name="TreeWalker"> |
|
84 |
|
85 <!-- Checks for Javadoc comments. --> |
|
86 <!-- See http://checkstyle.sf.net/config_javadoc.html --> |
|
87 <module name="JavadocMethod"> |
|
88 <property name="allowUndeclaredRTE" value="true"/> |
|
89 <property name="severity" value="error"/> |
|
90 </module> |
|
91 <module name="JavadocType"> |
|
92 <property name="severity" value="error"/> |
|
93 </module> |
|
94 <module name="JavadocVariable"> |
|
95 <property name="scope" value="package" /> |
|
96 <property name="severity" value="error"/> |
|
97 </module> |
|
98 <module name="JavadocStyle"> |
|
99 <property name="checkEmptyJavadoc" value="true"/> |
|
100 <property name="severity" value="error"/> |
|
101 </module> |
|
102 |
|
103 |
|
104 <!-- Checks for Naming Conventions. --> |
|
105 <!-- See http://checkstyle.sf.net/config_naming.html --> |
|
106 <module name="ConstantName"/> |
|
107 <module name="LocalFinalVariableName"/> |
|
108 <module name="LocalVariableName"/> |
|
109 <module name="MemberName"> |
|
110 <property name="format" value="^m[A-Z][a-zA-Z0-9]*$"/> |
|
111 <property name="severity" value="error"/> |
|
112 </module> |
|
113 <module name="MethodName"/> |
|
114 <module name="PackageName"/> |
|
115 <module name="ParameterName"/> |
|
116 <module name="StaticVariableName"/> |
|
117 <module name="TypeName"/> |
|
118 |
|
119 |
|
120 <!-- Checks for Headers --> |
|
121 <!-- See http://checkstyle.sf.net/config_header.html --> |
|
122 <!-- <module name="Header"> --> |
|
123 <!-- The follow property value demonstrates the ability --> |
|
124 <!-- to have access to ANT properties. In this case it uses --> |
|
125 <!-- the ${basedir} property to allow Checkstyle to be run --> |
|
126 <!-- from any directory within a project. See property --> |
|
127 <!-- expansion, --> |
|
128 <!-- http://checkstyle.sf.net/config.html#properties --> |
|
129 <!-- <property --> |
|
130 <!-- name="headerFile" --> |
|
131 <!-- value="${basedir}/java.header"/> --> |
|
132 <!-- </module> --> |
|
133 |
|
134 <!-- Following interprets the header file as regular expressions. --> |
|
135 <!-- <module name="RegexpHeader"/> --> |
|
136 |
|
137 |
|
138 <!-- Checks for imports --> |
|
139 <!-- See http://checkstyle.sf.net/config_import.html --> |
|
140 <module name="AvoidStarImport"/> |
|
141 <module name="IllegalImport"/> <!-- defaults to sun.* packages --> |
|
142 <module name="RedundantImport"/> |
|
143 <module name="UnusedImports"> |
|
144 <property name="severity" value="error"/> |
|
145 </module> |
|
146 <module name="AvoidStaticImport"> |
|
147 <property name="excludes" value="*"/> |
|
148 </module> |
|
149 |
|
150 |
|
151 <!-- Checks for Size Violations. --> |
|
152 <!-- See http://checkstyle.sf.net/config_sizes.html --> |
|
153 <module name="LineLength"> |
|
154 <property name="max" value="120" /> |
|
155 </module> |
|
156 <module name="MethodLength"/> |
|
157 <module name="ParameterNumber"/> |
|
158 <module name="AnonInnerLength"> |
|
159 <property name="max" value="60" /> |
|
160 </module> |
|
161 |
|
162 |
|
163 <!-- Checks for whitespace --> |
|
164 <!-- See http://checkstyle.sf.net/config_whitespace.html --> |
|
165 <module name="EmptyForIteratorPad"/> |
|
166 <module name="GenericWhitespace"/> |
|
167 <module name="MethodParamPad"/> |
|
168 <module name="NoWhitespaceAfter"/> |
|
169 <module name="NoWhitespaceBefore"/> |
|
170 <module name="OperatorWrap"/> |
|
171 <module name="ParenPad"/> |
|
172 <module name="TypecastParenPad"/> |
|
173 <!-- We want mixed tabulation |
|
174 <module name="TabCharacter"/> |
|
175 --> |
|
176 <module name="WhitespaceAfter"/> |
|
177 <module name="WhitespaceAround"/> |
|
178 |
|
179 |
|
180 <!-- Modifier Checks --> |
|
181 <!-- See http://checkstyle.sf.net/config_modifiers.html --> |
|
182 <module name="ModifierOrder"> |
|
183 <property name="severity" value="error"/> |
|
184 </module> |
|
185 <module name="RedundantModifier"> |
|
186 <property name="severity" value="error"/> |
|
187 </module> |
|
188 |
|
189 |
|
190 <!-- Checks for blocks. You know, those {}'s --> |
|
191 <!-- See http://checkstyle.sf.net/config_blocks.html --> |
|
192 <module name="AvoidNestedBlocks"/> |
|
193 <module name="EmptyBlock"/> |
|
194 <module name="LeftCurly"> |
|
195 <property name="severity" value="error"/> |
|
196 </module> |
|
197 <module name="RightCurly"> |
|
198 <property name="severity" value="error"/> |
|
199 </module> |
|
200 <!-- |
|
201 <module name="NeedBraces"/> |
|
202 --> |
|
203 |
|
204 <!-- Check for annotations |
|
205 http://checkstyle.sourceforge.net/config_annotation.html#MissingDeprecated |
|
206 --> |
|
207 <module name="AnnotationUseStyle"> |
|
208 <property name="severity" value="error"/> |
|
209 </module> |
|
210 <module name="MissingDeprecated"> |
|
211 <property name="severity" value="error"/> |
|
212 </module> |
|
213 <module name="MissingOverride"> |
|
214 <property name="severity" value="error"/> |
|
215 </module> |
|
216 |
|
217 <!-- Checks for common coding problems --> |
|
218 <!-- See http://checkstyle.sf.net/config_coding.html --> |
|
219 <module name="CovariantEquals"/> |
|
220 <module name="AvoidInlineConditionals"/> |
|
221 <module name="InnerAssignment" /> |
|
222 <module name="DoubleCheckedLocking"/> <!-- MY FAVOURITE --> |
|
223 <module name="EmptyStatement"/> |
|
224 <module name="EqualsHashCode"> |
|
225 <property name="severity" value="error"/> |
|
226 </module> |
|
227 <module name="HiddenField"> |
|
228 <property name="ignoreConstructorParameter" value="true"/> |
|
229 <property name="ignoreAbstractMethods" value="true"/> |
|
230 <property name="ignoreSetter" value="true"/> |
|
231 </module> |
|
232 <module name="IllegalInstantiation"/> |
|
233 <module name="InnerAssignment"> |
|
234 <property name="severity" value="error"/> |
|
235 </module> |
|
236 <module name="MagicNumber"/> |
|
237 <module name="MissingSwitchDefault"> |
|
238 <property name="severity" value="error"/> |
|
239 </module> |
|
240 <module name="RedundantThrows"/> |
|
241 <module name="SimplifyBooleanExpression"> |
|
242 <property name="severity" value="error"/> |
|
243 </module> |
|
244 <module name="SimplifyBooleanReturn"> |
|
245 <property name="severity" value="error"/> |
|
246 </module> |
|
247 <module name="StringLiteralEquality"> |
|
248 <property name="severity" value="error"/> |
|
249 </module> |
|
250 <module name="IllegalCatch"/> |
|
251 <module name="IllegalThrows"/> |
|
252 <module name="IllegalType"/> |
|
253 <module name="PackageDeclaration"/> |
|
254 <module name="JUnitTestCase"/> |
|
255 <module name="DeclarationOrder"> |
|
256 <property name="severity" value="error"/> |
|
257 </module> |
|
258 <module name="ExplicitInitialization"/> |
|
259 <module name="DefaultComesLast"/> |
|
260 <module name="MissingCtor"/> |
|
261 <module name="FallThrough"/> |
|
262 <module name="MultipleStringLiterals"> |
|
263 <property name="allowedDuplicates" value="2"/> |
|
264 </module> |
|
265 <module name="MultipleVariableDeclarations"/> |
|
266 <module name="UnnecessaryParentheses"/> |
|
267 <module name="ParameterAssignment"/> |
|
268 <module name="EqualsAvoidNull"> |
|
269 <property name="severity" value="error"/> |
|
270 </module> |
|
271 <module name="NoClone"/> |
|
272 <module name="NoFinalizer"/> |
|
273 <module name="SuperClone"/> |
|
274 <module name="SuperFinalize"/> |
|
275 <module name="ModifiedControlVariable"> |
|
276 <property name="severity" value="error"/> |
|
277 </module> |
|
278 <module name="ReturnCount"> |
|
279 <property name="max" value="3"/> |
|
280 </module> |
|
281 |
|
282 <!-- Checks for class design --> |
|
283 <!-- See http://checkstyle.sf.net/config_design.html --> |
|
284 <!-- |
|
285 <module name="DesignForExtension"/> |
|
286 --> |
|
287 <module name="FinalClass"/> |
|
288 <module name="HideUtilityClassConstructor"/> |
|
289 <!-- |
|
290 <module name="InterfaceIsType"/> |
|
291 --> |
|
292 <module name="VisibilityModifier"/> |
|
293 <module name="MutableException"/> |
|
294 <module name="ThrowsCount"> |
|
295 <property name="max" value="2" /> |
|
296 </module> |
|
297 |
|
298 |
|
299 <!-- Miscellaneous other checks. --> |
|
300 <!-- See http://checkstyle.sf.net/config_misc.html --> |
|
301 <module name="ArrayTypeStyle"/> |
|
302 <module name="FinalParameters"> |
|
303 <property name="tokens" value="CTOR_DEF"/> |
|
304 </module> |
|
305 <module name="Indentation"/> |
|
306 |
|
307 <module name="TodoComment"/> |
|
308 <module name="UpperEll"/> |
|
309 |
|
310 <module name="BooleanExpressionComplexity"/> |
|
311 <module name="UpperEll"/> |
|
312 |
|
313 <module name="ArrayTypeStyle"/> |
|
314 |
|
315 </module> |
|
316 |
|
317 </module> |
|