Class: Moxml::SAX::ElementHandler

Inherits:
Handler
  • Object
show all
Defined in:
lib/moxml/sax/element_handler.rb

Overview

Element-focused SAX handler with stack tracking

Extends the base Handler with utilities for tracking element context:

  • Element stack (current hierarchy)

  • Current path (array of element names from root)

  • Helper methods for checking context

Examples:

Using element context

class MyHandler < Moxml::SAX::ElementHandler
  def on_start_element(name, attributes = {}, namespaces = {})
    super # Important: call super to update stack

    if path_matches?(%r{/library/book/title$})
      puts "Found title at: #{current_path.join('/')}"
    end
  end
end

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Handler

#on_cdata, #on_characters, #on_comment, #on_end_document, #on_error, #on_processing_instruction, #on_start_document, #on_warning

Constructor Details

#initialize ⇒ ElementHandler

Returns a new instance of ElementHandler.



30
31
32
33
34
 
# File 'lib/moxml/sax/element_handler.rb', line 30

def initialize
  super
  @element_stack = []
  @current_path = []
end

Instance Attribute Details

#current_path ⇒ Array<String> (readonly)

Returns Current path from root to current element.

Returns:

  • (Array<String>) —

    Current path from root to current element



28
29
30
 
# File 'lib/moxml/sax/element_handler.rb', line 28

def current_path
  @current_path
end

#element_stack ⇒ Array<String> (readonly)

Returns Stack of currently open elements.

Returns:

  • (Array<String>) —

    Stack of currently open elements



25
26
27
 
# File 'lib/moxml/sax/element_handler.rb', line 25

def element_stack
  @element_stack
end

Instance Method Details

#current_element ⇒ String?

Get the name of the current (innermost) element

Examples:

current_element # => "title"

Returns:

  • (String, nil) —

    Current element name, or nil if at document level



73
74
75
 
# File 'lib/moxml/sax/element_handler.rb', line 73

def current_element
  @element_stack.last
end

#depth ⇒ Integer

Get current depth in the document tree

Examples:

depth # => 3 (e.g., /library/book/title)

Returns:

  • (Integer) —

    Current nesting level (0 at document root)



91
92
93
 
# File 'lib/moxml/sax/element_handler.rb', line 91

def depth
  @element_stack.length
end

#in_element?(name) ⇒ Boolean

Check if currently inside an element with the given name

Examples:

in_element?("book") # true if inside any <book> element

Parameters:

  • name (String) —

    Element name to check

Returns:

  • (Boolean) —

    true if inside the element



64
65
66
 
# File 'lib/moxml/sax/element_handler.rb', line 64

def in_element?(name)
  @element_stack.include?(name)
end

#on_end_element(name) ⇒ void

This method returns an undefined value.

Removes element from stack before calling super

Parameters:

  • name (String) —

    Element name



52
53
54
55
56
 
# File 'lib/moxml/sax/element_handler.rb', line 52

def on_end_element(name)
  @element_stack.pop
  @current_path.pop
  super
end

#on_start_element(name, attributes = {}, namespaces = {}) ⇒ void

This method returns an undefined value.

Tracks element on stack before calling super

Parameters:

  • name (String) —

    Element name

  • attributes (Hash) (defaults to: {}) —

    Element attributes

  • namespaces (Hash) (defaults to: {}) —

    Namespace declarations



42
43
44
45
46
 
# File 'lib/moxml/sax/element_handler.rb', line 42

def on_start_element(name, attributes = {}, namespaces = {})
  @element_stack.push(name)
  @current_path.push(name)
  super
end

#parent_element ⇒ String?

Get the name of the parent element

Examples:

parent_element # => "book"

Returns:

  • (String, nil) —

    Parent element name, or nil if no parent



82
83
84
 
# File 'lib/moxml/sax/element_handler.rb', line 82

def parent_element
  @element_stack[-2]
end

#path_matches?(pattern) ⇒ Boolean

Check if current path matches a pattern

Examples:

path_matches?(/book\/title$/) # true if at /*/book/title
path_matches?("/library/book/title") # exact path match

Parameters:

  • pattern (String, Regexp) —

    Pattern to match against path

Returns:

  • (Boolean) —

    true if path matches



102
103
104
105
106
107
108
109
 
# File 'lib/moxml/sax/element_handler.rb', line 102

def path_matches?(pattern)
  path_str = "/#{@current_path.join('/')}"
  if pattern.is_a?(Regexp)
    !path_str.match?(pattern).nil?
  else
    path_str == pattern.to_s
  end
end

#path_string(separator = "/") ⇒ String

Get the full path as a string

Examples:

path_string # => "/library/book/title"

Parameters:

  • separator (String) (defaults to: "/") —

    Path separator (default: “/”)

Returns:

  • (String) —

    Full path string



117
118
119
 
# File 'lib/moxml/sax/element_handler.rb', line 117

def path_string(separator = "/")
  separator + @current_path.join(separator)
end