您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 程式設計技術

iOS 網路編程:JSON 結構解析與 NSJSONSerialization 用法

編輯:iOS 程式設計技術

一、JSON 結構

1.1 簡介

JSON(JavaScript Object Notation)是儲存與交換文字資訊的語法格式,概念上類似 XML,但體積更小、解析更快。所謂輕量,指的是描述相同資料所需的字元數遠少於 XML。

簡單說,JSON 由兩種資料型別組成:陣列與字典。

1.2 語法

JSON 語法是 JavaScript 語法的子集,但對 iOS 開發而言不需深入研究 JavaScript。

(1)基本規則

  • 資料以「名稱/值」成對呈現
  • 項目之間以逗號分隔
  • 物件用大括號包圍(無序容器)
  • 陣列用中括號包圍(有序容器)

(2)名稱/值對

相當於 iOS 中的字典,也就是映射表;但 JSON 的「名稱」必須是字串。格式為:名稱置於雙引號中,接一個冒號,然後是值。

"firstName": "John"

(3)值的型別

  • 數字(整數或浮點數)
  • 字串(置於雙引號中)
  • 布林值(true/false)
  • 陣列(置於中括號中)
  • 物件(置於大括號中)
  • null

圖 1

(4)物件

物件寫在大括號中,可包含多組「名稱/值」對,本質上是無序的鍵值集合。

圖 2

{ "firstName": "John", "lastName": "Doe" }

(5)陣列

陣列寫在中括號中,可包含多個物件,本質上是值的有序集合。

圖 3

{
  "employees": [
    { "firstName": "John",  "lastName": "Doe" },
    { "firstName": "Anna",  "lastName": "Smith" },
    { "firstName": "Peter", "lastName": "Jones" }
  ]
}

上例中,employees 是一個包含三個物件的陣列,每個物件代表一筆員工紀錄。

二、JSON 解碼

2.1 iOS 的解碼技術選項

依效能由低到高分列:

  • JSON-framework:較早期的第三方庫
  • TouchJSON:同樣是老一輩的第三方庫
  • YAJL:較老但效能不俗
  • JSONKit:優秀的第三方框架,解碼速度快
  • NSJSONSerialization:iOS 5 之後 Apple 提供的官方 API,是目前的首選

2.2 NSJSONSerialization

這個類別的用法相當簡便,設計思路是透過一個「中介物件」與 JSON 資料互相轉換。中介可以是 NSData,也可以是串流。

2.2.1 以 NSData 為中介

NSData 能直接與檔案互動,因此最常這樣用:

注意:還原出來的物件型別取決於 JSON 最外層的符號——大括號對應字典,中括號對應陣列。

以如下的 Notes.json 為例:

{
  "ResultCode": 110,
  "Record": 112
}

解析為字典後再反向編碼回檔案:

- (void)viewDidLoad {
    [super viewDidLoad];

    NSString *path = [[NSBundle mainBundle] pathForResource:@"Notes" ofType:@"json"];

    NSData *jsonData = [[NSData alloc] initWithContentsOfFile:path];

    // 反序列化:NSData → 物件(此例最外層為大括號,故得字典)
    id jsonObj = [NSJSONSerialization JSONObjectWithData:jsonData options:0 error:nil];

    NSLog(@"%@", [jsonObj objectForKey:@"ResultCode"]);

    // 序列化:物件 → NSData
    NSData *outData = [NSJSONSerialization dataWithJSONObject:jsonObj options:0 error:nil];
    [outData writeToFile:@"/Users/tengfei/Desktop/s.json" atomically:YES];
}

2.2.2 以串流為中介

串流方式分別用兩個類別處理:解析時用 NSInputStream,編碼時用 NSOutputStream。

兩者的建立方式:

類別建立方法
NSInputStream+ inputStreamWithData:
+ inputStreamWithFileAtPath:
+ inputStreamWithURL:
- initWithData:
- initWithFileAtPath:
- initWithURL:
NSOutputStream+ outputStreamToMemory
+ outputStreamToFileAtPath:append:
+ outputStreamWithURL:append:
- initToMemory
- initToFileAtPath:append:
- initWithURL:append:

完整範例:

- (void)testJsonWithStream {
    NSString *path = [[NSBundle mainBundle] pathForResource:@"Notes" ofType:@"json"];

    // 建立輸入串流並開啟
    NSInputStream *inputStream = [[NSInputStream alloc] initWithFileAtPath:path];
    [inputStream open];

    id jsonObj = [NSJSONSerialization JSONObjectWithStream:inputStream
                                                 options:NSJSONReadingMutableLeaves
                                                   error:nil];

    NSLog(@"%@", [jsonObj objectForKey:@"ResultCode"]);

    // 建立輸出串流並開啟
    NSOutputStream *outputStream =
        [[NSOutputStream alloc] initToFileAtPath:@"/Users/tengfei/Desktop/s.json" append:YES];
    [outputStream open];

    [NSJSONSerialization writeJSONObject:jsonObj
                                 toStream:outputStream
                                  options:0
                                    error:nil];

    [inputStream close];
    [outputStream close];
}

兩種方式該怎麼選?小檔案用 NSData 最省事;處理大型 JSON(例如幾十 MB 的匯出檔)時,串流方式不必一次把整份資料讀進記憶體,明顯佔優勢。另外提醒,實務上傳入的 error 參數不該一律丟 nil——JSON 格式錯誤時若沒有接收 NSError,除錯會非常痛苦。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved