Class: Model
- Includes:
- ModelHashBehaviour, ModelHelpers, ModelWrapper, ObjectTracking, ReactiveTags
- Defined in:
- lib/volt/models/model.rb
Instance Attribute Summary collapse
-
#attributes ⇒ Object
Returns the value of attribute attributes.
-
#options ⇒ Object
Returns the value of attribute options.
-
#parent ⇒ Object
readonly
Returns the value of attribute parent.
-
#path ⇒ Object
readonly
Returns the value of attribute path.
-
#persistor ⇒ Object
readonly
Returns the value of attribute persistor.
Instance Method Summary collapse
-
#! ⇒ Object
Pass through needed.
-
#<<(value) ⇒ Object
Initialize an empty array and append to it.
-
#==(val) ⇒ Object
Pass the comparison through.
-
#assign_attribute(method_name, *args, &block) ⇒ Object
Do the assignment to a model and trigger a changed event.
- #deep_cur ⇒ Object
-
#expand! ⇒ Object
If this model is nil, it makes it into a hash model, then sets it up to track from the parent.
-
#initialize(attributes = {}, options = {}) ⇒ Model
constructor
A new instance of Model.
- #inspect ⇒ Object
- #method_missing(method_name, *args, &block) ⇒ Object
- #new_array_model(*args) ⇒ Object
- #new_model(attributes, options) ⇒ Object
-
#read_attribute(method_name) ⇒ Object
When reading an attribute, we need to handle reading on: 1) a nil model, which returns a wrapped error 2) reading directly from attributes 3) trying to read a key that doesn’t exist.
-
#read_new_model(method_name) ⇒ Object
Get a new model, make it easy to override.
- #return_undefined_method(method_name) ⇒ Object
- #trigger_by_attribute!(event_name, attribute, *passed_args) ⇒ Object
Methods included from ModelHashBehaviour
#clear, #delete, #false?, included, #nil?, #to_h, #true?
Methods included from ModelHelpers
#class_at_path, #deep_unwrap, #event_added, #event_removed
Methods included from ObjectTracking
Methods included from ModelWrapper
Methods included from ReactiveTags
included, #reactive_method_tag
Constructor Details
#initialize(attributes = {}, options = {}) ⇒ Model
Returns a new instance of Model.
27 28 29 30 31 32 33 |
# File 'lib/volt/models/model.rb', line 27 def initialize(attributes={}, ={}) self. = self.attributes = wrap_values(attributes) @persistor.loaded if @persistor end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(method_name, *args, &block) ⇒ Object
67 68 69 70 71 72 73 74 75 76 77 78 79 80 |
# File 'lib/volt/models/model.rb', line 67 def method_missing(method_name, *args, &block) if method_name[0] == '_' if method_name[-1] == '=' # Assigning an attribute with = assign_attribute(method_name, *args, &block) else read_attribute(method_name) end else # Call method directly on attributes. (since they are # not using _ ) attributes.send(method_name, *args, &block) end end |
Instance Attribute Details
#attributes ⇒ Object
Returns the value of attribute attributes.
24 25 26 |
# File 'lib/volt/models/model.rb', line 24 def attributes @attributes end |
#options ⇒ Object
Returns the value of attribute options.
25 26 27 |
# File 'lib/volt/models/model.rb', line 25 def @options end |
#parent ⇒ Object (readonly)
Returns the value of attribute parent.
25 26 27 |
# File 'lib/volt/models/model.rb', line 25 def parent @parent end |
#path ⇒ Object (readonly)
Returns the value of attribute path.
25 26 27 |
# File 'lib/volt/models/model.rb', line 25 def path @path end |
#persistor ⇒ Object (readonly)
Returns the value of attribute persistor.
25 26 27 |
# File 'lib/volt/models/model.rb', line 25 def persistor @persistor end |
Instance Method Details
#! ⇒ Object
Pass through needed
57 58 59 |
# File 'lib/volt/models/model.rb', line 57 def ! !attributes end |
#<<(value) ⇒ Object
Initialize an empty array and append to it
179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 |
# File 'lib/volt/models/model.rb', line 179 def <<(value) if @parent @parent. else raise "Model data should be stored in sub collections." end # Grab the last section of the path, so we can do the assign on the parent path = @path.last result = @parent.send(path) if result.nil? # If this isn't a model yet, instantiate it @parent.send(:"#{path}=", new_array_model([], @options)) result = @parent.send(path) end # Add the new item result << value return nil end |
#==(val) ⇒ Object
Pass the comparison through
46 47 48 49 50 51 52 53 54 |
# File 'lib/volt/models/model.rb', line 46 def ==(val) if val.is_a?(Model) # Use normal comparison for a model return super else # Compare to attributes otherwise return attributes == val end end |
#assign_attribute(method_name, *args, &block) ⇒ Object
Do the assignment to a model and trigger a changed event
83 84 85 86 87 88 89 90 91 92 93 94 95 96 |
# File 'lib/volt/models/model.rb', line 83 def assign_attribute(method_name, *args, &block) self. # Assign, without the = attribute_name = method_name[0..-2].to_sym value = args[0] __assign_element(attribute_name, value) attributes[attribute_name] = wrap_value(value, [attribute_name]) trigger_by_attribute!('changed', attribute_name) # Let the persistor know something changed @persistor.changed(attribute_name) if @persistor end |
#deep_cur ⇒ Object
206 207 208 |
# File 'lib/volt/models/model.rb', line 206 def deep_cur attributes end |
#expand! ⇒ Object
If this model is nil, it makes it into a hash model, then sets it up to track from the parent.
164 165 166 167 168 169 170 171 172 173 |
# File 'lib/volt/models/model.rb', line 164 def if attributes.nil? self.attributes = {} if @parent @parent. @parent.attributes[@path.last] = self end end end |
#inspect ⇒ Object
202 203 204 |
# File 'lib/volt/models/model.rb', line 202 def inspect "<#{self.class.to_s} #{attributes.inspect}>" end |
#new_array_model(*args) ⇒ Object
145 146 147 |
# File 'lib/volt/models/model.rb', line 145 def new_array_model(*args) ArrayModel.new(*args) end |
#new_model(attributes, options) ⇒ Object
141 142 143 |
# File 'lib/volt/models/model.rb', line 141 def new_model(attributes, ) class_at_path([:path]).new(attributes, ) end |
#read_attribute(method_name) ⇒ Object
When reading an attribute, we need to handle reading on: 1) a nil model, which returns a wrapped error 2) reading directly from attributes 3) trying to read a key that doesn’t exist.
102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 |
# File 'lib/volt/models/model.rb', line 102 def read_attribute(method_name) # Reading an attribute, we may get back a nil model. method_name = method_name.to_sym if method_name[0] != '_' && attributes == nil # The method we are calling is on a nil model, return a wrapped # exception. return return_undefined_method(method_name) elsif attributes && attributes.has_key?(method_name) # Method has the key, look it up directly return attributes[method_name] else return read_new_model(method_name) end end |
#read_new_model(method_name) ⇒ Object
Get a new model, make it easy to override
119 120 121 122 123 124 125 |
# File 'lib/volt/models/model.rb', line 119 def read_new_model(method_name) if @persistor && @persistor.respond_to?(:read_new_model) @persistor.read_new_model(method_name) else return new_model(nil, @options.merge(parent: self, path: path + [method_name])) end end |
#return_undefined_method(method_name) ⇒ Object
127 128 129 130 131 132 133 134 135 136 137 138 139 |
# File 'lib/volt/models/model.rb', line 127 def return_undefined_method(method_name) # Methods called on nil capture an error so the user can know where # their nil calls are. This error can be re-raised at a later point. begin raise NilMethodCall.new("undefined method `#{method_name}' for #{self.to_s}") rescue => e result = e # Cleanup backtrace around ReactiveValue's # TODO: this could be better result.backtrace.reject! {|line| line['lib/models/model.rb'] || line['lib/models/live_value.rb'] } end end |
#trigger_by_attribute!(event_name, attribute, *passed_args) ⇒ Object
149 150 151 152 153 154 155 156 157 158 159 160 |
# File 'lib/volt/models/model.rb', line 149 def trigger_by_attribute!(event_name, attribute, *passed_args) trigger_by_scope!(event_name, *passed_args) do |scope| method_name, *args, block = scope # TODO: Opal bug args ||= [] # Any methods without _ are not directly related to one attribute, so # they should all trigger !method_name || method_name[0] != '_' || (method_name == attribute.to_sym && args.size == 0) end end |