下载 | 阿里Java开发手册嵩山版

今早阿里云开发社区发布了嵩山版《Java开发手册》

那此次新版本的更新有哪些亮点呢？《Java开发手册（嵩山版）》特别增长了先后端交互的一些规约，并修复了一些原来存在的一些问题，接下来让咱们先品尝一些嵩山版带来的新的滋味吧。

在先后端工程师分工协做越发广泛的今天（先后端分离，前端干前端的事情，后端干后端的事情），使效率获得大大的提高，可是凡事有利也有弊，分离的同时也带来了不少协做上的问题。本次开发手册新增的先后端规约旨在解决先后端工程师协做上的问题以及让你们规避工做中常见的、易于疏漏的错误，让你们少走弯路。

在如今的先后端协做当中沟通就显得极为重要，可是规范大于约定，正所谓“没有规矩，不成方圆”，大到先后端API的约定，小到先后端的时间格式约定，咱们都得精心设计已达到最优的效果。walking本人就亲眼看到过身边的同事由于先后端编码不规范，API不规范，没有沟通到位而大打出手的（脾气都太火爆了😥）。用苹果的宣传语来说即是“惟一的不一样，是到处不一样”，因此若是每一个系统都对应着本身的一套先后端约定那就很是不利于维护，混乱的约定更让系统接手与维护的人头痛不堪。规矩并不是枷锁，而是老司机们上路的安全带，有了它，才能让咱们在程序的世界里安全的驰骋，去最大可能的提高效率，去创造更大的奇迹。

是先后端交互API的约定

在先后端交互的过程中，API是重中之重，一个好的API应该可以明确协议、域名、路径、请求方法、请求内容、状态码、响应体等7个重要要素。一个好的API约定会让先后端双方可以为接下来的开发工做节省许多时间和沟通的成本，是咱们先后端协做的基石。

整数精度丢失的问题

不一样于后端程序的各类数字类型的明确区分，在JS的世界里数字只有一种类型，那就是Number类型，后端的API中每每会返回一些状态字段，结果值是0、一、2这些，若是没有约定好前端就不知道这是数字啊仍是字符串，还有，先后端传参时若是没有约定好字段类型也会引起后端的数据类型转换异常。而前端的Number类型它实际上是双精度浮点数，所以，它形成的麻烦老是令人困惑和痛苦，当咱们将一个过大的整数传递给前端的时候，想象一下当它超过了双精度浮点数能最精确表示范围的时候会出现怎么样的悲剧吧？欲知详情如何，请见嵩山版开发手册吧。

系统错误信息与用户提示信息混淆

你是否曾经把异常带到了页面上？你是否把系统的错误提示发给了一脸懵的用户？walking曾经在和别的系统对接的时候，就看到对方把空指针的堆栈信息都返回给我了😱。今天，先后端规约将助你摆脱这样尴尬的境遇。用户体验不只仅是产品设计须要考虑的部分，做为技术人的咱们更应该注重产品自己的质量，所以用户提示必定要与系统自己的错误区分开，给用户更友好的提示也是系统鲁棒性的象征，另外发生错误的时候返回给前端的信息除了上面两种错误信息再搭配上错误码与HTTP状态码一块儿食用更香哦。

URL参数传递注意长度

不少场景须要咱们用URL来作先后端的参数传递，可是比较蛋疼的是URL有最长长度的限制，而不一样的浏览器对URL最大长度限制倒是不一样的。这些不明确的地方都是不易察觉的深坑，不知道栽进去了多少的仁人志士，为了规避掉入这样的深坑，先后端规约中特别指出，对于URL长度限制采用全部浏览器限制的最小值，为2048字节。

不但有文档，还有集成开发工具插件

Java 规约插件

为了让开发者更加方便、快速的将规范推进并实行起来，阿里巴巴基于手册内容，研发了一套自动化的IDE检测插件（IDEA、Eclipse）， 该插件在扫描代码后，将不符合《手册》的代码按Blocker/Critical/Major三个等级显示在下方，甚至在IDEA上，还基于Inspection机制提供了实时检测功能，编写代码的同时也能快速发现问题所在。

Alibaba Cloud Toolkit

从Java代码检查到持续集成、自动化测试、自动部署，全面覆盖研发部署工做场景，支持IntelliJ IDEA、Eclipse、Visual Studio Code等不一样IDE，无需对接第三方工具，大幅提高研发效率。 支持一键部署至任意服务器及云端（ECS、EDAS、ACK、ACR、小程序云等），有效下降开发者重复性工做量。

下载学习

公众号后台回复嵩山，获取下载连接

欢迎关注公众号，编程大道，以前整理的 redis 和 MQ 的知识点思惟导图分享给你们

本文分享自微信公众号 - 编程大道（learn_code）。
若有侵权，请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一块儿分享。