Class: Moxml::Adapter::Rexml

Inherits:
Base
  • Object
show all
Defined in:
lib/moxml/adapter/rexml.rb

Constant Summary

Constants included from XmlUtils

XmlUtils::VALID_ELEMENT_NAMES

Class Method Summary collapse

Methods inherited from Base

actual_native, attribute_name, bare_get_qname_safe?, bulk_materialize?, children_accepts_entity_flag?, create_cdata, create_comment, create_declaration, create_doctype, create_element, create_entity_reference, create_namespace, create_processing_instruction, create_text, decode_entities, digest, entity_bearing?, expanded_attr_reads?, expanded_attr_value, free_document, iterparse, iterparse_file, line_number, materialize_fields, native_inclusive10, parse_errors, parse_html, patch_node, patches_children?, plan_rows, preprocess_entities, restore_entities, same_node?, sax_supported?, serialize_generation, source_position, walk_descendants, wrap_native, wrappers_recyclable?

Methods included from XmlUtils

#encode_entities, #normalize_xml_value, #validate_comment_content, #validate_declaration_encoding, #validate_declaration_standalone, #validate_declaration_version, #validate_element_name, #validate_entity_reference_name, #validate_pi_target, #validate_prefix, #validate_uri

Class Method Details

.add_child(element, child) ⇒ Object



328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
# File 'lib/moxml/adapter/rexml.rb', line 328

def add_child(element, child)
  # Special handling for declarations on REXML documents
  if element.is_a?(::REXML::Document) && child.is_a?(::REXML::XMLDecl)
    # Track declaration state in attachment map
    attachments.set(element, :xml_declaration, child)
  end

  case child
  when String
    element.add_text(child)
    append_child_sequence(element, :native)
  when ::Moxml::Adapter::CustomizedRexml::EntityReference
    # REXML doesn't support custom node types in its tree.
    # Store alongside native children via attachment map.
    refs = attachments.get(element, :entity_refs) || []
    refs << child
    attachments.set(element, :entity_refs, refs)
    append_child_sequence(element, :eref)
  else
    element.add(child)
    append_child_sequence(element, :native)
  end
end

.add_next_sibling(node, sibling) ⇒ Object



368
369
370
371
# File 'lib/moxml/adapter/rexml.rb', line 368

def add_next_sibling(node, sibling)
  parent = node.parent
  parent.insert_after(node, sibling)
end

.add_previous_sibling(node, sibling) ⇒ Object



358
359
360
361
362
363
364
365
366
# File 'lib/moxml/adapter/rexml.rb', line 358

def add_previous_sibling(node, sibling)
  parent = node.parent
  # caveat: Rexml fails if children belong to the same parent and are already in a correct order
  # example: "<root><a/><b/></root>"
  # add_previous_sibling(node_b, node_a)
  # result: "<root><b/><a/></root>"
  # expected result: "<root><a/><b/></root>"
  parent.insert_before(node, sibling)
end

.append_child_sequence(element, type) ⇒ Object



352
353
354
355
356
# File 'lib/moxml/adapter/rexml.rb', line 352

def append_child_sequence(element, type)
  seq = attachments.get(element, :child_sequence) || []
  seq << type
  attachments.set(element, :child_sequence, seq)
end

.at_xpath(node, expression, namespaces = {}) ⇒ Object



618
619
620
621
# File 'lib/moxml/adapter/rexml.rb', line 618

def at_xpath(node, expression, namespaces = {})
  results = xpath(node, expression, namespaces)
  results.first
end

.attachmentsObject



13
14
15
# File 'lib/moxml/adapter/rexml.rb', line 13

def attachments
  @attachments ||= Moxml::NativeAttachment.new
end

.attribute_element(attribute) ⇒ Object



287
288
289
# File 'lib/moxml/adapter/rexml.rb', line 287

def attribute_element(attribute)
  attribute.element
end

.attributes(element) ⇒ Object



271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
# File 'lib/moxml/adapter/rexml.rb', line 271

