配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)

前言

因为看到了《阿里巴巴Java开发手册(华山版)》,所以在Eclipse和IDEA中安装了相应的插件,分别是Javadoc和阿里巴巴编码规约扫描。

1. Eclipse

  • p3c
  1. 安装
    Eclipse安装p3c和普通的插件安装一样,这里是阿里巴巴GitHub链接:
    https://github.com/alibaba/p3c/tree/master/eclipse-plugin。
    按照上面的步骤完全可以安装成功。

  2. 测试
    安装完成后需要重启。
    编写一个简单代码测试:
    配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第1张图片
    运行阿里巴巴编码规约扫描:
    右键 -> 阿里巴巴编码规约扫描
    在这里插入图片描述
    可以看到扫描结果:
    在这里插入图片描述
    第一个问题是类名,这里将P3CTesting修改位P3cTesting。
    第二个问题是没有添加类的注释信息,添加即可(博主已经配置了注释模板)。

再次扫描:
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第2张图片

  • Javadoc
    Javadoc不用安装,直接使用即可。
    点击Project -> Generate Javadoc
    配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第3张图片
    配置如下:
    第一个框选择自己已经安装的JDK目录下的javadoc.exe。
    第二个框选择自己要使用的类,可以选择整个项目,博主这里只选择刚才写的类。
    第三个框生成doc文件的目录,默认选项。
    配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第4张图片
    点击Next:
    选择:
    配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第5张图片
    点击Next,设置编码格式:
    -encoding UTF-8 -charset UTF-8
    配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第6张图片
    点击Finish:
    配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第7张图片

项目目录下会生成doc目录,浏览器打开index.html:
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第8张图片
结果(有没有感觉网页排版在哪里见过,哈哈。):
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第9张图片

2. IDEA

IDEA使用插件安装即可:
File -> Settings -> Plugins
分别搜索安装JavaDoc 和 Alibaba
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第10张图片
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第11张图片
安装完成后需要重启。。。

测试

创建一个Java项目:
右键运行编码规约扫描:
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第12张图片
运行结果:
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第13张图片
可以看到与Eclipse中的检测结果一致。

修改类名,和添加注释后,再次扫描:
左下方提示没有发现可以代码。。。
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第14张图片

生成Javadoc:
Tools -> Generate JavaDoc
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第15张图片
设置参数:
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第16张图片
结果:
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第17张图片
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第18张图片

查看:
配置Eclipse和IDEA的Javadoc 和 阿里巴巴代码规范检测工具(p3c)_第19张图片

完!

你可能感兴趣的:(JAVA,IDEA)