摘要：作者介紹鮑協(xié)浩，小米部門，基礎應用組通訊錄開發(fā)負責人問題現(xiàn)象在業(yè)務同步的邏輯代碼中，使用到了來解析服務端的數(shù)據(jù)。

作者介紹：鮑協(xié)浩，小米MIUI部門， MIUI基礎應用組通訊錄開發(fā)負責人

在 Android 業(yè)務同步的邏輯代碼中，使用到了 JSONObject 來解析服務端的 JSON 數(shù)據(jù)。同時本地因為業(yè)務新增需求的緣故，在本地數(shù)據(jù)庫中使用 JSONObject 緩存了包括水位等同步相關的信息，其中，水位值是 Long 型。但近期發(fā)現(xiàn)同步過程中下一次同步時，傳遞給服務器的水位并不是上一次服務器返回的新水位，而是相差一些。以 301028292893495297L 為例，服務器返回這個水位之后，下次客戶端上傳的水位是 301028292893495296L，差值為 -1。

通過反復排查代碼邏輯，發(fā)現(xiàn)水位從服務端返回到下次請求之間，只經(jīng)過了以下轉(zhuǎn)換：

認真閱讀代碼不難發(fā)現(xiàn)，Long 型的水位值保存在 JSON 對象中的時候轉(zhuǎn)成了 String 型，而在讀取的時候又當作是 Long 型來處理。因此會有精度缺失的問題，參見如下 JSONObject 的文檔：

由此可見，在讀取 JSON 對象的某個值時，如果原先是 String 型，讀取的時候當作是 Long 型，是會將 String 型通過 Double 進行解析的，所以在值超過 2^52 時會有精度缺失的問題。于是，遇到的問題就可以解釋了。以下是 Double 的存儲格式規(guī)范：

其中，Double 和 Long 的精度測試代碼很簡單(輸入?yún)?shù)可以提供例如 301028292893495297L 這樣超過 2^52 的 long 值，會發(fā)現(xiàn)其返回值不為 0)：

Double 和 Long 的精度測試代碼很簡單(輸入?yún)?shù)可以提供例如 301028292893495297L 這樣超過 2^52 的 long 值)：

知道了問題的根源，修復就一目了然了，在水位保存在 JSONObject 對象中時，應該當作 Long 型而不是 String 型來保存；亦或者在讀取的時候也當作是 String 型，然后通過 Long.valueOf 等接口進行解析。

另外，關于 JSON 對象中的值是 Long 型還是 String 型，其實比較容易被忽略。如果JSON 對象在使用 String 表示的時候，該值對應處有引號就是 String 型。看如下的試用例就一目了然了：

類似的問題在網(wǎng)上隨意一搜，其實有許多人遇坑了，比如這個。

所以，盡管不能說這個庫的設計是很失敗的，但肯定不算是一個設計良好的庫。因為你無法直接從 API 名稱看出其內(nèi)在的潛在邏輯，容易導致使用者使用不當。因此，經(jīng)驗教訓就是：使用第三方庫的時候，能看 API 文檔就看 API 文檔，切不可望文生義。當然，這個問題可能也僅限在 Android 中較老的代碼模塊，畢竟新的代碼都會使用 GSON 等類庫進行 JSON 對象操作，也就不容易出現(xiàn)這樣的不易發(fā)現(xiàn)的問題了。

當然，單就這個問題來看，其實是在新增業(yè)務邏輯的時候，沒有正確使用 JSONObject 對象的接口，Long 型的值不應當看成是 String 型進行保存而又當成是 Long 型來讀取，如果保存和讀取的接口保持對應，也就不會出現(xiàn)問題了。不管怎么說，該問題的教訓是在使用 JSONObject 相關接口時要倍加小心謹慎。

備注：Github 上最新的 JSON-Java 庫沒有這個問題，可以放心使用。

知道了問題的根源，修復就一目了然了，在水位保存在 JSON 對象中時，應該當作 Long 型而不是 String 型來保存；或者在讀取的時候也當作是 String 型，然后通過 Long.valueOf 等接口進行解析。

問題后話

類似的問題在網(wǎng)上隨意一搜，其實有許多人遇坑了，比如這個。所以，盡管不能說這個庫的設計是很失敗的，但肯定不算是一個設計良好的庫。因為你無法直接從 API 名稱看出內(nèi)在的潛在邏輯，導致使用不當。因此，經(jīng)驗教訓就是：使用第三方庫的時候，能看 API 文檔就看 API 文檔，切不可望文生義。

當然，Github 上最新的 JSON-Java 庫是沒有這個問題的。

小米開放平臺重磅推出小米帳號接入有禮活動：成功接入小米帳號即可獲得小米開放平臺免費提供的平臺資源（小米應用商店、小米卡包、小米推送vip、小米帳號聯(lián)盟等資源），機會不容錯過，我們期待您的加入！
活動報名地址：http://dev.xiaomi.com/console...

官方QQ交流群：398616987
想要了解更多？
那就關注我們吧！