Convention-Python/Convention/Runtime/EasySave.md

返回

/Convention/Runtime/EasySave

---

完整的序列化和数据持久化系统，提供易用的数据存储和读取功能

核心特性

支持的数据格式

• EasySave - JSON 支持多态的json格式
• Binary 紧凑的二进制格式

EasySave主类

基本保存操作

泛型保存

• Save<T>(string key, T value) 保存到默认文件
• Save<T>(string key, T value, string filePath) 保存到指定文件
• Save<T>(string key, T value, EasySaveSettings settings) 使用自定义设置

原始数据保存

• SaveRaw(byte[] bytes) / SaveRaw(string str) 保存原始数据
• AppendRaw(byte[] bytes) / AppendRaw(string str) 追加原始数据

基本加载操作

泛型加载

• Load<T>(string key) 从默认文件加载
• Load<T>(string key, string filePath) 从指定文件加载
• Load<T>(string key, T defaultValue) 带默认值的安全加载

原始数据加载

• LoadRawBytes() / LoadRawString() 加载原始数据
• LoadString(string key, string defaultValue) 加载字符串

加载到现有对象

• LoadInto<T>(string key, T obj) 将数据加载到现有对象
• LoadInto(string key, string filePath, object obj) 从指定文件加载到对象

序列化操作

内存序列化

• Serialize<T>(T value, EasySaveSettings settings = null) 序列化为字节数组
• Deserialize<T>(byte[] bytes, EasySaveSettings settings = null) 从字节数组反序列化
• DeserializeInto<T>(byte[] bytes, T obj) 反序列化到现有对象

加密和压缩

加密操作

• EncryptBytes(byte[] bytes, string password = null) 加密字节数组
• DecryptBytes(byte[] bytes, string password = null) 解密字节数组
• EncryptString(string str, string password = null) 加密字符串
• DecryptString(string str, string password = null) 解密字符串

压缩操作

• CompressBytes(byte[] bytes) 压缩字节数组
• DecompressBytes(byte[] bytes) 解压字节数组
• CompressString(string str) 压缩字符串
• DecompressString(string str) 解压字符串

备份系统

备份操作

• CreateBackup() / CreateBackup(string filePath) 创建备份
• RestoreBackup(string filePath) 恢复备份

时间戳

• GetTimestamp() / GetTimestamp(string filePath) 获取文件时间戳

缓存系统

缓存操作

• StoreCachedFile() / StoreCachedFile(string filePath) 存储缓存文件
• CacheFile() / CacheFile(string filePath) 缓存文件

EasySaveSettings配置

枚举类型定义

存储位置

public enum Location { File, InternalMS, Cache }

目录类型

public enum Directory { PersistentDataPath, DataPath }

加密类型

public enum EncryptionType { None, AES }

压缩类型

public enum CompressionType { None, Gzip }

数据格式

public enum Format { JSON }

引用模式

public enum ReferenceMode { ByRef, ByValue, ByRefAndValue }