泰山版java开发手册下载_「Java开发者的福音」泰山版《Java开发手册》速览!附下载地址。...

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

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

b1494e2a42793c85040f0f5319a24416.png

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

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

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

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

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

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

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

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

4e473e290d59a601ebaade7fd11bcfb6.png

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

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

带大家简单看一下!

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

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

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

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

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

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

c865110d4003eed1a60583b3a8c53668.png

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

eb07d16574bbb49d248ec40979d35a02.png

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

a44b09b3f58fa5d591a9b5fd079e5065.png

6d82c8f58110ce6e245694b448be426a.png

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

965978c644f64ff4fd0a93e89fb0c110.png

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

3e371da9fded98c6ce1c7eafa0f99c86.png

考虑到很多读者对这个方法不太了解,我写了一个简单的 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);

}

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

4e68675533bbf06dd73ff336624efdaa.png

配合阿里巴巴对应开发的插件— 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

前言 《Java 开发手册》是阿里巴巴集团技术团队的集体智慧结晶和经验总结,经历了多次大规模一线实战的检验及不断完善,公开到业界后,众多社区开发者踊跃参与,共同打磨完善,系统化地整理成册,当前的本是泰山。现代软件行业的高速发展对开发者的综合素质要求越来越高,因为不仅是编程知识点,其它维度的知识点也会影响到软件的最终交付质量。比如:数据库的表结构和索引设计缺陷可能带来软件上的架构缺陷或性能风险;工程结构混乱导致后续维护艰难;没有鉴权的漏洞代码易被黑客攻击等等。所以本手册Java 开发者为中心视角,划分为编程规约、异常日志、单元测试、安全规约、MySQL 数据库、工程结构、设计规约七个维度,再根据内容特征,细分成若干二级子目录。另外,依据约束力强弱及故障敏感性,规约依次分为强制、推荐、参考三大类。在延伸信息中,“说明”对规约做了适当扩展和解释;“正例”提倡什么样的编码和实现方式;“反例”说明需要提防的雷区,以及真实的错误案例。 手册的愿景是码出高效,码出质量。现代软件架构的复杂性需要协同开发完成,如何高效地协同呢?无规矩不成方圆,无规范难以协同,比如,制订交通法规表面上是要限制行车权,实际上是保障公众的人身安全,试想如果没有限速,没有红绿灯,谁还敢上路行驶?对软件来说,适当的规范和标准绝不是消灭代码内容的创造性、优雅性,而是限制过度个性化,以一种普遍认可的统一方式一起做事,提升协作效率,降低沟通成本。代码的字里行间流淌的是软件系统的血液,质量的提升是尽可能少踩坑,杜绝踩重复的坑,切实提升系统稳定性,码出质量。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值