会当凌绝顶,一览众山小。经过一年的修炼,《Java 开发手册》泰山版于 4.22 正式发布。泰山版发布之后,我便立马去下载简单阅读了一下新增加了内容。

Guide 哥:我平时会经常拿出来看看,里面的很多精华都是阿里工程师踩坑而得,学到就可以立马用到,避免再犯同样的错误。

JAVA手册在哪看 java手册下载_Java

泰山版实际增加的内容不是很多,并没有太多的惊喜,毕竟它的内容本来就已经非常棒了,还是一如既往的实用!

相比于华山版来说主要增加了如下内容:

异常日志这块增加了对于错误码的规定;

编程规约这块主要增加了:关于日期和时间的一些约束

集合处理这块增加了一些新的规定(大部分都和 Java8 新增加的特性有关);

三目运算的自动拆箱可能导致 NPE 问题

sql 语句主要增加表的别名增加了两条规定;

修改描述 90 处。比如,阻塞等待锁、建表的小数类型等。


JAVA手册在哪看 java手册下载_JAVA手册在哪看_02

按照官方的来说这次总结可以概括为:

本次泰山版是一次全新的革新,涉及到集合转化函数式接口中的深坑、年份天数写死所带来的问题、SQL 多表操作未加表名对字段限制惨案、以及统一错误码能够为我们带来的巨大好处。

带大家简单看一下!

增加了对于错误码的一些规定

我在使用枚举简单封装一个优雅的 Spring Boot 全局异常处理! 这篇文章中也使用到了错误码,但是关于错误的码设计并没有完全满足阿里巴巴开发手册的要求。我之前设计错误码的时候只是单纯使用 4 位数字唯一表示每一种错误,并没有区分具体场景。而阿里巴巴开发手册它要求将错误产生来源分为 3 类,这样确实更好一点:

A :错误来源于用户,比如参数错误,用户安装版本过低,用户支付 超时等问题;

B :错误来源于当前系统,往往是业务逻辑出错,或程序健壮性差等问题;

C :错误来源于第三方服务,比如 CDN 服务出错,消息投递超时等问题;

错误码的第一位是错误产生来源,后四位数字编号从 0001 到 9999,比如 A0001 表示用户端错误。


JAVA手册在哪看 java手册下载_错误码_03

多表操作的话需要在字段前加上表的别名避免多表之间存在相同的名字(多表之间存在项目的相同名字的字段很常见)


JAVA手册在哪看 java手册下载_错误码_04

三目运算的自动拆箱可能导致 NPE 这个问题之前倒是没有注意过,算是一个小坑吧!

JAVA手册在哪看 java手册下载_Java_05


JAVA手册在哪看 java手册下载_JAVA手册在哪看_06

切勿把天数写死,推荐使用 Java8 相关的日期类


JAVA手册在哪看 java手册下载_多表_07

使用 java.util.stream.Collectors类的toMap()方法的时候要注意


JAVA手册在哪看 java手册下载_泰山版java开发手册下载_08

考虑到很多读者对这个方法不太了解,我写了一个简单的 Demo,大家感受一下:

public class ToMapDemo{
public static void main(String[] args){
List lt = new ArrayList<>();
lt.add(new ProgramLanguage(1, "Java"));
lt.add(new ProgramLanguage(2, "C++"));
lt.add(new ProgramLanguage(2, "Python"));
Map map = lt.stream().collect(Collectors.toMap(ProgramLanguage::getId, ProgramLanguage::getName,(x, y) -> x + ", " + y));
map.forEach((x, y) -> System.out.println(x + "=" + y));
}
static class ProgramLanguage{
// key
private Integer id;
// value
private String name;
public ProgramLanguage(Integer id, String name){
this.id = id;
this.name = name;
}
public Integer getId(){
return id;
}
public String getName(){
return name;
}
}
}

输出:

1=Java
2=C++, Python

toMap方法如下,可以看出这个方法默认返回的是 HashMap,前两个参数一个是获取 key,一个是获取 value,第三个参数的作用是处理相同 key 的情况。

Collector> toMap(Function super T, ? extends K> keyMapper,
Function super T, ? extends U> valueMapper,
BinaryOperator mergeFunction) {
return toMap(keyMapper, valueMapper, mergeFunction, HashMap::new);
}

更多内容还需要自己去探索啦!

JAVA手册在哪看 java手册下载_错误码_09

配合阿里巴巴对应开发的插件— Alibaba Java Code Guidelines(阿里巴巴 Java 代码规范)效果更佳哦!我在《第一弹!安排!安利 10 个让你爽到爆的 IDEA 必备插件!》这篇文章中也推荐到了这个插件。

阿里巴巴 Java 代码规范,对应的 Github 地址为:https://github.com/alibaba/p3c 。

下载地址:https://gitee.com/SnailClimb/awesome-java/raw/master/books/%E6%B3%B0%E5%B1%B1%E7%89%88%E3%80%8AJava%E5%BC%80%E5%8F%91%E6%89%8B%E5%86%8C%E3%80%8B.pdf