Class: XML::DOM::DOMBuilder

Inherits:
ParserNS show all
Defined in:
lib/xml/dom2/dombuilder.rb

Overview

Class XML::DOM::DOMBuilder

superclass

XML::Parser

Constant Summary collapse

NSSEP =
'!'

Constants inherited from ParserNS

ParserNS::EVENT_HANDLERS

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from ParserNS

#initialize, #method_missing, #setReturnNSTriplet

Constructor Details

This class inherits a constructor from XML::ParserNS

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class XML::ParserNS

Instance Attribute Details

#createCDATASectionObject

Returns the value of attribute createCDATASection.



34
35
36
# File 'lib/xml/dom2/dombuilder.rb', line 34

def createCDATASection
  @createCDATASection
end

#createEntityReferenceObject

Returns the value of attribute createEntityReference.



35
36
37
# File 'lib/xml/dom2/dombuilder.rb', line 35

def createEntityReference
  @createEntityReference
end

Class Method Details

.new(document = nil, *args) ⇒ Object

new(document = nil, encoding = nil) new(document = nil, parser, context, encoding = nil)



51
52
53
54
55
56
57
58
59
60
61
62
# File 'lib/xml/dom2/dombuilder.rb', line 51

def self.new(document = nil, *args)
  document ||= Document.new
  if args[0].is_a?(self.class)
    ret = super(*args)
    ret.__initialize__(document, true)
  else
    ret = super(args[0], NSSEP)
    ret.__initialize__(document, false)
  end
  ret.setReturnNSTriplet(true)
  ret
end

Instance Method Details

#__initialize__(document, external = false) ⇒ Object



64
65
66
67
68
69
70
71
# File 'lib/xml/dom2/dombuilder.rb', line 64

def __initialize__(document, external = false)
  @tree = nil
  @entityResolver = DOMEntityResolverImpl.new
  @createCDATASection = false
  @createEntityReference = false
  @document = document
  @external = external
end

#character(data) ⇒ Object



177
178
179
180
181
182
183
184
# File 'lib/xml/dom2/dombuilder.rb', line 177

def character(data)
##        if @cdata_f
    @cdata_buf << data
##        else
##          cdata = @document.createTextNode(data)
##          @current.appendChild(cdata)
##        end
end

#comment(data) ⇒ Object



236
237
238
239
240
# File 'lib/xml/dom2/dombuilder.rb', line 236

def comment(data)
  text
  comment = @document.createComment(data)
  @current.appendChild(comment)
end

#endCdataObject



228
229
230
231
232
233
234
# File 'lib/xml/dom2/dombuilder.rb', line 228

def endCdata
  return unless @createCDATASection
  cdata = @document.createCDATASection(@cdata_buf)
  @current.appendChild(cdata)
  @cdata_buf = ''
  @cdata_f = false
end

#endElement(name) ⇒ Object



172
173
174
175
# File 'lib/xml/dom2/dombuilder.rb', line 172

def endElement(name)
  text
  @current = @current.parentNode
end

#entityResolverObject

DOM3?


268
# File 'lib/xml/dom2/dombuilder.rb', line 268

def entityResolver; @entityResolver; end

#entityResolver=(resolver) ⇒ Object

Raises:

  • (ArgumentError)


269
270
271
272
273
# File 'lib/xml/dom2/dombuilder.rb', line 269

def entityResolver=(resolver)
  raise ArgumentError, 'invalid value for DOMEntityResolver' unless
    resolver.is_a?(DOMEntityResolver)
  @entityResolver = resolver
end

#externalEntityRef(context, base, systemId, publicId) ⇒ Object



192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
# File 'lib/xml/dom2/dombuilder.rb', line 192

def externalEntityRef(context, base, systemId, publicId)
  text
  tree = nil
  if @parse_ext
    extp = self.class.new(@document, self, context)
    extp.setBase(base) if base
    file = systemId
    if systemId !~ /^\/|^\.|^http:|^ftp:/ && !base.nil? # /
      file = base + systemId
    end
    begin
      xml = @entityResolver.resolveEntity(nil, file).byteStream.read
      tree = extp.parse(xml, @parse_ext)
    rescue XML::Parser::Error
      raise XML::Parser::Error.new("#{systemId}(#{extp.line}): #{$!}")
    rescue Errno::ENOENT
      raise
    end
    extp.done
  end
  if @createEntityReference
    entref = @document.createEntityReference(context)
    @current.appendChild(entref)
    entref.appendChild(tree) if tree
  else
    @current.appendChild(tree) if tree
  end
