Module: Dynamoid::Document
Overview
This is the base module for all domain objects that need to be persisted to the database as documents.
Defined Under Namespace
Modules: ClassMethods
Constant Summary
Constants included from Finders
Constants included from Fields
Instance Attribute Summary
Attributes included from Persistence
Attributes included from Fields
Instance Method Summary collapse
-
#==(other) ⇒ Object
An object is equal to another object if their ids are equal.
- #eql?(other) ⇒ Boolean
- #hash ⇒ Object
-
#hash_key ⇒ Object
Return an object’s hash key, regardless of what it might be called to the object.
-
#hash_key=(value) ⇒ Object
Assign an object’s hash key, regardless of what it might be called to the object.
-
#initialize(attrs = {}) ⇒ Dynamoid::Document
Initialize a new object.
- #load(attrs) ⇒ Object
- #range_value ⇒ Object
- #range_value=(value) ⇒ Object
-
#reload ⇒ Dynamoid::Document
Reload an object from the database – if you suspect the object has changed in the datastore and you need those changes to be reflected immediately, you would call this method.
Methods included from Dirty
#clear_changes, #save, #update!, #write_attribute
Methods included from IdentityMap
clear, #delete, #identity_map, #identity_map_key, #save
Methods included from Validations
Methods included from Persistence
#delete, #destroy, #dump, #persisted?, #save, #touch, #update, #update!
Methods included from Fields
#read_attribute, #update_attribute, #update_attributes, #write_attribute
Instance Method Details
#==(other) ⇒ Object
An object is equal to another object if their ids are equal.
141 142 143 144 145 146 147 148 |
# File 'lib/dynamoid/document.rb', line 141 def ==(other) if self.class.identity_map_on? super else return false if other.nil? other.is_a?(Dynamoid::Document) && self.hash_key == other.hash_key && self.range_value == other.range_value end end |
#eql?(other) ⇒ Boolean
150 151 152 |
# File 'lib/dynamoid/document.rb', line 150 def eql?(other) self == other end |
#hash ⇒ Object
154 155 156 |
# File 'lib/dynamoid/document.rb', line 154 def hash hash_key.hash ^ range_value.hash end |
#hash_key ⇒ Object
Return an object’s hash key, regardless of what it might be called to the object.
174 175 176 |
# File 'lib/dynamoid/document.rb', line 174 def hash_key self.send(self.class.hash_key) end |
#hash_key=(value) ⇒ Object
Assign an object’s hash key, regardless of what it might be called to the object.
181 182 183 |
# File 'lib/dynamoid/document.rb', line 181 def hash_key=(value) self.send("#{self.class.hash_key}=", value) end |
#initialize(attrs = {}) ⇒ Dynamoid::Document
Initialize a new object.
122 123 124 125 126 127 128 129 130 |
# File 'lib/dynamoid/document.rb', line 122 def initialize(attrs = {}) run_callbacks :initialize do @new_record = true @attributes ||= {} @associations ||= {} load(attrs) end end |
#load(attrs) ⇒ Object
132 133 134 135 136 |
# File 'lib/dynamoid/document.rb', line 132 def load(attrs) self.class.undump(attrs).each do |key, value| send("#{key}=", value) if self.respond_to?("#{key}=") end end |
#range_value ⇒ Object
185 186 187 188 189 |
# File 'lib/dynamoid/document.rb', line 185 def range_value if range_key = self.class.range_key self.send(range_key) end end |
#range_value=(value) ⇒ Object
191 192 193 |
# File 'lib/dynamoid/document.rb', line 191 def range_value=(value) self.send("#{self.class.range_key}=", value) end |
#reload ⇒ Dynamoid::Document
Reload an object from the database – if you suspect the object has changed in the datastore and you need those changes to be reflected immediately, you would call this method. This is a consistent read.
164 165 166 167 168 169 |
# File 'lib/dynamoid/document.rb', line 164 def reload range_key_value = range_value ? dumped_range_value : nil self.attributes = self.class.find(hash_key, :range_key => range_key_value, :consistent_read => true).attributes @associations.values.each(&:reset) self end |