tristanhimmelman/ObjectMapper
ObjectMapper
ObjectMapper is a JSON serialization framework for Swift that maps JSON strings and dictionaries into strongly typed classes and structs. It functions as a data mapper and converter, facilitating the bidirectional transformation of data between raw JSON and Swift model objects.
The library uses protocol-based mapping to associate specific JSON keys with object properties. It supports nested key extraction via dot-notation pathing and employs custom transformation classes to bridge the gap between JSON and Swift types.
The framework provides capabilities for model validation during initialization, including throwable initializers to populate immutable properties. It also supports mapping inheritance between superclasses and subclasses, as well as context-aware mapping to share configuration across nested model hierarchies.
Features
- JSON Serializers - Provides a comprehensive framework to convert application data into JSON and parse JSON responses into Swift models.
- Object-to-Data Mapping Frameworks - Functions as a framework for mapping raw JSON structures into strongly typed Swift model objects.
- JSON Key Association - Associates specific JSON keys with object properties to convert raw data into model classes or structs.
- JSON-to-Model Mappers - Transforms JSON strings or dictionaries into typed model objects using configurable key mapping and transformations.
- JSON Serialization Libraries - Transforms model objects into JSON strings or dictionaries for serialization and data transmission.
- Nested Dictionary Utilities - Extracts values from deeply nested JSON structures or arrays using dot-notation within mapping keys.
- Nested Object Mapping - Processes complex data structures where objects are embedded within other objects, arrays, or dictionaries.
- Value Transformations - Converts values between JSON and model types using custom logic or predefined transformation classes.
- JSON Path Navigation - Supports navigation of hierarchical JSON structures using dot-notation path segments to resolve values.
- Swift Model Definitions - Provides a mechanism to define how raw JSON keys map to strongly typed Swift properties and nested structures.
- JSON Serialization - Transforms model objects back into JSON format for storage or network transmission.
- Type Conversion Classes - Implements dedicated transformation classes to separate type conversion logic from the data models.
- Serialization Inheritance - Ensures shared data definitions are processed in subclasses by triggering mapping logic from parent classes.
- Immutable Property Population - Populates constant properties during object creation using throwable initializers to maintain data integrity.
- Data Integrity Validation - Inspects incoming JSON data during object initialization to prevent crashes by validating data integrity.
- Failable Initializers - Uses throwable initializers to populate immutable properties, throwing errors if required JSON keys are missing or invalid.
- Generic Type Resolution - Handles classes with generic type parameters by ensuring generic types conform to the mapping protocol.
- JSON Schema Validation - Inspects JSON data during object initialization to determine whether the mapping process should proceed or abort.
- Mapping Contexts - Provides an optional context object to share configuration across nested model hierarchies during the mapping process.
- Data Parsing - Converts model objects to and from JSON.
- Data Persistence - JSON object mapping.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
