寻找有关如何规范来自不同来源的传入json格式的建议

Question

我正在开发一个从许多不同来源接收数据（json）的项目。 每个源以不同的格式返回json，但是所有服务属于同一类别，即来自Jira的问题和来自PivotalTracker的Stories每个都具有相同的核心信息。

我正在寻找一种尽可能规范化的方法，以便将来可以添加其他服务和格式。 现在我分别处理每个响应类型（Jira，PivotalTracker）并独立地对每个响应采取行动。

到目前为止，我认为我需要为每个服务提供一个解析器，即JiraIssueParser，PivotalTrackerStoryParser等，它将响应转换为一种通用格式，可以由一种方法用于发布，而不是让每种方法都可以进行接收/解析/后。

像这样的格式：

{
  issue: {
    title: ,
    description: ,
    assignee: ,
    comments: {
      1: {
        id: ,
        title: ,
        body: 
      }
    time_entries: {
      1: {
        id: ,
        time: ,
        date: 
      }
    }
  }
}

我想在某处定义公共模式，以便每个解析器的输出始终相同。 我想这可以用YAML文件完成，但我不知道如何去做，以及如何在解析器中使用它。

我非常感谢有关如何做到这一点的一些建议。 也许这是一个非常愚蠢的问题，我应该从每个解析器输出上述格式，但我认为有一种强制/验证的格式是有意义的。

建议表示赞赏，如果有人有任何想法，我愿意接受新的指示。 提前致谢。

Answer 1

如果您正在使用Rails，那么我假设您将在某个时候拥有关系数据库。

我建议定义表达“规范化”格式的ActiveRecord模型：Issue，Comment，TimeEntry等。

然后，解析器的工作是将JSON数据强制转换为适当的模型对象和属性并保存它们。 因此，您的模型会强制执行规范数据结构（即架构），甚至可以使用验证程序进行进一步的健全性检查。

最后，我还会将原始JSON保存在模型旁边，最好也保存在数据库中。 即使您已经解析了JSON，保留它也可以派上用场进行故障排除。 例如，如果您找到并修复了解析错误，则可以在已保存的JSON上重新运行解析器，而无需重新下载原始外部源的所有内容。