如何通过Grape的present方法返回空数组？

一、如何返回空数组而非无效实体对象 #

要实现当集合中无符合MyEntity要求的条目时返回{"collection"=>[]}，需要两步操作：

1. 提前过滤无效条目：在调用present前，筛选出满足MyEntity属性要求的OpenStruct实例，直接排除不符合规则的条目
2. 显式指定root参数：默认情况下，Grape会用实体类名的蛇形小写作为根键（比如MyEntity对应my_entity），需要手动指定root: 'collection'来得到期望的键名

示例代码：

get 'collection' do
  # ... 原有获取collection_of_items的逻辑

  # 根据MyEntity定义的必要属性过滤有效条目
  valid_items = collection_of_items.select do |item|
    # 替换为MyEntity实际要求的属性检查，比如需要id和name字段
    item.respond_to?(:id) && item.id.present? && item.respond_to?(:name) && item.name.present?
  end

  # 传入过滤后的数组，并指定root键为collection
  present valid_items, with: Entities::MyEntity, root: 'collection'
end

如果valid_items为空数组，present会直接返回{"collection"=>[]}，完全符合需求。

二、Grape底层返回实体数组的逻辑 #

Grape的present方法处理数组这类集合的核心流程：

• 当传入的对象是数组（实现了Enumerable接口，哈希除外）时，Grape会初始化集合表示器（Collection Representer），而非单个实体表示器
• 集合表示器会遍历数组中的每个元素，调用指定的Entity类对元素进行序列化：将元素转换为Entity实例，再按照Entity定义的属性、格式规则生成哈希结构
• 最后将所有序列化后的元素组成数组，结合指定的root参数（若有）生成最终响应结构

如果传入的数组为空，集合表示器会直接返回空数组，不会生成无效的实体对象。

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