mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
eb3f829be9
== SOAP client and server == === for both client side and server side === * improved document/literal service support. style(rpc,document)/use(encoding, literal) combination are all supported. for the detail about combination, see test/soap/test_style.rb. * let WSDLEncodedRegistry#soap2obj map SOAP/OM to Ruby according to WSDL as well as obj2soap. closes #70. * let SOAP::Mapping::Object handle XML attribute for doc/lit service. you can set/get XML attribute via accessor methods which as a name 'xmlattr_' prefixed (<foo name="bar"/> -> Foo#xmlattr_name). === client side === * WSDLDriver capitalized name operation bug fixed. from 1.5.3-ruby1.8.2, operation which has capitalized name (such as KeywordSearchRequest in AWS) is defined as a method having uncapitalized name. (converted with GenSupport.safemethodname to handle operation name 'foo-bar'). it introduced serious incompatibility; in the past, it was defined as a capitalized. define capitalized method as well under that circumstance. * added new factory interface 'WSDLDriverFactory#create_rpc_driver' to create RPC::Driver, not WSDLDriver (RPC::Driver and WSDLDriver are merged). 'WSDLDriverFactory#create_driver' still creates WSDLDriver for compatibility but it warns that the method is deprecated. please use create_rpc_driver instead of create_driver. * allow to use an URI object as an endpoint_url even with net/http, not http-access2. === server side === * added mod_ruby support to SOAP::CGIStub. rename a CGI script server.cgi to server.rb and let mod_ruby's RubyHandler handles the script. CGIStub detects if it's running under mod_ruby environment or not. * added fcgi support to SOAP::CGIStub. see the sample at sample/soap/calc/server.fcgi. (almost same as server.cgi but has fcgi handler at the bottom.) * allow to return a SOAPFault object to respond customized SOAP fault. * added the interface 'generate_explicit_type' for server side (CGIStub, HTTPServer). call 'self.generate_explicit_type = true' if you want to return simplified XML even if it's rpc/encoded service. == WSDL == === WSDL definition === * improved XML Schema support such as extension, restriction, simpleType, complexType + simpleContent, ref, length, import, include. * reduced "unknown element/attribute" warnings (warn only 1 time for each QName). * importing XSD file at schemaLocation with xsd:import. === code generation from WSDL === * generator crashed when there's '-' in defined element/attribute name. * added ApacheMap WSDL definition. * sample/{soap,wsdl}: removed. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@8500 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
212 lines
5.4 KiB
Ruby
212 lines
5.4 KiB
Ruby
# SOAP4R - Stream handler.
|
|
# Copyright (C) 2000, 2001, 2003 NAKAMURA, Hiroshi <nahi@ruby-lang.org>.
|
|
|
|
# This program is copyrighted free software by NAKAMURA, Hiroshi. You can
|
|
# redistribute it and/or modify it under the same terms of Ruby's license;
|
|
# either the dual license version in 2003, or any later version.
|
|
|
|
|
|
require 'soap/soap'
|
|
require 'soap/httpconfigloader'
|
|
begin
|
|
require 'stringio'
|
|
require 'zlib'
|
|
rescue LoadError
|
|
warn("Loading stringio or zlib failed. No gzipped response support.") if $DEBUG
|
|
end
|
|
|
|
|
|
module SOAP
|
|
|
|
|
|
class StreamHandler
|
|
Client = begin
|
|
require 'http-access2'
|
|
if HTTPAccess2::VERSION < "2.0"
|
|
raise LoadError.new("http-access/2.0 or later is required.")
|
|
end
|
|
HTTPAccess2::Client
|
|
rescue LoadError
|
|
warn("Loading http-access2 failed. Net/http is used.") if $DEBUG
|
|
require 'soap/netHttpClient'
|
|
SOAP::NetHttpClient
|
|
end
|
|
|
|
RUBY_VERSION_STRING = "ruby #{ RUBY_VERSION } (#{ RUBY_RELEASE_DATE }) [#{ RUBY_PLATFORM }]"
|
|
|
|
class ConnectionData
|
|
attr_accessor :send_string
|
|
attr_accessor :send_contenttype
|
|
attr_accessor :receive_string
|
|
attr_accessor :receive_contenttype
|
|
attr_accessor :is_fault
|
|
attr_accessor :soapaction
|
|
|
|
def initialize(send_string = nil)
|
|
@send_string = send_string
|
|
@send_contenttype = nil
|
|
@receive_string = nil
|
|
@receive_contenttype = nil
|
|
@is_fault = false
|
|
@soapaction = nil
|
|
end
|
|
end
|
|
|
|
def self.parse_media_type(str)
|
|
if /^#{ MediaType }(?:\s*;\s*charset=([^"]+|"[^"]+"))?$/i !~ str
|
|
return nil
|
|
end
|
|
charset = $1
|
|
charset.gsub!(/"/, '') if charset
|
|
charset || 'us-ascii'
|
|
end
|
|
|
|
def self.create_media_type(charset)
|
|
"#{ MediaType }; charset=#{ charset }"
|
|
end
|
|
end
|
|
|
|
|
|
class HTTPStreamHandler < StreamHandler
|
|
include SOAP
|
|
|
|
public
|
|
|
|
attr_reader :client
|
|
attr_accessor :wiredump_file_base
|
|
|
|
NofRetry = 10 # [times]
|
|
|
|
def initialize(options)
|
|
super()
|
|
@client = Client.new(nil, "SOAP4R/#{ Version }")
|
|
@wiredump_file_base = nil
|
|
@charset = @wiredump_dev = nil
|
|
@options = options
|
|
set_options
|
|
@client.debug_dev = @wiredump_dev
|
|
@cookie_store = nil
|
|
@accept_encoding_gzip = false
|
|
end
|
|
|
|
def test_loopback_response
|
|
@client.test_loopback_response
|
|
end
|
|
|
|
def accept_encoding_gzip=(allow)
|
|
@accept_encoding_gzip = allow
|
|
end
|
|
|
|
def inspect
|
|
"#<#{self.class}>"
|
|
end
|
|
|
|
def send(endpoint_url, conn_data, soapaction = nil, charset = @charset)
|
|
conn_data.soapaction ||= soapaction # for backward conpatibility
|
|
send_post(endpoint_url, conn_data, charset)
|
|
end
|
|
|
|
def reset(endpoint_url = nil)
|
|
if endpoint_url.nil?
|
|
@client.reset_all
|
|
else
|
|
@client.reset(endpoint_url)
|
|
end
|
|
@client.save_cookie_store if @cookie_store
|
|
end
|
|
|
|
private
|
|
|
|
def set_options
|
|
HTTPConfigLoader.set_options(@client, @options)
|
|
@charset = @options["charset"] || XSD::Charset.charset_label($KCODE)
|
|
@options.add_hook("charset") do |key, value|
|
|
@charset = value
|
|
end
|
|
@wiredump_dev = @options["wiredump_dev"]
|
|
@options.add_hook("wiredump_dev") do |key, value|
|
|
@wiredump_dev = value
|
|
@client.debug_dev = @wiredump_dev
|
|
end
|
|
set_cookie_store_file(@options["cookie_store_file"])
|
|
@options.add_hook("cookie_store_file") do |key, value|
|
|
set_cookie_store_file(value)
|
|
end
|
|
ssl_config = @options["ssl_config"]
|
|
basic_auth = @options["basic_auth"]
|
|
@options.lock(true)
|
|
ssl_config.unlock
|
|
basic_auth.unlock
|
|
end
|
|
|
|
def set_cookie_store_file(value)
|
|
@cookie_store = value
|
|
@client.set_cookie_store(@cookie_store) if @cookie_store
|
|
end
|
|
|
|
def send_post(endpoint_url, conn_data, charset)
|
|
conn_data.send_contenttype ||= StreamHandler.create_media_type(charset)
|
|
|
|
if @wiredump_file_base
|
|
filename = @wiredump_file_base + '_request.xml'
|
|
f = File.open(filename, "w")
|
|
f << conn_data.send_string
|
|
f.close
|
|
end
|
|
|
|
extra = {}
|
|
extra['Content-Type'] = conn_data.send_contenttype
|
|
extra['SOAPAction'] = "\"#{ conn_data.soapaction }\""
|
|
extra['Accept-Encoding'] = 'gzip' if send_accept_encoding_gzip?
|
|
send_string = conn_data.send_string
|
|
@wiredump_dev << "Wire dump:\n\n" if @wiredump_dev
|
|
begin
|
|
res = @client.post(endpoint_url, send_string, extra)
|
|
rescue
|
|
@client.reset(endpoint_url)
|
|
raise
|
|
end
|
|
@wiredump_dev << "\n\n" if @wiredump_dev
|
|
receive_string = res.content
|
|
if @wiredump_file_base
|
|
filename = @wiredump_file_base + '_response.xml'
|
|
f = File.open(filename, "w")
|
|
f << receive_string
|
|
f.close
|
|
end
|
|
case res.status
|
|
when 405
|
|
raise PostUnavailableError.new("#{ res.status }: #{ res.reason }")
|
|
when 200, 500
|
|
# Nothing to do.
|
|
else
|
|
raise HTTPStreamError.new("#{ res.status }: #{ res.reason }")
|
|
end
|
|
if res.respond_to?(:header) and !res.header['content-encoding'].empty? and
|
|
res.header['content-encoding'][0].downcase == 'gzip'
|
|
receive_string = decode_gzip(receive_string)
|
|
end
|
|
conn_data.receive_string = receive_string
|
|
conn_data.receive_contenttype = res.contenttype
|
|
conn_data
|
|
end
|
|
|
|
def send_accept_encoding_gzip?
|
|
@accept_encoding_gzip and defined?(::Zlib)
|
|
end
|
|
|
|
def decode_gzip(instring)
|
|
unless send_accept_encoding_gzip?
|
|
raise HTTPStreamError.new("Gzipped response content.")
|
|
end
|
|
begin
|
|
gz = Zlib::GzipReader.new(StringIO.new(instring))
|
|
gz.read
|
|
ensure
|
|
gz.close
|
|
end
|
|
end
|
|
end
|
|
|
|
|
|
end
|