Class: Lutaml::Xml::ParseSession

Inherits:
Object
  • Object
show all
Defined in:
lib/lutaml/xml/parse_session.rb

Overview

Per-parse context threaded through ModelTransform's mapping passes.

Bundles everything one data_to_model call needs — the parsed doc, the instance under construction, the effective register, and the flags derived from them — so apply_xml_mapping and value_for_rule take one object instead of a growing positional parameter list. Memoizes the per-parse lookups (mapping, namespace class, adopted document namespace) that every rule would otherwise recompute.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(doc, instance, options, register) ⇒ ParseSession

Returns a new instance of ParseSession.



16
17
18
19
20
21
 
# File 'lib/lutaml/xml/parse_session.rb', line 16

def initialize(doc, instance, options, register)
  @doc = doc
  @instance = instance
  @options = options
  @register = register
end

Instance Attribute Details

#doc ⇒ Object (readonly)

Returns the value of attribute doc.



14
15
16
 
# File 'lib/lutaml/xml/parse_session.rb', line 14

def doc
  @doc
end

#instance ⇒ Object (readonly)

Returns the value of attribute instance.



14
15
16
 
# File 'lib/lutaml/xml/parse_session.rb', line 14

def instance
  @instance
end

#options ⇒ Object (readonly)

Returns the value of attribute options.



14
15
16
 
# File 'lib/lutaml/xml/parse_session.rb', line 14

def options
  @options
end

#register ⇒ Object (readonly)

Returns the value of attribute register.



14
15
16
 
# File 'lib/lutaml/xml/parse_session.rb', line 14

def register
  @register
end

Instance Method Details

#adopted_namespace_uri ⇒ Object

The document's own namespace when it differs from the model's bound namespace (lenient, out-of-namespace documents). Adopted as an implicit alias for element matching (lutaml-model#754).



70
71
72
73
 
# File 'lib/lutaml/xml/parse_session.rb', line 70

def adopted_namespace_uri
  @adopted_namespace_uri ||=
    instance_is_serialize ? instance.original_namespace_uri : nil
end

#element_local_attribute_index(element) ⇒ Object

Local-name -> [attributes] index over one element's attributes, built on first lenient lookup (TODO.max-perf/08) and memoized per element for the life of the session. The URI-form attribute conversion and the lenient fallback used to rescan every attribute per rule per element (the ISO-13849 pathology); elements are parse-frozen, so each index builds at most once.



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'lib/lutaml/xml/parse_session.rb', line 42

def element_local_attribute_index(element)
  @element_local_attribute_index ||= {}.compare_by_identity
  @element_local_attribute_index[element] ||= begin
    # Plain hash: a miss must stay a nil lookup, not allocate an
    # empty default array — misses dominate (the ISO-13849 shape
    # resolves ~390k lenient lookups that match nothing).
    index = {}
    element.attributes.each_value do |attr|
      local_names(attr).each do |key|
        entries = (index[key] ||= [])
        entries << attr unless entries.include?(attr)
      end
    end
    index
  end
end

#instance_is_serialize ⇒ Object 



23
24
25
 
# File 'lib/lutaml/xml/parse_session.rb', line 23

def instance_is_serialize
  @instance_is_serialize ||= instance.is_a?(::Lutaml::Model::Serialize)
end

#model_class ⇒ Object 



59
60
61
 
# File 'lib/lutaml/xml/parse_session.rb', line 59

def model_class
  @model_class ||= instance.class
end

#model_namespace_uris ⇒ Object

Namespace URIs accepted for children of this model: the model's namespace URIs plus the adopted document namespace when present.



77
78
79
80
81
82
83
84
85
86
87
88
 
# File 'lib/lutaml/xml/parse_session.rb', line 77

def model_namespace_uris
  @model_namespace_uris ||=
    begin
      ns_class = instance_is_serialize ? xml_mapping&.namespace_class : nil
      uris = ns_class&.all_uris
      adopted = adopted_namespace_uri
      if ns_class && adopted && !uris&.include?(adopted)
        uris = (uris || []) + [adopted]
      end
      uris
    end
end

#rule_name_resolution ⇒ Object

(element, rule name) -> resolved attribute name / matched attribute VALUE for the lenient lookup paths. Both are pure functions of the element and the name; ISO-13849-shaped documents repeat the same resolutions per rule application, so the computed answer is memoized per element for the parse.



32
33
34
 
# File 'lib/lutaml/xml/parse_session.rb', line 32

def rule_name_resolution
  @rule_name_resolution ||= {}
end

#xml_mapping ⇒ Object 



63
64
65
 
# File 'lib/lutaml/xml/parse_session.rb', line 63

def xml_mapping
  @xml_mapping ||= model_class.mappings_for(:xml, register)
end