DIV CSS 佈局教程網

JSON 對象常用操作函數封裝:長度、鍵值提取與類型校驗
編輯:JavaScript基礎知識     

項目裡 JSON 的處理頻率非常高,把幾個高頻操作抽成工具函數,之後直接調用即可,能省下不少重複勞動,也便於日後維護。以下四個函數分別負責:格式校驗與歸一化、長度計算、提取全部 key、提取全部 value。

一、校驗並歸一化為 JSON 對象

這個函數同時接受 JSON 對象與 JSON 格式字符串,內部先做判斷:是字符串就解析,是對象就直接返回,其餘情況提示並返回 false。

/**
 * 檢驗傳入的參數是否為 JSON 對象或 JSON 格式字符串
 * 符合條件返回 JSON 對象,否則返回 false
 * 注意:'weiyl'、'abcd' 這類普通字符串不是合法 JSON,會拋出異常
 */
function toJson(json) {
  var type = typeof json;
  // 同時判斷 type 與 json 本身,可排除 null、undefined 與空字符串
  if (type == "string" && json) {
    return JSON.parse(json);
  } else if (type == "object") {
    return json;
  } else {
    alert('你傳入的參數 ' + json + ',不是 JSON 對象或 JSON 格式的字符串');
    return false;
  }
}

二、獲取 JSON 的長度

JSON 沒有 length 屬性,只能透過 for...in 遍歷計數。這裡先複用 toJson 做歸一化,再排除不適用的類型,最後統計屬性個數,非法輸入返回 -1。

/**
 * 傳入 JSON 對象或 JSON 格式字符串,返回其長度;不合法則返回 -1
 */
function getJsonLen(jsonObj) {
  jsonObj = toJson(jsonObj);
  var type = typeof jsonObj;
  if (type == "boolean" || type == "undefined" ||
      type == "number" || type == "function") {
    return -1;
  }
  var len = 0;
  for (var item in jsonObj) {
    len++;
  }
  return len;
}

順帶複習 typeof 的六種返回值:"undefined"(未定義)、"boolean"(布爾值)、"string"(字符串)、"number"(數值)、"object"(對象或 null)、"function"(函數)。

三、提取所有 key

/**
 * 傳入 JSON 對象或 JSON 字符串,以數組返回所有 key;不合法則返回 -1
 */
function getJsonKey(JsonObj) {
  var len = getJsonLen(JsonObj);
  if (len == -1) {
    return -1;
  }
  var array = [];
  // getJsonLen 內部已完成合法性判斷,這裡可直接遍歷
  for (var item in JsonObj) {
    array.push(item);
  }
  return array;
}

四、提取所有 value

/**
 * 傳入 JSON 對象或 JSON 字符串,以數組返回所有 value;不合法則返回 -1
 */
function getJsonValue(JsonObj) {
  var len = getJsonLen(JsonObj);
  if (len == -1) {
    return -1;
  }
  var array = [];
  for (var item in JsonObj) {
    array.push(JsonObj[item]);
  }
  return array;
}

設計上的兩點說明

第一,層層複用而非重複校驗。getJsonKey 與 getJsonValue 都不再自行判斷格式,而是依賴 getJsonLen 的返回值做前置攔截,讓校驗邏輯集中在一處,後續修改只改一個地方。

第二,用 -1 而非拋異常表達失敗。這樣調用方可以用簡單的數值比較來分支處理,不必到處寫 try...catch;代價是丟失了具體錯誤信息,若用於對外接口,建議改成拋出自定義異常。

還有一個實務提醒:for...in 會枚舉原型鏈上的可枚舉屬性。若數據來源不可控,可在遍歷時加上 hasOwnProperty 判斷,避免混入非自身屬性。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved