SwiftでJSONを扱う基本を完全ガイド！初心者でもわかるCodableの使い方

先生と生徒の会話形式で理解しよう

生徒

「Swiftでアプリを作ると、インターネットのデータを使うって聞いたんですが、本当にできますか？」

先生

「できますよ。SwiftではJSONという形のデータをよく使います。難しそうに見えますが、考え方はとても単純です。」

生徒

「JSONって何ですか？パソコンを触ったことがなくても理解できますか？」

先生

「大丈夫です。紙に書いた名簿を読む感覚で説明しますね。」

1. JSONとは何かをやさしく説明

JSONとは、データを文字で表現するための決まりごとです。名前と値をセットで書く形式で、人にもプログラムにも読みやすいのが特徴です。例えば、名前と年齢を書いた名簿のようなものだと考えると分かりやすいです。Swiftのアプリ開発では、サーバーからJSON形式でデータを受け取ることがとても多くあります。

2. SwiftでJSONを扱う理由

SwiftはiPhoneアプリやiPadアプリで使われる言語です。天気情報やニュース、ログイン情報など、多くのデータはインターネット経由でJSONとして届きます。そのため、JSONを理解することはSwiftの基本スキルの一つです。ここを押さえるだけで、できることが大きく広がります。

3. Codableとは何か

Codableは、SwiftでJSONを簡単に変換するための仕組みです。変換とは、JSONの文字をSwiftのデータにしたり、その逆をしたりすることです。Codableを使うと、難しい処理を書かなくても、自動で変換してくれます。


struct User: Codable {
    let name: String
    let age: Int
}

Go言語を基礎からスッキリ学びたい人や、文法だけでなく「実用的な使い方」まで押さえたい人には、定番の入門書がこちらです。

基礎からわかるGo言語をAmazonで見る

※ Amazon広告リンク

4. JSONをSwiftのデータに変換する

JSONの文字列をSwiftの構造体に変換することをデコードと呼びます。少し難しい言葉ですが、「読む」と思えば大丈夫です。名簿を見て、人の情報を頭に入れるイメージです。


let json = """
{"name":"Taro","age":20}
"""
let data = json.data(using: .utf8)!
let user = try JSONDecoder().decode(User.self, from: data)
print(user.name)


Taro

5. SwiftのデータをJSONに変換する

反対に、SwiftのデータをJSONの形にすることをエンコードと呼びます。これは「書く」作業です。自分の情報を紙に書き出すような感覚で考えると理解しやすいです。


let newUser = User(name: "Hanako", age: 25)
let jsonData = try JSONEncoder().encode(newUser)
let jsonString = String(data: jsonData, encoding: .utf8)!
print(jsonString)