如何在StrongLoop LoopBack中定义带多语言字符串的API模型？

嘿，这个需求我之前在项目里刚好处理过，LoopBack其实有几种很实用的方式来实现这种带多语言嵌套字段的模型，我给你梳理下最常用的几个方案，你可以根据自己的场景选：

如果你的支持语言是固定的（比如只需要英文、德文），那这个方案最省心，直接在模型的properties里定义嵌套对象就行，完全匹配你想要的存储格式。

比如在product.json里这么写：

{
  "name": "Product",
  "base": "PersistedModel",
  "properties": {
    "price": {
      "type": "number",
      "required": true
    },
    "title": {
      "type": "object",
      "properties": {
        "en": {
          "type": "string",
          "required": true
        },
        "de": {
          "type": "string"
        }
        // 后续要加其他语言的话，直接在这里加对应的字段就行，比如fr、es
      },
      "required": true
    }
  }
}

这种方式的好处是零额外配置，LoopBack会自动处理嵌套对象的序列化和反序列化，主流数据库（MongoDB、PostgreSQL等）也能直接存储这种结构。

如果你的支持语言可能动态变化，不想在模型里硬编码每一种语言，那可以自定义一个LocalizedString类型，还能顺便加一些验证逻辑，确保数据的完整性。

步骤大概是这样：

1. 在common/models下创建localized-string.js，写自定义类型的逻辑：

module.exports = function(LocalizedString) {
  // 自定义验证：确保至少有一个语言字段是非空的
  LocalizedString.validatesPresenceOfAtLeastOne = function() {
    return function(err) {
      const hasValidContent = Object.values(this).some(val => 
        typeof val === 'string' && val.trim() !== ''
      );
      if (!hasValidContent) {
        err(new Error('Title must have at least one valid language entry'));
      }
    };
  };
};

2. 在model-config.json里注册这个自定义类型：

{
  "LocalizedString": {
    "dataSource": "db",
    "public": false
  }
}

3. 然后在Product模型里使用这个类型：

{
  "name": "Product",
  "base": "PersistedModel",
  "properties": {
    "price": {
      "type": "number",
      "required": true
    },
    "title": {
      "type": "LocalizedString",
      "required": true,
      "validate": {
        "presenceOfAtLeastOne": true
      }
    }
  }
}

这个方案的优势是灵活度高，不管后续加多少种语言，都不用改模型定义，还能通过自定义验证保证数据不会出现空的多语言对象。

如果只是做快速原型，不想搞复杂的配置，也可以直接用LoopBack的Any类型：

{
  "name": "Product",
  "base": "PersistedModel",
  "properties": {
    "price": {
      "type": "number",
      "required": true
    },
    "title": {
      "type": "any",
      "required": true
    }
  }
}

不过要注意，这种方式没有任何类型校验，生产环境不推荐用，除非你自己在业务逻辑里做严格的参数校验，避免传入不符合格式的数据。

• 查询多语言字段：如果需要按特定语言查询，比如找英文标题包含某个关键词的产品，直接用点语法就行：

Product.find({where: {'title.en': {like: '%laptop%'}}})

• 自动返回对应语言的内容：可以在模型的afterFind钩子里面，根据请求头的Accept-Language自动返回对应语言的标题，减轻前端的负担：

Product.observe('after find', function(ctx, next) {
  const preferredLang = ctx.req.headers['accept-language']?.split(',')[0] || 'en';
  
  if (ctx.instance) {
    // 处理单个实例
    ctx.instance.displayTitle = ctx.instance.title[preferredLang] || ctx.instance.title.en;
  } else if (ctx.data) {
    // 处理实例列表
    ctx.data.forEach(item => {
      item.displayTitle = item.title[preferredLang] || item.title.en;
    });
  }
  next();
});

总的来说，如果语言列表固定，方案1是最优选择；如果需要动态语言或者自定义验证，方案2更合适；原型开发可以临时用方案3。

内容的提问来源于stack exchange，提问作者Qiong Wu