JSON sang Swift

Đề xuất Liên quan

Về JSON sang Swift: Biến dữ liệu JSON thành kiểu gốc hệ sinh thái Apple

Trường hợp sử dụng

• Phát triển iOS: Chuyển JSON trả về từ REST API backend thành Swift struct, dùng để mô hình hóa lớp mạng SwiftUI hoặc UIKit và giải mã JSONDecoder
• Phát triển macOS: Chuyển JSON cấu hình ứng dụng thành kiểu Swift, đọc cấu hình an toàn kiểu trong dự án AppKit, tránh lỗi chính tả
• Phát triển watchOS: Chuyển JSON dữ liệu sức khỏe, vận động cho ứng dụng Apple Watch thành mô hình Swift và kết nối SwiftUI với HealthKit
• Phát triển tvOS: Chuyển JSON giao diện đề xuất nội dung thành kiểu Swift, dùng cho hiển thị dữ liệu trang chủ ứng dụng TV và điều hướng tiêu điểm
• Mô hình hóa SwiftUI MVVM: Liên kết trực tiếp mô hình dữ liệu API làm thuộc tính @Published vào ViewModel, sau đó điều khiển giao diện xem
• Luồng dữ liệu phản ứng Combine: Sử dụng kiểu phản hồi JSON làm kiểu đầu ra của Publisher, kết hợp JSONDecoder để phân tích phản ứng
• Mô hình hóa trước SwiftData / Core Data: Tạo Swift struct trước, sau đó thủ công thêm chú thích @Model hoặc @NSManaged để ánh xạ thực thể
• Kết nối SDK bên thứ ba: Chuyển mẫu JSON phản hồi trong tài liệu SDK thành kiểu Swift, nhanh chóng kết nối SDK đăng nhập, thanh toán, thông báo đẩy, bản đồ, v.v.
• Chuẩn bị kiểm thử đơn vị: Chuyển JSON mock giao diện thành kiểu Swift sau đó dùng cho dữ liệu kiểm thử và khẳng định XCTest, nâng cao khả năng bảo trì kiểm thử
• Đánh giá code: Chuyển JSON trả về API thành kiểu Swift, thuận tiện cho nhóm thảo luận đặt tên trường và tính tùy chọn khi Code Review
• Phát triển kết hợp Flutter / React Native: Chuẩn bị mô hình dữ liệu để gọi module Swift gốc, giảm lỗi chuyển đổi kiểu lớp bridge
• Di chuyển giao diện backend: Tạo mô hình client Swift từ tài liệu giao diện REST hoặc mẫu JSON Postman, đồng bộ nhanh chóng khi nâng cấp phiên bản
• Đào tạo giảng dạy: Trình bày ánh xạ từ JSON sang hệ thống kiểu trong khóa học Swift / iOS, giúp sinh viên hiểu mô hình hóa dữ liệu API và an toàn kiểu
• Ứng dụng sức khỏe và thể dục: Chuyển JSON trả về từ giao diện HealthKit / Fitbit thành kiểu Swift, dùng cho mô hình hóa dữ liệu Apple Health
• Ứng dụng thanh toán và tài chính: Chuyển JSON phản hồi giao diện cổng thanh toán thành mô hình Swift, thuận tiện cho đối soát và xử lý ngoại lệ
• Hệ thống đơn hàng thương mại điện tử: Chuyển JSON đơn hàng, sản phẩm, địa chỉ thành Swift struct, kết hợp danh sách SwiftUI và trang chi tiết để hiển thị
• Ứng dụng tin tức và nội dung: Chuyển JSON phản hồi hệ thống quản lý nội dung thành kiểu Swift, dùng cho TableView / danh sách SwiftUI / trang chi tiết
• Phát triển phía máy chủ Vapor: Chuyển JSON yêu cầu/phản hồi của API backend thành struct Swift, dùng cho định nghĩa mô hình phía máy chủ và mã hóa/giải mã Codable
• MapKit và dữ liệu địa lý: Chuyển JSON trả về từ giao diện bản đồ thành Swift struct, dùng cho tìm kiếm địa điểm, lập kế hoạch tuyến đường, mô hình hóa kết quả mã hóa địa lý

