( ( 二) ) 日志规约    【强制】应用中不可直接使用日志系统 （Log4j、Logback） 中的 API ，而应依赖使用日志框架SLF4J 中的 API ，使用门面模式的日志框架，有利于维护和各个类的日志处理方式统一。 import org.slf4j.Logger; import org.slf4j.LoggerFactory; private static final Logger logger = LoggerFactory.getLogger(Abc.class);  【强制】日志文件至少保存 15 天，因为有些异常具备以“周”为频次发生的特点。  【强制】应用中的扩展日志 ...

【强制】Java 类库中定义的可以通过预检查方式规避的 RuntimeException 异常不应该通过catch 的方式来处理，比如： NullPointerException ， IndexOutOfBoundsException 等等。 说明：无法通过预检查的异常除外，比如，在解析字符串形式的数字时，不得不通过 catch NumberFormatException 来实现。 正例：if (obj != null) { System.out.println(obj); } try { obj.method(); } catch (NullPointerException e) { e.p...

除了用完就会舍弃的内容，类和方法的声明中都可以加上public，这样就可以在任何地方使用。  在类中，可以根据需要定义访问。用于获取字段abc的值的getter方法可以定义为getAbc，用于设置值的setter方法可以定义为setAbc。  当使用赋值或初始化复制类类型变量的值时，复制的并不是所有字段的值，而是引用目标。当通过方法的参数传递类类型的变量时，传递的实例的引用（类似于指针）。  当使用相等运算符比较类类型变量的值时，判断的是引用目标是否相等，而不是判断所有字段的值是否相等。  如果重载构造函数，该类的实例构建方法的选择范围就比较广了。在构造函数的开头，可以使用this(……)调用...

( 九) ) 其它    【强制】在使用正则表达式时，利用好其预编译功能，可以有效加快正则匹配速度。 说明：不要在方法体内定义： Pattern pattern = Pattern . compile(“ 规则 ”); /** 正则表达式：用来校验网址正确性的 */ private static final Pattern WEBSITEURL_REGEX = Pattern.compile( "^([hH][tT]{2}[pP]:/*|[hH][tT]{2}[pP][sS]:/*|[fF][tT][pP]:/*)(([A-Za-z0-9-~]+).)+([A-Za-z0-9-~\\...

( 八) ) 注释规约 Java IDE中设置作者日期等Javadoc注释信息    【强制】类、类属性、类方法的注释必须使用 Javadoc 规范，使用/*内容/格式，不得使用 // xxx 方式。 说明：在 IDE 编辑窗口中， Javadoc 方式会提示相关注释，生成 Javadoc 可以正确输出相应注释 ； 在 IDE 中，工程调用方法时，不进入方法即可悬浮提示方法、参数、返回值的意义，提高阅读效率。 建议 /** * 获取用户信息 * @param userId [用户id，对应数据库中的userid字段] * @return [返回单个用户或空] */ public User ge...

