Class: Soaspec::SoapHandler

Inherits:
ExchangeHandler show all
Extended by:
Forwardable, SoapAccessors, SoapGlobals
Defined in:
lib/soaspec/exchange_handlers/soap_handler.rb

Overview

Wraps around Savon client defining default values dependent on the soap request

Instance Attribute Summary collapse

Attributes inherited from ExchangeHandler

#exception, #request_option, #template_name

Class Method Summary collapse

Instance Method Summary collapse

Methods included from SoapAccessors

root_attributes

Methods included from SoapGlobals

basic_auth, soap_version, wsdl

Methods inherited from ExchangeHandler

#default_hash=, #elements, #set_remove_key, #set_remove_keys, #store, #to_s, use, #use

Methods included from HandlerAccessors

#attribute, #convert_to_lower, #default_hash, #element, #mandatory_elements, #mandatory_json_values, #mandatory_xpath_values, #strip_namespaces, #template_name

Methods included from ExchangeHandlerDefaults

#convert_to_lower?, #expected_mandatory_elements, #expected_mandatory_json_values, #expected_mandatory_xpath_values, #request, #retry_exception_limit, #retry_on_exceptions, #retry_pause_time, #strip_namespaces?

Constructor Details

#initialize(name = self.class.to_s, options = {}) ⇒ SoapHandler

Setup object to handle communicating with a particular SOAP WSDL

Parameters:

  • name (String) (defaults to: self.class.to_s) —

    Name to describe handler. Used in calling ‘to_s’

  • options (Hash) (defaults to: {}) —

    Options defining SOAP request. WSDL, authentication, See savonrb.com/version2/globals.html for list of options



71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 71

def initialize(name = self.class.to_s, options = {})
  if name.is_a?(Hash) && options == {} # If name is not set
    options = name
    name = self.class.to_s
  end
  super
  set_remove_keys(options, %i[operation default_hash template_name])
  merged_options = SoapDefaults.options
  merged_options.merge!(logging_options) if Soaspec::SpecLogger.log_api_traffic?
  merged_options.merge! savon_options
  merged_options.merge! savon_globals
  merged_options.merge!(options)
  Soaspec::SpecLogger.info "Using Savon globals: #{merged_options}"
  self.client = Savon.client(merged_options)
end

Instance Attribute Details

#client ⇒ Object

Savon client used to make SOAP calls



32
33
34
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 32

def client
  @client
end

#operation ⇒ Object

SOAP Operation to use by default



34
35
36
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 34

def operation
  @operation
end

#savon_globals ⇒ Object 



38
39
40
41
42
43
44
45
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 38

def savon_globals
  @savon_globals = {}
  %i[wsdl basic_auth soap_version raise_errors namespace namespaces endpoint
     ssl_verify_mode].each do |global|
    @savon_globals.merge!(global => send(global)) if respond_to? global
  end
  @savon_globals
end

Class Method Details

.method_missing(method_name, *args, &block) ⇒ Object

Implement undefined setter with []= for FactoryBot to use without needing to define params to set

Parameters:

  • method_name (Object) —

    Name of method not defined

  • args (Object) —

    Arguments passed to method

  • block (Object) 


227
228
229
230
231
232
233
234
235
236
237
238
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 227

def method_missing(method_name, *args, &block)
  if operations.include? method_name
    tmp_class = new(method_name)
    tmp_class.operation = method_name
    exchange = Exchange.new(method_name, *args)
    exchange.exchange_handler = tmp_class
    yield exchange if block_given?
    exchange
  else
    super
  end
end

.operations ⇒ Array

Returns List of operations WSDL can perform.

Returns:

  • (Array) —

    List of operations WSDL can perform



218
219
220
221
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 218

def operations
  operation_class = new('Get operations')
  operation_class.operations
end

.respond_to_missing?(method_name, *args) ⇒ Boolean

Override respond_to_missing so that any method name that is an operation can be used

Returns:

  • (Boolean) 


242
243
244
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 242

def respond_to_missing?(method_name, *args)
  operations.include?(method_name) || super
end

Instance Method Details

#convert_to_lower_case(xml_doc) ⇒ Object

Convert all XML nodes to lowercase

Parameters:

  • xml_doc (Nokogiri::XML::Document) —

    Xml document to convert



159
160
161
162
163
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 159

def convert_to_lower_case(xml_doc)
  xml_doc.traverse do |node|
    node.name = node.name.downcase if node.is_a?(Nokogiri::XML::Element)
  end
end

#found?(response) ⇒ Boolean

Returns Whether the request found the desired value or not.

Returns:

  • (Boolean) —

    Whether the request found the desired value or not



133
134
135
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 133

def found?(response)
  status_code_for(response) != 404
end

#include_in_body?(response, expected) ⇒ Boolean

Returns Whether response includes provided string within it.

Returns:

  • (Boolean) —

    Whether response includes provided string within it



145
146
147
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 145

def include_in_body?(response, expected)
  response.to_xml.to_s.include? expected
end

#include_key?(response, expected) ⇒ Boolean

Returns Whether response body contains expected key.

Parameters:

  • expected (Symbol)

Returns:

  • (Boolean) —

    Whether response body contains expected key



151
152
153
154
155
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 151

def include_key?(response, expected)
  body = response.body
  body.extend Hashie::Extensions::DeepFind
  !body.deep_find_all(expected).empty?
end

#include_value?(response, expected_value) ⇒ Boolean

Returns Whether any of the keys of the Body Hash include value.

Returns:

  • (Boolean) —

    Whether any of the keys of the Body Hash include value