def attributes(element)
  return [] unless element.is_a?(::REXML::Element)

  # Each real Attribute node, not Attributes#values: when two
  # attributes share a local name across namespaces, REXML's
  # values leaks its internal prefix-grouping Hash alongside
  # the Attribute objects (issue #95).
  result = []
  element.attributes.each_attribute do |attr|
    next if attr.prefix.to_s.start_with?("xmlns")

    result << attr
  end
  result
end

.bare_set_qname_safe?Boolean

Returns:

  • (Boolean)


17
18
19
# File 'lib/moxml/adapter/rexml.rb', line 17

def bare_set_qname_safe?
  true
end

.cdata_content(node) ⇒ Object



422
423
424
# File 'lib/moxml/adapter/rexml.rb', line 422

def cdata_content(node)
  node.value
end

.children(node, **_entity_bearing) ⇒ Object



192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
# File 'lib/moxml/adapter/rexml.rb', line 192

def children(node, **_entity_bearing)
  return [] unless node.is_a?(::REXML::Parent)

  # Return all children preserving whitespace text nodes
  result = node.children.dup

  # Include any EntityReference wrappers stored alongside native
  # children. Native children are identity-unique; only this
  # concat can duplicate (the same wrapper added twice), so the
  # dedupe lives here and the common path stays scan-free.
  entity_refs = attachments.get(node, :entity_refs)
  if entity_refs
    result.concat(entity_refs).uniq!(&:object_id) || result
  else
    result
  end
end

.comment_content(node) ⇒ Object



414
415
416
# File 'lib/moxml/adapter/rexml.rb', line 414

def comment_content(node)
  node.string
end

.create_document(_native_doc = nil) ⇒ Object



94
95
96
# File 'lib/moxml/adapter/rexml.rb', line 94

def create_document(_native_doc = nil)
  ::REXML::Document.new
end

.create_native_cdata(content, _owner_doc = nil) ⇒ Object



114
115
116
# File 'lib/moxml/adapter/rexml.rb', line 114

def create_native_cdata(content, _owner_doc = nil)
  ::REXML::CData.new(content.to_s)
end

.create_native_comment(content, _owner_doc = nil) ⇒ Object



118
119
120
# File 'lib/moxml/adapter/rexml.rb', line 118

def create_native_comment(content, _owner_doc = nil)
  ::REXML::Comment.new(content.to_s)
end

.create_native_declaration(version, encoding, standalone) ⇒ Object



127
128
129
# File 'lib/moxml/adapter/rexml.rb', line 127

def create_native_declaration(version, encoding, standalone)
  ::REXML::XMLDecl.new(version, encoding&.downcase, standalone)
end

.create_native_doctype(name, external_id, system_id) ⇒ Object



131
132
133
134
135
136
137
138
139
140
# File 'lib/moxml/adapter/rexml.rb', line 131

def create_native_doctype(name, external_id, system_id)
  return nil unless name

  external = if external_id
               system_id ? %(PUBLIC "#{external_id}" "#{system_id}") : %(PUBLIC "#{external_id}")
             elsif system_id
               %(SYSTEM "#{system_id}")
             end
  external ? ::REXML::DocType.new(name.to_s, external) : ::REXML::DocType.new(name.to_s)
end

.create_native_element(name, _owner_doc = nil) ⇒ Object



98
99
100
# File 'lib/moxml/adapter/rexml.rb', line 98

def create_native_element(name, _owner_doc = nil)
  ::REXML::Element.new(name.to_s)
end

.create_native_entity_reference(name, _owner_doc = nil) ⇒ Object



106
107
108
# File 'lib/moxml/adapter/rexml.rb', line 106

def create_native_entity_reference(name, _owner_doc = nil)
  ::Moxml::Adapter::CustomizedRexml::EntityReference.new(name)
end

.create_native_namespace(element, prefix, uri) ⇒ Object

add a namespace definition, keep the element name unchanged



495
496
497
498
# File 'lib/moxml/adapter/rexml.rb', line 495

def create_native_namespace(element, prefix, uri)
  element.add_namespace(prefix.to_s, uri)
  ::REXML::Attribute.new(prefix.to_s, uri, element)
end

.create_native_processing_instruction(target, content) ⇒ Object



122
123
124
125
# File 'lib/moxml/adapter/rexml.rb', line 122