Cách Sử dụng

1. Dán nội dung JSON vào trình soạn thảo bên trái, hoặc nhấp nút tải lên để chọn tệp .json / .txt, cũng có thể tải dữ liệu mẫu tích hợp
2. Công cụ sẽ tự động gọi quicktype-core để chuyển đổi sau 400ms debounce, bên phải hiển thị code Swift struct / class tạo ra
3. Nếu JSON định dạng lỗi, nhấp nút「Sửa JSON」để tự động sửa các vấn đề cú pháp phổ biến (dấu phẩy đuôi, dấu nháy đơn, thiếu dấu nháy, v.v.)
4. Kiểm tra kết quả tạo ra, có thể thủ công thêm các giao thức Codable / Equatable / Identifiable theo nhu cầu dự án; nhấp「Sao chép」để dán vào Xcode, hoặc nhấp「Tải xuống」để lưu thành tệp .swift

Tính năng

• Chuyển đổi hoàn toàn trên trình duyệt cục bộ: Phân tích JSON và tạo code Swift đều được hoàn thành bằng quicktype-core trong trình duyệt, JSON gốc và code tạo ra đều không được tải lên bất kỳ máy chủ nào
• Chế độ quicktype-core just-types: Đầu ra là khai báo thuộc tính struct / class Swift sạch sẽ, không có import, không có chú thích Codable / CodingKeys, thuận tiện để tùy chỉnh theo nhu cầu dự án
• Tự động chuyển đổi sau 400ms debounce: Tạo kiểu Swift gần như tức thì sau khi dán hoặc sửa đổi JSON, không cần nhấp nút chuyển đổi lặp lại, quá trình chuyển đổi hoàn toàn bất đồng bộ không chặn UI
• Thực thi nền Web Worker: quicktype-core chạy trong Web Worker của trình duyệt, tránh đóng băng luồng chính và giật lag khi chỉnh sửa với JSON lớn
• Suy luận kiểu thông minh: Tự động ánh xạ String, Int, Double, Bool, [T], kiểu tùy chỉnh, mảng được suy luận theo kiểu phần tử đầu tiên, không cần viết tay kiểu trường
• Tự động mở rộng đối tượng lồng nhau: Đệ quy tạo kiểu Swift độc lập cho mỗi đối tượng lồng nhau, đặt tên theo viết hoa chữ cái đầu của tên trường, tránh định nghĩa lặp lại kiểu
• Tự động suy luận kiểu mảng: Mảng JSON tự động chuyển thành [String] / [Int] / [Double] / [kiểu tùy chỉnh], mảng rỗng mặc định tạo [Any]
• Sửa lỗi JSON một cú nhấp chuột: Khi gặp lỗi định dạng phổ biến như dấu phẩy đuôi, dấu nháy đơn, thiếu dấu nháy, comment, có thể tự động sửa một cú nhấp chuột và tiếp tục chuyển đổi
• Sao chép một cú nhấp chuột + tải xuống .swift: Sao chép code Swift tạo ra vào bộ nhớ đệm một cú nhấp chuột, hoặc tải xuống dưới dạng tệp .swift để kéo thả trực tiếp vào dự án Xcode
• Dữ liệu mẫu + tải tệp: Tích hợp JSON mẫu phong cách Swift (bao gồm address / company / tags lồng nhau), hỗ trợ kéo thả hoặc nhấp để tải tệp .json / .txt
• Lịch sử đầu vào localStorage: Tự động lưu đầu vào gần đây, có thể khôi phục nhanh chóng để tiếp tục chỉnh sửa sau khi làm mới hoặc đóng nhầm trang, không lo mất nội dung
• Trình soạn thảo chia màn hình responsive: Xem trước tức thì chia màn hình trái phải, tự điều chỉnh cho máy tính để bàn và thiết bị di động, màn hình nhỏ cũng có thể thao tác mượt mà

