Class: REXML::Parsers::SAX2Parser

Inherits:
Object
  • Object
show all
Defined in:
lib/rexml/parsers/sax2parser.rb

Overview

SAX2Parser

Instance Method Summary collapse

Constructor Details

#initialize(source) ⇒ SAX2Parser

Returns a new instance of SAX2Parser.



10
11
12
13
14
15
16
17
18
 
# File 'lib/rexml/parsers/sax2parser.rb', line 10

def initialize source
  @parser = BaseParser.new(source)
  @listeners = []
  @procs = []
  @namespace_stack = []
  @has_listeners = false
  @tag_stack = []
     @entities = {}
end

Instance Method Details

#add_listener(listener) ⇒ Object 



24
25
26
 
# File 'lib/rexml/parsers/sax2parser.rb', line 24

def add_listener( listener )
  @parser.add_listener( listener )
end

#deafen(listener = nil, &blok) ⇒ Object 



76
77
78
79
80
81
82
83
 
# File 'lib/rexml/parsers/sax2parser.rb', line 76

def deafen( listener=nil, &blok )
  if listener
    @listeners.delete_if {|item| item[-1] == listener }
    @has_listeners = false if @listeners.size == 0
  else
    @procs.delete_if {|item| item[-1] == blok }
  end
end

#listen(*args, &blok) ⇒ Object

Array contains regular expressions or strings which will be matched against fully qualified element names.

Listener must implement the methods in SAX2Listener

Block will be passed the same arguments as a SAX2Listener method would be, where the method name is the same as the matched Symbol. See the SAX2Listener for more information.



58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/rexml/parsers/sax2parser.rb', line 58

def listen( *args, &blok )
  if args[0].kind_of? Symbol
    if args.size == 2
      args[1].each { |match| @procs << [args[0], match, blok] }
    else
      add( [args[0], nil, blok] )
    end
  elsif args[0].kind_of? Array
    if args.size == 2
      args[0].each { |match| add( [nil, match, args[1]] ) }
    else
      args[0].each { |match| add( [ :start_element, match, blok ] ) }
    end
  else
    add([nil, nil, args[0]])
  end
end

#parse ⇒ Object 



85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
 
# File 'lib/rexml/parsers/sax2parser.rb', line 85

def parse
  @procs.each { |sym,match,block| block.call if sym == :start_document }
  @listeners.each { |sym,match,block| 
    block.start_document if sym == :start_document or sym.nil?
  }
  root = context = []
  while true
    event = @parser.pull
    case event[0]
    when :end_document
      handle( :end_document )
      break
       when :start_doctype
         handle( :doctype, *event[1..-1])
    when :end_doctype
      context = context[1]
    when :start_element
      @tag_stack.push(event[1])
      # find the observers for namespaces
      procs = get_procs( :start_prefix_mapping, event[1] )
      listeners = get_listeners( :start_prefix_mapping, event[1] )
      if procs or listeners
        # break out the namespace declarations
        # The attributes live in event[2]
        event[2].each {|n, v| event[2][n] = @parser.normalize(v)}
        nsdecl = event[2].find_all { |n, value| n =~ /^xmlns(:|$)/ }
        nsdecl.collect! { |n, value| [ n[6..-1], value ] }
        @namespace_stack.push({})
        nsdecl.each do |n,v|
          @namespace_stack[-1][n] = v
          # notify observers of namespaces
          procs.each { |ob| ob.call( n, v ) } if procs
          listeners.each { |ob| ob.start_prefix_mapping(n, v) } if listeners
        end
      end
      event[1] =~ Namespace::NAMESPLIT
      prefix = $1
      local = $2
      uri = get_namespace(prefix)
      # find the observers for start_element
      procs = get_procs( :start_element, event[1] )
      listeners = get_listeners( :start_element, event[1] )
      # notify observers
      procs.each { |ob| ob.call( uri, local, event[1], event[2] ) } if procs
      listeners.each { |ob| 
        ob.start_element( uri, local, event[1], event[2] ) 
      } if listeners
    when :end_element
      @tag_stack.pop
      event[1] =~ Namespace::NAMESPLIT
      prefix = $1
      local = $2
      uri = get_namespace(prefix)
      # find the observers for start_element
      procs = get_procs( :end_element, event[1] )
      listeners = get_listeners( :end_element, event[1] )
      # notify observers
      procs.each { |ob| ob.call( uri, local, event[1] ) } if procs
      listeners.each { |ob| 
        ob.end_element( uri, local, event[1] ) 
      } if listeners

      namespace_mapping = @namespace_stack.pop
      # find the observers for namespaces
      procs = get_procs( :end_prefix_mapping, event[1] )
      listeners = get_listeners( :end_prefix_mapping, event[1] )
      if procs or listeners
        namespace_mapping.each do |prefix, uri|
          # notify observers of namespaces
          procs.each { |ob| ob.call( prefix ) } if procs
          listeners.each { |ob| ob.end_prefix_mapping(prefix) } if listeners
        end
      end
    when :text
         #normalized = @parser.normalize( event[1] )
         #handle( :characters, normalized )
         copy = event[1].clone
         @entities.each { |key, value| copy = copy.gsub("&#{key};", value) }
         copy.gsub!( Text::NUMERICENTITY ) {|m|
           m=$1
           m = "0#{m}" if m[0] == ?x
           [Integer(m)].pack('U*')
         }
         handle( :characters, copy )
       when :entitydecl
         @entities[ event[1] ] = event[2] if event.size == 3
      handle( *event )
    when :processing_instruction, :comment, :attlistdecl, 
      :elementdecl, :cdata, :notationdecl, :xmldecl
      handle( *event )
    end
       handle( :progress, @parser.position )
  end
end

#source ⇒ Object 



20
21
22
 
# File 'lib/rexml/parsers/sax2parser.rb', line 20

def source
  @parser.source
end