Parent

Nori::XMLUtilityNode

This is a slighly modified version of the XMLUtilityNode from merb.devjavu.com/projects/merb/ticket/95 (has.sox@gmail.com)

John Nunemaker: It’s mainly just adding vowels, as I ht cd wth n vwls :) This represents the hard part of the work, all I did was change the underlying parser.

Constants

XS_DATE

Simple xs:date Regexp.

XS_DATE_TIME

Simple xs:dateTime Regexp.

XS_TIME

Simple xs:time Regexp.

Attributes

attributes[RW]
children[RW]
name[RW]
type[RW]

Public Class Methods

available_typecasts() click to toggle source
# File lib/nori/xml_utility_node.rb, line 38
def self.available_typecasts
  @@available_typecasts
end
available_typecasts=(obj) click to toggle source
# File lib/nori/xml_utility_node.rb, line 42
def self.available_typecasts=(obj)
  @@available_typecasts = obj
end
new(name, normalized_attributes = {}) click to toggle source
# File lib/nori/xml_utility_node.rb, line 60
def initialize(name, normalized_attributes = {})
  # unnormalize attribute values
  attributes = Hash[* normalized_attributes.map do |key, value|
    [ key, unnormalize_xml_entities(value) ]
  end.flatten]

  @name = name.tr("-", "_")
  @name = @name.split(":").last if Nori.strip_namespaces?
  @name = Nori.convert_tag(@name) if Nori.convert_tags?

  # leave the type alone if we don't know what it is
  @type = self.class.available_typecasts.include?(attributes["type"]) ? attributes.delete("type") : attributes["type"]

  @nil_element = false
  attributes.keys.each do |key|
    if result = /^((.*):)?nil$/.match(key)
      @nil_element = attributes.delete(key) == "true"
      attributes.delete("xmlns:#{result[2]}") if result[1]
    end
  end
  @attributes = undasherize_keys(attributes)
  @children = []
  @text = false
end
typecasts() click to toggle source
# File lib/nori/xml_utility_node.rb, line 30
def self.typecasts
  @@typecasts
end
typecasts=(obj) click to toggle source
# File lib/nori/xml_utility_node.rb, line 34
def self.typecasts=(obj)
  @@typecasts = obj
end

Public Instance Methods

add_node(node) click to toggle source
# File lib/nori/xml_utility_node.rb, line 98
def add_node(node)
  @text = true if node.is_a? String
  @children << node
end
advanced_typecasting(value) click to toggle source
# File lib/nori/xml_utility_node.rb, line 187
def advanced_typecasting(value)
  split = value.split
  return value if split.size > 1

  case split.first
    when "true"       then true
    when "false"      then false
    when XS_DATE_TIME then DateTime.parse(value)
    when XS_DATE      then Date.parse(value)
    when XS_TIME      then Time.parse(value)
    else                   value
  end
end
inner_html() click to toggle source

Get the inner_html of the REXML node.

# File lib/nori/xml_utility_node.rb, line 210
def inner_html
  @children.join
end
prefixed_attribute_name(attribute) click to toggle source
# File lib/nori/xml_utility_node.rb, line 94
def prefixed_attribute_name(attribute)
  Nori.convert_tags? ? Nori.convert_tag(attribute) : attribute
end
prefixed_attributes() click to toggle source
# File lib/nori/xml_utility_node.rb, line 87
def prefixed_attributes
  attributes.inject({}) do |memo, (key, value)|
    memo[prefixed_attribute_name("@#{key}")] = value
    memo
  end
end
to_hash() click to toggle source
# File lib/nori/xml_utility_node.rb, line 103
def to_hash
  if @type == "file"
    f = StringIOFile.new((@children.first || '').unpack('m').first)
    f.original_filename = attributes['name'] || 'untitled'
    f.content_type = attributes['content_type'] || 'application/octet-stream'
    return { name => f }
  end

  if @text
    t = typecast_value unnormalize_xml_entities(inner_html)
    t = advanced_typecasting(t) if t.is_a?(String) && Nori.advanced_typecasting?

    if t.is_a?(String)
      t = StringWithAttributes.new(t)
      t.attributes = attributes
    end

    return { name => t }
  else
    #change repeating groups into an array
    groups = @children.inject({}) { |s,e| (s[e.name] ||= []) << e; s }

    out = nil
    if @type == "array"
      out = []
      groups.each do |k, v|
        if v.size == 1
          out << v.first.to_hash.entries.first.last
        else
          out << v.map{|e| e.to_hash[k]}
        end
      end
      out = out.flatten

    else # If Hash
      out = {}
      groups.each do |k,v|
        if v.size == 1
          out.merge!(v.first)
        else
          out.merge!( k => v.map{|e| e.to_hash[k]})
        end
      end
      out.merge! prefixed_attributes unless attributes.empty?
      out = out.empty? ? nil : out
    end

    if @type && out.nil?
      { name => typecast_value(out) }
    else
      { name => out }
    end
  end
end
to_html() click to toggle source

Converts the node into a readable HTML node.

@return <String> The HTML node in text form.

# File lib/nori/xml_utility_node.rb, line 217
def to_html
  attributes.merge!(:type => @type ) if @type
  "<#{name}#{attributes.to_xml_attributes}>#{@nil_element ? '' : inner_html}</#{name}>"
end
Also aliased as: to_s
to_s() click to toggle source
Alias for: to_html
typecast_value(value) click to toggle source

Typecasts a value based upon its type. For instance, if node has type == “integer”, {{[node.typecast_value(“12”) #=> 12]}}

@param value<String> The value that is being typecast.

@details [:type options]

"integer"::
  converts +value+ to an integer with #to_i
"boolean"::
  checks whether +value+, after removing spaces, is the literal
  "true"
"datetime"::
  Parses +value+ using Time.parse, and returns a UTC Time
"date"::
  Parses +value+ using Date.parse

@return <Integer, TrueClass, FalseClass, Time, Date, Object>

The result of typecasting +value+.

@note

If +self+ does not have a "type" key, or if it's not one of the
options specified above, the raw +value+ will be returned.
# File lib/nori/xml_utility_node.rb, line 181
def typecast_value(value)
  return value unless @type
  proc = self.class.typecasts[@type]
  proc.nil? ? value : proc.call(value)
end
undasherize_keys(params) click to toggle source

Take keys of the form foo-bar and convert them to foo_bar

# File lib/nori/xml_utility_node.rb, line 202
def undasherize_keys(params)
  params.keys.each do |key, value|
    params[key.tr("-", "_")] = params.delete(key)
  end
  params
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.