Class: Aws::AwsParser

Inherits:
Object show all
Defined in:
lib/awsbase/right_awsbase.rb

Overview

:nodoc:

Direct Known Subclasses

Aws::AcfInterface::AcfBaseDistributionParser, Aws::AcfInterface::AcfDistributionConfigParser, Ec2::QEc2AllocateAddressParser, Ec2::QEc2AttachAndDetachVolumeParser, Ec2::QEc2BundleInstanceParser, Ec2::QEc2ConfirmProductInstanceParser, Ec2::QEc2CreateKeyPairParser, Ec2::QEc2CreateSnapshotParser, Ec2::QEc2CreateVolumeParser, Ec2::QEc2DescribeAddressesParser, Ec2::QEc2DescribeAvailabilityZonesParser, Ec2::QEc2DescribeBundleTasksParser, Ec2::QEc2DescribeImageAttributeParser, Ec2::QEc2DescribeImagesParser, Ec2::QEc2DescribeInstancesParser, Ec2::QEc2DescribeKeyPairParser, Ec2::QEc2DescribeRegionsParser, Ec2::QEc2DescribeSecurityGroupsParser, Ec2::QEc2DescribeSnapshotsParser, Ec2::QEc2DescribeTagsParser, Ec2::QEc2DescribeVolumesParser, Ec2::QEc2GetConsoleOutputParser, Ec2::QEc2MonitorInstancesParser, Ec2::QEc2RegisterImageParser, Ec2::QEc2TerminateInstancesParser, Ec2::RightBoolResponseParser, Elb::QElbCreateParser, Elb::QElbDeleteParser, Elb::QElbDescribeInstancesHealthParser, Elb::QElbDescribeLoadBalancersParser, Elb::QElbRegisterInstancesParser, Mon::QMonGetMetricStatistics, Mon::QMonListMetrics, RightErrorResponseParser, RightHttp2xxParser, S3Interface::S3AclParser, S3Interface::S3BucketLocationParser, S3Interface::S3CopyParser, S3Interface::S3ImprovedListBucketParser, S3Interface::S3ListAllMyBucketsParser, S3Interface::S3ListBucketParser, S3Interface::S3LoggingParser, SdbInterface::QSdbDomainMetadataParser, SdbInterface::QSdbGetAttributesParser, SdbInterface::QSdbListDomainParser, SdbInterface::QSdbQueryParser, SdbInterface::QSdbQueryWithAttributesParser, SdbInterface::QSdbSelectParser, SdbInterface::QSdbSimpleParser, SqsInterface::SqsCreateQueueParser, SqsInterface::SqsGetQueueAttributesParser, SqsInterface::SqsListQueuesParser, SqsInterface::SqsReceiveMessageParser, SqsInterface::SqsSendMessagesParser, SqsInterface::SqsStatusParser

Constant Summary collapse

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

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(params = {}) ⇒ AwsParser

Returns a new instance of AwsParser.



1085
1086
1087
1088
1089
1090
1091
1092
 
# File 'lib/awsbase/right_awsbase.rb', line 1085

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

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method, *params) ⇒ Object

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



1165
1166
1167
1168
1169
1170
1171
1172
 
# File 'lib/awsbase/right_awsbase.rb', line 1165

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

Instance Attribute Details

#result ⇒ Object

Returns the value of attribute result.



1081
1082
1083
 
# File 'lib/awsbase/right_awsbase.rb', line 1081

def result
  @result
end

#xml_lib ⇒ Object

Returns the value of attribute xml_lib.



1083
1084
1085
 
# File 'lib/awsbase/right_awsbase.rb', line 1083

def xml_lib
  @xml_lib
end

#xmlpath ⇒ Object (readonly)

Returns the value of attribute xmlpath.



1082
1083
1084
 
# File 'lib/awsbase/right_awsbase.rb', line 1082

def xmlpath
  @xmlpath
end

Class Method Details

.xml_lib ⇒ Object 



1073
1074
1075
 
# File 'lib/awsbase/right_awsbase.rb', line 1073

def self.xml_lib
    @@xml_lib
end

.xml_lib=(new_lib_name) ⇒ Object 



1077
1078
1079
 
# File 'lib/awsbase/right_awsbase.rb', line 1077

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

Instance Method Details

#parse(xml_text, params = {}) ⇒ Object

Parser method. Params:

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



1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
 
# File 'lib/awsbase/right_awsbase.rb', line 1116

def parse(xml_text, params={})
    # Get response body
    unless xml_text.is_a?(String)
        xml_text = xml_text.body.respond_to?(:force_encoding) ? xml_text.body.force_encoding("UTF-8") : xml_text.body
    end

    @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'
            xml = XML::SaxParser.string(xml_text)
            # 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

#reset ⇒ Object

the functions to be overriden by children (if nessesery)



1175
1176
 
# File 'lib/awsbase/right_awsbase.rb', line 1175

def reset;
end

#tag_end(name) ⇒ Object 



1100
1101
1102
1103
1104
1105
 
# File 'lib/awsbase/right_awsbase.rb', line 1100

def tag_end(name)
    if @xmlpath =~ /^(.*?)\/?#{name}$/
        @xmlpath = $1
    end
    tagend(name)
end

#tag_start(name, attributes) ⇒ Object 



1094
1095
1096
1097
1098
 
# File 'lib/awsbase/right_awsbase.rb', line 1094

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

#tagend(name) ⇒ Object 



1182
1183
1184
 
# File 'lib/awsbase/right_awsbase.rb', line 1182

def tagend(name)
    ;
end

#tagstart(name, attributes) ⇒ Object 



1178
1179
1180
 
# File 'lib/awsbase/right_awsbase.rb', line 1178

def tagstart(name, attributes)
    ;
end

#tagtext(text) ⇒ Object 



1186
1187
1188
 
# File 'lib/awsbase/right_awsbase.rb', line 1186

def tagtext(text)
    ;
end

#text(text) ⇒ Object 



1107
1108
1109
1110
 
# File 'lib/awsbase/right_awsbase.rb', line 1107

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