def create_native_processing_instruction(target, content)
  # Clone strings to avoid frozen string errors
  ::REXML::Instruction.new(target.to_s.dup, content.to_s.dup)
end

.create_native_text(content, _owner_doc = nil) ⇒ Object



102
103
104
# File 'lib/moxml/adapter/rexml.rb', line 102

def create_native_text(content, _owner_doc = nil)
  ::REXML::Text.new(content.to_s, true, nil)
end

.declaration_attribute(node, name) ⇒ Object



392
393
394
395
396
397
398
399
400
401
# File 'lib/moxml/adapter/rexml.rb', line 392

def declaration_attribute(node, name)
  case name
  when "version"
    node.version
  when "encoding"
    node.encoding
  when "standalone"
    node.standalone
  end
end

.doctype_external_id(native) ⇒ Object



569
570
571
572
573
574
# File 'lib/moxml/adapter/rexml.rb', line 569

def doctype_external_id(native)
  # Constructed doctypes keep the identifier as a raw
  # external_id string; parsed ones populate public directly
  native.public ||
    native.external_id&.match(/PUBLIC\s+"([^"]*)"/)&.[](1)
end

.doctype_name(native) ⇒ Object

Doctype accessor methods



565
566
567
# File 'lib/moxml/adapter/rexml.rb', line 565

def doctype_name(native)
  native.name
end

.doctype_system_id(native) ⇒ Object



576
577
578
579
580
581
# File 'lib/moxml/adapter/rexml.rb', line 576

def doctype_system_id(native)
  return native.system if native.system

  quoted = native.external_id&.scan(/"([^"]*)"/)
  quoted&.last&.first
end

.document(node) ⇒ Object



258
259
260
# File 'lib/moxml/adapter/rexml.rb', line 258

def document(node)
  node.document
end

.duplicate_node(node) ⇒ Object



184
185
186
187
188
189
190
# File 'lib/moxml/adapter/rexml.rb', line 184

def duplicate_node(node)
  if node.is_a?(::REXML::Parent)
    node.deep_clone
  else
    Marshal.load(Marshal.dump(node))
  end
end

.entity_reference_name(node) ⇒ Object



110
111
112
# File 'lib/moxml/adapter/rexml.rb', line 110

def entity_reference_name(node)
  node.name if node.is_a?(::Moxml::Adapter::CustomizedRexml::EntityReference)
end

.extract_encoding_from_xml(xml) ⇒ Object



57
58
59
60
61
62
63
64
65
66
# File 'lib/moxml/adapter/rexml.rb', line 57

def extract_encoding_from_xml(xml)
  return "UTF-8" unless xml.start_with?("<?xml")

  decl_end = xml.index("?>")
  return "UTF-8" unless decl_end

  decl = xml[0...decl_end]
  match = decl.match(/encoding\s*=\s*["']([^"']+)["']/i)
  match ? match[1] : "UTF-8"
end

.extract_text_recursively(element) ⇒ Object



454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
# File 'lib/moxml/adapter/rexml.rb', line 454

def extract_text_recursively(element)
  return "" unless element

  text = ""
  element.children.each do |child|
    case child
    when ::REXML::Text
      # Preserve original spacing from text nodes exactly including newlines and all whitespace
      text += child.value
    when ::REXML::Element
      # Extract text recursively from child element
      child_text = extract_text_recursively(child)
      # Concatenate directly like other adapters - NO SPACE INSERTION
      text += child_text
    end
  end
  # Don't strip - preserve original spacing including newlines
  text
end

.get_attribute(element, name) ⇒ Object



316
317
318
# File 'lib/moxml/adapter/rexml.rb', line 316

def get_attribute(element, name)
  element.attributes.get_attribute(name)
end

.get_attribute_value(element, name) ⇒ Object



320
321
322
# File 'lib/moxml/adapter/rexml.rb', line 320

def get_attribute_value(element, name)
  element.attributes[name]
end

.has_declaration?(native_doc, wrapper) ⇒ Boolean

Returns:

  • (Boolean)


