<?xml version="1.0"?>
<!--
~ Licensed to the Apache Software Foundation (ASF) under one or more
~ contributor license agreements. See the NOTICE file distributed with
~ this work for additional information regarding copyright ownership.
~ The ASF licenses this file to You under the Apache License, Version 2.0
~ (the "License"); you may not use this file except in compliance with
~ the License. You may obtain a copy of the License at
~
~ http://www.apache.org/licenses/LICENSE-2.0
~
~ Unless required by applicable law or agreed to in writing, software
~ distributed under the License is distributed on an "AS IS" BASIS,
~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
~ See the License for the specific language governing permissions and
~ limitations under the License.
-->
<!--配置详解参考 https://checkstyle.sourceforge.io/config_coding.html -->
<!DOCTYPE module PUBLIC "-//Puppy Crawl//DTD Check Configuration 1.3//EN"
"http://checkstyle.sourceforge.net/dtds/configuration_1_3.dtd">
<module name="Checker">
<property name="charset" value="UTF-8"/>
<property name="severity" value="error"/>
<property name="fileExtensions" value="java, properties, xml"/>
<module name="Header">
<!-- 指定要处理的文件的文件类型扩展名为java。 -->
<property name="fileExtensions" value="java"/>
</module>
<!-- 检查文件中是否含有'\t' -->
<module name="FileTabCharacter">
<property name="eachLine" value="true"/>
</module>
<!-- 文件长度不超过1500行 -->
<module name="FileLength">
<property name="max" value="1500"/>
</module>
<!-- 检查文件是否以一个\n结束 -->
<module name="NewlineAtEndOfFile">
<property name="lineSeparator" value="lf"/>
</module>
<!-- 检查property文件中是否有相同的key -->
<module name="Translation"/>
<module name="UniqueProperties"/>
<module name="SeverityMatchFilter"/>
<!-- 每个java文件一个语法树 -->
<module name="TreeWalker">
<!-- 命名规范 -->
<!-- 包名的检查（只允许小写字母），默认^[a-z]+(\.[a-zA-Z_][a-zA-Z_0-9_]*)*$ -->
<module name="PackageName">
<property name="format" value="^[a-z]+(\.[a-z][a-z0-9]*)*$"/>
<message key="name.invalidPattern" value="包名 ''{0}'' 要符合 ''{1}''格式."/>
</module>
<!-- Class或Interface名检查，默认^[A-Z][a-zA-Z0-9]*$-->
<module name="TypeName">
<property name="severity" value="warning"/>
<message key="name.invalidPattern" value="名称 ''{0}'' 要符合 ''{1}''格式."/>
</module>
<!-- 检查方法名称是否符合指定的模式，默认"^[a-z][a-zA-Z0-9]*$" -->
<module name="MethodName"/>
<!-- 检查接口类型参数名是否符合指定的模式，默认"^[A-Z]$" -->
<module name="InterfaceTypeParameterName"/>
<!-- 检查类类型参数名是否符合指定的模式，默认"^[A-Z]$" -->
<module name="ClassTypeParameterName"/>
<!-- 检查方法类型参数名称是否符合指定的模式，默认"^[A-Z]$"-->
<module name="MethodTypeParameterName"/>
<!-- 检查常量名称是否符合指定的模式，默认"^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$" -->
<module name="ConstantName"/>
<!-- 检查静态的非final变量名是否符合指定的模式，默认"^[a-z][a-zA-Z0-9]*$" -->
<module name="StaticVariableName"/>
<!-- 检查实例变量名称是否符合指定的模式，默认"^[a-z][a-zA-Z0-9]*$" -->
<module name="MemberName"/>
<!-- 检查局部的非final变量名是否符合指定的模式。catch参数被认为是一个局部变量，默认"^[a-z][a-zA-Z0-9]*$" -->
<module name="LocalVariableName"/>
<!-- 检查局部final变量名称是否符合指定的模式。try语句中的catch参数和资源被认为是局部的、最终的变量，默认"^[a-z][a-zA-Z0-9]*$"-->
<module name="LocalFinalVariableName"/>
<!-- 检查方法参数名称是否符合指定的模式，默认"^[a-z][a-zA-Z0-9]*$" -->
<module name="ParameterName"/>
<!-- 检查catch参数名是否符合指定的模式，默认"^(e|t|ex|[a-z][a-z][a-zA-Z]+)$" -->
<module name="CatchParameterName"/>
<!-- 验证标识符名称中的缩写(连续大写字母)长度。-->
<module name="AbbreviationAsWordInName">
<!-- 指出目标标识符(类、接口、变量和方法名称中的缩写，等等)中允许连续大写字母的数量。 -->
<property name="allowedAbbreviationLength" value="6"/>
</module>
<!-- 长度检查 -->
<!-- 检查长匿名内部类长度，默认最大20 -->
<module name="AnonInnerLength"/>
<!-- 检查长方法和构造函数，默认最大150 -->
<module name="MethodLength"/>
<!-- 每行不超过200个字符 -->
<module name="LineLength">
<property name="max" value="200"/>
</module>
<!-- 检查在文件的外部(或根)级别声明的类型的数量,默认最大1 -->
<module name="OuterTypeNumber"/>
<!-- 检查初始化式的空白填充。默认非空 -->
<module name="EmptyForInitializerPad"/>
<!-- 检查迭代器的空填充，默认非空 -->
<module name="EmptyForIteratorPad"/>
<!-- 检查方法定义、构造函数定义、方法调用或构造函数调用的标识符之间的填充;以及参数列表的左括号。
也就是说，如果标识符和左括号在同一行，检查标识符后面是否需要空格，或者这样的空格是禁止的。
如果它们不在同一行上，报告违规，除非配置为允许换行。要允许在标识符之后换行，将属性allowLineBreaks设置为true。 -->
<module name="MethodParamPad"/>
<!-- 检查圆括号内填充的策略;也就是左括号和右括号之前是否需要空格，默认非空格 -->
<module name="ParenPad"/>
<!-- 在类型转换时，不允许左圆括号右边有空格，也不允许与右圆括号左边有空格 -->
<module name="TypecastParenPad"/>
<!-- 检查所选语句是否没有行换行。默认情况下，此检查限制包装import和package语句，但是可以检查任何语句。 -->
<module name="NoLineWrap"/>
<!-- 检查如何在操作符上换行的策略。默认nl -->
<module name="OperatorWrap"/>
<!-- 用分隔符检查行包装。 -->
<module name="SeparatorWrap">
<property name="id" value="SeparatorWrapDot"/>
<property name="tokens" value="DOT"/>
<property name="option" value="nl"/>
</module>
<module name="SeparatorWrap">
<property name="id" value="SeparatorWrapComma"/>
<property name="tokens" value="COMMA"/>
<property name="option" value="EOL"/>
</module>
<module name="SeparatorWrap">
<property name="id" value="SeparatorWrapEllipsis"/>
<property name="tokens" value="ELLIPSIS"/>
<property name="option" value="EOL"/>
</module>
<module name="SeparatorWrap">
<property name="id" value="SeparatorWrapArrayDeclarator"/>
<property name="tokens" value="ARRAY_DECLARATOR"/>
<property name="option" value="EOL"/>
</module>
<module name="SeparatorWrap">
<property name="id" value="SeparatorWrapMethodRef"/>
<property name="tokens" value="METHOD_REF"/>
<property name="option" value="nl"/>
</module>
<!-- 检查通用标记周围的空格(尖括号)"<"和">"是正确的典型约定。该约定是不可配置的。 -->
<module name="GenericWhitespace"/>
<!-- 检查标记之前是否有空格。更具体地说，它检查前面是否有空格，或者(如果允许换行)前面的所有字符都是空格。 -->
<module name="NoWhitespaceBefore"/>
<!-- 检查标记后是否有空格。更具体地说，它检查后面是否有空格，或者(如果允许换行)后面的行中的所有字符都是空格。 -->
<module name="NoWhitespaceAfter"/>
<!-- 检查标记是否被空格包围。空构造函数，方法，类，枚举，接口，循环体(块)，形式的lambdas -->
<module name="WhitespaceAround"/>
<!-- 检查标记后面是否有空格，但不检查空迭代器的分号后面是否有空格。 -->
<module name="WhitespaceAfter"/>
<!-- 检查非空白字符之间的空格不能超过一个。 -->
<module name="SingleSpaceSeparator"/>
<!-- 检查头、包、所有导入声明、字段、构造函数、方法、嵌套类、静态初始化器和实例初始化器之后的空行分隔符。 -->
<module name="EmptyLineSeparator">
<!-- 允许在类成员之间有多个空行，默认true，此处为false-->
<property name="allowMultipleEmptyLines" value="false"/>
<!-- 允许在类成员中有多个空行,默认true，此处为false-->
<property name="allowMultipleEmptyLinesInsideClassMembers" value="false"/>
</module>
<!-- import检查-->
<!-- 避免使用* -->
<module name="AvoidStarImport"/>
<!-- 避免使用静态导入 -->
<module name="AvoidStaticImport">
<property name="excludes"
value="org.junit.Assert.*,org.hamcrest.CoreMatchers.*,org.mockito.Mockito.*,org.mockito.ArgumentMatchers.*"/>
</module>
<!-- 检查是否从非法的包中导入了类 -->
<module name="IllegalImport"/>
<!-- 检查冗余的导入语句。-->
<module name="RedundantImport"/>
<!-- 没用的import检查，比如：1.没有被用到2.重复的3.import java.lang的4.import 与该类在同一个package的 -->
<module name="UnusedImports"/>
<!-- 检查导入声明组是否按用户指定的顺序出现。如果有一个导入，但是在配置中没有指定它的组，那么这个导入应该放在导入列表的末尾。-->
<module name="CustomImportOrder"/>
<!-- 检查语言元素上注解的位置。默认情况下，检查强制以在文档块之后和目标元素之前定位注解，注解应该位于与目标元素分开的行中。如果注解不在同一行上，该检查还将验证注解是否与注释元素处于同一缩进级别。-->
<module name="AnnotationLocation">
<property name="id" value="AnnotationLocationMostCases"/>
<property name="tokens" value="CLASS_DEF, INTERFACE_DEF, ENUM_DEF, METHOD_DEF, CTOR_DEF"/>
</module>
<module name="AnnotationLocation">
<property name="id" value="AnnotationLocationVariables"/>
<property name="tokens" value="VARIABLE_DEF"/>
<!-- 允许注解与目标元素位于同一行。 -->
<property name="allowSamelineMultipleAnnotations" value="true"/>
</module>
<!-- 检查注释中元素的样式。-->
<module name="AnnotationUseStyle"/>
<!-- 验证当@inheritDoc javadoc标记存在时是否存在@Override注释。 -->
<module name="MissingOverride"/>
<!-- 允许指定@SuppressWarnings不允许抑制哪些警告。您还可以指定一个tokenttype列表，配置的警告不能被抑制。-->
<module name="SuppressWarnings"/>
<!-- 验证注释@Deprecated和Javadoc标记@Deprecated是否同时存在。 -->
<module name="MissingDeprecated"/>
<!-- 维护一组来自@SuppressWarnings注释的检查抑制。它允许防止Checkstyle报告来自注释为@SuppressWarnings的代码部分的违规，并使用被排除的检查名称。还可以为需要抑制的检查名称定义别名。-->
<module name="SuppressWarningsHolder"/>
<!-- 修饰符检查 -->
<!-- 检查修饰符的顺序是否遵照java语言规范，默认public、protected、private、abstract、default、static、final、transient、volatile、synchronized、native、strictfp -->
<module name="ModifierOrder"/>
<!-- 检查接口和annotation中是否有多余修饰符，如接口方法不必使用public -->
<module name="RedundantModifier"/>
<!-- Coding -->
<!-- 检查数组初始化是否包含末尾逗号。 -->
<module name="ArrayTrailingComma"/>
<!-- 检查类是否覆盖了equals(java.lang.Object)。 -->
<module name="CovariantEquals"/>
<!-- 检查default是否在switch语句中的所有case之后。 -->
<module name="DefaultComesLast"/>
<!-- 检查类、记录或接口声明的各个部分是否按照Java编程语言的代码约定建议的顺序出现。-->
<module name="DeclarationOrder"/>
<!-- 检查空的代码段 -->
<module name="EmptyStatement"/>
<!-- 检查字符串字面值的任何组合是否位于equals()比较的左侧。还检查分配给某些字段的字符串字面量(例如someString。= (anotherString =“文本”))。 -->
<module name="EqualsAvoidNull"/>
<!-- 检查任何类或对象成员的类型值是否显式初始化为默认值(对象引用为null，数值类型为0,boolean类型为char, false)。 -->
<module name="ExplicitInitialization"/>
<!-- 检查switch代码的case中是否缺少break，return，throw和continue。 -->
<module name="FallThrough"/>
<!-- 检查优先使用工厂方法的非法实例化。 -->
<module name="IllegalInstantiation"/>
<!-- 检查某些异常类型不会出现在catch语句中。 -->
<module name="IllegalCatch">
<!-- 指定要拒绝的异常类名。 -->
<property name="illegalClassNames" value="Error,Throwable,java.lang.Error,java.lang.Throwable"/>
</module>
<!-- 检查指定的类型是否声明为要抛出。声明一个方法会引发java.lang.Error或java.lang.RuntimeException几乎是不可接受的。 -->
<module name="IllegalThrows"/>
<!-- 检查特定的类或接口是否从未被使用。-->
<module name="IllegalType">
<!-- 方法、参数、变量-->
<property name="tokens" value="METHOD_DEF,PARAMETER_DEF,VARIABLE_DEF"/>
</module>
<!-- 检查非法的分隔符的下个字符。-->
<module name="IllegalTokenText">
<property name="tokens" value="STRING_LITERAL, CHAR_LITERAL"/>
<property name="format"
value="\\u00(09|0(a|A)|0(c|C)|0(d|D)|22|27|5(C|c))|\\(0(10|11|12|14|15|42|47)|134)"/>
<property name="message"
value="考虑使用特殊转义序列来代替八进制值或Unicode转义值."/>
</module>
<!-- 检查switch语句是否有default -->
<module name="MissingSwitchDefault"/>
<!-- 检查for循环控制变量是否在for块中被修改。-->
<module name="ModifiedControlVariable"/>
<!-- 检查每个变量声明是否在自己的语句中并在自己的行中。-->
<module name="MultipleVariableDeclarations"/>
<!-- 将嵌套的if-else块限制到指定的深度。 -->
<module name="NestedIfDepth">
<property name="max" value="3"/>
</module>
<!-- 将嵌套的try-catch-finally块限制到指定的深度。默认1 -->
<module name="NestedTryDepth"/>
<!-- 检查是否从Object 类中重写克隆方法。 -->
<module name="NoClone"/>
<!-- 检查没有带零个参数的方法finalize。 -->
<module name="NoFinalizer"/>
<!-- 检查覆盖的clone()方法是否调用super.clone()。不检查native方法，因为它们没有可能的java定义的实现。-->
<module name="SuperClone"/>
<!-- 检查覆盖的finalize()方法是否调用super.finalize()。不检查native方法，因为它们没有可能的java定义的实现。 -->
<module name="SuperFinalize"/>
<!-- 检查每行是否只有一条语句。-->
<module name="OneStatementPerLine"/>
<!-- 检查是否将重载方法分组在一起。重载的方法具有相同的名称但不同的签名，其中签名可以因输入参数的数量或输入参数的类型或两者的数量而不同。-->
<module name="OverloadMethodsDeclarationOrder"/>
<!-- 确保类有包声明，以及(可选的)包名是否与源文件的目录名匹配。-->
<module name="PackageDeclaration"/>
<!-- 禁止给参数赋值。-->
<module name="ParameterAssignment"/>
<!-- 检查过于复杂的布尔表达式。目前发现代码，如if (b == true)， b || true， !false，等等。-->
<module name="SimplifyBooleanExpression"/>
<!-- 检查过于复杂的布尔返回语句。 -->
<module name="SimplifyBooleanReturn"/>
<!-- 检查字符串字面值是否与==或!=一起使用。因为==将比较对象引用，而不是字符串的实际值，所以应该使用String.equals()。-->
<module name="StringLiteralEquality"/>
<!-- 检查语句或表达式中是否使用了不必要的括号。-->
<module name="UnnecessaryParentheses"/>
<!-- 检查变量声明与第一次使用之间的距离。注意:变量声明/初始化语句在计算长度时不被计算。-->
<module name="VariableDeclarationUsageDistance"/>
<!-- 代码块检查 -->
<!-- 检查空块。此检查不验证顺序块。 -->
<module name="EmptyBlock"/>
<!-- 检查空的catch块。默认情况下，check允许包含任何注释的空catch块。 -->
<module name="EmptyCatchBlock">
<!-- 如果需要异常的变量名，或者忽略，或者有任何注释，则配置检查来抑制空catch块-->
<property name="exceptionVariableName" value="expected|ignore"/>
</module>
<!-- 查找嵌套块(代码中自由使用的块)。 -->
<module name="AvoidNestedBlocks"/>
<!-- 检查代码块周围的括号。 -->
<module name="NeedBraces"/>
<!-- 检查左大括号位置 -->
<module name="LeftCurly"/>
<!-- 检查代码块的左花括号('{')位置。 -->
<module name="RightCurly"/>
<!-- 类设计检查 -->
<!-- 检查只有private构造函数的类是否声明为final -->
<module name="FinalClass"/>
<!-- cannot recognize for lombok @NoArgsConstructor(access = AccessLevel.PRIVATE), just ignore -->
<!--<module name="HideUtilityClassConstructor"/>-->
<!-- 检查每个顶级类、接口、枚举或注释是否驻留在自己的源文件中。-->
<module name="OneTopLevelClass"/>
<!-- 检查接口是否仅定义类型 -->
<module name="InterfaceIsType"/>
<!-- 嵌套的(内部的)类/接口在初始化和静态初始化块、方法、构造函数和字段声明之后，在主(顶级)类的底部声明。-->
<module name="InnerTypeLast"/>
<!-- 检查类成员的可见性。只有static final、不可变或由指定注释成员注释的才可以是public;除非设置了protectedAllowed或packageAllowed属性，否则其他类成员必须是私有的。-->
<module name="VisibilityModifier"/>
<!-- 确保异常类(名称与某些正则表达式一致的类以及名称与其他正则表达式一致的显式扩展类)是不可变的，也就是说，它们只有final字段。-->
<module name="MutableException"/>
<!-- 将抛出语句限制为指定的计数。带有"Override"或"java.lang.Override "的方法。从验证中跳过注释，因为当前类不能更改这些方法的签名。-->
<module name="ThrowsCount"/>
<!-- 定义检查 -->
<!-- 检查数组类型定义的样式 -->
<module name="ArrayTypeStyle"/>
<!-- 检查long型定义是否有大写的“L” -->
<module name="UpperEll"/>
<!-- 限制使用Unicode转义(例如/u221e)。允许对不可打印的控制字符使用转义。此外，可以将此检查配置为如果存在跟踪注释，则允许使用转义。通过这个选项，如果字面只包含转义，可以允许使用转义。-->
<module name="AvoidEscapedUnicodeCharacters"/>
<!-- 检查其他令牌下面的受限令牌。-->
<module name="DescendantToken"/>
<!-- 检查方法、构造函数、catch和for-each块的参数是否为final。没有检查接口、抽象和native方法:final关键字对于接口、抽象和native方法参数没有意义，因为没有代码可以修改参数。 -->
<!-- <module name="FinalParameters"/>-->
<!-- 检查Java代码的正确缩进。-->
<module name="Indentation"/>
<!-- 检查外部类型名称和文件名是否匹配。例如，类Foo必须在一个名为Foo.java的文件中。-->
<module name="OuterTypeFilename"/>
<!-- 检查TODO:注释。实际上，它是Java注释上的一个通用正则表达式匹配器。要检查Java注释中的其他模式，设置format属性。-->
<module name="TodoComment"/>
<!-- 检查以确保要求注释是一行上唯一的东西。-->
<module name="TrailingComment"/>
<!-- Javadoc Comments -->
<!-- 检查javadoc块标记或javadoc标记的顺序。-->
<module name="AtclauseOrder">
<property name="tagOrder" value="@param, @return, @throws, @deprecated"/>
</module>
<!-- 检查块标签后面是否有描述。-->
<module name="NonEmptyAtclauseDescription"/>
<!-- 检查Javadoc段落。-->
<module name="JavadocParagraph"/>
<!-- 验证Javadoc注释，以确保它们格式良好。 -->
<module name="JavadocStyle"/>
<!-- 检查块标记中延续行的缩进。-->
<module name="JavadocTagContinuationIndentation"/>
<!-- 检查Javadoc块是否可以放在一行中，并且不包含块标记。至少包含一个块标记的Javadoc注释应该用几行进行格式化。-->
<module name="SingleLineJavadoc"/>
<!-- <module name="SummaryJavadoc"/>-->
<!-- 检查方法和构造函数的javadoc -->
<module name="JavadocMethod">
<property name="scope" value="public"/>
<property name="allowedAnnotations"
value="Override, Test, Before, After, BeforeClass, AfterClass, Parameterized, Parameters"/>
<property name="ignoreMethodNamesRegex" value="^assert.*$|^verify.*$"/>
<property name="tokens" value="METHOD_DEF, ANNOTATION_FIELD_DEF"/>
</module>
<!-- Filters -->
<module name="SuppressionCommentFilter"/>
<module name="SuppressWithNearbyCommentFilter"/>
</module>
</module>
