class Ecoportal::API::Common::Content::CollectionModel
Attributes
Public Class Methods
# File lib/ecoportal/api/common/content/collection_model.rb, line 76 def doc_class(name) dim_class = new_class(name, inherits: Common::Content::ArrayModel) do |klass| klass.order_matters = order_matters klass.uniq = uniq end end
# File lib/ecoportal/api/common/content/collection_model.rb, line 11 def items_key @items_key ||= "id" end
# File lib/ecoportal/api/common/content/collection_model.rb, line 15 def items_key=(value) @items_key = value && value.to_s.freeze end
Resolves to the nuclear `Class` of the elements @note
- use block to define `klass` callback
@param value [Hash] base `doc` (raw object) to create the object with @yield [doc] identifies the target `class` of the raw object @yieldparam doc [Hash] @yieldreturn [Klass] the target `class` @return [Klass] the target `class`
# File lib/ecoportal/api/common/content/collection_model.rb, line 27 def klass(value = NOT_USED, &block) if block @klass = block block.call(value) if value != NOT_USED elsif used_param?(value) if @klass.is_a?(Proc) @klass.call(value) else resolve_class(@klass, exception: false) end else resolve_class(@klass, exception: false) end end
@return [Boolean] are there the factory logics to build item objects defined?
# File lib/ecoportal/api/common/content/collection_model.rb, line 72 def klass? @klass || @new_item end
Ecoportal::API::Common::Content::DoubleModel::new
# File lib/ecoportal/api/common/content/collection_model.rb, line 87 def initialize(ini_doc = [], parent: self, key: nil) unless self.class.klass? raise "Undefined base 'klass' or 'new_item' callback for #{self.class}" end ini_doc = case ini_doc when Array ini_doc when Enumerable ini_doc.to_a else [] end super(ini_doc, parent: parent, key: key) end
Generates a new object of the target class @note
- use block to define `new_item` callback, which will prevail over `klass` - if `new_item` callback was **not** defined, it is required to defnie `klass`
@param doc [Hash] doc to parse @note if block is given, it ignores `doc` @yield [doc, parent, key] creates an object instance of the target `klass` @yieldparam doc [Hash] @yieldreturn [Klass] instance object of the target `klass` @return [Klass] instance object of the target `klass`
# File lib/ecoportal/api/common/content/collection_model.rb, line 52 def new_item(doc = NOT_USED, parent: nil, key: nil, &block) if block @new_item = block elsif used_param?(doc) raise "You should define either a 'klass' or a 'new_item' callback first" unless klass? if @new_item @new_item.call(doc, parent, key) else if target_class = self.klass(doc) doc.is_a?(target_class) ? doc : target_class.new(doc, parent: parent, key: key) else raise "Could not find a class for: #{doc}" end end else raise "To define the 'new_item' callback (factory), you need to use a block" end end
Public Instance Methods
Get an element usign the `key`.
# File lib/ecoportal/api/common/content/collection_model.rb, line 143 def [](value) items_by_key[get_key(value)] end
Transforms `value` into the actual `key` to access the object in the doc `Array`
# File lib/ecoportal/api/common/content/collection_model.rb, line 110 def _doc_key(value) #print "*(#{value.class})" return super(value) unless value.is_a?(Hash) || value.is_a?(Content::DoubleModel) if id = get_key(value) #print "^" _doc_items.index {|item| get_key(item) == id}.tap do |p| #print "{{#{p}}}" end else raise UnlinkedModel.new("Can't find child: #{value}") end end
# File lib/ecoportal/api/common/content/collection_model.rb, line 132 def _items return @_items if @_items [].tap do |elements| variable_set(:@_items, elements) _doc_items.each do |item_doc| elements << new_item(item_doc) end end end
# File lib/ecoportal/api/common/content/collection_model.rb, line 170 def delete!(value) unless value.is_a?(Hash) || value.is_a?(Content::DoubleModel) raise "'Content::DoubleModel' or 'Hash' doc required" end if item = self[value] _doc_delete(item.doc) end end
# File lib/ecoportal/api/common/content/collection_model.rb, line 127 def each(&block) return to_enum(:each) unless block _items.each(&block) end
# File lib/ecoportal/api/common/content/collection_model.rb, line 124 def empty?; count == 0; end
@return [Class] the class of the elements of the Collection
# File lib/ecoportal/api/common/content/collection_model.rb, line 105 def items_class self.class.klass end
# File lib/ecoportal/api/common/content/collection_model.rb, line 123 def length; count; end
# File lib/ecoportal/api/common/content/collection_model.rb, line 125 def present?; count > 0; end
Tries to find the element `value`, if it exists, it updates it Otherwise it pushes it to the end @return the element
# File lib/ecoportal/api/common/content/collection_model.rb, line 154 def upsert!(value, pos: NOT_USED, before: NOT_USED, after: NOT_USED) unless value.is_a?(Hash) || value.is_a?(Content::DoubleModel) raise "'Content::DoubleModel' or 'Hash' doc required" end item_doc = value.is_a?(Content::DoubleModel)? value.doc : value item_doc = JSON.parse(item_doc.to_json) if item = self[value] item.replace_doc(item_doc) else _doc_upsert(item_doc, pos: pos, before: before, after: after) end (item || self[item_doc]).tap do |item| yield(item) if block_given? end end
# File lib/ecoportal/api/common/content/collection_model.rb, line 147 def values_at(*keys) keys.map {|key| self[key]} end
Protected Instance Methods
# File lib/ecoportal/api/common/content/collection_model.rb, line 201 def _doc_items replace_doc([]) unless doc.is_a?(Array) doc end
Gets the `key` of the object
# File lib/ecoportal/api/common/content/collection_model.rb, line 190 def get_key(value) case value when Content::DoubleModel value.key when Hash value[items_key] when String value end end
@note it does not support a change of `id` on an existing item
# File lib/ecoportal/api/common/content/collection_model.rb, line 207 def items_by_key return @items_by_key if @indexed {}.tap do |hash| variable_set(:@items_by_key, hash) _items.each {|item| hash[item.key] = item} @indexed = true end end
# File lib/ecoportal/api/common/content/collection_model.rb, line 183 def items_key; self.class.items_key; end
# File lib/ecoportal/api/common/content/collection_model.rb, line 185 def on_change variables_remove! end
# File lib/ecoportal/api/common/content/collection_model.rb, line 181 def order_matters?; self.class.order_matters; end
# File lib/ecoportal/api/common/content/collection_model.rb, line 182 def uniq?; self.class.uniq; end
Private Instance Methods
# File lib/ecoportal/api/common/content/collection_model.rb, line 238 def _doc_delete(value) if current_pos = _doc_key(value) _doc_items.delete_at(current_pos) on_change end end
# File lib/ecoportal/api/common/content/collection_model.rb, line 245 def _doc_upsert(value, pos: NOT_USED, before: NOT_USED, after: NOT_USED) current_pos = _doc_key(value) pos = case when used_param?(pos) pos when used_param?(before) _doc_key(before) when used_param?(after) #puts "to add after #{after.id}" if i = _doc_key(after) i + 1 end end pos ||= current_pos if current_pos && pos _doc_items.delete_at(current_pos) pos = (pos <= current_pos)? pos : pos - 1 end pos = (pos && pos < _doc_items.length)? pos : _doc_items.length pos.tap do |i| _doc_items.insert(pos, value) on_change end end
# File lib/ecoportal/api/common/content/collection_model.rb, line 218 def new_item(value) self.class.new_item(value, parent: self) end
Helper to remove tracked down instance variables
Ecoportal::API::Common::Content::DoubleModel#variable_remove!
# File lib/ecoportal/api/common/content/collection_model.rb, line 223 def variable_remove!(key) if @items_by_key && (k = get_key(key)) && (item = @items_by_key[k]) _items.delete(item) if _items.include?(item) @items_by_key.delete(k) else super(key) end end
Removes all the persistent variables
Ecoportal::API::Common::Content::DoubleModel#variables_remove!
# File lib/ecoportal/api/common/content/collection_model.rb, line 233 def variables_remove! @indexed = false super end