Class: Glimmer::DataBinding::ModelBinding
- Inherits:
-
Object
- Object
- Glimmer::DataBinding::ModelBinding
show all
- Includes:
- Observable, Observer
- Defined in:
- lib/glimmer/data_binding/model_binding.rb
Instance Attribute Summary collapse
Instance Method Summary
collapse
Methods included from Observer
#add_dependent, #dependents, #dependents_for, proc, #register, #registration_for, #registrations, #remove_dependent, #unregister, #unregister_all_observables, #unregister_dependents_with_observable
Methods included from Observable
#inspect
Constructor Details
#initialize(base_model, property_name_expression, binding_options = nil) ⇒ ModelBinding
Returns a new instance of ModelBinding.
12
13
14
15
16
17
18
19
20
21
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 12
def initialize(base_model, property_name_expression, binding_options = nil)
@base_model = base_model
@property_name_expression = property_name_expression
@binding_options = binding_options || {}
if computed?
@computed_model_bindings = computed_by.map do |computed_by_property_expression|
self.class.new(base_model, computed_by_property_expression)
end
end
end
|
Instance Attribute Details
#binding_options ⇒ Object
Returns the value of attribute binding_options.
10
11
12
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 10
def binding_options
@binding_options
end
|
Instance Method Details
#add_computed_observers(observer) ⇒ Object
168
169
170
171
172
173
174
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 168
def add_computed_observers(observer)
@computed_model_bindings.each do |computed_model_binding|
observer_registration = computed_observer_for(observer).observe(computed_model_binding)
my_registration = observer.registration_for(self)
observer.add_dependent(my_registration => observer_registration)
end
end
|
#add_nested_observers(observer) ⇒ Object
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 176
def add_nested_observers(observer)
nested_property_observers = nested_property_observers_for(observer)
nested_models.zip(nested_property_names).each_with_index do |zip, i|
model, property_name = zip
nested_property_observer = nested_property_observers[property_name]
previous_index = i - 1
parent_model = previous_index.negative? ? self : nested_models[previous_index]
parent_property_name = previous_index.negative? ? nil : nested_property_names[previous_index]
parent_observer = previous_index.negative? ? observer : nested_property_observers[parent_property_name]
parent_property_name = nil if parent_property_name.to_s.start_with?('[')
unless model.nil?
if property_indexed?(property_name)
observer_registration = nested_property_observer.observe(model)
else
observer_registration = nested_property_observer.observe(model, property_name)
end
parent_registration = parent_observer.registration_for(parent_model, parent_property_name)
parent_observer.add_dependent(parent_registration => observer_registration)
end
end
end
|
#add_observer(observer) ⇒ Object
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 130
def add_observer(observer)
if computed?
add_computed_observers(observer)
elsif nested_property?
add_nested_observers(observer)
else
model_binding_observer = Observer.proc do |new_value|
observer.call(evaluate_property)
end
observer_registration = model_binding_observer.observe(model, property_name)
my_registration = observer.registration_for(self)
observer.add_dependent(my_registration => observer_registration)
end
end
|
#apply_converter(converter, value) ⇒ Object
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 62
def apply_converter(converter, value)
if converter.nil?
value
elsif converter.is_a?(String) || converter.is_a?(Symbol)
if value.respond_to?(converter)
value.send(converter)
else
raise Glimmer::Error, "Unsupported bind converter: #{converter.inspect}"
end
elsif converter.respond_to?(:call, value)
converter.call(value)
else
raise Glimmer::Error, "Unsupported bind converter: #{converter.inspect}"
end
end
|
#base_model ⇒ Object
46
47
48
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 46
def base_model
@base_model
end
|
#call(value) ⇒ Object
199
200
201
202
203
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 199
def call(value)
return if model.nil?
converted_value = value
invoke_property_writer(model, "#{property_name}=", converted_value) unless evaluate_property == converted_value
end
|
#computed? ⇒ Boolean
106
107
108
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 106
def computed?
!computed_by.empty?
end
|
#computed_by ⇒ Object
110
111
112
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 110
def computed_by
[@binding_options[:computed_by]].flatten.compact
end
|
#computed_observer_for(observer) ⇒ Object
158
159
160
161
162
163
164
165
166
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 158
def computed_observer_for(observer)
@computed_observer_collection ||= {}
unless @computed_observer_collection.has_key?(observer)
@computed_observer_collection[observer] = Observer.proc do |new_value|
observer.call(evaluate_property)
end
end
@computed_observer_collection[observer]
end
|
#convert_on_read(value) ⇒ Object
54
55
56
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 54
def convert_on_read(value)
apply_converter(@binding_options[:on_read], value)
end
|
#convert_on_write(value) ⇒ Object
58
59
60
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 58
def convert_on_write(value)
apply_converter(@binding_options[:on_write], value)
end
|
#evaluate_options_property ⇒ Object
211
212
213
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 211
def evaluate_options_property
model.send(options_property_name) unless model.nil?
end
|
#evaluate_property ⇒ Object
205
206
207
208
209
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 205
def evaluate_property
value = nil
value = invoke_property_reader(model, property_name) unless model.nil?
convert_on_read(value)
end
|
#invoke_property_reader(object, property_expression) ⇒ Object
223
224
225
226
227
228
229
230
231
232
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 223
def invoke_property_reader(object, property_expression)
if property_indexed?(property_expression)
property_method = '[]'
property_argument = property_expression[1...-1]
property_argument = property_argument.to_i if property_argument.match(/\d+/)
object.send(property_method, property_argument)
else
object.send(property_expression)
end
end
|
#invoke_property_writer(object, property_expression, value) ⇒ Object
234
235
236
237
238
239
240
241
242
243
244
245
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 234
def invoke_property_writer(object, property_expression, value)
return if @binding_options[:read_only]
value = convert_on_write(value)
if property_indexed?(property_expression)
property_method = '[]='
property_argument = property_expression[1...-2]
property_argument = property_argument.to_i if property_argument.match(/\d+/)
object.send(property_method, property_argument, value)
else
object.send(property_expression, value)
end
end
|
#model ⇒ Object
23
24
25
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 23
def model
nested_property? ? nested_model : base_model
end
|
#model_property_names ⇒ Object
Model representing nested property names e.g. property name expression “address.state” gives [:address]
94
95
96
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 94
def model_property_names
nested_property_names[0...-1]
end
|
#nested_model ⇒ Object
42
43
44
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 42
def nested_model
nested_models.last
end
|
#nested_models ⇒ Object
e.g. person.address.state returns [person, person.address]
28
29
30
31
32
33
34
35
36
37
38
39
40
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 28
def nested_models
@nested_models = [base_model]
model_property_names.reduce(base_model) do |reduced_model, nested_model_property_name|
if reduced_model.nil?
nil
else
invoke_property_reader(reduced_model, nested_model_property_name).tap do |new_reduced_model|
@nested_models << new_reduced_model
end
end
end
@nested_models
end
|
#nested_property? ⇒ Boolean
98
99
100
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 98
def nested_property?
property_name_expression.match(/[.\[]/)
end
|
#nested_property_name ⇒ Object
Final nested property name e.g. property name expression “address.state” gives :state
88
89
90
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 88
def nested_property_name
nested_property_names.last
end
|
#nested_property_names ⇒ Object
All nested property names e.g. property name expression “address.state” gives [‘address’, ‘state’] If there are any indexed property names, this returns indexes as properties. e.g. property name expression “addresses.state” gives [‘addresses’, ‘[1]’, ‘state’]
82
83
84
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 82
def nested_property_names
@nested_property_names ||= property_name_expression.split(".").map {|pne| pne.match(/([^\[]+)(\[[^\]]+\])?/).to_a.drop(1)}.flatten.compact
end
|
#nested_property_observers_for(observer) ⇒ Object
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 114
def nested_property_observers_for(observer)
@nested_property_observers_collection ||= {}
unless @nested_property_observers_collection.has_key?(observer)
@nested_property_observers_collection[observer] = nested_property_names.reduce({}) do |output, property_name|
output.merge(
property_name => Observer.proc do |new_value|
add_observer(observer)
observer.call(evaluate_property)
end
)
end
end
@nested_property_observers_collection[observer]
end
|
#options_property_name ⇒ Object
215
216
217
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 215
def options_property_name
self.property_name + "_options"
end
|
#property_indexed?(property_expression) ⇒ Boolean
219
220
221
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 219
def property_indexed?(property_expression)
property_expression.to_s.start_with?('[')
end
|
#property_name ⇒ Object
50
51
52
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 50
def property_name
nested_property? ? nested_property_name : property_name_expression
end
|
#property_name_expression ⇒ Object
102
103
104
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 102
def property_name_expression
@property_name_expression
end
|
#remove_observer(observer) ⇒ Object
145
146
147
148
149
150
151
152
153
154
155
156
|
# File 'lib/glimmer/data_binding/model_binding.rb', line 145
def remove_observer(observer)
if computed?
@computed_model_bindings.each do |computed_model_binding|
computed_observer_for(observer).unobserve(computed_model_binding)
end
@computed_observer_collection.delete(observer)
elsif nested_property?
nested_property_observers_for(observer).clear
else
observer.unobserve(model, property_name)
end
end
|