在Gradle工程中使用checkstyle来规范你的项目

作者主页:青花锁 简介:Java领域优质创作者、Java微服务架构公号作者
简历模板、学习资料、面试题库、技术互助

文末获取联系方式
在这里插入图片描述

系列专栏目录

[Java项目实战] 介绍Java组件安装、使用;手写框架等
[Aws服务器实战] Aws Linux服务器上操作nginx、git、JDK、Vue等
[Java微服务实战] Java 微服务实战,Spring Cloud Netflix套件、Spring Cloud Alibaba套件、Seata、gateway、shadingjdbc等实战操作
[Java基础篇] Java基础闲聊,已出HashMap、String、StringBuffer等源码分析,JVM分析,持续更新中
[Springboot篇] 从创建Springboot项目,到加载数据库、静态资源、输出RestFul接口、跨越问题解决到统一返回、全局异常处理、Swagger文档
[Spring MVC篇] 从创建Spring MVC项目,到加载数据库、静态资源、输出RestFul接口、跨越问题解决到统一返回
[华为云服务器实战] 华为云Linux服务器上操作nginx、git、JDK、Vue等,以及使用宝塔运维操作添加Html网页、部署Springboot项目/Vue项目等
[Java爬虫] 通过Java+Selenium+GoogleWebDriver 模拟真人网页操作爬取花瓣网图片、bing搜索图片等
[Vue实战] 讲解Vue3的安装、环境配置,基本语法、循环语句、生命周期、路由设置、组件、axios交互、Element-ui的使用等
[Spring] 讲解Spring(Bean)概念、IOC、AOP、集成jdbcTemplate/redis/事务等


前言

在现代公司的运营中,后端研发部是必不可少的,其中Java又占据了大头。其中最火热的话题之一,就是代码风格,一个十人的团队,每个人都有自己的代码习惯,最后项目review时可以看出十种风格。
但随着时间发展,Google、Oracle、Spring、Netty 等机构和优秀框架,给我们带来了一些行业规范。当然,不存在绝对的正确和错误,关键在于规范的定义。
今天就给大家介绍下google style guide,Checkstyle就是以这种风格开发出的一个自动化插件,来辅助判断代码格式是否满足规范。

1、在Gralde中使用

在gralde中用法比较简单。示例项目: https://github.com/Ryan-Miao/springboot-security-demo/blob/master/config/checkstyle/checkstyle.xml

1.1、新建一个checkstyle.gradle

/**
 * The Checkstyle Plugin
 *
 * Gradle plugin that performs quality checks on your project's Java source files using Checkstyle
 * and generates reports from these checks.
 *
 * Tasks:
 * Run Checkstyle against {rootDir}/src/main/java: ./gradlew checkstyleMain
 * Run Checkstyle against {rootDir}/src/test/java: ./gradlew checkstyleTest
 *
 * Reports:
 * Checkstyle reports can be found in {project.buildDir}/build/reports/checkstyle
 *
 * Configuration:
 * Checkstyle is very configurable. The configuration file is located at {rootDir}/config/checkstyle/checkstyle.xml
 *
 * Additional Documentation:
 * https://docs.gradle.org/current/userguide/checkstyle_plugin.html
 */

apply plugin: 'checkstyle'

checkstyle {
    // The version of the code quality tool to be used.
    // The most recent version of Checkstyle can be found at https://github.com/checkstyle/checkstyle/releases
    toolVersion = "8.8"

    // The source sets to be analyzed as part of the check and build tasks.
    // Use 'sourceSets = []' to remove Checkstyle from the check and build tasks.
//    sourceSets = [project.sourceSets.main, project.sourceSets.test]

    // Whether or not to allow the build to continue if there are warnings.
    ignoreFailures = false

    // Whether or not rule violations are to be displayed on the console.
    showViolations = true
}

1.2、在build.gradle中引入checkstyle

apply plugin: 'checkstyle'

1.3、加载checkstyle配置文件

关键的地方是指定checkstyle.xml规则配置文件了。默认会读取根目录下

config/checkstyle/checkstyle.xml

文件的内容来自:https://sourceforge.net/projects/checkstyle/files/checkstyle/
去maven中找到对应版本的checkstyle, 然后下载jar,解压,里面有google-checks.xml, 复制里面的内容即可。

还可以直接用最新版本,参见Github。
在Gradle工程中使用checkstyle来规范你的项目_第1张图片

1.4、运行任务

./gradlew check

1.5、可以在以下目录找到检查结果

build/reports/checkstyle/main.html

更多细节,参考gradle 官网.

1.6、 根据流水线的Check提示,修改代码格式

在遇到Error级别代码检查异常时,会中断流水线,这时我们可以找到指定的Error信息,去修改工程里对应的代码。
在Gradle工程中使用checkstyle来规范你的项目_第2张图片


总结

一个团队还是统一代码风格好,不仅仅是代码可观赏性,对代码的可维护性影响也非常大。后续的代码中,都会按照这套规范执行下去,如果有新人进来,可以学习一下,在有文档的情况下,学习成本也是可控的。


联系方式

微信公众号:Java微服务架构

你可能感兴趣的:(Java微服务,intellij-idea,Gradle,checkstyle)