672
673
674
675
676
677
678
679
680
681
682
683
# File 'lib/moxml/adapter/rexml.rb', line 672

def has_declaration?(native_doc, wrapper)
  xml_decl = attachments.get(native_doc, :xml_declaration)
  if xml_decl.nil?
    if attachments.key?(native_doc, :xml_declaration)
      false
    else
      wrapper.has_xml_declaration
    end
  else
    true
  end
end

.in_scope_namespaces(element) ⇒ Object



554
555
556
557
558
559
560
561
562
# File 'lib/moxml/adapter/rexml.rb', line 554

def in_scope_namespaces(element)
  namespaces = {}
  element.namespaces.each do |prefix, uri|
    key = prefix.to_s.empty? ? "xmlns" : prefix.to_s
    ns = ::REXML::Attribute.new(key, uri, element)
    namespaces[prefix] = ns
  end
  namespaces.values
end

.inner_text(node) ⇒ Object



474
475
476
477
478
479
480
# File 'lib/moxml/adapter/rexml.rb', line 474

def inner_text(node)
  # Get direct text children only, filter duplicates
  text_children = node.children
    .grep(::REXML::Text)
    .uniq(&:object_id)
  text_children.map(&:value).join
end

.namespace(node) ⇒ Object



533
534
535
536
537
538
539
540
# File 'lib/moxml/adapter/rexml.rb', line 533

def namespace(node)
  prefix = node.prefix
  uri = node.namespace(prefix)
  return if prefix.to_s.empty? && uri.to_s.empty?

  owner = node.is_a?(::REXML::Attribute) ? node.element : node
  ::REXML::Attribute.new(prefix, uri, owner)
end

.namespace_definitions(node) ⇒ Object



542
543
544
545
546
547
548
549
550
551
552
# File 'lib/moxml/adapter/rexml.rb', line 542

def namespace_definitions(node)
  return [] unless node.is_a?(::REXML::Element)

  result = []
  node.attributes.each_attribute do |attr|
    next unless attr.prefix == "xmlns" || (attr.name == "xmlns" && attr.prefix.to_s.empty?)

    result << attr
  end
  result
end

.namespace_prefix(node) ⇒ Object



525
526
527
# File 'lib/moxml/adapter/rexml.rb', line 525

def namespace_prefix(node)
  node.name unless node.name == "xmlns"
end

.namespace_uri(node) ⇒ Object



529
530
531
# File 'lib/moxml/adapter/rexml.rb', line 529

def namespace_uri(node)
  node.value
end

.native_identity_stable?Boolean

Returns:

  • (Boolean)


21
22
23
# File 'lib/moxml/adapter/rexml.rb', line 21

def native_identity_stable?
  true
end

.next_sibling(node) ⇒ Object



214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
# File 'lib/moxml/adapter/rexml.rb', line 214

def next_sibling(node)
  current = node.next_sibling

  seen = {}
  while current
    if current.is_a?(::REXML::Text) && current.to_s.strip.empty?
      current = current.next_sibling
      next
    end

    if seen[current.object_id]
      current = current.next_sibling
      next
    end

    seen[current.object_id] = true
    break
  end

  current
end

.node_name(node) ⇒ Object



173
174
175
176
177
178
179
180
181
182
# File 'lib/moxml/adapter/rexml.rb', line 173

def node_name(node)
  case node
  when ::REXML::Element, ::REXML::DocType
    node.name
  when ::REXML::XMLDecl
    "xml"
  when ::REXML::Instruction
    node.target
  end
end

.node_type(node) ⇒ Object



147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
# File 'lib/moxml/adapter/rexml.rb', line 147

def node_type(node)
  case node
  when ::REXML::Document then :document
  when ::REXML::Element then :element
  when ::REXML::CData then :cdata
  when ::REXML::Text then :text
  when ::REXML::Comment then :comment
  when ::REXML::Attribute then :attribute # but in fact it may be a namespace as well
  when ::REXML::Namespace then :namespace # we don't use this one
  when ::REXML::Instruction then :processing_instruction
  when ::REXML::DocType then :doctype
  when ::REXML::XMLDecl then :declaration
  when ::Moxml::Adapter::CustomizedRexml::EntityReference then :entity_reference
  else :unknown
  end
