JSON から Swift

関連おすすめ

JSONからSwiftについて：JSONデータをAppleエコシステムのネイティブ型に変換

ユースケース

• iOS開発：バックエンドREST APIが返すJSONをSwift structに変換し、SwiftUIまたはUIKitネットワーク層のモデリングとJSONDecoderデコードに使用
• macOS開発：アプリ設定JSONをSwift型に変換し、AppKitプロジェクトで型安全な設定読み取りを行い、スペルミスを回避
• watchOS開発：Apple Watchアプリの健康・運動データJSONをSwiftモデルに変換し、SwiftUIとHealthKitに接続
• tvOS開発：コンテンツレコメンドインターフェースJSONをSwift型に変換し、テレビアプリのホームページデータ表示とフォーカスナビゲーションに使用
• SwiftUI MVVMモデリング：APIデータモデルを@Publishedプロパティとして直接ViewModelにバインドし、画面ビューを駆動
• Combineリアクティブデータフロー：JSONレスポンス型をPublisherの出力型として使用し、JSONDecoderと組み合わせてリアクティブ解析を行う
• SwiftData/Core Data事前モデリング：先にSwift structを生成し、手動で@Modelまたは@NSManaged注釈を追加してエンティティマッピング
• サードパーティSDK連携：SDKドキュメントのJSONレスポンス例をSwift型に変換し、ログイン、決済、プッシュ、地図などのSDKに迅速に接続
• 単体テスト準備：インターフェースのモックJSONをSwift型に変換し、XCTestテストデータとアサーションに使用してテストの保守性を向上
• コードレビュー：APIが返すJSONをSwift型に変換し、チームのCode Review時にフィールド命名とオプショナル性について議論しやすくする
• Flutter/React Nativeハイブリッド開発：ネイティブSwiftモジュール呼び出し用のデータモデルを準備し、bridge層の型変換エラーを削減
• バックエンドインターフェース移行：RESTインターフェースドキュメントまたはPostmanサンプルJSONからSwiftクライアントモデルを生成し、バージョンアップ時に迅速に同期
• 教育研修：Swift/iOSコースでJSONから型システムへのマッピングをデモンストレーションし、学生がAPIデータモデリングと型安全を理解するのを支援
• 健康・フィットネスアプリ：HealthKit/Fitbitなどのインターフェースが返すJSONをSwift型に変換し、Apple Healthデータモデリングに使用
• 決済・金融アプリ：決済ゲートウェイのインターフェースレスポンスJSONをSwiftモデルに変換し、照合と例外処理を容易に
• ECオーダーシステム：注文、商品、住所などのJSONをSwift structに変換し、SwiftUIリストと詳細ページの表示に使用
• ニュース・コンテンツアプリ：コンテンツ管理システムのJSONレスポンスをSwift型に変換し、TableView/SwiftUIリスト/詳細ページに使用
• Vaporサーバーサイド開発：バックエンドAPIのリクエスト/レスポンスJSONをSwift構造体に変換し、サーバーサイドモデル定義とCodableエンコード/デコードに使用
• MapKitと地理データ：地図インターフェースが返すJSONをSwift structに変換し、場所検索、ルート計画、ジオコーディング結果のモデリングに使用

使い方

1. 左側のエディタにJSONコンテンツを貼り付けるか、アップロードボタンをクリックして.json/.txtファイルを選択、または内蔵サンプルデータをロード
2. ツールは400msのデバウンス後にquicktype-coreを自動的に呼び出して変換し、右側に生成されたSwift struct/classコードを表示
3. JSONフォーマットエラーがある場合は、「JSONを修復」ボタンをクリックして一般的な構文問題（末尾のカンマ、単一引用符、引用符の欠落など）を自動修復
4. 生成結果を確認し、プロジェクトの必要に応じてCodable/Equatable/Identifiableなどのプロトコルを手動で追加；「コピー」をクリックしてXcodeに貼り付けるか、「ダウンロード」をクリックして.swiftファイルとして保存

