在Rails应用中结合Grape实现适配Ember的关联资源API返回

首先，要让你的API输出符合JSON API规范的结构（这是Ember Data默认期望的格式），结合ActiveModel::Serializer和Grape，我们可以一步步搞定：

1. 配置Grape使用JSON API适配器 #

在你的Grape API主类里，指定JSON格式并启用ActiveModelSerializers的JSON API适配器，这样序列化后的结构会自动包含data和included字段：

class YourAPI < Grape::API
  format :json
  # 指定使用JSON API适配器，适配Ember的格式要求
  formatter :json, ActiveModelSerializers::Adapter::JsonApi
end

2. 给关联模型创建序列化器 #

你已经有了JudgeSerializer，现在需要给Judgecourt模型也写一个对应的序列化器，比如：

class JudgecourtSerializer < ActiveModel::Serializer
  # 替换成Judgecourt模型的实际字段，保持和数据库一致的大写格式
  attributes :ID, :JUDGE_ID, :COURT_ID

  # 如果需要反向关联回Judge，可以加这行（可选）
  belongs_to :judge, serializer: JudgeSerializer
end

3. 在JudgeSerializer中声明关联 #

修改你的JudgeSerializer，添加has_many关联并指定对应的序列化器：

class JudgeSerializer < ActiveModel::Serializer
  attributes :ID, :FIRST_NAME, :LAST_NAME, :FULL_NAME

  # 声明关联，指定对应的序列化器
  has_many :judgecourts, serializer: JudgecourtSerializer
end

4. 在Grape端点中指定要包含的关联 #

在你的API端点里，渲染Judge数据时通过include参数指定要加载的关联，这样关联数据就会被自动放到included数组里：

get '/judges/:id' do
  judge = Judge.find(params[:id])
  # 用include指定要包含的关联，这里是judgecourts
  render json: judge, include: 'judgecourts'
end

如果希望默认就包含关联，不用每次写include参数，可以在JudgeSerializer里加一行：

class JudgeSerializer < ActiveModel::Serializer
  default_includes :judgecourts # 默认自动包含judgecourts关联数据
  # ... 其他代码
end

关键注意事项 #

• 确保你的Judge模型关联配置正确，比如：

  class Judge < ApplicationRecord
    self.primary_key = 'id'
    self.table_name = 'judge'
    has_many :judgecourts, 
             class_name: 'Judgecourt', 
             primary_key: 'ID', # 对应Judge表的主键字段
             foreign_key: 'JUDGE_ID' # 对应Judgecourt表中关联Judge的外键字段
  end
  

• 如果你的字段是大写格式，要避免ActiveModelSerializers自动转换字段名，可在config/initializers/active_model_serializers.rb里添加配置：

  ActiveModelSerializers.config.key_transform = :none # 保持字段名原样，不做驼峰/蛇形转换
  

这样返回的响应就会完全符合Ember的期望：主资源在data节点，关联的judgecourts数据在included数组里，能直接被Ember Data解析使用~

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