end

.parent(node) ⇒ Object



210
211
212
# File 'lib/moxml/adapter/rexml.rb', line 210

def parent(node)
  node.parent
end

.parse(xml, options = {}, _context = nil) ⇒ Object



25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
# File 'lib/moxml/adapter/rexml.rb', line 25

def parse(xml, options = {}, _context = nil)
  xml = "" if xml.nil?

  # Handle frozen strings by creating a mutable copy
  processed_xml = if xml.frozen?
                    xml.dup.force_encoding("UTF-8").encode("UTF-8")
                  else
                    xml.force_encoding("UTF-8").encode("UTF-8")
                  end

  # Preprocess entities to avoid double-escaping on output
  processed_xml = preprocess_entities(processed_xml)

  native_doc = begin
    ::REXML::Document.new(processed_xml)
  rescue ::REXML::ParseException => e
    if options[:strict]
      raise Moxml::ParseError.new(
        e.message,
        line: e.line,
        source: xml.is_a?(String) ? xml[0..100] : nil,
      )
    end
    create_document
  end

  ctx = _context || Context.new(:rexml)
  doc = Wrappers::Document.new(native_doc, ctx)
  Entity::Restorer.new(doc).run if ctx.config.restore_entities
  doc
end

.parse_fragment(xml, _context = nil) ⇒ Object



262
263
264
265
# File 'lib/moxml/adapter/rexml.rb', line 262

def parse_fragment(xml, _context = nil)
  doc = parse("<m>#{xml}</m>").native
  children(root(doc))
end

.prepare_xpath_namespaces(node) ⇒ Object

not used at the moment but may be useful when the xpath is upgraded to work with namespaces



585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
# File 'lib/moxml/adapter/rexml.rb', line 585

def prepare_xpath_namespaces(node)
  ns = {}

  # Get all namespace definitions in scope
  all_ns = namespace_definitions(node)

  # Convert to XPath-friendly format
  all_ns.each do |prefix, uri|
    if prefix.to_s.empty?
      ns["xmlns"] = uri
    else
      ns[prefix] = uri
    end
  end

  ns
end

.previous_sibling(node) ⇒ Object



236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
# File 'lib/moxml/adapter/rexml.rb', line 236

def previous_sibling(node)
  current = node.previous_sibling

  seen = {}
  while current
    if current.is_a?(::REXML::Text) && current.to_s.strip.empty?
      current = current.previous_sibling
      next
    end

    if seen[current.object_id]
      current = current.previous_sibling
      next
    end

    seen[current.object_id] = true
    break
  end

  current
end

.processing_instruction_content(node) ⇒ Object



434
435
436
# File 'lib/moxml/adapter/rexml.rb', line 434

def processing_instruction_content(node)
  node.content
end

.processing_instruction_target(node) ⇒ Object



430
431
432
# File 'lib/moxml/adapter/rexml.rb', line 430

def processing_instruction_target(node)
  node.target
end

.remove(node) ⇒ Object



373
374
375
376
377
378
379
380
381
# File 'lib/moxml/adapter/rexml.rb', line 373

def remove(node)
  # Special handling for declarations on REXML documents
  if node.is_a?(::REXML::XMLDecl) && node.parent.is_a?(::REXML::Document)
    # Clear declaration state in attachment map
    attachments.set(node.parent, :xml_declaration, nil)
  end

  node.remove
end

.remove_attribute(element, name) ⇒ Object



324
325
326
# File 'lib/moxml/adapter/rexml.rb', line 324

def remove_attribute(element, name)
  element.delete_attribute(name.to_s)
end

.remove_attribute_native(attribute) ⇒ Object



311
312
313
314
# File 'lib/moxml/adapter/rexml.rb', line 311

def remove_attribute_native(attribute)
  attribute.element.attributes.delete(attribute.expanded_name)
  attribute
end

.remove_declaration(native_doc) ⇒ Object



685
686
687
# File 'lib/moxml/adapter/rexml.rb', line 685

def remove_declaration(native_doc)
  attachments.set(native_doc, :xml_declaration, nil)
end