Ví dụ mã

import Foundation

// 1) Kiểu gốc tạo ra bởi công cụ này (bổ sung giao thức Codable)
struct User: Codable {
    let id: Int
    let name: String
    let email: String
    let isActive: Bool
    let tags: [String]
}

// 2) URLSession lấy bất đồng bộ và giải mã
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) Ví dụ sử dụng (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

// Kiểu tạo ra bởi công cụ này, thêm Codable sau đó trực tiếp sử dụng được
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 phong cách 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)
                    }
                }
        }
    }
}

// Ví dụ gọi phong cách 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

// Kiểu gốc tạo ra bởi công cụ này
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
    }

    /// Dùng Combine để lộ luồng dữ liệu
    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()
    }

    /// Đăng ký trong 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

Câu hỏi Thường gặp

Xử lý sự cố

Thuật ngữ

struct

Kiểu giá trị trong Swift. Mặc định phù hợp biểu diễn mô hình dữ liệu bất biến, khi gán giá trị sẽ được sao chép. Công cụ này mặc định tạo struct để biểu diễn đối tượng JSON.

class

Kiểu tham chiếu trong Swift. Phù hợp cho các tình huống cần chia sẻ trạng thái, kế thừa hoặc nhận dạng danh tính (===). Công cụ này có thể tạo class dưới một số cấu hình nhất định.

Optional（?）

Bổ nghĩa kiểu trong Swift biểu thị giá trị có thể là nil, ví dụ var name: String?. Các trường tạo ra bởi công cụ này mặc định không Optional, sau khi tạo có thể thủ công thêm ? theo trường JSON có thể thiếu hay không.

Array（[T]）

Viết tắt kiểu mảng trong Swift. Công cụ này chuyển mảng JSON thành [T], T suy luận theo kiểu phần tử mảng, ví dụ [String], [Int] hoặc [kiểu tùy chỉnh].

Codable

Tổ hợp giao thức của Decodable và Encodable trong Swift. Sau khi triển khai Codable có thể dùng JSONDecoder để phân tích dữ liệu JSON thành thể hiện kiểu. Công cụ này mặc định không tạo Codable, cần thêm thủ công.

JSONDecoder

Bộ phân tích JSON trong framework Foundation. Sử dụng kết hợp với giao thức Codable, có thể chuyển Data thành thể hiện kiểu Swift. Sau khi công cụ này xuất ra kiểu thuần, nhà phát triển có thể tự phân tích bằng JSONDecoder.

URLSession

API yêu cầu mạng trong framework Foundation của nền tảng Apple. Cách sử dụng phổ biến là URLSession.shared.data(from: url), kết hợp với JSONDecoder để hoàn thành liên kết giao diện.

Alamofire

Thư viện mạng HTTP bên thứ ba phổ biến nhất trong cộng đồng Swift. Đóng gói dựa trên URLSession, hỗ trợ responseDecodable giải tuần tự hóa trực tiếp thành kiểu Swift.

Moya

Lớp trừu tượng mạng Swift, thường kết hợp với Alamofire. Moya kết hợp với kiểu Codable có thể đơn giản hóa đáng kể code mẫu gọi API.

Vapor

Framework phía máy chủ chủ đạo của Swift, sử dụng Swift để xây dựng ứng dụng Web trên macOS / Linux. Struct Swift tạo ra bởi công cụ này cũng có thể sử dụng cho mô hình định tuyến của Vapor.

quicktype

Công cụ mã nguồn mở tạo kiểu đa ngôn ngữ, công cụ này hoàn thành chuyển đổi JSON sang Swift thông qua quicktype-core trong Web Worker trình duyệt.

Property

Khai báo thuộc tính trong kiểu Swift. Công cụ này ánh xạ mỗi key của JSON thành một Swift property, ví dụ "name": "Alice" ánh xạ thành var name: String.

