alibaba/handyjson
Handyjson
HandyJSON is a Swift JSON serialization library and data mapper. It functions as an object mapper that converts JSON data into typed Swift models and transforms Swift objects back into JSON strings for storage or transmission.
The library uses reflection to automatically map JSON keys to object properties and supports custom mapping metadata to resolve naming differences between APIs and code. It provides capabilities for extracting values from deep nested paths within a JSON structure and supports the transformation of complex types such as dates and URLs.
The framework handles both the deserialization of JSON into structured classes and structs and the serialization of model objects. It also allows for updating existing object instances by populating them with values derived from JSON strings or dictionaries.
Features
- JSON-to-Model Mappers - Transforms JSON structures into typed model objects using configurable key mapping and reflection.
- JSON-to-Object Mappers - Transforms raw JSON text strings into strongly typed Swift data structures.
- Custom Field Mapping - Customizes the mapping of object fields to JSON keys to handle naming discrepancies.
- JSON Deserializers - Implements JSON deserialization with the ability to extract values from deep nested paths to populate object properties.
- JSON Serialization Libraries - Offers a complete toolkit for converting Swift objects to JSON strings and parsing JSON data back into models.
- JSON Key Path Lookups - Navigates nested JSON structures using dot-separated key paths to retrieve values.
- JSON Serializers - Converts native Swift data structures into formatted JSON string representations.
- Model-to-JSON Converters - Transforms structured model objects into JSON string representations for storage or transmission.
- Typed Class Deserializers - Parses JSON strings into typed Swift class instances with automatic conversion and nested handling.
- Property-to-Key Mapping - Provides a mapping layer to link internal object properties to specific external JSON keys.
- Dynamic Property Mapping - Uses runtime reflection to automatically map JSON keys to object properties without boilerplate.
- JSON Transformation - Manipulates and transforms values, such as dates and URLs, during the JSON parsing process.
- Complex Data Serialization - Provides serialization support for non-primitive data types like dates and URLs.
- Instance Value Updates - Populates existing object instances with new values derived from JSON strings or dictionaries.
- JSON Data Extraction - Locates and retrieves specific data values from complex, deeply nested JSON structures.
- Complex Type Converters - Converts non-primitive types like dates and URLs into standard JSON formats.
- Object Mappers - Transforms complex data types and nested JSON structures into structured Swift classes and structs.
- Intermediate Data Representations - Parses raw JSON strings into intermediate key-value maps before mapping them to typed models.
- In-Place Object Population - Allows updating existing object instances by populating them with values derived from JSON.
- Data Parsing - Convenient JSON serialization and deserialization for Swift.
- Data Persistence - JSON serialization and deserialization.
