Class: RightAws::RightAWSParser

Inherits:

Object

• Object
• RightAws::RightAWSParser

show all

Defined in:

lib/awsbase/right_awsbase.rb

Overview

Constant Summary

DEFAULT_XML_LIBRARY =

default parsing library

'rexml'

@@supported_xml_libs =

a list of supported parsers

[DEFAULT_XML_LIBRARY, 'libxml']

@@xml_lib =

xml library name: 'rexml' | 'libxml'

DEFAULT_XML_LIBRARY

Instance Attribute Summary (collapse)

• - (Object) full_tag_name readonly

  Returns the value of attribute full_tag_name.

• - (Object) result

  Returns the value of attribute result.

• - (Object) tag readonly

  Returns the value of attribute tag.

• - (Object) xml_lib

  Returns the value of attribute xml_lib.

• - (Object) xmlpath readonly

  Returns the value of attribute xmlpath.

Class Method Summary (collapse)

• + (Object) xml_lib
• + (Object) xml_lib=(new_lib_name)

Instance Method Summary (collapse)

• - (RightAWSParser) initialize(params = {}) constructor

  A new instance of RightAWSParser.

• - (Object) method_missing(method, *params)

  Parser must have a lots of methods (see /usr/lib/ruby/1.8/rexml/parsers/streamparser.rb) We dont need most of them in RightAWSParser and method_missing helps us to skip their definition.

• - (Object) parse(xml_text, params = {})

  Parser method.

• - (Object) reset

  the functions to be overriden by children (if nessesery).

• - (Object) tag_end(name)
• - (Object) tag_start(name, attributes)
• - (Object) tagend(name)
• - (Object) tagstart(name, attributes)
• - (Object) tagtext(text)
• - (Object) text(text)

827
828
829
830
831
832
833
834
835
836

# File 'lib/awsbase/right_awsbase.rb', line 827

def initialize(params={})
  @xmlpath = ''
  @full_tag_name = ''
  @result  = false
  @text    = ''
  @tag     = ''
  @xml_lib = params[:xml_lib] || @@xml_lib
  @logger  = params[:logger]
  reset
end

908
909
910
911
912
913
914
915

# File 'lib/awsbase/right_awsbase.rb', line 908

def method_missing(method, *params)
    # if the method is one of known - just skip it ...
  return if [:comment, :attlistdecl, :notationdecl, :elementdecl, 
             :entitydecl, :cdata, :xmldecl, :attlistdecl, :instruction, 
             :doctype].include?(method)
    # ... else - call super to raise an exception
  super(method, params)
end

824
825
826

# File 'lib/awsbase/right_awsbase.rb', line 824

def full_tag_name
  @full_tag_name
end

821
822
823

# File 'lib/awsbase/right_awsbase.rb', line 821

def result
  @result
end

825
826
827

# File 'lib/awsbase/right_awsbase.rb', line 825

def tag
  @tag
end

823
824
825

# File 'lib/awsbase/right_awsbase.rb', line 823

def xml_lib
  @xml_lib
end

822
823
824

# File 'lib/awsbase/right_awsbase.rb', line 822

def xmlpath
  @xmlpath
end

814
815
816

# File 'lib/awsbase/right_awsbase.rb', line 814

def self.xml_lib
  @@xml_lib
end

817
818
819

# File 'lib/awsbase/right_awsbase.rb', line 817

def self.xml_lib=(new_lib_name)
  @@xml_lib = new_lib_name
end

xml_text         - xml message text(String) or Net:HTTPxxx instance (response)
params[:xml_lib] - library name: 'rexml' | 'libxml'

857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903

# File 'lib/awsbase/right_awsbase.rb', line 857

def parse(xml_text, params={})
    # Get response body
  xml_text = xml_text.body unless xml_text.is_a?(String)
  @xml_lib = params[:xml_lib] || @xml_lib
    # check that we had no problems with this library otherwise use default 
  @xml_lib = DEFAULT_XML_LIBRARY unless @@supported_xml_libs.include?(@xml_lib)       
    # load xml library
  if @xml_lib=='libxml' && !defined?(XML::SaxParser)
    begin
      require 'xml/libxml'
      # is it new ? - Setup SaxParserCallback 
      if XML::Parser::VERSION >= '0.5.1.0'
        RightSaxParserCallback.include_callback 
      end           
    rescue LoadError => e
      @@supported_xml_libs.delete(@xml_lib) 
      @xml_lib = DEFAULT_XML_LIBRARY           
      if @logger
        @logger.error e.inspect
        @logger.error e.backtrace
        @logger.info "Can not load 'libxml' library. '#{DEFAULT_XML_LIBRARY}' is used for parsing." 
      end
    end
  end
    # Parse the xml text
  case @xml_lib
  when 'libxml'  
    if XML::Parser::VERSION >= '0.9.9'
      # avoid warning on every usage
      xml        = XML::SaxParser.string(xml_text)
    else
      xml        = XML::SaxParser.new 
      xml.string = xml_text 
    end
    # check libxml-ruby version 
    if XML::Parser::VERSION >= '0.5.1.0'
      xml.callbacks = RightSaxParserCallback.new(self) 
    else 
      xml.on_start_element{|name, attr_hash| self.tag_start(name, attr_hash)} 
      xml.on_characters{   |text|            self.text(text)}
      xml.on_end_element{  |name|            self.tag_end(name)} 
    end 
    xml.parse
  else
    REXML::Document.parse_stream(xml_text, self)
  end
end

917

# File 'lib/awsbase/right_awsbase.rb', line 917

def reset                     ; end

844
845
846
847
848

# File 'lib/awsbase/right_awsbase.rb', line 844

def tag_end(name)
  @xmlpath = @full_tag_name[/^(.*?)\/?#{name}$/] && $1
  tagend(name)
  @full_tag_name = @xmlpath
end

837
838
839
840
841
842
843

# File 'lib/awsbase/right_awsbase.rb', line 837

def tag_start(name, attributes)
  @text = ''
  @tag  = name
  @full_tag_name += @full_tag_name.empty? ? name : "/#{name}"
  tagstart(name, attributes)
  @xmlpath = @full_tag_name
end

919

# File 'lib/awsbase/right_awsbase.rb', line 919

def tagend(name)              ; end

918

# File 'lib/awsbase/right_awsbase.rb', line 918

def tagstart(name, attributes); end

920

# File 'lib/awsbase/right_awsbase.rb', line 920

def tagtext(text)             ; end

849
850
851
852

# File 'lib/awsbase/right_awsbase.rb', line 849

def text(text)
  @text += text
  tagtext(text)
end