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 <!-- This rules is desactivated because it is too stupid. |
|
82 It also compare the Header of the file. |
|
83 <module name="StrictDuplicateCode"> |
|
84 <property name="min" value="25" /> |
|
85 </module> |
|
86 --> |
|
87 |
|
88 <!-- Header file --> |
|
89 <module name="RegexpHeader"> |
|
90 <property name="headerFile" value="tools/JavaHeaderCheck.regex"/> |
|
91 <property name="multiLines" value="5, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38"/> |
|
92 <property name="severity" value="error" /> |
|
93 </module> |
|
94 |
|
95 <module name="TreeWalker"> |
|
96 |
|
97 <!-- Checks for Javadoc comments. --> |
|
98 <!-- See http://checkstyle.sf.net/config_javadoc.html --> |
|
99 <module name="JavadocMethod"> |
|
100 <property name="allowUndeclaredRTE" value="true"/> |
|
101 <property name="severity" value="error"/> |
|
102 </module> |
|
103 <module name="JavadocType"> |
|
104 <property name="severity" value="error"/> |
|
105 </module> |
|
106 <module name="JavadocVariable"> |
|
107 <property name="scope" value="package" /> |
|
108 <property name="severity" value="error"/> |
|
109 </module> |
|
110 <module name="JavadocStyle"> |
|
111 <property name="checkEmptyJavadoc" value="true"/> |
|
112 <property name="severity" value="error"/> |
|
113 </module> |
|
114 |
|
115 |
|
116 <!-- Checks for Naming Conventions. --> |
|
117 <!-- See http://checkstyle.sf.net/config_naming.html --> |
|
118 <module name="ConstantName"/> |
|
119 <module name="LocalFinalVariableName"/> |
|
120 <module name="LocalVariableName"/> |
|
121 <module name="MemberName"> |
|
122 <property name="format" value="^m[A-Z][a-zA-Z0-9]*$"/> |
|
123 <property name="severity" value="error"/> |
|
124 </module> |
|
125 <module name="MethodName"/> |
|
126 <module name="PackageName"/> |
|
127 <module name="ParameterName"/> |
|
128 <module name="StaticVariableName"/> |
|
129 <module name="TypeName"/> |
|
130 |
|
131 |
|
132 <!-- Checks for Headers --> |
|
133 <!-- See http://checkstyle.sf.net/config_header.html --> |
|
134 <!-- <module name="Header"> --> |
|
135 <!-- The follow property value demonstrates the ability --> |
|
136 <!-- to have access to ANT properties. In this case it uses --> |
|
137 <!-- the ${basedir} property to allow Checkstyle to be run --> |
|
138 <!-- from any directory within a project. See property --> |
|
139 <!-- expansion, --> |
|
140 <!-- http://checkstyle.sf.net/config.html#properties --> |
|
141 <!-- <property --> |
|
142 <!-- name="headerFile" --> |
|
143 <!-- value="${basedir}/java.header"/> --> |
|
144 <!-- </module> --> |
|
145 |
|
146 <!-- Checks for imports --> |
|
147 <!-- See http://checkstyle.sf.net/config_import.html --> |
|
148 <module name="AvoidStarImport"/> |
|
149 <module name="IllegalImport"/> <!-- defaults to sun.* packages --> |
|
150 <module name="RedundantImport"/> |
|
151 <module name="UnusedImports"> |
|
152 <property name="severity" value="error"/> |
|
153 </module> |
|
154 <module name="AvoidStaticImport"> |
|
155 <property name="excludes" value="*"/> |
|
156 </module> |
|
157 |
|
158 |
|
159 <!-- Checks for Size Violations. --> |
|
160 <!-- See http://checkstyle.sf.net/config_sizes.html --> |
|
161 <module name="LineLength"> |
|
162 <property name="max" value="120" /> |
|
163 </module> |
|
164 <module name="MethodLength"/> |
|
165 <module name="ParameterNumber"/> |
|
166 <module name="AnonInnerLength"> |
|
167 <property name="max" value="60" /> |
|
168 </module> |
|
169 |
|
170 |
|
171 <!-- Checks for whitespace --> |
|
172 <!-- See http://checkstyle.sf.net/config_whitespace.html --> |
|
173 <module name="EmptyForIteratorPad"/> |
|
174 <module name="GenericWhitespace"> |
|
175 <property name="severity" value="error"/> |
|
176 </module> |
|
177 <module name="MethodParamPad"> |
|
178 <property name="severity" value="error"/> |
|
179 </module> |
|
180 <module name="NoWhitespaceAfter"> |
|
181 <property name="severity" value="error"/> |
|
182 </module> |
|
183 <module name="NoWhitespaceBefore"> |
|
184 <property name="severity" value="error"/> |
|
185 </module> |
|
186 <module name="OperatorWrap"/> |
|
187 <module name="ParenPad"> |
|
188 <property name="severity" value="error"/> |
|
189 </module> |
|
190 <module name="TypecastParenPad"> |
|
191 <property name="severity" value="error"/> |
|
192 </module> |
|
193 <!-- We want mixed tabulation |
|
194 <module name="TabCharacter"/> |
|
195 --> |
|
196 <module name="WhitespaceAfter"> |
|
197 <property name="severity" value="error"/> |
|
198 </module> |
|
199 <module name="WhitespaceAround"> |
|
200 <property name="severity" value="error"/> |
|
201 </module> |
|
202 |
|
203 |
|
204 <!-- Modifier Checks --> |
|
205 <!-- See http://checkstyle.sf.net/config_modifiers.html --> |
|
206 <module name="ModifierOrder"> |
|
207 <property name="severity" value="error"/> |
|
208 </module> |
|
209 <module name="RedundantModifier"> |
|
210 <property name="severity" value="error"/> |
|
211 </module> |
|
212 |
|
213 |
|
214 <!-- Checks for blocks. You know, those {}'s --> |
|
215 <!-- See http://checkstyle.sf.net/config_blocks.html --> |
|
216 <module name="AvoidNestedBlocks"/> |
|
217 <module name="EmptyBlock"/> |
|
218 <module name="LeftCurly"> |
|
219 <property name="severity" value="error"/> |
|
220 </module> |
|
221 <module name="RightCurly"> |
|
222 <property name="severity" value="error"/> |
|
223 </module> |
|
224 <!-- |
|
225 <module name="NeedBraces"/> |
|
226 --> |
|
227 |
|
228 <!-- Check for annotations |
|
229 http://checkstyle.sourceforge.net/config_annotation.html#MissingDeprecated |
|
230 --> |
|
231 <module name="AnnotationUseStyle"> |
|
232 <property name="severity" value="error"/> |
|
233 </module> |
|
234 <module name="MissingDeprecated"> |
|
235 <property name="severity" value="error"/> |
|
236 </module> |
|
237 <module name="MissingOverride"> |
|
238 <property name="severity" value="error"/> |
|
239 </module> |
|
240 |
|
241 <!-- Checks for common coding problems --> |
|
242 <!-- See http://checkstyle.sf.net/config_coding.html --> |
|
243 <module name="CovariantEquals"/> |
|
244 <module name="AvoidInlineConditionals"/> |
|
245 <module name="InnerAssignment" /> |
|
246 <module name="DoubleCheckedLocking"/> <!-- MY FAVOURITE --> |
|
247 <module name="EmptyStatement"/> |
|
248 <module name="EqualsHashCode"> |
|
249 <property name="severity" value="error"/> |
|
250 </module> |
|
251 <module name="HiddenField"> |
|
252 <property name="ignoreConstructorParameter" value="true"/> |
|
253 <property name="ignoreAbstractMethods" value="true"/> |
|
254 <property name="ignoreSetter" value="true"/> |
|
255 </module> |
|
256 <module name="IllegalInstantiation"/> |
|
257 <module name="InnerAssignment"> |
|
258 <property name="severity" value="error"/> |
|
259 </module> |
|
260 <module name="MagicNumber"/> |
|
261 <module name="MissingSwitchDefault"> |
|
262 <property name="severity" value="error"/> |
|
263 </module> |
|
264 <module name="RedundantThrows"/> |
|
265 <module name="SimplifyBooleanExpression"> |
|
266 <property name="severity" value="error"/> |
|
267 </module> |
|
268 <module name="SimplifyBooleanReturn"> |
|
269 <property name="severity" value="error"/> |
|
270 </module> |
|
271 <module name="StringLiteralEquality"> |
|
272 <property name="severity" value="error"/> |
|
273 </module> |
|
274 <module name="IllegalCatch"/> |
|
275 <module name="IllegalThrows"/> |
|
276 <module name="IllegalType"/> |
|
277 <module name="PackageDeclaration"/> |
|
278 <module name="JUnitTestCase"/> |
|
279 <module name="DeclarationOrder"> |
|
280 <property name="severity" value="error"/> |
|
281 </module> |
|
282 <module name="ExplicitInitialization"/> |
|
283 <module name="DefaultComesLast"/> |
|
284 <module name="MissingCtor"/> |
|
285 <module name="FallThrough"/> |
|
286 <module name="MultipleStringLiterals"> |
|
287 <property name="allowedDuplicates" value="2"/> |
|
288 </module> |
|
289 <module name="MultipleVariableDeclarations"/> |
|
290 <module name="UnnecessaryParentheses"/> |
|
291 <module name="ParameterAssignment"/> |
|
292 <module name="EqualsAvoidNull"> |
|
293 <property name="severity" value="error"/> |
|
294 </module> |
|
295 <module name="NoClone"/> |
|
296 <module name="NoFinalizer"/> |
|
297 <module name="SuperClone"/> |
|
298 <module name="SuperFinalize"/> |
|
299 <module name="ModifiedControlVariable"> |
|
300 <property name="severity" value="error"/> |
|
301 </module> |
|
302 <module name="ReturnCount"> |
|
303 <property name="max" value="3"/> |
|
304 </module> |
|
305 |
|
306 <!-- Checks for class design --> |
|
307 <!-- See http://checkstyle.sf.net/config_design.html --> |
|
308 <!-- |
|
309 <module name="DesignForExtension"/> |
|
310 --> |
|
311 <module name="FinalClass"/> |
|
312 <module name="HideUtilityClassConstructor"/> |
|
313 <!-- |
|
314 <module name="InterfaceIsType"/> |
|
315 --> |
|
316 <module name="VisibilityModifier"/> |
|
317 <module name="MutableException"/> |
|
318 <module name="ThrowsCount"> |
|
319 <property name="max" value="2" /> |
|
320 </module> |
|
321 |
|
322 |
|
323 <!-- Miscellaneous other checks. --> |
|
324 <!-- See http://checkstyle.sf.net/config_misc.html --> |
|
325 <module name="ArrayTypeStyle"/> |
|
326 <module name="FinalParameters"> |
|
327 <property name="tokens" value="CTOR_DEF"/> |
|
328 </module> |
|
329 <module name="Indentation"/> |
|
330 |
|
331 <module name="TodoComment"/> |
|
332 <module name="UpperEll"/> |
|
333 |
|
334 <module name="BooleanExpressionComplexity"/> |
|
335 <module name="UpperEll"/> |
|
336 |
|
337 <module name="ArrayTypeStyle"/> |
|
338 |
|
339 </module> |
|
340 |
|
341 </module> |
|