.replace(node, new_node) ⇒ Object



383
384
385
# File 'lib/moxml/adapter/rexml.rb', line 383

def replace(node, new_node)
  node.replace_with(new_node)
end

.replace_children(element, children) ⇒ Object



387
388
389
390
# File 'lib/moxml/adapter/rexml.rb', line 387

def replace_children(element, children)
  element.children.each(&:remove)
  children.each { |child| element.add(child) }
end

.root(document) ⇒ Object



267
268
269
# File 'lib/moxml/adapter/rexml.rb', line 267

def root(document)
  document.root
end

.sax_parse(xml, handler) ⇒ void

This method returns an undefined value.

SAX parsing implementation for REXML

Parameters:



73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
# File 'lib/moxml/adapter/rexml.rb', line 73

def sax_parse(xml, handler)
  require "rexml/parsers/streamparser"
  require "rexml/source"

  bridge = REXMLStreamBridge.new(handler)

  xml_string = xml.is_a?(IO) || xml.is_a?(StringIO) ? xml.read : xml.to_s

  # StreamParser (rather than SAX2Parser) is used because
  # SAX2Parser normalizes plain "&#NN;" and "&amp;#NN;" attribute
  # literals to the same raw string, making spec-correct decoding
  # impossible after the fact. StreamParser delivers values in
  # the same decoded form as REXML's DOM.
  handler.on_start_document
  ::REXML::Parsers::StreamParser.new(xml_string, bridge).parse
  handler.on_end_document
rescue ::REXML::ParseException => e
  error = Moxml::ParseError.new(e.message, line: e.line)
  handler.on_error(error)
end

.serialize(node, options = {}) ⇒ Object



623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
# File 'lib/moxml/adapter/rexml.rb', line 623

def serialize(node, options = {})
  output = StringIO.new("") if RUBY_ENGINE == "opal"
  output ||= +""

  if node.is_a?(::REXML::Document)
    # Check if we should include declaration
    # Priority: explicit option > check if document has xml_decl
    should_include_decl = if options.key?(:no_declaration)
                            !options[:no_declaration]
                          else
                            # Include declaration only if document has xml_decl
                            !node.xml_decl.nil?
                          end

    # Include XML declaration only if should_include_decl and xml_decl exists
    if should_include_decl && node.xml_decl
      decl = node.xml_decl
      decl.encoding = options[:encoding] if options[:encoding]
      output << "<?xml"
      output << %( version="#{decl.version}") if decl.version
      output << %( encoding="#{decl.encoding}") if decl.encoding
      output << %( standalone="#{decl.standalone}") if decl.standalone
      output << "?>"
    end

    # output << "\n"
    node.doctype&.write(output)

    # Write processing instructions
    node.children.each do |child|
      next unless [::REXML::Instruction, ::REXML::CData,
                   ::REXML::Comment, ::REXML::Text].include?(child.class)

      write_with_formatter(child, output, options[:indent] || 2)
      # output << "\n"
    end

    if node.root
      write_with_formatter(node.root, output,
                           options[:indent] || 2)
    end
  else
    write_with_formatter(node, output, options[:indent] || 2)
  end

  result = output.is_a?(StringIO) ? output.string : output
  result.strip
end

.set_attribute(element, name, value) ⇒ Object



291
292
293
294
# File 'lib/moxml/adapter/rexml.rb', line 291

def set_attribute(element, name, value)
  element.attributes[name&.to_s] = value&.to_s
  element.attributes.get_attribute(name&.to_s)
end

.set_attribute_name(attribute, name) ⇒ Object



296
297
298
299
300
301
302
303
304
# File 'lib/moxml/adapter/rexml.rb', line 296

def set_attribute_name(attribute, name)
  old_name = attribute.expanded_name
  attribute.name = name
  # Rexml doesn't change the keys of the attributes hash
  element = attribute.element
  element.attributes.delete(old_name)
  element.attributes << attribute
  attribute
end

.set_attribute_value(attribute, value) ⇒ Object



306
307
308
309
# File 'lib/moxml/adapter/rexml.rb', line 306

def set_attribute_value(attribute, value)
  attribute.normalized = value
  attribute
