今早阿里雲開發社區發佈了嵩山版《Java開發手冊》前端
![](http://static.javashuo.com/static/loading.gif)
那此次新版本的更新有哪些亮點呢?《Java開發手冊(嵩山版)》特別增長了先後端交互的一些規約,並修復了一些原來存在的一些問題,接下來讓咱們先品嚐一些嵩山版帶來的新的滋味吧。redis
在先後端工程師分工協做越發廣泛的今天(先後端分離,前端幹前端的事情,後端幹後端的事情),使效率獲得大大的提高,可是凡事有利也有弊,分離的同時也帶來了不少協做上的問題。本次開發手冊新增的先後端規約旨在解決先後端工程師協做上的問題以及讓你們規避工做中常見的、易於疏漏的錯誤,讓你們少走彎路。
在如今的先後端協做當中溝通就顯得極爲重要,可是規範大於約定,正所謂「沒有規矩,不成方圓」,大到先後端API的約定,小到先後端的時間格式約定,咱們都得精心設計已達到最優的效果。walking本人就親眼看到過身邊的同事由於先後端編碼不規範,API不規範,沒有溝通到位而大打出手的(脾氣都太火爆了😥)。用蘋果的宣傳語來說即是「惟一的不一樣,是到處不一樣」,因此若是每一個系統都對應着本身的一套先後端約定那就很是不利於維護,混亂的約定更讓系統接手與維護的人頭痛不堪。規矩並不是枷鎖,而是老司機們上路的安全帶,有了它,才能讓咱們在程序的世界裏安全的馳騁,去最大可能的提高效率,去創造更大的奇蹟。
在先後端交互的過程中,API是重中之重,一個好的API應該可以明確協議、域名、路徑、請求方法、請求內容、狀態碼、響應體等7個重要要素。一個好的API約定會讓先後端雙方可以爲接下來的開發工做節省許多時間和溝通的成本,是咱們先後端協做的基石。
不一樣於後端程序的各類數字類型的明確區分,在JS的世界裏數字只有一種類型,那就是Number類型,後端的API中每每會返回一些狀態字段,結果值是0、一、2這些,若是沒有約定好前端就不知道這是數字啊仍是字符串,還有,先後端傳參時若是沒有約定好字段類型也會引起後端的數據類型轉換異常。而前端的Number類型它實際上是雙精度浮點數,所以,它形成的麻煩老是令人困惑和痛苦,當咱們將一個過大的整數傳遞給前端的時候,想象一下當它超過了雙精度浮點數能最精確表示範圍的時候會出現怎麼樣的悲劇吧?欲知詳情如何,請見嵩山版開發手冊吧。
你是否曾經把異常帶到了頁面上?你是否把系統的錯誤提示發給了一臉懵的用戶?walking曾經在和別的系統對接的時候,就看到對方把空指針的堆棧信息都返回給我了😱。今天,先後端規約將助你擺脫這樣尷尬的境遇。用戶體驗不只僅是產品設計須要考慮的部分,做爲技術人的咱們更應該注重產品自己的質量,所以用戶提示必定要與系統自己的錯誤區分開,給用戶更友好的提示也是系統魯棒性的象徵,另外發生錯誤的時候返回給前端的信息除了上面兩種錯誤信息再搭配上錯誤碼與HTTP狀態碼一塊兒食用更香哦。
不少場景須要咱們用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 的知識點思惟導圖分享給你們app
![](http://static.javashuo.com/static/loading.gif)