控制语句    【强制】在一个 switch 块内，每个 case 要么通过 break/return 等来终止，要么注释说明程序将继续执行到哪一个 case 为止； 在一个 switch 块内，都必须包含一个 default 语句并且放在最后，即使空代码。 switch(statementsOrVariable) { case finalValue1: //do something; break; case finalValue2: //do something; break; case finalValue3: // you can add default here to make def...

阿里巴巴java开发手册:第一章，第六节 并发处理   新增16条设计规约！阿里巴巴Java开发手册（详尽版）开放下载！    【强制】获取单例对象需要保证线程安全，其中的方法也要保证线程安全。 说明：资源驱动类、工具类、单例工厂类都需要注意。  【强制】创建线程或线程池时请指定有意义的线程名称，方便出错时回溯。 正例： public class TimerTaskThread extends Thread { public TimerTaskThread() { super.setName("TimerTaskThread"); //... } }  【强制】线程资源必须...

集合处理    【强制】关于 hashCode 和 equals 的处理，遵循如下规则： 1） 只要重写 equals ，就必须重写 hashCode 。 2） 因为 Set 存储的是不重复的对象，依据 hashCode 和 equals 进行判断，所以 Set 存储的 对象必须重写这两个方法。 3） 如果自定义对象作为 Map 的键，那么必须重写 hashCode 和 equals 。 说明： String 重写了 hashCode 和 equals 方法，所以我们可以非常愉快地使用 String 对象 作为 key 来使用。  【强制】 ArrayList 的 subList 结果不可强转...

(三)代码格式    【强制】大括号的使用约定。如果是大括号内为空，则简洁地写成{}即可，不需要换行； 如果 是非空代码块则： 1） 左大括号前不换行。 2） 左大括号后换行。 3） 右大括号前换行。 4） 右大括号后还有 else 等代码则不换行； 表示终止的右大括号后必须换行。  public void emptyBaseFunction(){} public void notEmptyFunction(){ int age = 100; if (age<100){ //do something; } else { //do another thing } }   【强制】 左小括号...

( ( 二) ) 常量定义    【强制】不允许任何魔法值 （ 即未经预先定义的常量 ） 直接出现在代码中。 反例： String key = "ID#taobao_" + tradeId; *** . put(key , value);  public static final String KEY_PREFIX="ID#taobao_"; String key = KEY_PREFIX+tradeId; ***.put(key,value);   【强制】 long 或者 Long 初始赋值时，使用大写的 L ，不能是小写的 l ，小写容易跟数字 1...

目录   数组是相同类型的变量的集合。各个变量是构成元素，变量的类型是构成元素类型。构成元素本身为数组的数组，称为***数组。 数组主体是使用new运算符，在程序运行时动态创建的对象。数组变量引用该数组主体。 用于访问一个数组a中各个构成元素的表达式是对数组变量运用索引运算符的a[i]。方括号中的索引是从零开始连续编号的整数型数值。 数组中各构成元素如果没有进行显示初始化，则会初始化为默认值零（注：int[]数组）。 数组的初始化是将各个构成元素的初始值（1，2，3）用大括号括起来的形式{1,2,3,}。最后一个逗号可以省略。当为***数组时，则使用嵌套结构。{{1,2,3},{2,3,4}}...

一、编程规约  (一) 命名风格  1. 【强制】代码中的命名均不能以下划线或美元符号开始，也不能以下划线或美元符号结束。  反例：_name / __name / $name / name_ / name$ / name__  正例：name算正例吗？一般情况下，建议还是加一个标识单词放前面，因为name被重名的机会太多了。 比如对于一本书中就有好多如bookName,publisherName,authorName等等。 2. 【强制】代码中的命名严禁使用拼音与英文混合的方式，更不允许直接使用中文的方式。 说明：正确的英文拼写和语法可以让阅读者易于理解，避免歧义。注意，即使纯拼音命名方式 ...

目录   第五章 小结   java中可以使用的类型分为基本类型和引用类型   基本类型分为数值类型和布尔型。数值类型又分为整型和浮点型。   类型不同，表示数值的位也有所不同。   整型是表示一定范围内连续的整数的类型。整型分为char型、byte型、short型、int型、long型。   char型以外的整数型是表示负值、0、正值的有符号整型。其内部通过补码表示的形式来表示。   整数常量是int型，但如果加上整形后缀L或l(阿里巴巴java开发规范，建议使用大写L，以免和数字1引起视觉上的混淆),就变成了long型。如果开头是0x或0X，则为十六进制整数常量，如果开头是0并且是2位以上...

目录 手段：先从明解java和practical Java两本书的代码开始学习整理。   方法：   用eclipse的插件进行学习整理。   附：   1、定期更新的重新规范的明解java代码   https://github.com/finersoft/ShinMeiKaiJava   2、定期更新的重新规范的Practical Java代码   https://github.com/finersoft/PracticalJava   3、一个简单java代码的规范写法  /** * 文件说明 * */ package com.alibaba.javamanuals; /** * 名称：J...