end

.set_cdata_content(node, content) ⇒ Object



426
427
428
# File 'lib/moxml/adapter/rexml.rb', line 426

def set_cdata_content(node, content)
  node.value = content.to_s
end

.set_comment_content(node, content) ⇒ Object



418
419
420
# File 'lib/moxml/adapter/rexml.rb', line 418

def set_comment_content(node, content)
  node.string = content.to_s
end

.set_declaration_attribute(node, name, value) ⇒ Object



403
404
405
406
407
408
409
410
411
412
# File 'lib/moxml/adapter/rexml.rb', line 403

def set_declaration_attribute(node, name, value)
  case name
  when "version"
    node.version = value
  when "encoding"
    node.encoding = value
  when "standalone"
    node.standalone = value
  end
end

.set_namespace(element, ns) ⇒ Object

add a namespace prefix to the element name AND a namespace definition



501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
# File 'lib/moxml/adapter/rexml.rb', line 501

def set_namespace(element, ns)
  if ns.nil?
    # Nil-clear contract (issue #164): the XML Namespaces 1.0
    # undeclaration, plus an unqualified name.
    element.add_namespace(nil, "") if element.is_a?(::REXML::Element)
    element.name = element.name.to_s.sub(/\A(?:\w+):/, "")
    return element
  end

  prefix = ns.name.to_s.empty? ? "xmlns" : ns.name.to_s
  if element.is_a?(::REXML::Element)
    element.add_namespace(prefix,
                          ns.value)
  end
  # Renames the node in place (works for elements and
  # attributes alike); the caller keeps tracking the same
  # native.
  # Local part only — a qname create_element leaves "p:c"
  # and prefixing it again would double (issue #208).
  local = element.name.to_s.split(":", 2)[-1]
  element.name = "#{prefix}:#{local}"
  element
end

.set_node_name(node, name) ⇒ Object



164
165
166
167
168
169
170
171
# File 'lib/moxml/adapter/rexml.rb', line 164

def set_node_name(node, name)
  case node
  when ::REXML::Element
    node.name = name.to_s
  when ::REXML::Instruction
    node.target = name.to_s
  end
end

.set_processing_instruction_content(node, content) ⇒ Object



438
439
440
# File 'lib/moxml/adapter/rexml.rb', line 438

def set_processing_instruction_content(node, content)
  node.content = content.to_s
end

.set_root(doc, element) ⇒ Object



142
143
144
145
# File 'lib/moxml/adapter/rexml.rb', line 142

def set_root(doc, element)
  doc.delete_element(doc.root) if doc.root
  doc.add_element(element)
end

.set_text_content(node, content) ⇒ Object



482
483
484
485
486
487
488
489
490
491
492
# File 'lib/moxml/adapter/rexml.rb', line 482

def set_text_content(node, content)
  case node
  when ::REXML::Text, ::REXML::CData
    node.value = content.to_s
  when ::REXML::Element
    # Remove existing text nodes to prevent duplicates
    node.texts.each(&:remove)
    # Add new text content
    node.add_text(content.to_s)
  end
end

.text_content(node) ⇒ Object



442
443
444
445
446
447
448
449
450
451
452
# File 'lib/moxml/adapter/rexml.rb', line 442

def text_content(node)
  case node
  when ::REXML::Text, ::REXML::CData
    node.value.to_s
  when ::Moxml::Adapter::CustomizedRexml::EntityReference
    ""
  when ::REXML::Element
    # Extract text recursively from all children to match other adapters
    extract_text_recursively(node)
  end.to_s
end

.xpath(node, expression, namespaces = {}) ⇒ Object



603
604
605
606
607
608
609
610
611
612
613
614
615
616
# File 'lib/moxml/adapter/rexml.rb', line 603

def xpath(node, expression, namespaces = {})
  if namespaces && !namespaces.empty?
    ::REXML::XPath.match(node, expression, namespaces)
  else
    node.get_elements(expression).to_a
  end
rescue ::REXML::ParseException => e
  raise Moxml::XPathError.new(
    e.message,
    expression: expression,
    adapter: "REXML",
    node: node,
  )
end