Пока нет содержимого
Бесплатный онлайн инструмент JSON в Swift, одним щелчком преобразует ответы API, файлы конфигурации или журналы JSON в чистые объявления типов Swift struct / class. Без регистрации, без загрузки, генерация в реальном времени в локальном браузере, подходит для быстрого моделирования в проектах iOS, macOS, watchOS и tvOS.
JSON в Swift - это процесс автоматического преобразования данных в формате JSON (объектов или массивов) в объявления типов Swift struct / class. JSON - это фактический стандарт REST API, файлов конфигурации, журналов событий, а Swift - основной язык разработки приложений iOS, macOS, watchOS, tvOS, а также основной язык серверных фреймворков, таких как Vapor. В разработке часто нужно записывать JSON, возвращаемый API, в соответствующие типы Swift, ручное написание не только отнимает время, но и легко пропустить опциональные поля, роль этого инструмента - автоматизировать этот процесс.
Этот инструмент использует quicktype-core для завершения преобразования локально в браузере. quicktype - это многопоточный генератор структур с поддержкой многих языков, этот инструмент включает опции just-types и no-comments для Swift, поэтому вывод представляет собой чистые объявления свойств struct / class, не содержащие аннотаций сериализации Codable, Decodable, Encodable, а также операторов import или комментариев заголовка файла. Этот «голый тип» позволяет разработчикам свободно добавлять протоколы, настраивать контроль доступа в соответствии с потребностями проекта или изменять на соглашения об именовании, предпочитаемые сетевыми фреймворками, такими как Alamofire / Moya.
Система типов Swift известна своей безопасностью. struct - это тип значения, подходящий для представления неизменяемых моделей данных; class - это ссылочный тип, подходящий для сценариев, требующих общего состояния или наследования. Свойства, генерируемые этим инструментом, по возможности сопоставляются с String, Int, Double, Bool, [T], пользовательскими типами Swift и т.д. Разработчики могут после генерации изменить определенные поля на Optional (?) в соответствии с бизнес-потребностями, добавить протокол Codable к типам или обновить весь struct до class для получения ссылочной семантики.
Обработка вложенных объектов - ключевая возможность инструмента. Когда JSON содержит вложенные объекты, инструмент рекурсивно генерирует независимые подтипы, например, когда Root содержит объект address, будет сгенерирован тип Address, на который ссылается var address: Address в основном типе. Это позволяет избежать повторного определения типов и позволяет автодополнению и проверке типов Xcode правильно отслеживать иерархические отношения. Правило именования использует заглавную букву имени поля, например элементы в массиве users будут названы User.
Вывод типов массивов следует стратегии «вывод по первому элементу». Если элементы массива - строки, генерируется [String], целые числа - [Int], числа с плавающей точкой - [Double], объекты - [пользовательский тип]. Пустые массивы [] из-за отсутствия выборки генерируют [Any] или резервный тип, после генерации рекомендуется изменить на конкретный тип в соответствии с реальным бизнесом. Для особенно больших или разреженных массивов рекомендуется поместить реальные элементы выборки в исходный JSON для повышения точности вывода.
Чистая фронтенд-обработка - основное архитектурное преимущество этого инструмента. Весь анализ JSON и генерация кода Swift выполняются в JavaScript браузера (включая quicktype-core в Web Worker), не зависит от бэкенд-сервисов и не отправляет данные на какие-либо серверы. Эта конструкция не только защищает данные JSON, которые могут содержать конфиденциальную информацию, но и гарантирует, что скорость преобразования ограничена только производительностью локального устройства, без ожидания сетевых обращений. Особенно важно при обработке JSON, содержащего API-ключи, неопубликованные бизнес-поля.
Этот инструмент отличается от некоторых онлайн-инструментов, которые принудительно связывают стратегии декодирования Codable / CodingKeys / Date: члены команды разработки часто имеют разные предпочтения относительно протоколов, именования, контроля доступа, этот инструмент придерживается принципа минимального вывода, оставляя выбор протоколов и стратегий разработчикам для доработки по потребностям проекта. Этот рабочий процесс «генерация полуфабриката + проектная доработка» в средних и крупных командах обычно более популярен у инженеров, чем «все в одном».
Наиболее распространенное использование в проектах iOS / macOS: добавьте Codable к struct, сгенерированному этим инструментом, затем используйте URLSession для асинхронной выборки и декодирования с помощью JSONDecoder.
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)
}
}При использовании Alamofire можно напрямую использовать responseDecodable для автоматического декодирования struct, сгенерированного этим инструментом, в объект Swift.
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)В проектах SwiftUI / Combine можно использовать сгенерированный struct вместе с dataTaskPublisher / decode для создания реактивных потоков данных.
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?
}Вставьте содержимое JSON в левое поле ввода, инструмент автоматически вызовет quicktype-core для преобразования в код Swift через 400 мс после задержки и отобразит результат в реальном времени на правой панели. Вы также можете нажать кнопку загрузки, чтобы выбрать файл .json / .txt, или нажать кнопку примера для загрузки встроенных данных. После завершения преобразования можно скопировать одним щелчком или загрузить как файл .swift.
По умолчанию не содержит. Этот инструмент использует режим just-types от quicktype-core, вывод представляет собой чистые объявления свойств struct / class, без аннотаций Codable, Decodable или Encodable, а также без операторов import. Если вам нужен Codable, просто добавьте : Codable вручную после генерации (например struct User: Codable {}), или напишите собственную логику парсинга JSONDecoder.
Поддерживаются все допустимые JSON: базовые типы (null, boolean, number, string), одномерные или многомерные массивы, вложенные объекты любой глубины. Корневой ввод может быть объектом JSON или массивом JSON, инструмент обрабатывает с приоритетом объектов, массивы выводятся по первому элементу. Неподдерживаемые вводы включают специальные значения JavaScript (функции, Symbol, undefined) и текст, не являющийся JSON.
Инструмент рекурсивно генерирует независимые типы Swift для каждого вложенного объекта. Правила именования основаны на комбинации имени родительского типа и имени поля, например, когда Root содержит поле address, будет сгенерирован подтип Address, на который ссылается var address: Address в основном типе. Это позволяет избежать повторного определения типов и позволяет автодополнению и проверке типов Xcode правильно отслеживать иерархические отношения.
Да. Массивы JSON автоматически преобразуются в форму [T] Swift. Если элементы массива - строки, генерируется [String], целые числа - [Int], числа с плавающей точкой - [Double], объекты - [пользовательский тип]. Пустые массивы [] из-за отсутствия элементов выборки по умолчанию генерируют [Any], рекомендуется вручную изменить на [String] или [Int] и другие конкретные типы после генерации.
Значение null в JSON не может вывести конкретный тип, инструмент может сгенерировать Any или резервный тип. Рекомендуется заменить поля со значением null в исходном JSON на примеры значений (например "field": "" выводится как String) или вручную изменить на Optional в соответствии с бизнес-логикой (например var phone: String?), что больше соответствует безопасной семантике системы типов Swift.
Да. Нажмите кнопку имени типа на панели инструментов (или вход в настройки), чтобы изменить имя корневого типа (по умолчанию Root или выводится по примеру данных). Имена подтипов автоматически генерируются на основе корневого имени и имени поля, правило именования - заглавная буква имени поля, например users → User, tags → Tag.
Инструмент автоматически проверит допустимость JSON, при ошибке отобразит конкретное сообщение об ошибке справа и предоставит кнопку「Исправить JSON」. После нажатия можно автоматически исправить распространенные ошибки: лишние запятые в конце, замена одинарных кавычек двойными, дополнение ключей с отсутствующими кавычками, удаление комментариев и т.д. После успешного исправления можно продолжить преобразование, не нужно вручную исправлять JSON.
Полностью локальная работа в браузере. Весь анализ JSON и генерация кода Swift выполняются локально через JavaScript браузера (включая quicktype-core в Web Worker), введенные данные JSON и сгенерированный код Swift не загружаются на какие-либо серверы, не записываются и не кэшируются в облаке. Конфиденциальные JSON, содержащие API key, токены, личные поля пользователей, неопубликованные бизнес-структуры, можно использовать с уверенностью, при закрытии страницы данные удаляются.
Да. Сгенерированный код - это стандартный синтаксис Swift, его можно напрямую скопировать в файл .swift в Xcode или сохранить как файл .swift через кнопку「Загрузить」для перетаскивания в проект. Поскольку вывод представляет собой чистые объявления типов, рекомендуется вручную добавить протоколы Codable, Equatable, Identifiable в соответствии с потребностями проекта или настроить модификаторы доступа (public / internal / private).
Поддерживаются. Когда корневой ввод - массив JSON, инструмент использует первый элемент массива в качестве шаблона для генерации типа элемента и выводит определение этого типа элемента. Например [{"id":1,"name":"A"}] сгенерирует struct с именем Item (или имя, выведенное по полям), его поля - это поля первого элемента; основной тип ссылается через свойство items: [Item], избегая прямого рассмотрения массива как корневого типа.
У инструмента нет явных ограничений размера, но браузер будет замедляться при разборе и отображении очень больших JSON. Рекомендации: ① Преобразуйте JSON только одного бизнес-модуля за раз; ② При слишком глубокой вложенности разделяйте уровни для обработки; ③ JSON размером более нескольких МБ можно обрабатывать с помощью командной строки quicktype; ④ Разделение одного и того же JSON на несколько подмодулей для отдельного преобразования может значительно снизить потребление памяти.
Оба преобразуют JSON в определения типов соответствующего языка, но акценты различаются: JSON в Swift генерирует объявления свойств struct / class для нативных приложений iOS / macOS; JSON в TypeScript генерирует объявления interface / type для проверки типов интерфейса. Если в вашем проекте одновременно есть клиент iOS и веб-интерфейс, рекомендуется сгенерировать две версии Swift и TS для одного и того же JSON отдельно, чтобы обеспечить согласованность типов на обеих сторонах.
Этот инструмент по умолчанию выводит чистые типы, не несет протоколы напрямую. После генерации вам просто нужно добавить : Codable после объявления struct/class, например struct User: Codable {}, чтобы JSONDecoder мог использовать. Если вы хотите, чтобы по умолчанию был Codable, вы можете форкнуть quicktype-core и изменить его рендерер Swift, или использовать функцию пакетной замены Xcode после генерации, чтобы добавить протоколы ко всем типам.
При первом посещении страницы требуется подключение к Интернету для загрузки скриптов инструмента и ресурсов quicktype-core, после чего можно работать в автономном режиме в кэше браузера (в уже посещенном браузере). Мобильные браузеры (iOS Safari, Android Chrome) также могут нормально использовать, интерфейс - адаптивный дизайн с разделенным экраном, при вертикальной ориентации автоматически переключается на вертикальное расположение.
Поддерживается. После генерации каждый тип Swift является независимым struct / class, вывод инструмента - обычный текст, вы можете отдельно скопировать определенный тип и вставить в Xcode, или использовать рефакторинг Rename в Xcode для пакетного изменения типов и полей, не влияя на другие типы. Если нужно перегенерировать всю группу типов, обновите страницу и снова вставьте JSON.
Поддержка union/enum в quicktype требует дополнительных type hints или ввода GraphQL/JSON Schema. Только на основе выборки JSON сложно вывести перечисления, поэтому этот инструмент по умолчанию не генерирует enum. Если вам нужны перечисления, вы можете вручную изменить соответствующий struct на enum + Codable, или использовать инструмент JSON в Kotlin / TypeScript сначала для получения типа enum, а затем вручную перенести в Swift.
Левое поле ввода пусто или содержит только пробельные символы. Пожалуйста, вставьте допустимое содержимое JSON, или нажмите「Пример」для загрузки образца, или нажмите「Загрузить」для выбора файла .json / .txt.
JSON имеет недопустимый формат. Распространенные причины: ① Лишняя запятая в конце (например {"a":1,}); ② Использованы одинарные кавычки вместо двойных; ③ Запись объекта JS (например {key: value}) вместо JSON (например {"key": "value"}); ④ Содержит комментарии JavaScript. Нажатие кнопки「Исправить JSON」может автоматически исправить часть распространенных ошибок.
Это ожидаемое поведение. Этот инструмент использует режим just-types, выводит чистые объявления свойств struct / class. Если нужен Codable, пожалуйста, после генерации добавьте : Codable к типу (например struct User: Codable {}), или напишите extension User: Codable {} перед вызовом JSONDecoder.
Пустые массивы не имеют элементов выборки, инструмент сгенерирует резервный тип [Any]. Рекомендуется поместить хотя бы один элемент примера в исходный JSON (например [1, 2]), после генерации удалите пример значения и вручную укажите конкретный тип; или после генерации напрямую измените на [String] / [User] и другие более точные типы.
JSON null не может вывести конкретный тип, инструмент может сгенерировать Any или резервный тип. Рекомендуется заменить null в исходном JSON на репрезентативное значение примера (например "" или 0), после генерации измените это поле на Optional (?) или конкретный тип, например var phone: String?.
Можно изменить имя корневого типа на панели инструментов, имена подтипов автоматически генерируются на основе корневого имени + имени поля. Если все еще не удовлетворены, после генерации используйте рефакторинг Rename в Xcode для пакетного изменения (правая кнопка → Refactor → Rename), Xcode синхронно обновит все ссылки.
Браузер замедляется при рендеринге очень больших JSON и генерации множества типов. Рекомендуется разделять JSON на несколько независимых бизнес-модулей для отдельного преобразования или извлекать только ключевые объекты, нуждающиеся в моделировании, для преобразования; JSON размером более 10 МБ рекомендуется обрабатывать с помощью командной строки quicktype.
Указывает, что после добавления Codable к некоторым полям вы неправильно обработали типы, такие как Optional / Date / Enum. Распространенные исправления: ① Измените все поля, которые могут быть null, на Optional<T>; ② Пользовательская стратегия дат JSONDecoder().dateDecodingStrategy = .iso8601; ③ Пользовательские CodingKeys для согласования ключей JSON с именами свойств Swift.
Этот инструмент по умолчанию сохраняет исходные имена полей JSON, поэтому поля snake_case генерируются как есть. Если хотите унифицировать в camelCase, можно после генерации использовать Xcode Rename для пакетного переименования или в пользовательском рендерере quicktype преобразовать имена полей в camelCase, затем дополнить отображение CodingKeys, обеспечив правильное декодирование JSON.
Swift рекомендует имена полей в виде английских ASCII-идентификаторов. Если исходный JSON содержит китайские ключи (например {"имя": "Alice"}), сгенерированное var имя: String вызовет ошибку компилятора Swift в некоторых исторических версиях. Рекомендуется в исходном JSON изменить ключи на английские (например name), что больше соответствует нормам кодирования Swift.
Этот инструмент по умолчанию генерирует свойства var public, удобные для доработки после генерации. Если нужен let или контроль доступа (например private(set)), можно использовать Refactor → Add Access Control в Xcode для пакетного изменения или после генерации использовать sed / инструменты текстового редактирования для замены var на let.
Этот инструмент по умолчанию отображает строки ISO 8601 как String, Swift не будет автоматически преобразовывать в Date. Требуется установить dateDecodingStrategy в JSONDecoder, например JSONDecoder().dateDecodingStrategy = .iso8601. Если формат даты нестандартный, также нужно вручную реализовать DateFormatter или пользовательскую логику парсинга.
Инструмент использует «заглавная буква имени поля» для именования подтипов. В глубоко вложенных JSON могут появиться одноименные вложенные объекты, приводящие к конфликтам типов. Методы решения: ① Добавить бизнес-префиксы к полям в исходном JSON; ② Разделить корневой JSON на несколько независимых модулей для отдельной генерации; ③ После генерации использовать Xcode Rename для пакетного изменения конфликтующих имен типов.
Этот инструмент по умолчанию генерирует internal struct, без явного модификатора public. Если проект разделен по модулям и требуется доступ между модулями, нужно в Xcode пакетно заменить struct на public struct или после генерации использовать скрипты sed/awk для единообразного добавления ключевого слова public.
Инструмент автоматически выводит соответствующие типы Swift на основе формы значений JSON:
| Пример значения JSON | Метод определения | Сгенерированный тип Swift | Примечание |
|---|---|---|---|
null | value === null | Any? или конкретный Optional | Невозможно вывести конкретный тип, после генерации рекомендуется вручную изменить на Optional<T> |
true / false | typeof value === 'boolean' | Bool | Непосредственное сопоставление с булевым типом Swift |
42 | typeof value === 'number' && Number.isInteger(value) | Int | Целые числа сопоставляются с Int (32/64 бита определяются платформой) |
3.14 | typeof value === 'number' && !Number.isInteger(value) | Double | Числа с плавающей точкой сопоставляются с Double |
"hello" | typeof value === 'string' | String | Строки сопоставляются с String |
[] (пустой массив) | Array.isArray(value) && value.length === 0 | [Any] | Невозможно вывести тип элементов, рекомендуется дополнить пример или вручную изменить на конкретный тип |
["a", "b"] | Array.isArray(value) && typeof value[0] === 'string' | [String] | Массив строк |
[1, 2, 3] | Array.isArray(value) && typeof value[0] === 'number' | [Int] | Массив целых чисел |
[1.5, 2.5] | Array.isArray(value) && typeof value[0] === 'number' && !Number.isInteger(value[0]) | [Double] | Массив чисел с плавающей точкой |
[{...}, {...}] | Array.isArray(value) && typeof value[0] === 'object' | [Item] | Массив объектов, элементы - пользовательские типы, имена выводятся по именам полей |
{...} (вложенный объект) | typeof value === 'object' && !Array.isArray(value) | Независимый struct / class | Рекурсивная генерация независимых типов, имена с заглавной буквы по имени поля |
Сгенерированные типы Swift можно напрямую использовать в различных сценариях платформы Apple / сторонних фреймворков:
| Сценарий использования | Распространенные фреймворки | Требуемые протоколы / обработка | Типичный фрагмент кода |
|---|---|---|---|
Парсинг REST API | URLSession + JSONDecoder | Добавить Codable к типам, сохранить семантику значений struct | try JSONDecoder().decode(User.self, from: data) |
Упрощение HTTP-запросов | Alamofire | Добавить Codable к типам, в сочетании с responseDecodable | session.request(url).responseDecodable(of: User.self) |
Абстракция сетевого слоя | Moya | Добавить Codable к типам, Moya автоматически десериализует | provider.request(.user(id: 1)).map(User.self) |
Реактивный поток данных | Combine + JSONDecoder | Добавить Codable к типам, в сочетании с dataTaskPublisher | URLSession.shared.dataTaskPublisher(for: url).decode(type: User.self, decoder: decoder) |
Отображение списков SwiftUI | SwiftUI List + Identifiable | Добавить Identifiable к типам, чтобы List автоматически forEach | List(items) { Text($0.name) } |
Определение серверных моделей | Vapor | Добавить Codable к типам, Vapor автоматически сериализует Content | struct User: Codable, Content { var id: Int; var name: String } |
Модели локального сохранения | SwiftData / Core Data | На сгенерированном struct / class добавить @Model / @NSManaged | @Model class User { var id: Int; var name: String } |
Кроссплатформенное совместное использование типов | JSON в Swift + JSON в TypeScript совместно | Сохранять имена полей Swift и TS согласованными, на стороне TS в сочетании с типами TS | Swift: var name: String / TS: name: string |
Все операции анализа JSON и генерации типов Swift этого инструмента JSON в Swift полностью выполняются локально в вашем браузере через JavaScript (quicktype-core / Web Worker), введенные данные JSON и сгенерированный код Swift не загружаются на какие-либо серверы, не записываются, не кэшируются и не хранятся в облаке. Конфиденциальные JSON, содержащие поля внутренних интерфейсов, API key, токены, личные данные пользователей, неопубликованные бизнес-структуры, можно использовать с уверенностью, после закрытия или обновления страницы все входные и выходные данные автоматически удаляются из памяти, не зависит от каких-либо сторонних сетевых сервисов.