资讯专栏INFORMATION COLUMN

阿里巴巴Java代码规约插件p3c-pmd使用指南与实现解析

worldligang / 3010人阅读

摘要:年月底,阿里巴巴集团发布了阿里巴巴开发手册终极版,年月日,在杭州云栖大会上,代码规约插件全球首发,插件支持以上版本和以上版本。阿里巴巴代码规约插件安装阿里代码规约插件有插件和插件。

2017年9月底,阿里巴巴集团发布了《阿里巴巴Java开发手册》PDF终极版,2017年10月14日,在2017杭州云栖大会上,Java代码规约插件全球首发,p3c-pmd插件支持Eclipse4.2以上版本和IDEA14.1.7以上版本。

阿里巴巴Java代码规约插件安装

阿里Java代码规约插件有Eclipse插件和IDEA插件。

Eclipse插件安装

Eclipse版插件支持4.2(Juno,JDK1.8+)及以上版本,通过 Help
-- Install New Software 然后输入https://p3c.alibaba.com/plugi... 即可看到安装列表。可以通过 Help-- Check for Udates 进行插件新版检测。

勾选Ali-CodeAnalysis,Next,安装完成后重启即可。

IDEA插件安装

IDEA版的插件已发布到IDEA官方仓库中(最低支持版本14.1.7,JDK1.7+),只需打开File-- Settings --Plugins -- Browse repositories 输入 Alibaba 搜索便可以看到对应插件,点击安装等待安装完成。IDEA会自动检测插件新版并提示。
File--Setting--Plugins--Browse repositories

检索alibaba,第一个就是Alibaba Java Coding Guidelines,点击右侧Install即可,可以看到下载量是6天前已经发布。安装完毕后重启IDEA即可。

重启IDEA后,可以看到Tools菜单下面有阿里编程规约的插件,有三项子功能:
编程规约扫描(快捷键Ctrl+Alt+Shift+J)、
关闭/打开实时检测功能、
切换语言至英文(English):点击后提示:SmartFox Intellij IDEA Plugin切换语言成功,重启后生效
中文界面如下:

英文界面如下:

阿里代码规约插件的使用

这里仅仅以IDEA环境为例进行说明,Eclipse操作类似

代码检查 Inspections

File-Settings-Editor- Inspections,打开后右侧找到Ali-Check,可以看到很多代码检查规则,可以修改规则对应提示的颜色。这里一共有55条规则。

以编程规约之命名风格为例:

变量test_Double命名不符合驼峰形式,高亮显示,Ctrl+F1给出修改提示

常量Test_CONSTANT命名不符合规范,高亮显示,Ctrl+F1给出修改提示

代码分析Code Analyze

在当前类中右键或者在左侧Project视图中类名称上右键,选择Alibaba Coding Guidelines Analyze, 可以对某一个类进行代码分析;也可以直接在Project视图中,项目的包上面单击右键,选择Alibaba Coding Guidelines Analyze,可以批量分析包中所有类


分析结果在IDEA底部逐条给出,我们还是对上面的类进行分析,结果如下:


单击红色矩形框可以跳转到代码所在行。

P3C-PMD插件实现规则说明

P3C-PMD插件基于PMD实现了《阿里巴巴Java开发手册》中涉及的48条规则。
编程规约 (六)并发处理,实现了1、2、3、4、5、10、11、12等8条规则;
编程规约(五)集合处理,实现了4、5、6、7、9、11等6条规则;
编程规约(一)命名风格,实现了1、2、3、4、5、6、7、8、9、13等10条规则;
编程规约(二)常量定义,实现了1、2等2条规则;
编程规约(四)OOP规约,实现了5、6、7、8、9、12、17等7条规则;
编程规约(七)控制语句,实现了1、2、4等3条规则;
编程规约(八)注释规约,实现了1、2、3、4、5等5条规则;
编程规约(九)其他,实现了1、3、4、5等4条规则;
异常日志 (一)异常处理,实现了5、7、10等3条规则;

PMD执行Java代码分析的原理

PMD是一种代码静态分析工具,当使用PMD规则分析Java源码时,PMD首先利用JavaCC和EBNF文法产生了一个语法分析器,用来分析普通文本形式的Java代码,产生符合特定语法结构的语法,同时又在JavaCC的基础上添加了语义的概念即JJTree,通过JJTree的一次转换,这样就将Java代码转换成了一个AST,AST是Java符号流之上的语义层,PMD把AST处理成一个符号表。然后编写PMD规则,一个PMD规则可以看成是一个Visitor,通过遍历AST找出多个对象之间的一种特定模式,即代码所存在的问题。
自定义PMD实现规则有如下2种方式:
(1). 自定义Java类并继承AbstractJavaRule抽象类,重写visit()方法,并在xml规则文件中引用该类。

name:自定义规则的名字;