end

#parse(xml, parse_ext = false) ⇒ Object

Parse

doctree = parser.parse(xml, parse_ext)
  xml:       string or stream of XML contents
  parse_ext: flag whether parse external entities or not


90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
# File 'lib/xml/dom2/dombuilder.rb', line 90

def parse(xml, parse_ext = false)
  if @external
    @tree = @document.createDocumentFragment
  else
    @tree = @document
  end
  @parse_ext = parse_ext
  @current = @tree
  @inDocDecl = 0
  @decl = ""
  @inDecl = 0
  @idRest = 0
  @extID = nil
  @cdata_f = false
  @cdata_buf = ''
  @nsdecl = []
  super(xml)
  @tree
end

#parseURI(uri) ⇒ Object



110
111
112
113
114
115
# File 'lib/xml/dom2/dombuilder.rb', line 110

def parseURI(uri)
  uri =~ /^((\w+):\/\/.+\/).*$/ ## /
  setBase($1) if $1
  xml = @entityResolver.resolveEntity(nil, uri).byteStream.read
  parse(xml, true)
end

#processingInstruction(name, data) ⇒ Object



186
187
188
189
190
# File 'lib/xml/dom2/dombuilder.rb', line 186

def processingInstruction(name, data)
  text
  pi = @document.createProcessingInstruction(name, data)
  @current.appendChild(pi)
end

#startCdataObject



221
222
223
224
225
226
# File 'lib/xml/dom2/dombuilder.rb', line 221

def startCdata
  return unless @createCDATASection
  text
  @cdata_f = true
##        @cdata_buf = ''
end

#startDoctypeDecl(name, pubid, sysid, internal_subset) ⇒ Object



242
243
244
245
246
# File 'lib/xml/dom2/dombuilder.rb', line 242

def startDoctypeDecl(name, pubid, sysid, internal_subset)
  doctype = @document.implementation.createDocumentType(name,
                                                        pubid, sysid)
  @current.appendChild(doctype)
end

#startElement(name, data) ⇒ Object



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
# File 'lib/xml/dom2/dombuilder.rb', line 124

def startElement(name, data)
  text
  if !name.index(NSSEP)
    qname = name
    uri = nil
  else
    uri, localname, prefix = name.split(NSSEP)
    if prefix.nil?
      qname = localname
    else
      qname = prefix + ':' + localname
    end
  end
  elem = @document.createElementNS(uri, qname)

  @nsdecl.each do |nsdecl|
    elem.setAttributeNode(nsdecl)
  end
  @nsdecl = []

  attr = {}
  specified = getSpecifiedAttributes
  ## not implemented
  ## elem.idAttribute = getIdAttribute

  data.each do |key, value|
    if !key.index(NSSEP)
      qname = key
      uri = nil
    else
      uri, localname, prefix = key.split(NSSEP)
      if prefix.nil?
        qname = localname
      else
        qname = prefix + ':' + localname
      end
    end
    attr = @document.createAttributeNS(uri, qname)
    attr.appendChild(@document.createTextNode(value))
##          attr.specified = specified[key]
    attr.specified = specified.include?(key)
    elem.setAttributeNode(attr)
  end

  @current.appendChild(elem)
  @current = elem
end

#startNamespaceDecl(prefix, uri) ⇒ Object



248
249
250
251
252
253
254
255
256
257
# File 'lib/xml/dom2/dombuilder.rb', line 248

def startNamespaceDecl(prefix, uri)
  qname = 'xmlns'
  if prefix
    qname << ':' + prefix
  end
  attr = @document.createAttributeNS(nil, qname)
  attr.appendChild(@document.createTextNode(uri))
  attr.specified = true
  @nsdecl << attr
end

#textObject



117
118
119
120
121
122
# File 'lib/xml/dom2/dombuilder.rb', line 117

def text
  return if @cdata_buf == ''
  textnode = @document.createTextNode(@cdata_buf)
  @current.appendChild(textnode)
  @cdata_buf = ''
end