特徴

• 純粋なブラウザローカル変換：JSON解析とSwiftコード生成はすべてブラウザ内でquicktype-coreにより実行され、元のJSONと生成コードはサーバーにアップロードされません
• quicktype-core just-typesモード：クリーンなSwift struct/classプロパティ宣言を出力。importなし、Codable/CodingKeysなどの注釈なしで、プロジェクトの必要に応じて加工が容易
• 400msデバウンス自動変換：JSONを貼り付けまたは変更すると、ほぼリアルタイムでSwift型を生成。変換ボタンを繰り返しクリックする必要がなく、変換プロセスは完全に非同期でUIをブロックしません
• Web Workerバックグラウンド実行：quicktype-coreはブラウザのWeb Workerで実行され、大きなJSONの変換時にメインスレッドのフリーズや編集のカクつきを回避
• インテリジェント型推論：String、Int、Double、Bool、[T]、カスタム型を自動マッピング。配列は最初の要素の型で推論し、フィールド型を手書きする必要なし
• ネストオブジェクトの自動展開：再帰的に各ネストオブジェクトに独立したSwift型を生成し、フィールド名の先頭を大文字にして命名、型の重複定義を回避
• 配列型の自動推論：JSON配列は自動的に[String]/[Int]/[Double]/[カスタム型]に変換。空配列はデフォルトで[Any]を生成
• ワンクリックJSONエラー修復：末尾のカンマ、単一引用符、引用符の欠落、コメントなどの一般的なフォーマットエラーをワンクリックで自動修復して変換を続行
• ワンクリックコピー + .swiftダウンロード：生成されたSwiftコードをワンクリックでクリップボードにコピー、または.swiftファイルとしてダウンロードしてXcodeプロジェクトに直接ドラッグ
• サンプルデータ + ファイルアップロード：SwiftスタイルのサンプルJSON（ネストされたaddress/company/tagsを含む）を内蔵。.json/.txtファイルのドラッグ＆ドロップまたはクリックアップロードをサポート
• localStorage入力履歴：最近の入力を自動保存。ページをリフレッシュしたり誤って閉じたりしても迅速に復元して編集を続行可能、コンテンツの損失を心配不要
• レスポンシブ分割画面エディタ：左右分割画面でリアルタイムプレビュー。デスクトップとモバイルに自動適応、小画面でもスムーズに操作

コード例

import Foundation

// 1) 本ツールが生成したルート型（Codableプロトコルを補足）
struct User: Codable {
    let id: Int
    let name: String
    let email: String
    let isActive: Bool
    let tags: [String]
}

// 2) URLSessionで非同期取得してデコード
func fetchUser(id: Int) async throws -> User {
    let url = URL(string: "https://api.example.com/users/\(id)")!
    let (data, response) = try await URLSession.shared.data(from: url)
    guard
        let http = response as? HTTPURLResponse,
        (200..<300).contains(http.statusCode)
    else {
        throw URLError(.badServerResponse)
    }
    return try JSONDecoder().decode(User.self, from: data)
}

// 3) 使用例（Swift 5.5+ async/await）
Task {
    do {
        let user = try await fetchUser(id: 42)
        print("User: \(user.name), tags: \(user.tags)")
    } catch {
        print("Failed to decode:", error)
    }
}

import Foundation
import Alamofire

// 本ツールが生成した型、Codableを追加すると直接使用可能
struct Product: Codable {
    let id: Int
    let title: String
    let price: Double
    let inStock: Bool
    let images: [String]
}

final class ProductService {
    private let session: Session

    init(session: Session = .default) {
        self.session = session
    }

