一 配置jdk
在"系统变量"中设置3项属性,JAVA HOME, PATH, CLASSPATH(大小写无所谓),若已存在则点击编辑,不存在则点击新建
变量名: JAVA HOME
变量值: C:/Java/jdk1.8.0 151 [注意]要根据自己的实际路径配置
变量名: CLASSPATH(idk1.8以前)
变量值: .;%JAVA_HOME%/lib/dt.jar; %JAVA HOME%/lib/tools.jar; [注意]前面有个.;
变量名: Path
变量值: %JAVA_HOME%/bin;%JAVA_HOME%/jre/bin; [注意] PATH中的变量值为新增的,不要删掉原来有的值
检验 cmd后输入键入命令: java -version命令
二 安装idea,设置相应系统的bit (64-bit launcher)配置
在开发过程中,在一个类中对同一个类的方法或依赖包引用次数变多时,idea可能会将这个被引用的类或依赖包变为类似exampl.package.的格式,比如import org.springframework.web.bind.annotation., 这不符合代码规范。
导致这个的原因主要是idea中的一个属性设置,Settings-> Editor-> Code Style-> Java-> Imports,如下图,对图中的两个属性Class count to use import with "*和Names count to use static import with大设置为较大的数值即可
1) Maven配置
在安装好IDEA之后,需要在IDEA配置Maven仓库的相关信息,一般公司会提供maven settings文件模板,在本地新建settings.xml并把Mave源配置拷贝进去修改保存。
需要maven在settings并中存储加密密码(根据公司要求来定)
配置环境变量:
- 在计算机-属性-高级系统设置环境变量中,在系统变量栏下单击新建,创建新的系统环境变量:
- 新建-变量名"MAVEN_HOME’",变量值为“[IDEA安装路径] “\plugins\maven\lib\maven3”;如C:\Program Files\JetBrains\IntelliJ IDEA Community Edition 2018.2.2\plugins\maven\lib\maven3
- 编辑path变量, 增加"%MAVEN HOME%\bin":
在IDEA的File-> Settings -> Build,Execution,Deployment -> Build Tools -> Maven中,在User setting files 中配置maven的setting文件,如下图所示,点击0K或Apply即可完成IDEA中对Maven的配置。详细的Maven可参考: maven的相关资料。
2)CheckStyle安装配置
安装CheckStyle插件
Checkstyle是Idea的用于检验代码开发规范的插件。
插件Checkstyle下载(一般公司会提供,自己电脑可以直接在插件中搜索安装)
选择File-> Settings-Plugins,从本地安装插件(Install plugin from disk…),选择CheckStyle-IDEA-5.22.0ZiP.
安装后需重启IDEA,重启完成后可看下方出现CheckStyle模块。
●配置CheckStyle
checkstyle.xml(一般公司会提供"checkstyle.xml")
选择File -> Setting -> Other Settings -> Checkstyle ,选择工程/scripts/pipline/checkstyte.xml。
安装完毕之后需要配置Checktyle,以下是对配置的过程和配置属性的说明。
1.下图中检查范围选项分别为:仅java源文件(不含测试)、仅java源文件(包含测试)、所有源文件(不会测试)、所有源文件(包含测试、工程中所有文件。我们选择:仅java源文件(不含测试)。
2.输入如图所示,点击Next核对后,勾选Apply就可以使用checkstyle规则了。(以下是我用的,也可以参考后面自己改)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE module PUBLIC "-//Puppy Crawl//DTD Check Configuration 1.3//EN"
"http://www.puppycrawl.com/dtds/configuration_1_3.dtd">
<!--
This configuration file was written by the eclipse-cs plugin configuration editor
-->
<!--
Checkstyle-Configuration: CTP
Description: none
-->
<module name="Checker">
<property name="severity" value="error"/>
<property name="charset" value="UTF-8"/>
<module name="TreeWalker">
<module name="JavadocMethod">
<property name="suppressLoadErrors" value="true"/>
<property name="allowUndeclaredRTE" value="true"/>
<property name="allowMissingPropertyJavadoc" value="true"/>
<property name="allowMissingThrowsTags" value="true"/>
<property name="allowMissingParamTags" value="true"/>
</module>
<module name="JavadocVariable"/>
<module name="JavadocStyle">
<property name="checkEmptyJavadoc" value="true"/>
<property name="checkFirstSentence" value="false"/>
<property name="checkHtml" value="false"/>
<message key="javadoc.missing" value="空白注释,请确保注释中文中至少留有一行纯中文功能描述注释"/>
</module>
<module name="JavadocType">
<property name="scope" value="public"/>
<property name="allowMissingParamTags" value="true"/>
<property name="allowUnknownTags" value="true"/>
<property name="authorFormat" value="[\u4e00-\u9fa5]"/>
<message key="javadoc.missing" value="类注释:缺少Javadoc注释.或者作者格式没按照@author + 中文姓名来注释"/>
</module>
<module name="AnnotationUseStyle">
<property name="elementStyle" value="ignore"/>
<property name="trailingArrayComma" value="ignore"/>
<property name="closingParens" value="ignore"/>
</module>
<module name="AvoidStarImport">
<property name="severity" value="error"/>
<message key="import.avoidStar" value="请不要使用''.*''进行import - {0}."/>
</module>
<!--module name="NultipleStringLiterals"-->
<!--module name="NultipleVariableDeclarations-->
<module name="NestedTryDepth">
<property name="max" value="3"/>
</module>
<!--clone方法必须调用了super.clone() -->
<module name="SuperClone"/>
<!--finalize 必须调用了super.finalize() -->
<module name="SuperFinalize"/>
<!--switch要有default-->
<module name="DefaultComesLast"/>
<!--
<module name="ParameterNumber">
<message key="maxParam" value="参数太多,共{1,number,integer}个,最好不要超过{0,number,integer}个。"/>
</module>
<module name="LineLength">
<property name="max" value="200"/>
<property name="tabWidth" value="4"/>
</module>
-->
<module name="StringLiteralEquality">
<metadata name="net.sf.eclipsecs.core.comment" value="String比较请使用equals"/>
<property name="severity" value="error"/>
<message key="string.literal.equality" value="String比较请使用equals(),而不是''{0}''."/>
</module>
<!--
<module name="ParameterAssignment">
<metadata name="net.sf.eclipsecs.core,comment" value="方法参数不允许复制"/>
<property name="severity" value="error"/>
<message key="parameter.assignment" value="请不要堆方法的参数赋值:''{0}''"/>
</module>
<module name="ModifiedControlVariable">
<metadata name="net.sf.eclipsecs.core.comment" value="不允许修改循环控制变量"/>
<property name="severity" value="error"/>
</module>
<module name="ReturnCount">
<metadata name="net.sf.eclipsecs.core.comment" value="方法最大允许3个return"/>
<property name="severity" value="error"/>
<property name="max" value="4"/>
</module>
-->
</module>
<module name="RegexpSingleline">
<metadata name="net.sf.eclipsecs.core.comment" value="不允许使用System.out.print"/>
<property name="severity" value="error"/>
<property name="format" value="System\.out\.print"/>
<property name="message" value="不允许使用System.our.print,请使用log4j"/>
</module>
</module>
根据自己的需求在此基础上修改
<?xml version="1.0"?>
<!DOCTYPE module PUBLIC
"-//Puppy Crawl//DTD Check Configuration 1.3//EN"
"http://www.puppycrawl.com/dtds/configuration_1_3.dtd">
<module name="Checker">
<module name="TreeWalker">
<!-- =============注释检查============= -->
<!-- 检查类和接口的javadoc 默认不检查author 和version tags
authorFormat: 检查author标签的格式
versionFormat: 检查version标签的格式
scope: 可以检查的类的范围,例如:public只能检查public修饰的类,private可以检查所有的类
excludeScope: 不能检查的类的范围,例如:public,public的类将不被检查,但访问权限小于public的类仍然会检查,其他的权限以此类推
tokens: 该属性适用的类型,例如:CLASS_DEF,INTERFACE_DEF -->
<module name="JavadocType">
<property name="authorFormat" value="\S"/>
<property name="scope" value="protected"/>
<property name="versionFormat" value="\$Revision.*\$"/>
<property name="excludeScope" value="public"/>
<property name="tokens" value="CLASS_DEF,INTERFACE_DEF"/>
</module>
<!-- 检查方法的javadoc的注释
scope: 可以检查的方法的范围,例如:public只能检查public修饰的方法,private可以检查所有的方法
allowMissingParamTags: 是否忽略对参数注释的检查
allowMissingThrowsTags: 是否忽略对throws注释的检查
allowMissingReturnTag: 是否忽略对return注释的检查 -->
<module name="JavadocMethod">
<property name="scope" value="private"/>
<property name="allowMissingParamTags" value="false"/>
<property name="allowMissingThrowsTags" value="false"/>
<property name="allowMissingReturnTag" value="false"/>
<property name="tokens" value="METHOD_DEF"/>
<property name="allowUndeclaredRTE" value="true"/>
<property name="allowThrowsTagsForSubclasses" value="true"/>
<!--允许get set 方法没有注释-->
<property name="allowMissingPropertyJavadoc" value="true"/>
</module>
<!-- 检查变量是否具有Javadoc注释
scope: 检查变量的范围,例如:public只能检查public修饰的变量,private可以检查所有的变量 -->
<module name="JavadocVariable">
<property name="scope" value="private"/>
</module>
<!-- =============命名检查============= -->
<!-- 检查抽象类的名称是否遵守命名规约
format: 定义抽象类的命名规则 -->
<module name="AbstractClassName">
<property name="format" value="^Abstract.*$|^.*Factory$"/>
</module>
<!-- 检查常量(用static final修饰的字段)的名称是否遵守命名规约
format: 定义全局常量的命名规则 -->
<module name="ConstantName">
<property name="format" value="^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$"/>
</module>
<!-- 检查局部final变量的名称是否遵守命名规约
format: 定义局部常量的命名规则 -->
<module name="LocalFinalVariableName">
<property name="format" value="^[A_Z][A-Z0-9]*(_[A_Z0-9]+)*$"/>
</module>
<!-- 检查局部变量的名称是否遵守命名规约
format: 定义局部常量的命名规则 -->
<module name="LocalVariableName">
<property name="format" value="^[a-z][a-zA-Z0-9]*$"/>
</module>
<!-- 检查成员变量(非静态字段)的名称是否遵守命名规约
format: 定义非静态成员变量的命名规则
applyToPublic: 是否适用于public的成员变量
applyToProtected: 是否适用于protected的成员变量
applyToPackage: 是否适用于package的成员变量
applyToPrivate: 是否适用于private的成员变量 -->
<module name="MemberName">
<property name="format" value="^[a-z][a-zA-Z0-9]*$"/>
<property name="applyToPublic" value="true"/>
<property name="applyToProtected" value="true"/>
<property name="applyToPackage" value="true"/>
<property name="applyToPrivate" value="true"/>
</module>
<!-- 检查方法名称是否遵守命名规约
format: 定义方法名的命名规则 -->
<module name="MethodName">
<property name="format" value="^[a-z][a-zA-Z0-9]*$"/>
</module>
<!-- 检查包名称是否遵守命名规约
format: 定义包名的命名规则 -->
<module name="PackageName">
<property name="format" value="^[a-z]+(\.[a-z][a-z0-9]*)*$"/>
</module>
<!-- 检查参数名称是否遵守命名规约
format: 定义参数名的命名规则 -->
<module name="ParameterName">
<property name="format" value="^[a-z][a-zA-Z0-9]*$"/>
</module>
<!-- 检查静态变量(用static修饰,但没用final修饰的字段)的名称是否遵守命名规约
format: 定义静态变量的命名规则 -->
<module name="StaticVariableName">
<property name="format" value="^[a-z][a-zA-Z0-9]*$"/>
</module>
<!-- 检查类的名称是否遵守命名规约
format: 定义类和接口的命名规则
tokens: 定义规则适用的类型,例如:CLASS_DEF表示类,INTERFACE_DEF 表示接口 -->
<module name="TypeName">
<property name="format" value="^[A-Z][a-zA-Z0-9]*$"/>
<property name="tokens" value="CLASS_DEF,INTERFACE_DEF"/>
</module>
<!-- =============import检查=============-->
<!-- 检查没有import语句使用*符号
excludes: 定义可以使用*导入的包 -->
<module name="AvoidStarImport">
<property name="excludes" value="java.io,java.util"/>
</module>
<!-- 检查是否导入了指定的非法包 -->
<module name="IllegalImport"/>
<!-- 检查导入包的顺序/分组
groups: 定义导入包的顺序,默认以字母顺序导入
ordered: 定义包是否必须按规定的顺序显示
separated: 定义包与包之间是否应添加空白行
caseSensitive: 是否区分包名的大小写 -->
<module name="ImportOrder">
<property name="groups" value="java,javax"/>
<property name="ordered" value="true"/>
<property name="separated" value="true"/>
<property name="caseSensitive" value="true"/>
</module>
<!-- 检查是否存在多余的导入语句 -->
<module name="RedundantImport"/>
<!-- 检查未使用的导入语句 -->
<module name="UnusedImports"/>
<!-- =============长度检查============= -->
<!-- 检查匿名内部类的长度
max: 定义匿名内部类最多容许的行数 -->
<module name="AnonInnerLength">
<property name="max" value="20"/>
</module>
<!-- 检查要执行的语句的数目,将可执行语句的数量限制为一个指定的限值
max: 定义所能容许的语句的最多数目
tokens: 定义可以检查的类型,例如:CTOR_DEF,METHOD_DEF,STATIC_INIT,INSTANCE_INIT -->
<module name="ExecutableStatementCount">
<property name="max" value="20"/>
<property name="tokens" value="CTOR_DEF,METHOD_DEF,STATIC_INIT,INSTANCE_INIT"/>
</module>
<!-- 检查源码文件的长度
max: 定义一个文件所能容许的行数 -->
<module name="FileLength">
<property name="max" value="1000"/>
</module>
<!-- 检查源码每行的长度 -->
<module name="LineLength">
<property name="max" value="80"/>
<property name="ignorePattern" value="^ *\* *[^ ]+$"/>
</module>
<!-- 检查方法和构造器的长度
max: 最多容许的行数
countEmpty: 是否计算空行
tokens: 定义检查的类型 -->
<module name="MethodLength">
<property name="max" value="100"/>
<property name="countEmpty" value="true"/>
<property name="tokens" value="METHOD_DEF"/>
</module>
<!-- 检查一个方法或构造器的参数的数量
max: 定义最多有多少个参数
tokens: 定义检查的类型 -->
<module name="ParameterNumber">
<property name="max" value="10"/>
<property name="tokens" value="METHOD_DEF,CTOR_DEF"/>
</module>
<!-- =============空格检查============= -->
<!-- 检查空的for循环初始化语句的填充符
option: 定义初始化语句中是否使用空格,例如:space表示使用空格,则for(int i = 0; i < 100; i++)
就是符合格式要求的,而for(int i=0; i<100;i++)就不符合要求 -->
<module name="EmptyForInitializerPad">
<property name="option" value="space"/>
</module>
<!-- 检查for iterator语句是否使用空格
option:定义初始化语句是否使用空格,例如:space表示使用空格,则for(Iterator iterator = List.iterator();iterator.hasNext(); iterator.next())就是形式合理的,否则就是形式不合理的 -->
<module name="EmptyForIteratorPad">
<property name="option" value="space"/>
</module>
<!-- 检查指定标记之后没有空格。若要禁用指定标记之后的换行符,将allowLineBreaks属性设为false即可。 -->
<module name="NoWhitespaceAfter"/>
<!-- 检查指定标记之前没有空格。若要允许指定标记之前的换行符,将allowLineBreaks属性设为true即可 -->
<module name="NoWhitespaceBefore"/>
<!-- 检查代码自动换行时,运算符所处位置的策略
option: 定义运算符的位置,eol在同一行,nl在下一行
tokens: 定义检查的类型 -->
<module name="OperatorWrap">
<property name="tokens"
value="ASSIGN, DIV, DIV_ASSIGN, PLUS_ASSIGN, MINUS, MINUS_ASSIGN, STAR, STAR_ASSIGN, MOD, MOD_ASSIGN, SR, SR_ASSIGN, BSR, BSR_ASSIGN, SL, SL_ASSIGN, BXOR, BXOR_ASSIGN, BOR, BOR_ASSIGN, BAND, BAND_ASSIGN,PLUS, QUESTION"/>
<property name="option" value="eol"/>
</module>
<!-- 检查方法定义、构造器定义、方法调用、构造器调用的标识符和参数列表的左圆括号之间的填充符
allowLineBreaks: 参数是否允许在不同行
option: 在参数和括号、参数和标识符之间是否包含空格
tokens: 检查的类型 -->
<module name="MethodParamPad">
<property name="allowLineBreaks" value="false"/>
<property name="option" value="space"/>
<property name="tokens" value="METHOD_DEF,CTOR_DEF"/>
</module>
<!-- 检查圆括号的填充符策略,也就是在左圆括号之后和右圆括号之前是否需要有一个空格
option: space表示有空格,nospace表示没有空格
tokens: 定义检查的类型 -->
<module name="ParenPad">
<property name="option" value="nospace"/>
</module>
<!-- 检查类型转换的圆括号的填充符策略。也就是,在左圆括号之后和右圆括号之前是否需要有一个空格
option: space表示有空格,nospace表示没有空格
tokens: 定义检查的类型 -->
<module name="TypecastParenPad">
<property name="option" value="space"/>
</module>
<!-- 检查源码中没有制表符('\t') -->
<module name="TabCharacter"/>
<!-- 检查指定标记之后是否紧跟了空格
tokens: 检查的类型 -->
<module name="WhitespaceAfter">
<property name="tokens" value="COMMA,SEMI,TYPECAST"/>
</module>
<!-- 检查指定标记的周围是否有空格
可以选择性地从检查策略中排除,通过设置allowEmptyMethods和allowEmptyConstructors属性即可
tokens: 检查的类型 -->
<module name="WhitespaceAround">
<property name="tokens" value="ASSIGN"/>
</module>
<!-- =============修饰符检查============= -->
<!-- 检查代码中的标识符的顺序是否符合《Java Language Specification》中的第8.1.1、8.3.1章节所建议的顺序
正确的顺序应当如下:
1. public
2. protected
3. private
4. abstract
5. static
6. final
7. transient
8. volatile
9. synchronized
10. native
11. strictfp -->
<module name="ModifierOrder"/>
<!-- 在以下部分检查是否有多余的修饰符:
1. 接口和注解的定义;
2. final类的方法的final修饰符;
3. 被声明为static的内部接口声明
tokens: 检查的类型 -->
<module name="RedundantModifier">
<property name="tokens" value="METHOD_DEF,VARIABLE_DEF"/>
</module>
<!-- =============代码块检查============= -->
<!-- 找到嵌套代码块,也就是在代码中无节制使用的代码块
allowInSwitchCase: 定义是否允许switch case中使用嵌套的代码块 -->
<module name="AvoidNestedBlocks">
<property name="allowInSwitchCase" value="true"/>
</module>
<!-- 检查空代码块
option: 定义代码块中应该包含的内容,例如:stmt表示语句
tokens: 检查的类型 -->
<module name="EmptyBlock">
<property name="option" value="stmt"/>
</module>
<!-- 检查代码块的左花括号的放置位置
option: 定义左大括号'{'显示位置,eol在同一行显示,nl在下一行显示
maxLineLength: 大括号'{'所在行行最多容纳的字符数
tokens: 该属性适用的类型,例:CLASS_DEF,INTERFACE_DEF,METHOD_DEF,CTOR_DEF -->
<module name="LeftCurly">
<property name="option" value="eol"/>
<property name="maxLineLength" value="80"/>
<property name="tokens" value="CLASS_DEF,INTERFACE_DEF,METHOD_DEF,CTOR_DEF"/>
</module>
<!-- 检查代码块周围是否有大括号,可以检查do、else、if、for、while等关键字所控制的代码块
tokens: 定义检查的类型 -->
<module name="NeedBraces"/>
<!-- 检查else、try、catch标记的代码块的右花括号的放置位置
tokens: 定义检查的类型 -->
<module name="RightCurly">
<property name="option" value="alone"/>
<property name="tokens" value="LITERAL_TRY"/>
</module>
<!-- =============编码检查============= -->
<!-- 检查是否在同一行初始化, 例如:private int Age = nGe==1 ? 100 : 0; 就应该避免 -->
<module name="AvoidInlineConditionals"/>
<!-- 检查定义了共变equals()方法的类中是否同样覆盖了equals(java.lang.Object)方法 -->
<module name="CovariantEquals"/>
<!-- 检查switch语句中的default是否在所有的case分支之后 -->
<module name="DefaultComesLast"/>
<!-- 检查空的代码段 -->
<module name="EmptyStatement"/>
<!-- 检查覆盖了equals()方法的类是否也覆盖了hashCode()方法 -->
<module name="EqualsHashCode"/>
<!-- 检查类或对象的成员是否显式地初始化为成员所属类型的默认值
(对象引用的默认值为null,数值和字符类型的默认值为0,布尔类型的默认值为false) -->
<module name="ExplicitInitialization"/>
<!-- 检查switch语句中是否存在跨越分支。
如果一个case分支的代码中缺少break、return、throw或continue语句,那么就会导致跨越分支 -->
<module name="FallThrough"/>
<!-- 检查变量值没有改动的情况下,该变量是否定义成了final -->
<module name="FinalLocalVariable"/>
<!-- 检查局部变量或参数是否会遮蔽在相同类中定义的字段 -->
<module name="HiddenField"/>
<!-- 检查是否有不合法的实例化操作,是否使用工厂方法更好 -->
<module name="IllegalInstantiation"/>
<!-- 非法异常捕捉,不允许捕捉java.lang.Exception、java.lang.Error、java.lang.RuntimeException的行为 -->
<module name="IllegalCatch"/>
<!-- 检查子表达式中是否有赋值操作 -->
<module name="InnerAssignment"/>
<!-- 检查是否有"魔术"数字 -->
<module name="MagicNumber">
<property name="ignoreNumbers" value="0, 1"/>
<property name="ignoreAnnotation" value="true"/>
</module>
<!-- 检查switch语句是否含有default子句 -->
<module name="MissingSwitchDefault"/>
<!-- 检查循环控制变量是否被修改 -->
<module name="ModifiedControlVariable"/>
<!-- 检查一个字符串变量在不改变变量值的情况下或者字符串出现的次数
allowedDuplicates: 定义在类中一个字符串变量在不改变变量值的情况下或者字符串所能使用的最多次数 -->
<module name="MultipleStringLiterals">
<property name="allowedDuplicates" value="3"/>
</module>
<!-- 检查一次声明多个变量时,变量是否在同一行或者在同一个语句中 -->
<module name="MultipleVariableDeclarations"/>
<!-- 限制if-else代码块的嵌套层数(默认值为1)-->
<module name="NestedIfDepth">
<property name="max" value="1"/>
</module>
<!-- 限制try代码块的嵌套层数(默认值为1)-->
<module name="NestedTryDepth">
<property name="max" value="3"/>
</module>
<!-- 确保一个类具有一个包声明,并且(可选地)包名要与源代码文件所在的目录名相匹配 -->
<module name="PackageDeclaration"/>
<!-- 不允许对参数进行赋值 -->
<module name="ParameterAssignment"/>
<!-- 检查throws子句中是否声明了多余的异常 -->
<module name="RedundantThrows">
<property name="allowUnchecked" value="true"/>
<property name="allowSubclasses" value="true"/>
</module>
<!-- 检查是否使用了this -->
<module name="RequireThis">
<property name="checkFields" value="false"/>
<property name="checkMethods" value="false"/>
</module>
<!-- 禁止使用System.out.println -->
<module name="Regexp">
<property name="format" value="System\.out\.println"/>
<property name="illegalPattern" value="true"/>
</module>
<!-- 限制return语句的数量。默认值为2。可以忽略检查指定的方法(默认忽略equals()方法 -->
<module name="ReturnCount">
<property name="max" value="3"/>
</module>
<!-- 检查是否有过于复杂的布尔表达式。现在能够发现诸如if (b == true)、b || true、!false等类型的代码 -->
<module name="SimplifyBooleanExpression"/>
<!-- 检查是否有过于复杂的布尔类型return语句 -->
<module name="SimplifyBooleanReturn"/>
<!-- 检查在判断字符串是否相等时是否使用了正确的形式 -->
<module name="StringLiteralEquality"/>
<!-- 检查一个覆盖的clone()方法是否调用了super.clone()方法 -->
<module name="SuperClone"/>
<!-- 检查一个覆盖的finalize()方法是否调用了super.finalize()方法 -->
<module name="SuperFinalize"/>
<!-- 检查初始化数祖时,最后一个元素后面是否加了逗号,如果左右大括号都在同一行,则可以不加逗号 -->
<module name="ArrayTrailingComma"/>
<!-- 检查代码中是否使用了不必要的圆括号 -->
<module name="UnnecessaryParentheses"/>
<!-- =============类设计检查============= -->
<!-- 检查类是否被设计为可扩展的,如果是,则方法应该abstract、final或者是空的 -->
<module name="DesignForExtension"/>
<!-- 检查一个只有私有构造器的类是否被声明为final -->
<module name="FinalClass"/>
<!-- 确保工具类(在API中只有静态方法和字段的类)没有任何公有构造器 -->
<module name="HideUtilityClassConstructor"/>
<!-- 检查接口是否只定义了变量而没有定义方法,因为接口应该用来描述一个类型,所以只定义变量而不定义方法是不恰当的
allowMarkerInterfaces: 是否检查空接口 -->
<module name="InterfaceIsType">
<property name="allowMarkerInterfaces" value="true"/>
</module>
<!-- 将异常抛出语句的数量配置为一个指定的限值(默认值为1)-->
<module name="ThrowsCount">
<property name="max" value="7"/>
</module>
<!-- 检查类成员的可见性。
只有static final的类成员可以是公有的,其他的类成员必须是私有的,除非设置了protectedAllowed属性或packageAllowed属性
packageAllowed: 变量包内成员可以访问
protectedAllowed: 变量是受保护的
publicMemberPattern: 可以公开访问的变量所匹配的命名形式 -->
<module name="VisibilityModifier">
<property name="packageAllowed" value="false"/>
<property name="protectedAllowed" value="false"/>
<property name="publicMemberPattern" value="^seriaVersionUID$"/>
</module>
<!-- =============重复检查============= -->
<!-- 逐行地比较所有的代码行,如果有若干行只有缩进有所不同,那么就报告存在重复代码
min: 允许代码重复的最小行数
charset: 文件所用的字符集 -->
<module name="StrictDuplicateCode">
<property name="min" value="7"/>
<property name="charset" value="UTF-8"/>
</module>
<!-- =============度量检查============= -->
<!-- 限制一个表达式中的&&、||、&、|、^等逻辑运算符的数量
max: 布尔运算符在一条语句中允许出现的最大数目 -->
<module name="BooleanExpressionComplexity">
<property name="max" value="7"/>
</module>
<!-- 测量给定类中的其他类的实例化操作的次数 -->
<module name="ClassDataAbstractionCoupling">
<property name="max" value="7"/>
</module>
<!-- 检查循环复杂度是否超出了指定的限值。
该复杂度由构造器、方法、静态初始化程序、
实例初始化程序中的if、while、do、for、?:、catch、switch、case等语句,以及&&和||运算符的数量所测量 -->
<module name="CyclomaticComplexity">
<property name="severity" value="ignore"/>
</module>
<!-- =============杂项检查============= -->
<!-- 检查数组定义的风格。有的开发者使用Java风格:public static void main(String[] args);有的开发者使用C风格:public static void main(String args[]) -->
<module name="ArrayTypeStyle">
<property name="javaStyle" value="true"/>
</module>
<!-- 检查方法/构造器的参数是否是final的。这项检查会忽略接口方法的检查 -->
<module name="FinalParameters"/>
<!-- 检查Java代码的缩进是否正确
basicOffset: 定义代码体相对于所属的代码体的缩进量
braceAdjustment: 定义括号的缩进量
caseIndent: 定义case的缩进量 -->
<module name="Indentation">
<property name="basicOffset" value="4"/>
<property name="braceAdjustment" value="0"/>
<property name="caseIndent" value="4"/>
</module>
<!-- 检查文件是否以新行结束 -->
<module name="NewlineAtEndOfFile"/>
<!-- 这是一项FileSetCheck检查,通过检查关键字的一致性属性文件,它可以确保代码的语言转换的正确性 -->
<module name="Translation">
<property name="severity" value="info"/>
</module>
<!-- 检查源码中是否有未注释的main()方法(调试的残留物)
excludedClasses: 定义可以带main方法的类所匹配的名字形式 -->
<module name="UncommentedMain">
<property name="excludedClasses" value="^$"/>
</module>
<!-- 检查long类型的常量在定义时是否由大写的“L”开头 -->
<module name="UpperEll"/>
</module>
</module>
3.配置完成后,在IDEA下方的CheckStyle模块可以看到对代码规范的检查结果。下图为示例检查结果。
3) Lombok插件安装
Lombok是一个java实用工具, 可以帮助开发人员消除java的冗长,例如使用GCetter可以让代码在编译时自动生etter方法。为了使idea不在代码检测时报错,需要安装对应播件。
Lombok的下载
注意:如果Idea版本使用的是2020版的,则需要下载对应版本的Lombok插件:
Lombok的下载
选择File -> Setting -> Plugins,从本地安装插件,选择lombok plugin-0.19-2018.EAP-mercurylog1.0.zip。
激活
安装后需重启IDEA,重启完成后可以在使用lombok组件时不出现代码检测错误。
在配置好Lombok之后,需要在工程中导入maven,才能在开发中使用ombok的注解。这里是在工程的pom.xml文件中的lombok依赖。
需要导入相应的依赖
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
4) SonarLint插件安装
Sonar是款代码质量管理 工具,SonarLint是Sonar的插件名称。
支持版本: 2016.3.8
SonarLint插件下载
安装
点击File-> Settings。
- 在弹出框内左侧点击Plugins, 点击右侧齿轮按钮,选择Install Plugin from Disk.
安装后需重启IDEA
本地使用 - 点击View-SonarLint,添加SonarLint面板
点击绿色执行按钮,可分析当前选定文件。在项目上右键SonarLint-Analyzewith
SonarLint可分析整个项目。
点击File-Settings,打开设置面板,在OtherSettings中选中,SonarLintGeneralSettings. 勾选Automatically trigger analysis即可自动扫描。
Tools->SonarLInt
需要手动分析,可右击项目或文件,点击SonarLint-Analyze
分析结果中的问题,可跳转至具体代码行,右侧可查看具体规则。
服务器配置
在SonarLint面板,点击工具按钮,可对项目进行配置,也可通过File-Settings, Other Settings-SonarLint Project Settings对SonarQube服务器进行配置。
●. 勾选Enable binding to remote SonarQube Server, 点击Configure servers. 对服务器进行具体配置。
点击加号,在弹出的对话框中输入配置名称,选择右侧SonarQube, 输入服务器地址例如:http://127.0.0.1:8080
(针对新项目)。
(next)下一步
●登陆方式选择账户密码式(一般公司会提供)
配置完成后,在Bind to server中选择刚才配置的服务器,在下方的SonarQube Project中输入想要关联的工程,点击Search in ls查找,关联即可。