Keyv自定义序列化教程超越JSON支持更多数据类型【免费下载链接】keyvjaredwray/keyv: 这是一个分布式键值存储库用于在多个节点上存储数据。适合用于需要分布式存储和访问的场景。特点易于使用支持多种数据存储和访问方式具有高性能和可扩展性。项目地址: https://gitcode.com/gh_mirrors/ke/keyvKeyv是一个强大的分布式键值存储库专为需要高性能、可扩展存储的场景设计。作为现代化的键值存储解决方案Keyv提供了灵活的自定义序列化功能让你超越传统的JSON限制支持更多JavaScript原生数据类型。无论是Date对象、Map、Set还是BigIntKeyv的自定义序列化都能完美处理。为什么需要自定义序列化 默认情况下大多数键值存储库使用JSON作为序列化格式。但JSON有其局限性——它无法正确处理JavaScript中的许多原生类型。当你存储一个Date对象时JSON会将其转换为字符串当你存储一个Map或Set时JSON会将其转换为普通对象丢失了原始结构。Keyv通过可插拔的序列化系统解决了这个问题。你可以选择适合你需求的序列化器或者创建自己的序列化器来支持特定的数据类型。Keyv内置序列化器对比 1. 默认JSON序列化器 (KeyvJsonSerializer)Keyv内置的JSON序列化器已经比标准JSON.stringify/parse更强大。它支持Buffer/Uint8Array- 自动转换为base64编码字符串BigInt- 保留大整数类型嵌套对象和数组- 完全支持import Keyv from keyv; const keyv new Keyv(); // 默认使用KeyvJsonSerializer // 存储Buffer数据 await keyv.set(buffer, Buffer.from(hello)); const buffer await keyv.get(buffer); console.log(buffer instanceof Buffer); // true // 存储BigInt await keyv.set(bigint, 9007199254740993n); const bigint await keyv.get(bigint); console.log(typeof bigint); // bigint2. SuperJSON序列化器 (keyv/serialize-superjson)SuperJSON提供了更全面的类型支持特别适合需要保留复杂JavaScript类型的场景npm install keyv/serialize-superjson支持的数据类型✅ Date对象保留为Date不是字符串✅ RegExp正则表达式✅ Map和Set集合✅ BigInt大整数✅ undefined值✅ Error对象✅ URL对象import Keyv from keyv; import { superJsonSerializer } from keyv/serialize-superjson; const keyv new Keyv({ serialization: superJsonSerializer }); // 存储Date对象 const now new Date(); await keyv.set(currentDate, now); const retrievedDate await keyv.get(currentDate); console.log(retrievedDate instanceof Date); // true console.log(retrievedDate.getTime() now.getTime()); // true // 存储Map集合 const userMap new Map([ [id, 123], [name, Alice], [active, true] ]); await keyv.set(userMap, userMap); const retrievedMap await keyv.get(userMap); console.log(retrievedMap instanceof Map); // true console.log(retrievedMap.get(name)); // Alice3. MessagePack序列化器 (keyv/serialize-msgpackr)MessagePack是一种高效的二进制序列化格式比JSON更紧凑、解析更快npm install keyv/serialize-msgpackr支持的数据类型✅ Date对象✅ RegExp正则表达式✅ Map和Set集合✅ Error对象✅ undefined值✅ NaN、Infinity、-Infinity特殊值import Keyv from keyv; import { msgpackrSerializer } from keyv/serialize-msgpackr; const keyv new Keyv({ serialization: msgpackrSerializer }); // 存储特殊数值 await keyv.set(specialNumbers, { nan: NaN, infinity: Infinity, negativeInfinity: -Infinity }); const numbers await keyv.get(specialNumbers); console.log(Number.isNaN(numbers.nan)); // true console.log(numbers.infinity Infinity); // trueKeyv项目的垂直Logo展示了其现代化的设计风格如何选择适合的序列化器 性能考虑msgpackr二进制格式序列化/反序列化速度最快数据体积最小SuperJSONJSON格式扩展性能接近原生JSON但支持更多类型内置JSON性能良好支持Buffer和BigInt数据类型需求需要支持Date、Map、Set选择SuperJSON或msgpackr需要支持BigInt选择SuperJSON或内置JSON需要支持NaN/Infinity选择msgpackr只需要Buffer和基本类型内置JSON足够兼容性考虑需要与其他系统交互SuperJSON标准JSON格式纯JavaScript环境msgpackr或SuperJSON需要最小数据体积msgpackr创建自定义序列化器 ️Keyv的序列化系统设计得非常灵活。你可以轻松创建自己的序列化器只需要实现KeyvSerializationAdapter接口import Keyv from keyv; // 自定义序列化器接口 const customSerializer { stringify(object) { // 自定义序列化逻辑 return JSON.stringify({ data: object, timestamp: Date.now(), version: 1.0 }); }, parse(data) { // 自定义反序列化逻辑 const parsed JSON.parse(data); return parsed.data; } }; // 使用自定义序列化器 const keyv new Keyv({ serialization: customSerializer });实际案例支持自定义类假设你有一个自定义的User类class User { constructor(id, name, email) { this.id id; this.name name; this.email email; this.createdAt new Date(); } get displayName() { return ${this.name} (${this.email}); } } // 创建支持User类的序列化器 const userSerializer { stringify(object) { if (object instanceof User) { return JSON.stringify({ __type: User, id: object.id, name: object.name, email: object.email, createdAt: object.createdAt.toISOString() }); } return JSON.stringify(object); }, parse(data) { const parsed JSON.parse(data); if (parsed parsed.__type User) { const user new User(parsed.id, parsed.name, parsed.email); user.createdAt new Date(parsed.createdAt); return user; } return parsed; } }; // 使用自定义序列化器 const keyv new Keyv({ serialization: userSerializer }); const user new User(1, Alice, aliceexample.com); await keyv.set(user1, user); const retrievedUser await keyv.get(user1); console.log(retrievedUser instanceof User); // true console.log(retrievedUser.displayName); // Alice (aliceexample.com)Keyv项目的水平Logo适合在网站头部或文档中使用序列化与压缩的结合使用 ⚡Keyv支持序列化器和压缩器的链式使用。数据处理的顺序是序列化 → 压缩 → 存储。读取时的顺序相反解压 → 反序列化。import Keyv from keyv; import { superJsonSerializer } from keyv/serialize-superjson; import { gzipCompression } from keyv/compress-gzip; // 同时使用序列化和压缩 const keyv new Keyv({ serialization: superJsonSerializer, compression: gzipCompression }); // 存储大量数据时自动压缩 const largeData { users: Array.from({ length: 1000 }, (_, i) ({ id: i, name: User ${i}, createdAt: new Date(), tags: new Set([active, premium]) })), metadata: new Map([ [total, 1000], [lastUpdated, new Date()] ]) }; await keyv.set(largeDataset, largeData); const retrieved await keyv.get(largeDataset); console.log(retrieved.users[0].createdAt instanceof Date); // true禁用序列化 在某些情况下你可能希望完全禁用序列化。这对于内存存储特别有用可以避免不必要的序列化开销const keyv new Keyv({ serialization: false }); // 直接存储对象不进行序列化 const complexObject { date: new Date(), map: new Map([[key, value]]), set: new Set([1, 2, 3]) }; // 注意这只适用于内存存储 // 对于需要持久化的存储后端必须使用序列化器最佳实践建议 根据数据类型选择序列化器如果需要支持Date、Map、Set等类型优先考虑SuperJSON或msgpackr。性能测试在生产环境中对不同的序列化器进行性能测试选择最适合你用例的。向后兼容性一旦选择了序列化器尽量保持不变避免数据迁移问题。自定义类型标记创建自定义序列化器时使用明确的类型标记如__type来确保正确的反序列化。错误处理在自定义序列化器中添加适当的错误处理确保数据损坏时的优雅降级。版本控制考虑在序列化数据中添加版本信息便于未来的数据迁移。总结 Keyv的自定义序列化系统提供了极大的灵活性让你能够超越JSON的限制支持更多JavaScript原生数据类型。无论是使用官方的SuperJSON、msgpackr序列化器还是创建自己的自定义序列化器Keyv都能满足你的需求。通过合理选择序列化策略你可以保持JavaScript类型的完整性提高数据存储效率优化应用程序性能支持复杂的数据结构记住正确的序列化选择不仅能提升开发体验还能显著改善应用程序的性能和可靠性。现在就开始探索Keyv的强大序列化功能为你的项目选择最适合的序列化方案吧【免费下载链接】keyvjaredwray/keyv: 这是一个分布式键值存储库用于在多个节点上存储数据。适合用于需要分布式存储和访问的场景。特点易于使用支持多种数据存储和访问方式具有高性能和可扩展性。项目地址: https://gitcode.com/gh_mirrors/ke/keyv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考