Type Inference

Quá trình tự động suy luận kiểu Swift dựa trên dạng giá trị chữ của JSON. Công cụ này thực hiện ánh xạ dựa trên null, boolean, number, string, array, object.

localStorage

Lưu trữ khóa-giá trị cục bộ của trình duyệt. Công cụ này dùng localStorage để lưu lịch sử đầu vào gần đây, có thể khôi phục sau khi làm mới hoặc đóng nhầm trang.

Web Worker

Cơ chế luồng nền được cung cấp bởi trình duyệt. Công cụ này tải và thực thi quicktype-core thông qua Web Worker, tránh chặn luồng chính khi chuyển đổi JSON lớn.

SwiftUI

Framework UI khai báo được giới thiệu bởi Apple. Kiểu Swift tạo ra bởi công cụ này có thể làm mô hình dữ liệu cho chế độ xem SwiftUI, kết hợp @State / @ObservedObject để điều khiển giao diện.

Combine

Framework lập trình phản ứng của Apple. Kiểu Swift tạo ra kết hợp với JSONDecoder có thể xây dựng luồng dữ liệu phản ứng dataTaskPublisher.

SwiftData

Framework lưu trữ dữ liệu bền vững được Apple giới thiệu năm 2023. Kiểu tạo ra bởi công cụ này có thể làm lớp cơ sở mô hình SwiftData, sau khi thêm @Model là có thể được quản lý bởi SwiftData.

Value Type / Reference Type

Trong Swift struct là kiểu giá trị, class là kiểu tham chiếu. Công cụ này mặc định tạo struct, khi gán giá trị được sao chép; nếu cần ngữ nghĩa tham chiếu có thể thủ công đổi thành class.

Field Naming

Công cụ này mặc định giữ nguyên tên trường gốc của JSON. Nếu JSON gốc là snake_case mà dự án yêu cầu camelCase, cần rename thủ công hoặc tùy chỉnh trình kết xuất quicktype.

ISO 8601 ngày tháng

Định dạng ngày tháng JSON phổ biến, ví dụ 2026-07-14T10:00:00Z. Cần phối hợp JSONDecoder.dateDecodingStrategy = .iso8601 mới có thể phân tích chính xác thành kiểu Date.

Bảng tra cứu nhanh ánh xạ kiểu JSON sang kiểu Swift

Công cụ tự động suy luận kiểu Swift tương ứng dựa trên dạng giá trị JSON:

Các tình huống sử dụng phổ biến của JSON sang Swift trong hệ sinh thái Apple

Kiểu Swift tạo ra có thể sử dụng trực tiếp cho các tình huống khác nhau của nền tảng Apple / framework bên thứ ba:

Privacy & Security

Tất cả các hoạt động phân tích JSON, tạo kiểu Swift của công cụ JSON sang Swift này được hoàn thành hoàn toàn cục bộ trên trình duyệt của bạn thông qua JavaScript (quicktype-core / Web Worker), dữ liệu JSON đầu vào và code Swift tạo ra đều không được tải lên bất kỳ máy chủ nào, cũng không được ghi lại, lưu vào bộ nhớ đệm hoặc lưu trữ trên đám mây. JSON nhạy cảm chứa trường giao diện nội bộ, API key, token, dữ liệu riêng tư người dùng, cấu trúc nghiệp vụ chưa công khai đều có thể yên tâm sử dụng, sau khi đóng hoặc làm mới trang tất cả nội dung đầu vào và đầu ra tự động xóa khỏi bộ nhớ, không phụ thuộc bất kỳ dịch vụ mạng bên thứ ba nào.

Authoritative References

• AppleApple Developer - Tài liệu chính thức Swift Codable
• Swift.orgSwift.org - Tài liệu chính thức
• AppleApple Developer - Tài liệu JSONDecoder
• AlamofireKho lưu trữ GitHub Alamofire
• quicktypeKho lưu trữ GitHub quicktype