checkstyle.xml 9.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210
  1. <?xml version="1.0"?>
  2. <!DOCTYPE module PUBLIC
  3. "-//Puppy Crawl//DTD Check Configuration 1.3//EN"
  4. "http://www.puppycrawl.com/dtds/configuration_1_3.dtd">
  5. <module name="Checker">
  6. <!-- 检查文件是否以一个空行结束 -->
  7. <module name="NewlineAtEndOfFile"/>
  8. <!-- 文件长度不超过1500行 -->
  9. <module name="FileLength">
  10. <property name="max" value="1500"/>
  11. </module>
  12. <!-- 每个java文件一个语法树 -->
  13. <module name="TreeWalker">
  14. <!-- import检查-->
  15. <!-- 避免使用* -->
  16. <module name="AvoidStarImport">
  17. <property name="excludes" value="java.io,java.net,java.lang.Math"/>
  18. <!-- 实例;import java.util.*;.-->
  19. <property name="allowClassImports" value="false"/>
  20. <!-- 实例 ;import static org.junit.Assert.*;-->
  21. <property name="allowStaticMemberImports" value="true"/>
  22. </module>
  23. <!-- 检查是否从非法的包中导入了类 -->
  24. <module name="IllegalImport"/>
  25. <!-- 检查是否导入了多余的包 -->
  26. <module name="RedundantImport"/>
  27. <!-- 没用的import检查,比如:1.没有被用到2.重复的3.import java.lang的4.import 与该类在同一个package的 -->
  28. <module name="UnusedImports" />
  29. <!-- 注释检查 -->
  30. <!-- 检查方法和构造函数的javadoc -->
  31. <module name="JavadocType">
  32. <property name="allowUnknownTags" value="true"/>
  33. <message key="javadoc.missing" value="类注释:缺少Javadoc注释。"/>
  34. </module>
  35. <module name="JavadocMethod">
  36. <property name="tokens" value="METHOD_DEF" />
  37. <!--允许get set 方法没有注释-->
  38. <property name="allowMissingPropertyJavadoc" value="true"/>
  39. <message key="javadoc.missing" value="方法注释:缺少Javadoc注释。"/>
  40. </module>
  41. <!-- 命名检查 -->
  42. <!-- 局部的final变量,包括catch中的参数的检查 -->
  43. <module name="LocalFinalVariableName" />
  44. <!-- 局部的非final型的变量,包括catch中的参数的检查 -->
  45. <module name="LocalVariableName" />
  46. <!-- 包名的检查(只允许小写字母),默认^[a-z]+(\.[a-zA-Z_][a-zA-Z_0-9_]*)*$ -->
  47. <module name="PackageName">
  48. <property name="format" value="^[a-z]+(\.[a-z][a-z0-9]*)*$" />
  49. <message key="name.invalidPattern" value="包名 ''{0}'' 要符合 ''{1}''格式."/>
  50. </module>
  51. <!-- 仅仅是static型的变量(不包括static final型)的检查 -->
  52. <module name="StaticVariableName" />
  53. <!-- Class或Interface名检查,默认^[A-Z][a-zA-Z0-9]*$-->
  54. <module name="TypeName">
  55. <property name="severity" value="warning"/>
  56. <message key="name.invalidPattern" value="名称 ''{0}'' 要符合 ''{1}''格式."/>
  57. </module>
  58. <!-- 非static型变量的检查 -->
  59. <module name="MemberName" />
  60. <!-- 方法名的检查 -->
  61. <module name="MethodName" />
  62. <!-- 方法的参数名 -->
  63. <module name="ParameterName " />
  64. <!-- 常量名的检查(只允许大写),默认^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$ -->
  65. <module name="ConstantName" />
  66. <!-- 定义检查 -->
  67. <!-- 检查数组类型定义的样式 -->
  68. <module name="ArrayTypeStyle"/>
  69. <!-- 检查long型定义是否有大写的“L” -->
  70. <module name="UpperEll"/>
  71. <!-- 长度检查 -->
  72. <!-- 每行不超过120个字符-->
  73. <module name="LineLength">
  74. <property name="max" value="150" />
  75. </module>
  76. <!-- 方法不超过50行 -->
  77. <module name="MethodLength">
  78. <property name="tokens" value="METHOD_DEF" />
  79. <property name="max" value="160" />
  80. </module>
  81. <!-- 方法的参数个数不超过5个。 并且不对构造方法进行检查-->
  82. <module name="ParameterNumber">
  83. <property name="max" value="5" />
  84. <property name="ignoreOverriddenMethods" value="true"/>
  85. <property name="tokens" value="METHOD_DEF" />
  86. </module>
  87. <!-- 空格检查-->
  88. <!-- 方法名后跟左圆括号"(" -->
  89. <module name="MethodParamPad" />
  90. <!-- 在类型转换时,不允许左圆括号右边有空格,也不允许与右圆括号左边有空格 -->
  91. <module name="TypecastParenPad" />
  92. <!-- 检查在某个特定关键字之后应保留空格 -->
  93. <module name="NoWhitespaceAfter"/>
  94. <!-- 检查在某个特定关键字之前应保留空格 -->
  95. <module name="NoWhitespaceBefore"/>
  96. <!-- 操作符换行策略检查 -->
  97. <module name="OperatorWrap"/>
  98. <!-- 圆括号空白 -->
  99. <module name="ParenPad"/>
  100. <!-- 检查分隔符是否在空白之后 -->
  101. <module name="WhitespaceAfter"/>
  102. <!-- 检查分隔符周围是否有空白 -->
  103. <module name="WhitespaceAround"/>
  104. <!-- 修饰符检查 -->
  105. <!-- 检查修饰符的顺序是否遵照java语言规范,默认public、protected、private、abstract、static、final、transient、volatile、synchronized、native、strictfp -->
  106. <module name="ModifierOrder"/>
  107. <!-- 检查接口和annotation中是否有多余修饰符,如接口方法不必使用public -->
  108. <module name="RedundantModifier"/>
  109. <!-- 代码块检查 -->
  110. <!-- 检查是否有嵌套代码块 -->
  111. <module name="AvoidNestedBlocks"/>
  112. <!-- 检查是否有空代码块 -->
  113. <module name="EmptyBlock"/>
  114. <!-- 检查左大括号位置 -->
  115. <module name="LeftCurly"/>
  116. <!-- 检查代码块是否缺失{} -->
  117. <module name="NeedBraces"/>
  118. <!-- 检查右大括号位置 -->
  119. <module name="RightCurly"/>
  120. <!-- 代码检查 -->
  121. <!-- 检查空的代码段 -->
  122. <module name="EmptyStatement"/>
  123. <!-- 检查在重写了equals方法后是否重写了hashCode方法 -->
  124. <module name="EqualsHashCode"/>
  125. <!-- 检查局部变量或参数是否隐藏了类中的变量 -->
  126. <module name="HiddenField">
  127. <property name="tokens" value="VARIABLE_DEF"/>
  128. </module>
  129. <!-- 检查是否使用工厂方法实例化 -->
  130. <module name="IllegalInstantiation"/>
  131. <!-- 检查子表达式中是否有赋值操作 -->
  132. <module name="InnerAssignment"/>
  133. <!-- 检查是否有"魔术"数字 -->
  134. <module name="MagicNumber">
  135. <property name="ignoreNumbers" value="0, 1"/>
  136. <property name="ignoreAnnotation" value="true"/>
  137. </module>
  138. <!-- 检查switch语句是否有default -->
  139. <module name="MissingSwitchDefault"/>
  140. <!-- 检查是否有过度复杂的布尔表达式 -->
  141. <module name="SimplifyBooleanExpression"/>
  142. <!-- 检查是否有过于复杂的布尔返回代码段 -->
  143. <module name="SimplifyBooleanReturn"/>
  144. <!-- 类设计检查 -->
  145. <!-- 检查类是否为扩展设计l -->
  146. <!-- 检查只有private构造函数的类是否声明为final -->
  147. <module name="FinalClass"/>
  148. <!-- 检查工具类是否有putblic的构造器 -->
  149. <module name="HideUtilityClassConstructor"/>
  150. <!-- 检查接口是否仅定义类型 -->
  151. <module name="InterfaceIsType"/>
  152. <!-- 检查类成员的可见度 检查类成员的可见性。只有static final 成员是public的
  153. 除非在本检查的protectedAllowed和packagedAllowed属性中进行了设置-->
  154. <module name="VisibilityModifier">
  155. <property name="packageAllowed" value="true"/>
  156. <property name="protectedAllowed" value="true"/>
  157. </module>
  158. <!-- 语法 -->
  159. <!-- String的比较不能用!= 和 == -->
  160. <module name="StringLiteralEquality"/>
  161. <!-- 限制for循环最多嵌套2层 -->
  162. <module name="NestedForDepth">
  163. <property name="max" value="2"/>
  164. </module>
  165. <!-- if最多嵌套3层 -->
  166. <module name="NestedIfDepth">
  167. <property name="max" value="3"/>
  168. </module>
  169. <!-- 检查未被注释的main方法,排除以Appllication结尾命名的类 -->
  170. <module name="UncommentedMain">
  171. <property name="excludedClasses" value=".*Application$"/>
  172. </module>
  173. <!-- 禁止使用System.out.println -->
  174. <module name="Regexp">
  175. <property name="format" value="System\.out\.println"/>
  176. <property name="illegalPattern" value="true"/>
  177. </module>
  178. <!-- return个数 3个-->
  179. <module name="ReturnCount">
  180. <property name="max" value="3"/>
  181. </module>
  182. <!--try catch 异常处理数量 3-->
  183. <module name="NestedTryDepth ">
  184. <property name="max" value="3"/>
  185. </module>
  186. <!-- clone方法必须调用了super.clone() -->
  187. <module name="SuperClone" />
  188. <!-- finalize 必须调用了super.finalize() -->
  189. <module name="SuperFinalize" />
  190. </module>
  191. </module>