Morphia 2.3 中 Map 的 Locale 键映射失效问题及解决方案-java教程-PHP中文网

Morphia 2.3 中 Map 的 Locale 键映射失效问题及解决方案

morphia 2.3 默认不为 map 键执行 codec 序列化/反序列化，导致 mongodb 中存储的字符串键（如 "en"）无法自动还原为 locale 对象，需通过 conversions 注册自定义类型转换规则来解决。

morphia 2.3 默认不为 map 键执行 codec 序列化/反序列化，导致 mongodb 中存储的字符串键（如 "en"）无法自动还原为 locale 对象，需通过 conversions 注册自定义类型转换规则来解决。

在 Morphia 2.x 中，Map 的键（key）不会经过 Codec 流程处理——无论你是否注册了 LocaleCodec，它都仅作用于字段值（value），而对键完全无效。MongoDB 原生文档要求键必须是字符串，因此 Morphia 在写入时会自动调用 key.toString()（例如 new Locale("en").toString() → "en"），但在读取时，它不会尝试用 LocaleCodec 反向解析该字符串，而是直接将其作为 String 存入 Map。这就是为何你看到 Map 而非 Map 的根本原因。

✅ 正确解决方案：使用 Conversions.register() 注册双向转换

Morphia 提供了 Conversions 工具类（虽未标记为正式 public API，但长期稳定且被广泛使用），用于定义基础类型间的隐式转换。你需要注册 String ↔ Locale 的双向转换：

// 在应用初始化阶段（早于 Datastore 创建）执行：
Conversions.register(String.class, Locale.class, str -> {
    if (str == null || str.trim().isEmpty()) {
        return Locale.ENGLISH;
    }
    // 支持常见格式： "en", "en_US", "zh-CN", "de_DE@collation=phonebook"
    return Locale.forLanguageTag(str); // 推荐：兼容 BCP 47 标准
});

Conversions.register(Locale.class, String.class, locale -> {
    if (locale == null) {
        return Locale.getDefault().toLanguageTag();
    }
    return locale.toLanguageTag(); // 比 toString() 更标准、可逆
});

⚠️ 注意事项：

吐槽大师
一款以 AI 为核心的趣味文案生成工具，主打根据人物或内容生成轻松幽默的吐槽文本，适合社交媒体互动和娱乐表达。

下载

注册时机至关重要：必须在 Morphia.createDatastore(...) 之前调用，否则 Morphia 初始化时已构建内部转换器缓存，后续注册将被忽略。

优先使用 toLanguageTag() / forLanguageTag()：相比 toString()（返回 "en_US"）和 Locale(String) 构造器（仅支持语言代码），toLanguageTag() 输出符合 IETF BCP 47 标准的字符串（如 "en-US"），且 Locale.forLanguageTag() 可 100% 精确还原，避免区域变体丢失（如 "zh-CN" → Locale.CHINA）。

无需修改实体类或 Codec 注册逻辑：LocaleCodec 仍可用于其他场景（如独立 Locale 字段），此处仅需补充 Conversions 规则。

✅ 验证效果

完成注册后，你的原始实体代码即可正常工作：

private Map<locale messagetemplate> messageTemplates;

public Map<locale messagetemplate> getMessageTemplates() {
    if (messageTemplates == null) {
        messageTemplates = new HashMap();
    }
    return messageTemplates;
}</locale></locale>

从 MongoDB 加载文档时，messageTemplates 的 key 将自动为 Locale 实例（如 Locale.forLanguageTag("en")），不再需要手动 fixMap() —— 你的“hack”可安全移除。