前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >「Java开发者的福音」泰山版《Java开发手册》速览!附下载地址。

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

作者头像
Guide哥
发布2020-05-07 15:58:10
6830
发布2020-05-07 15:58:10
举报
文章被收录于专栏:JavaGuideJavaGuide

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

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

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

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

  1. 异常日志这块增加了对于错误码的规定;
  2. 编程规约这块主要增加了:
    • 关于日期和时间的一些约束
    • 集合处理这块增加了一些新的规定(大部分都和 Java8 新增加的特性有关);
    • 三目运算的自动拆箱可能导致 NPE 问题
  3. sql 语句主要增加表的别名增加了两条规定;
  4. 修改描述 90 处。比如,阻塞等待锁、建表的小数类型等。

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

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

带大家简单看一下!

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

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

  1. A :错误来源于用户,比如参数错误,用户安装版本过低,用户支付 超时等问题;
  2. B :错误来源于当前系统,往往是业务逻辑出错,或程序健壮性差等问题;
  3. C :错误来源于第三方服务,比如 CDN 服务出错,消息投递超时等问题;

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

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

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

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

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

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

代码语言:javascript
复制
public class ToMapDemo {
    public static void main(String[] args) {
        List<ProgramLanguage> lt = new ArrayList<>();

        lt.add(new ProgramLanguage(1, "Java"));
        lt.add(new ProgramLanguage(2, "C++"));
        lt.add(new ProgramLanguage(2, "Python"));

        Map<Integer, String> 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;
        }
    }
}

输出:

代码语言:javascript
复制
1=Java
2=C++, Python

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

代码语言:javascript
复制
    Collector<T, ?, Map<K,U>> toMap(Function<? super T, ? extends K> keyMapper,
                                    Function<? super T, ? extends U> valueMapper,
                                    BinaryOperator<U> mergeFunction) {
        return toMap(keyMapper, valueMapper, mergeFunction, HashMap::new);
    }

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

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

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2020-04-24,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 JavaGuide 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
相关产品与服务
内容分发网络 CDN
内容分发网络(Content Delivery Network,CDN)通过将站点内容发布至遍布全球的海量加速节点,使其用户可就近获取所需内容,避免因网络拥堵、跨运营商、跨地域、跨境等因素带来的网络不稳定、访问延迟高等问题,有效提升下载速度、降低响应时间,提供流畅的用户体验。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档