    /// Alamofire 5 async/awaitスタイルのresponseDecodable
    func loadProduct(id: Int) async throws -> Product {
        let url = "https://api.example.com/products/\(id)"
        return try await withCheckedThrowingContinuation { continuation in
            session.request(url)
                .validate(statusCode: 200..<300)
                .responseDecodable(of: Product.self) { response in
                    switch response.result {
                    case .success(let product):
                        continuation.resume(returning: product)
                    case .failure(let error):
                        continuation.resume(throwing: error)
                    }
                }
        }
    }
}

// Moyaスタイルの呼び出し例
// provider.request(.product(id: 1)).map(Product.self)
// let product: Product = try await provider.request(.product(id: 1)).map(Product.self)

import Foundation
import Combine

// 本ツールが生成したルート型
struct Article: Codable, Identifiable {
    let id: Int
    let title: String
    let body: String
    let publishedAt: Date
}

final class ArticleRepository {
    private let session: URLSession
    private var cancellables = Set<AnyCancellable>()

    init(session: URLSession = .shared) {
        self.session = session
    }

    /// Combineでデータストリームを公開
    func articlePublisher(id: Int) -> AnyPublisher<Article, Error> {
        let url = URL(string: "https://api.example.com/articles/\(id)")!
        let decoder = JSONDecoder()
        decoder.dateDecodingStrategy = .iso8601

        return session.dataTaskPublisher(for: url)
            .map(\.data)
            .decode(type: Article.self, decoder: decoder)
            .receive(on: DispatchQueue.main)
            .eraseToAnyPublisher()
    }

    /// SwiftUI ViewModelで購読
    func bind(to viewModel: ArticleViewModel, articleId: Int) {
        articlePublisher(id: articleId)
            .sink(
                receiveCompletion: { completion in
                    if case .failure(let err) = completion {
                        viewModel.errorMessage = err.localizedDescription
                    }
                },
                receiveValue: { article in
                    viewModel.article = article
                }
            )
            .store(in: &cancellables)
    }
}

final class ArticleViewModel: ObservableObject {
    @Published var article: Article?
    @Published var errorMessage: String?
}

Best Practices

よくある質問

トラブルシューティング

用語集

struct

Swiftの値型。デフォルトで不変データモデルの表現に適しており、代入時にコピーされます。本ツールはデフォルトでJSONオブジェクトを表すためにstructを生成します。

class

Swiftの参照型。状態の共有、継承、またはアイデンティティ（===）が必要なシナリオに適しています。本ツールは一部の設定でclassを生成できます。

Optional（?）

Swiftで値がnilになる可能性があることを示す型修飾子。例：var name: String?。本ツールが生成するフィールドはデフォルトで非Optionalであり、JSONフィールドが欠落する可能性があるかどうかに応じて生成後に手動で?を追加できます。

Array（[T]）

Swiftの配列型の短縮表記。本ツールはJSON配列を[T]に変換し、Tは配列要素の型から推論されます。例：[String]、[Int]または[カスタム型]。

Codable

SwiftにおけるDecodableとEncodableのプロトコル合成。Codableを実装すると、JSONDecoderを使用してJSONデータを型インスタンスにパースできます。本ツールはデフォルトでCodableを生成せず、手動で追加する必要があります。

JSONDecoder

FoundationフレームワークのJSONパーサー。Codableプロトコルと組み合わせて使用し、DataをSwift型インスタンスに変換できます。本ツールが純粋な型を出力した後、開発者は自身でJSONDecoderを使用してパースできます。

URLSession

AppleプラットフォームFoundationフレームワークのネットワークリクエストAPI。一般的な使用法はURLSession.shared.data(from: url)で、JSONDecoderと組み合わせてインターフェース連携を完了します。

Alamofire

Swiftコミュニティで最も人気のあるサードパーティHTTPネットワークライブラリ。URLSessionをベースにラップされており、responseDecodableをサポートしてSwift型に直接デシリアライズします。

Moya

Swiftネットワーク抽象化レイヤーで、通常Alamofireと組み合わせて使用されます。MoyaをCodable型と組み合わせると、API呼び出しのボイラープレートコードを大幅に削減できます。