206
207
208
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 206

def include_value?(response, expected_value)
  response.body.include_value?(expected_value)
end

#logging_options ⇒ Object

Options to log xml request and response



51
52
53
54
55
56
57
58
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 51

def logging_options
  {
    log: true, # See request and response. (Put this in traffic file)
    log_level: :debug,
    logger: Soaspec::SpecLogger.create,
    pretty_print_xml: true # Prints XML pretty
  }
end

#make_request(request_parameters) ⇒ Object

Used in together with Exchange request that passes such override parameters

Parameters:

  • request_parameters (Hash) —

    Parameters used to overwrite defaults in request



109
110
111
112
113
114
115
116
117
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 109

def make_request(request_parameters)
  # Call the SOAP operation with the request XML provided
  request = request_parameters(request_parameters)
  begin
    client.call request.operation, request.body # request_body_params(request_parameters)
  rescue Savon::HTTPError => e
    e
  end
end

#request_body_params(request_parameters) ⇒ Object

Used in making request via hash or in template via Erb

Parameters:

  • request_parameters (Hash) —

    Hash representing elements to send in request If the :body key is set, this will be used as the request body



96
97
98
99
100
101
102
103
104
105
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 96

def request_body_params(request_parameters)
  test_values = request_parameters[:body] || request_parameters
  test_values.transform_keys_to_symbols if Soaspec.always_use_keys?
  if @request_option == :template
    test_values = IndifferentHash.new(test_values) # Allow test_values to be either Symbol or String
    { xml: Soaspec::TemplateReader.new.render_body(template_name, test_values) }
  elsif @request_option == :hash
    { message: @default_hash.merge(test_values), attributes: request_root_attributes }
  end
end

#request_parameters(override_parameters) ⇒ SoapRequest

Returns Parameters used in making a request.

Parameters:

  • override_parameters (Hash) —

    Parameters for building the request

Returns:

  • (SoapRequest) —

    Parameters used in making a request



89
90
91
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 89

def request_parameters(override_parameters)
  SoapRequest.new(operation, request_body_params(override_parameters), @request_option)
end

#request_root_attributes ⇒ Object

Attributes set at the root XML element of SOAP request



48
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 48

def request_root_attributes; end

#response_body(response, format: :hash) ⇒ Object

Returns Generic body to be displayed in error messages.

Parameters:

  • format (Hash) (defaults to: :hash) —

    Format of expected result

Returns:

  • (Object) —

    Generic body to be displayed in error messages



121
122
123
124
125
126
127
128
129
130
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 121

def response_body(response, format: :hash)
  case format
  when :hash
    response.body
  when :raw
    response.xml
  else
    response.body
  end
end

#savon_options ⇒ Hash

Add values to here when extending this class to have default Savon options. See savonrb.com/version2/globals.html for details

Returns:

  • (Hash) —

    Savon options adding to & overriding defaults



63
64
65
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 63

def savon_options
  {}
end

#status_code_for(response) ⇒ Integer

Response status code for response. ‘200’ indicates a success

Parameters:

  • response (Savon::Response)

Returns:

  • (Integer) —

    Status code



140
141
142
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 140

def status_code_for(response)
  response.http.code
end

#to_hash(response) ⇒ Object

Hash of response body



211
212
213
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 211

def to_hash(response)
  response.body
end

#value_from_path(response, path, attribute: nil) ⇒ String

Based on a exchange, return the value at the provided xpath If the path does not begin with a ‘/’, a ‘//’ is added to it

Parameters:

  • response (Savon::Response)
  • path (String) —

    Xpath

  • attribute (String) (defaults to: nil) —

    Generic attribute to find. Will override path

Returns:

  • (String) —

    Value at Xpath

Raises:



190
191
192
193
194
195
196
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 190

def value_from_path(response, path, attribute: nil)
  results = xpath_elements_for(response: response, xpath: path, attribute: attribute)
  raise NoElementAtPath, "No value at Xpath '#{path}' in XML #{response.doc}" if results.empty?
  return results.first.inner_text if attribute.nil?

  results.first.attributes[attribute].inner_text
end

#values_from_path(response, path, attribute: nil) ⇒ Enumerable

Returns List of values returned from path.

Returns:

  • (Enumerable) —

    List of values returned from path



199
200
201
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 199

def values_from_path(response, path, attribute: nil)
  xpath_elements_for(response: response, xpath: path, attribute: attribute).map(&:inner_text)
end

#xpath_elements_for(response: nil, xpath: nil, attribute: nil) ⇒ Enumerable

Returns the value at the provided xpath

Parameters:

  • response (Savon::Response) (defaults to: nil)
  • xpath (String) (defaults to: nil)

Returns:

  • (Enumerable) —

    Elements found through Xpath



169
170
171
172
173
174
175
176
177
178
179
180
181
182
 
# File 'lib/soaspec/exchange_handlers/soap_handler.rb', line 169

def xpath_elements_for(response: nil, xpath: nil, attribute: nil)
  raise ArgumentError('response and xpath must be passed to method') unless response && xpath

  xpath = "//*[@#{attribute}]" unless attribute.nil?
  xpath = '//' + xpath if xpath[0] != '/'
  temp_doc = response.doc.dup
  convert_to_lower_case(temp_doc) if convert_to_lower?
  if strip_namespaces? && !xpath.include?(':')
    temp_doc.remove_namespaces!
    temp_doc.xpath(xpath)
  else
    temp_doc.xpath(xpath, temp_doc.collect_namespaces)
  end
end