3 分钟快速上手 Realm+JSON：CocoaPods 安装与第一个 JSON 模型入库教程

3 分钟快速上手 RealmJSONCocoaPods 安装与第一个 JSON 模型入库教程【免费下载链接】Realm-JSONA concise Mantle-like way of working with Realm and JSON.项目地址: https://gitcode.com/gh_mirrors/re/Realm-JSONRealmJSON 是一个简洁、Mantle 风格的 Objective-C 库专门用来打通Realm 数据库与JSON 数据之间的转换。对新手来说它最大的价值在于你只需要写一个模型类再调用一行方法就能把服务端返回的 JSON 数组或字典一键入库完全不用手动逐字段赋值。这篇教程将带你完成 RealmJSON 的 CocoaPods 安装并写出你的第一个 JSON 模型入库 Demo全程约 3 分钟。一、为什么你需要 RealmJSON在日常 iOS 开发中从接口拉取 JSON 再存入本地数据库是最常见的需求。传统写法往往是这样手写NSJSONSerialization解析代码再逐条把字典里的值赋给模型属性遇到 snake_case 命名还要自己写转换逻辑……RealmJSON 把这些繁琐步骤全部封装掉了。它模仿 Mantle 的设计思路通过映射字典Mapping Dictionary自动完成 JSON 与 Realm 对象之间的双向转换让JSON 模型入库变成一行代码的事。二、快速安装CocoaPods 安装步骤RealmJSON 已发布到 CocoaPods 官方仓库安装非常简单。2.1 添加 Pod 依赖在你的项目 Podfile 中追加一行pod RealmJSON, ~ 0.2然后执行pod install小提示如果网络环境访问 CocoaPods 官方源较慢也可以直接 clone 本仓库地址https://gitcode.com/gh_mirrors/re/Realm-JSON把RealmJSON文件夹里的源码复制进你的工程效果相同。2.2 引入头文件在需要使用的地方导入#import RealmJSON/RLMObjectJSON.h导入这个头文件后你的RLMObject子类就自动获得了createOrUpdateInRealm:withJSONArray:、JSONDictionary等一整套 JSON 能力声明见 RLMObjectJSON.h。三、3 分钟上手定义你的第一个 JSON 模型我们以项目 Demo 中的MCEpisode剧集为例定义一个简单的 Realm 模型参考 MCEpisode.hinterface MCEpisode : RLMObject property NSInteger episodeID; property NSInteger episodeNumber; property NSString *title; property NSString *subtitle; property NSDate *publishedDate; end就这么简单不需要任何 JSON 相关的基类继承模型保持干净。四、配置 JSON 映射入站与出站RealmJSON 的映射思路是JSON 里的字段名 ↔ 模型里的属性名。你可以在模型类中实现两个方法来自定义映射4.1 入站映射JSON → 模型 (NSDictionary *)JSONInboundMappingDictionary { return { episode.title : title, episode.description : subtitle, episode.id : episodeID, episode.published_at : publishedDate, }; }左边是 JSON 的 key path支持点语法层级右边是模型属性。这样即使接口返回的字段名与模型不一致也能准确对应。4.2 出站映射模型 → JSON (NSDictionary *)JSONOutboundMappingDictionary { return { title : title, subtitle : episode.description, episodeID : id, publishedDate: published_at, }; }用于把模型转回 JSON 字典方便直接拼装网络请求参数。如果完全不写映射方法RealmJSON 会使用默认规则模型属性 camelCase 自动对应 JSON 的 snake_case。五、核心一步JSON 一键入库拿到服务端返回的数据后入库只需要一行代码。Demo 中完整展示了从 AFNetworking 请求到入库的流程见 MCTableViewController.mRLMRealm *realm [RLMRealm defaultRealm]; [realm beginWriteTransaction]; NSArray *result [MCEpisode createOrUpdateInRealm:realm withJSONArray:array]; [realm commitWriteTransaction];传入数组createOrUpdateInRealm:withJSONArray:批量入库传入单个字典createOrUpdateInRealm:withJSONDictionary:。入库方法内部会调用 Realm 原生的createOrUpdateInRealm:withObject:性能有保障同时利用主键自动完成有则更新、无则插入。六、进阶技巧日期转换与值转换器JSON 里的时间字符串如何变成NSDate枚举字符串如何变成整型RealmJSON 内置了值转换器机制日期字段自动使用 MCJSONDateTransformer.m 处理自定义枚举可用 MCJSONValueTransformer.h 配置 (NSValueTransformer *)episodeTypeJSONTransformer { return [MCJSONValueTransformer valueTransformerWithMappingDictionary:{ free : (MCEpisodeTypeFree), paid : (MCEpisodeTypePaid) }]; }规则很简单实现名为属性名 JSONTransformer的方法即可框架会自动识别并调用。七、补充多线程与对象拷贝多线程Realm 规定不同线程不能共享同一个对象实例。可以用primaryKeyValue取出主键值再到目标线程通过objectInRealm:withPrimaryKeyValue:重新查询参考 RLMObjectJSON.h。临时副本编辑 UI 时不想立刻写库RLMObjectCopying提供了shallowCopy、deepCopy和mergePropertiesFromObject:先改副本、确认后再提交非常适合表单类页面声明见 RLMObjectCopying.h。八、小结到这里你已经完成了 RealmJSON 的 CocoaPods 安装、模型定义、JSON 映射配置和首个 JSON 模型入库 Demo。回顾一下核心 API需求调用方法JSON 数组入库createOrUpdateInRealm:withJSONArray:JSON 字典入库createOrUpdateInRealm:withJSONDictionary:模型转 JSON-JSONDictionary按主键查询objectInRealm:withPrimaryKeyValue:RealmJSON 用最少的代码解决了 Realm 与 JSON 之间最麻烦的转换问题。如果你正在使用 Realm 做本地缓存这个轻量级库值得一试。下一步不妨直接阅读 RLMObjectJSON.m 源码深入了解它的映射实现细节【免费下载链接】Realm-JSONA concise Mantle-like way of working with Realm and JSON.项目地址: https://gitcode.com/gh_mirrors/re/Realm-JSON创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考