Vapor

Swiftの主流なサーバーサイドフレームワークで、macOS/Linux上でSwiftを使用してWebアプリケーションを構築します。本ツールが生成するSwift構造体はVaporのルーティングモデルにも使用できます。

quicktype

多言語をサポートする型ジェネレーターのオープンソースツール。本ツールはquicktype-coreを介してブラウザWeb Worker内でJSONからSwiftへの変換を完了します。

Property

Swift型のプロパティ宣言。本ツールはJSONの各keyをSwiftプロパティにマッピングします。例："name": "Alice" はvar name: Stringにマッピングされます。

Type Inference

JSON値のリテラル形式に基づいてSwift型を自動的に推論するプロセス。本ツールはnull、boolean、number、string、array、objectに基づいてマッピングを行います。

localStorage

ブラウザのローカルキーバリューストア。本ツールはlocalStorageを使用して最近の入力履歴を保存し、ページをリフレッシュしたり誤って閉じたりした後に復元できるようにします。

Web Worker

ブラウザが提供するバックグラウンドスレッドメカニズム。本ツールはWeb Workerを介してquicktype-coreをロードおよび実行し、大きなJSONの変換がメインスレッドをブロックすることを回避します。

SwiftUI

Appleが発表した宣言的UIフレームワーク。本ツールが生成するSwift型はSwiftUIビューのデータモデルとして使用でき、@State/@ObservedObjectと組み合わせてUIを駆動します。

Combine

Appleのリアクティブプログラミングフレームワーク。生成されたSwift型をJSONDecoderと組み合わせると、dataTaskPublisherリアクティブデータフローを構築できます。

SwiftData

Appleが2023年に発表したデータ永続化フレームワーク。本ツールが生成する型はSwiftDataモデルの基底クラスとして使用でき、@Modelを追加するとSwiftDataによって管理されるようになります。

Value Type / Reference Type

Swiftではstructは値型、classは参照型です。本ツールはデフォルトでstructを生成し、代入時にコピーされます；参照セマンティクスが必要な場合は手動でclassに変更できます。

Field Naming

本ツールはデフォルトでJSONの元のフィールド名を保持します。ソースJSONがsnake_caseでプロジェクトがcamelCaseを要求する場合は、手動でリネームするかカスタムquicktypeレンダラーが必要です。

ISO 8601 日付

一般的なJSON日付形式。例：2026-07-14T10:00:00Z。Date型に正しくパースするにはJSONDecoder.dateDecodingStrategy = .iso8601を配套する必要があります。

JSON型からSwift型へのマッピング早見表

ツールはJSON値の形式に基づいて対応するSwift型を自動的に推論します：

JSONからSwiftのAppleエコシステムでの一般的な使用シナリオ

生成されたSwift型はAppleプラットフォーム/サードパーティフレームワークのさまざまなシナリオで直接使用できます：

Privacy & Security

本JSONからSwiftツールのすべてのJSON解析、Swift型生成操作は完全にあなたのブラウザローカルでJavaScript（quicktype-core/Web Worker）により実行され、入力されたJSONデータと生成されたSwiftコードはいかなるサーバーにもアップロードされず、クラウドに記録、キャッシュ、または保存されることもありません。内部インターフェースフィールド、API key、token、ユーザープライバシーデータ、未公開ビジネス構造を含む機密JSONも安心して使用でき、ページを閉じるかリフレッシュするとすべての入出力コンテンツはメモリから自動的に消去され、いかなるサードパーティネットワークサービスにも依存しません。

Authoritative References

• AppleApple Developer - Swift Codable公式ドキュメント
• Swift.orgSwift.org - 公式ドキュメント
• AppleApple Developer - JSONDecoderドキュメント
• AlamofireAlamofire GitHubリポジトリ
• quicktypequicktype GitHubリポジトリ