README.md

sonar自定义规则插件开发(基于阿里JAVA开发手册)

开发环境

• jdk 1.8
• maven

开发指南

• 自定义规则开发指南

• 官方示例

使用说明

• 编译打包
• 将打包好的jar放到extensions/plugins 目录下

已完成的规则

• 命名

1.抽象类命名使用 Abstract 或 Base 开头 
2.异常类命名使用Exception结尾
3.方法名、参数名、成员变量、局部变量都统一使用lowerCamelCase，必须遵从驼峰形式 
4.常量命名应该全部大写，单词间用下划线隔开，力求语义表达完整清楚  
5.所有编程相关的命名均不能以下划线或美元符号开始    
6.POJO 类中布尔类型的变量，都不要加 is 前缀  
7.包命名检查:包名统一使用小写，点分隔符之间有且仅有一个自然语义的英语单词  
8.测试类命名检查:测试类命名以它要测试的类名开始，以 Test 结尾  
9.对于 Service 和 DAO 类，暴露出来的服务一定是接口，
    内部的实现类用 Impl 的后缀与接口区别 

• 注释

10.所有的类都必须添加创建者信息   提示
11.类、类属性、类方法的注释必须使用javadoc规范，使用/**内容*/格式，
    不得使用//xxx方式和/*xxx*/方式
12.所有的枚举类型字段必须要有注释，说明每个数据项的用途 

• 多线程

13.线程池不允许使用Executors去创建，而是通过ThreadPoolExecutor的方式,
    规避资源耗尽的风险
14.线程资源必须通过线程池提供，不允许在应用中自行显式创建线程

• 异常

15.不能在finally块中使用return,finally块中的return返回后方法结束执行,
    不会再执行try块中的return语句 
16.返回类型为基本数据类型，return包装数据类型的对象时，自动拆箱有可能产生NPE

• 流程控制

17.除常用方法（如getXxx/isXxx）等外，不要在条件判断中执行复杂的语句，
    将复杂逻辑判断的结果赋值给一个有意义的布尔变量，以提高可读性
18.在if/else/for/while/do语句中,代码块应该写在花括号里,否则可能会影响代码执行 
19.在一个switch块内，都必须包含一个default语句并且放在最后，即使它什么代码也没有
20.在一个switch块内，每个case通过break/return等来终止,要么通过注释来说明

• 面向对象

21.不能使用过时的类或方法 
22.所有的包装类对象之间值的比较，全部使用equals方法比较
23.获取当前毫秒数：System.currentTimeMillis(); 而不是new Date().getTime()

• 集合

24.集合初始化时，指定集合初始值大小
25.ArrayList的subList结果不可强转成ArrayList，否则会抛出ClassCastException异常

• 其他

26.避免用Apache Beanutils进行属性的copy
27.iBATIS自带的queryForList(String statementName,int start,int size)不推荐使用
28.正确使用正则表达式,利用好其预编译功能,可以有效加快正则匹配速度 
29.所有的抽象方法（包括接口中的方法）必须要用javadoc注释、除了返回值、参数、异常说明外，
    还必须指出该方法做什么事情，实现什么功能 
30.Object的equals方法容易抛空指针异常，应使用常量或确定有值的对象来调用equals