language:要检查的语言

message:该规则被触发时,给出的消息提示;

class:规则使用类的全类名;

description:规则的描述信息;

priority:优先级别,从高到低依次是1-Blocker, 2-Critical, 3-Urgent, 4-important, 5-Warning;

example:在CDATA标签中书写一个该规则对应的实例。
示例:

(2). 自定义XPATH表达式,编写xml规则,在规则的properties-property节点中定义XPATH表达式,该表达式是依赖于抽象语法树AST的。

name:自定义规则的名字;

language:要检查的语言

message:该规则被触发时,给出的消息提示;

class: xPath规则统一配置为net.sourceforge.pmd.lang.rule. XPathRule;

description:规则的描述信息;

priority:优先级别,从高到低依次是1-Blocker, 2-Critical, 3-Urgent, 4-important, 5-Warning;

example:在CDATA标签中书写一个该规则对应的实例。

properties:这个是xpath必须配置的,其子节点property,value值使用CDATA标签配置对应的xpath表达式的形式,可以有多个property。
示例:

阿里代码规约插件p3c-pmd源码实现解析

p3c-pmd的项目开源托管在github上,可以自行去https://github.com/alibaba/p3c下载,项目是maven管理,项目代码结构如下:

p3c-pmd插件的实现是基于pmd的,更具体的来说是基于pmd-java的,因为pmd不仅支持java代码分析,还支持其他多种语言。具体实现自定义规则的方式当然也是上节所介绍的2种方式:自定义Java类和XPATH规则。
p3c-pmd插件封装了2个抽象类,分别介绍如下:
(1). 第一个是AbstractAliRule 继承了pmd的 AbstractJavaRule并重写visit(node,data)方法;AbstractPojoRule又继承了AbstractAliRule,用于检测Java类是否有Pojo。

第二个是AbstractXpathRule继承了pmd的抽象类XPathRule,用于处理XPATH规则。

最后给大家一个小小的福利,我把p3c-pmd项目的源码分包生成了对应的类图,大家可以自行下载,关注Java技术日志订阅号后,在消息框回复关键字:p3c或pmd可以获取类图下载地址。

本订阅号提供Java相关技术分享,从Java编程基础到Java高级技术,从JavaWeb技术基础Jsp、Servlet、JDBC到SSH、SSM开发框架,从REST风格接口设计到分布式项目实战。剖析主流开源技术框架,用亲身实践来谱写深度Java技术日志。“

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/67874.html

相关文章

  • # 在Gradle中使用阿里巴巴Java开发规约插件进行代码检查

    摘要:也就是说,在不运行程序的情况下报告错误。此外,用户还可以自己定义规则,检查代码是否符合某些特定的编码规范。使用短写方式运行任务输出的检测报告在我们定义的目录里可以找到 在Gradle中使用阿里巴巴Java开发规约插件进行代码检查 概述   最近阿里发布了《阿里巴巴Java开发手册》,一时间无数阿里拥趸如获武穆遗书,就在近日阿里又顺便发布了,可以轻松的在码字阶段获得相应的编码提示,那么,...

    Invoker 评论0 收藏0
  • 常识之外的规范——阿里java开发手册笔记(全章节)

    摘要:说明这篇文章是我第一次认真阅读阿里巴巴开发手册终极版的笔记。说明本手册明确防止是调用者的责任。一年半载后,那么单元测试几乎处于废弃状态。好的单元测试能够最大限度地规避线上故障。 说明 这篇文章是我第一次(认真)阅读《阿里巴巴 Java 开发手册(终极版)》的笔记。手册本身对规范的讲解已经非常详细了,如果你已经有一定的开发经验并且有良好的编码习惯和意识,会发现大部分规范是符合常识的。所以...

    Martin91 评论0 收藏0
  • IntelliJ IDEA 18 周岁,吐血推进珍藏已久的必装插件

    摘要:代码规约扫描插件以今年年初发布的阿里巴巴开发规约为标准,作为的插件形式存在,检测代码中存在不规范得位置然后给予提示。 IntelliJ IDEA是目前最好最强最智能的Java IDE,前几天,他刚刚年满18岁。 showImg(https://segmentfault.com/img/remote/1460000017974611); 本文,给大家推荐几款我私藏已久的,自己经常使用的...

    赵春朋 评论0 收藏0
  • 阿里Java开发手册节选(嵩山版)

    摘要:虚静出内功代码规范节选代码命名均不能以下划线或者美元符号开始,也不能以下划线或美元符号结束所有编程相关命名都严禁使用拼音和英文混合方式,也不允许直接使用中文类名使用风格,但以下情形例外等,正确命名示例等方法名参数名成员 ...

    xuhong 评论0 收藏0

发表评论

0条评论

worldligang

|高级讲师

TA的文章

阅读更多
最新活动
阅读需要支付1元查看
<