Module: RubyXL::RelationshipSupport

Included in:
ChartFile, Chartsheet, DrawingFile, Workbook, WorkbookRoot, Worksheet
Defined in:
lib/rubyXL/objects/relationships.rb

Defined Under Namespace

Modules: ClassMehods

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#generic_storage ⇒ Object

Returns the value of attribute generic_storage.



189
190
191
 
# File 'lib/rubyXL/objects/relationships.rb', line 189

def generic_storage
  @generic_storage
end

#relationship_container ⇒ Object

Returns the value of attribute relationship_container.



189
190
191
 
# File 'lib/rubyXL/objects/relationships.rb', line 189

def relationship_container
  @relationship_container
end

Class Method Details

.included(klass) ⇒ Object 



184
185
186
187
 
# File 'lib/rubyXL/objects/relationships.rb', line 184

def self.included(klass)
  klass.class_variable_set(:@@ooxml_relationships, {})
  klass.extend RelationshipSupport::ClassMehods
end

Instance Method Details

#attach_relationship(rid, rf) ⇒ Object 



219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
 
# File 'lib/rubyXL/objects/relationships.rb', line 219

def attach_relationship(rid, rf)
  relationships = self.class.class_variable_get(:@@ooxml_relationships)
  klass = rf.class
  if relationships.has_key?(klass) then
    accessor = relationships[klass]
    case accessor
    when NilClass then
      # Relationship is known, but we don't have a special accessor for it, store as generic
      store_relationship(rf)
    when false then
      # Do nothing, the code will perform attaching on its own
    else
      container = self.send(accessor)
      if container.is_a?(Array) then container << rf
      else self.send("#{accessor}=", rf)
      end
    end
  else store_relationship(rf, :unknown)
  end
end

#collect_related_objects ⇒ Object 



195
196
197
198
199
200
201
202
203
204
205
206
207
208
 
# File 'lib/rubyXL/objects/relationships.rb', line 195

def collect_related_objects
  res = related_objects.compact # Avoid tainting +related_objects+ array

  res += generic_storage if generic_storage

  if relationship_container then
    relationship_container.owner = self
    res << relationship_container
  end

  res.each { |o| res += o.collect_related_objects if o.respond_to?(:collect_related_objects) }

  res
end

#load_relationships(dir_path, base_file_name = '') ⇒ Object 



210
211
212
213
214
215
216
217
 
# File 'lib/rubyXL/objects/relationships.rb', line 210

def load_relationships(dir_path, base_file_name = '')
  self.relationship_container = self.class.const_get(:REL_CLASS).load_relationship_file(dir_path, base_file_name)
  return if relationship_container.nil?

  relationship_container.load_related_files(dir_path, base_file_name).each_pair { |rid, related_file|
    attach_relationship(rid, related_file) if related_file
  }
end

#related_objects ⇒ Object

Override this method



191
192
193
 
# File 'lib/rubyXL/objects/relationships.rb', line 191

def related_objects # Override this method
  []
end

#store_relationship(related_file, unknown = false) ⇒ Object 



240
241
242
243
244
 
# File 'lib/rubyXL/objects/relationships.rb', line 240

def store_relationship(related_file, unknown = false)
  self.generic_storage ||= []
  puts "WARNING: #{self.class} is not aware what to do with #{related_file.class}" if unknown
  self.generic_storage << related_file
end