Class: ActiveModel::Serializer::CollectionSerializer

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/active_model/serializer/collection_serializer.rb

Direct Known Subclasses

ArraySerializer

Constant Summary

NoSerializerError = 
Class.new(StandardError)

Instance Attribute Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (CollectionSerializer) initialize(resources, options = {})

Returns a new instance of CollectionSerializer



10
11
12
13
14
15
 
# File 'lib/active_model/serializer/collection_serializer.rb', line 10

def initialize(resources, options = {})
  @object                  = resources
  @options                 = options
  @root                    = options[:root]
  @serializers             = serializers_from_resources
end

Instance Attribute Details

- (Object) object (readonly)

Returns the value of attribute object



8
9
10
 
# File 'lib/active_model/serializer/collection_serializer.rb', line 8

def object
  @object
end

- (Object) root (readonly)

Returns the value of attribute root



8
9
10
 
# File 'lib/active_model/serializer/collection_serializer.rb', line 8

def root
  @root
end

Instance Method Details

- (Object) json_key

TODO: unify naming of root, json_key, and _type. Right now, a serializer's json_key comes from the root option or the object's model name, by default. But, if a dev defines a custom `json_key` method with an explicit value, we have no simple way to know that it is safe to call that instance method. (which is really a class property at this point, anyhow). rubocop:disable Metrics/CyclomaticComplexity Disabling cop since it's good to highlight the complexity of this method by including all the logic right here.



39
40
41
42
43
44
45
46
47
48
49
50
51
 
# File 'lib/active_model/serializer/collection_serializer.rb', line 39

def json_key
  return root if root
  # 1. get from options[:serializer] for empty resource collection
  key = object.empty? &&
    (explicit_serializer_class = options[:serializer]) &&
    explicit_serializer_class._type
  # 2. get from first serializer instance in collection
  key ||= (serializer = serializers.first) && serializer.json_key
  # 3. get from collection name, if a named collection
  key ||= object.respond_to?(:name) ? object.name && object.name.underscore : nil
  # 4. key may be nil for empty collection and no serializer option
  key && key.pluralize
end

- (Boolean) paginated?

rubocop:enable Metrics/CyclomaticComplexity

Returns:

  • (Boolean) 


54
55
56
57
58
 
# File 'lib/active_model/serializer/collection_serializer.rb', line 54

def paginated?
  object.respond_to?(:current_page) &&
    object.respond_to?(:total_pages) &&
    object.respond_to?(:size)
end

- (Object) serializable_hash(adapter_options, options, adapter_instance)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



22
23
24
25
26
27
28
29
 
# File 'lib/active_model/serializer/collection_serializer.rb', line 22

def serializable_hash(adapter_options, options, adapter_instance)
  include_directive = ActiveModel::Serializer.include_directive_from_options(adapter_options)
  adapter_options[:cached_attributes] ||= ActiveModel::Serializer.cache_read_multi(self, adapter_instance, include_directive)
  adapter_opts = adapter_options.merge(include_directive: include_directive)
  serializers.map do |serializer|
    serializer.serializable_hash(adapter_opts, options, adapter_instance)
  end
end

- (Boolean) success?

Returns:

  • (Boolean) 


17
18
19
 
# File 'lib/active_model/serializer/collection_serializer.rb', line 17

def success?
  true
end