当前位置：首页 > article >正文

Unity中的JsonManager

article 2025/8/18 20:54:35

1.具体代码

先贴代码

using LitJson;
using System.IO;
using UnityEngine;/// <summary>
/// 序列化和反序列化Json时  使用的是哪种方案    有两种  JsonUtility 不能直接序列化字典  ligJson可以序列化字典 
/// </summary>
public enum JsonType
{JsonUtility,LitJson,Newtonsoft,
}/// <summary>
/// Json数据管理类 主要用于进行 Json的序列化存储到硬盘 和 反序列化从硬盘中读取到内存中
/// </summary>
public class JsonMgr : SingleTon<JsonMgr>
{public JsonMgr(){}//存储Json数据 序列化public void SaveData(object data, string fileName, string directPath = "", JsonType type = JsonType.Newtonsoft){//确定存储路径string directoryPath = Application.persistentDataPath + "/" + directPath;string filePath = directoryPath + fileName + ".json";//序列化 得到Json字符串string jsonStr = "";switch (type){case JsonType.JsonUtility:jsonStr = JsonUtility.ToJson(data);break;case JsonType.LitJson:jsonStr = JsonMapper.ToJson(data);break;case JsonType.Newtonsoft:jsonStr = Newtonsoft.Json.JsonConvert.SerializeObject(data);break;}if (!Directory.Exists(directoryPath)){Directory.CreateDirectory(directoryPath);}//把序列化的Json字符串 存储到指定路径的文件中File.WriteAllText(filePath, jsonStr);}//读取指定文件中的 Json数据 反序列化public T LoadData<T>(string filePath, JsonType type = JsonType.Newtonsoft) where T : new(){//数据对象T data = new T();//确定从哪个路径读取//首先先判断 默认数据文件夹中是否有我们想要的数据 如果有 就从中获取string path = Application.streamingAssetsPath + "/" + filePath + ".json";//先判断 是否存在这个文件//如果不存在默认文件 就从 读写文件夹中去寻找if (!File.Exists(path))path = Application.persistentDataPath + "/" + filePath + ".json";//如果读写文件夹中都还没有 那就返回一个默认对象if (!File.Exists(path))return data;//进行反序列化string jsonStr = File.ReadAllText(path);switch (type){case JsonType.JsonUtility:data = JsonUtility.FromJson<T>(jsonStr);break;case JsonType.LitJson:data = JsonMapper.ToObject<T>(jsonStr);break;case JsonType.Newtonsoft:data = Newtonsoft.Json.JsonConvert.DeserializeObject<T>(jsonStr);break;}//把对象返回出去return data;}
}

2.使用示例

保存玩家数据

// 定义数据类
[Serializable]
public class PlayerData {public string name;public int level;
}// 保存数据
PlayerData data = new PlayerData { name = "Alice", level = 10 };
JsonMgr.Instance.SaveData(data, "player", "Save/", JsonType.Newtonsoft);

加载玩家数据

// 加载数据
PlayerData loadedData = JsonMgr.Instance.LoadData<PlayerData>("Save/player", JsonType.Newtonsoft);
Debug.Log($"Name: {loadedData.name}, Level: {loadedData.level}");

3.核心功能

多方案支持
JsonType 枚举：支持三种 JSON 序列化/反序列化方案：
- Newtonsoft（Json.NET）：功能强大的第三方库，支持复杂类型和更多特性。
- LitJson：第三方库，支持字典等复杂类型。
- JsonUtility：Unity 内置方案，不支持字典等复杂类型。
数据存储与读取
- SaveData 方法：将对象序列化为 JSON 字符串并保存到指定路径。
- LoadData<T> 方法：从指定路径读取 JSON 文件并反序列化为对象。

4.代码结构解析

1. 构造函数

public JsonMgr() { }

单例类的默认构造函数，无特殊逻辑。

2. 保存数据方法 `SaveData`

public void SaveData(object data, string fileName, string directPath = "", JsonType type = JsonType.Newtonsoft)

参数说明：
- data：要保存的对象。
- fileName：文件名（不含 .json 后缀）。
- directPath：可选的子目录路径。
- type：序列化方案（默认使用 Newtonsoft）。
逻辑流程：
1. 确定存储路径：
  - 使用 Application.persistentDataPath（可读写路径）构建完整路径。
  - 示例：/Users/xxx/Library/Application Support/Unity/.../directPath/fileName.json。
2. 序列化：
  - 根据 type 使用对应方案将对象转换为 JSON 字符串。
  - JsonUtility：JsonUtility.ToJson(data)。
  - LitJson：JsonMapper.ToJson(data)。
  - Newtonsoft：JsonConvert.SerializeObject(data)。
3. 创建目录：若目录不存在则创建。
4. 写入文件：使用 File.WriteAllText(filePath, jsonStr) 存储数据。

3. 读取数据方法 `LoadData<T>`

public T LoadData<T>(string filePath, JsonType type = JsonType.Newtonsoft) where T : new()

参数说明：
- filePath：文件路径（不含 .json 后缀）。
- type：反序列化方案（默认使用 Newtonsoft）。
- 泛型约束 where T : new()：确保类型 T 有无参构造函数。
逻辑流程：
1. 优先从只读路径加载：
  - 首先检查 Application.streamingAssetsPath（只读路径，通常用于默认配置文件）。
  - 如果文件不存在，尝试从 Application.persistentDataPath（用户数据路径）加载。
2. 若文件不存在：返回默认的 T 实例（通过 new T() 创建）。
3. 反序列化：
  - 根据 type 使用对应方案将 JSON 字符串转换为对象。
  - JsonUtility：JsonUtility.FromJson<T>(jsonStr)。
  - LitJson：JsonMapper.ToObject<T>(jsonStr)。
  - Newtonsoft：JsonConvert.DeserializeObject<T>(jsonStr)。

关键点分析

1. 路径选择与平台兼容性

Application.persistentDataPath：
- 可读写路径，适合保存用户数据（如玩家进度、配置等）。
Application.streamingAssetsPath：
- 只读路径，通常用于打包后的默认资源（如初始配置文件）。
- 注意：在某些平台（如 Android）上，File.ReadAllText 无法直接访问此路径的文件，需通过 UnityWebRequest 或 WWW 加载。当前代码可能在此类平台上抛出异常。