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
258 lines
5.5 KiB
Ruby
258 lines
5.5 KiB
Ruby
# SOAP4R - SOAP elements library
|
|
# Copyright (C) 2000, 2001, 2003-2005 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 'xsd/qname'
|
|
require 'soap/baseData'
|
|
|
|
|
|
module SOAP
|
|
|
|
|
|
###
|
|
## SOAP elements
|
|
#
|
|
module SOAPEnvelopeElement; end
|
|
|
|
class SOAPFault < SOAPStruct
|
|
include SOAPEnvelopeElement
|
|
include SOAPCompoundtype
|
|
|
|
public
|
|
|
|
def faultcode
|
|
self['faultcode']
|
|
end
|
|
|
|
def faultstring
|
|
self['faultstring']
|
|
end
|
|
|
|
def faultactor
|
|
self['faultactor']
|
|
end
|
|
|
|
def detail
|
|
self['detail']
|
|
end
|
|
|
|
def faultcode=(rhs)
|
|
self['faultcode'] = rhs
|
|
end
|
|
|
|
def faultstring=(rhs)
|
|
self['faultstring'] = rhs
|
|
end
|
|
|
|
def faultactor=(rhs)
|
|
self['faultactor'] = rhs
|
|
end
|
|
|
|
def detail=(rhs)
|
|
self['detail'] = rhs
|
|
end
|
|
|
|
def initialize(faultcode = nil, faultstring = nil, faultactor = nil, detail = nil)
|
|
super(EleFaultName)
|
|
@elename = EleFaultName
|
|
@encodingstyle = EncodingNamespace
|
|
|
|
if faultcode
|
|
self.faultcode = faultcode
|
|
self.faultstring = faultstring
|
|
self.faultactor = faultactor
|
|
self.detail = detail
|
|
self.faultcode.elename = EleFaultCodeName if self.faultcode
|
|
self.faultstring.elename = EleFaultStringName if self.faultstring
|
|
self.faultactor.elename = EleFaultActorName if self.faultactor
|
|
self.detail.elename = EleFaultDetailName if self.detail
|
|
end
|
|
faultcode.parent = self if faultcode
|
|
faultstring.parent = self if faultstring
|
|
faultactor.parent = self if faultactor
|
|
detail.parent = self if detail
|
|
end
|
|
|
|
def encode(generator, ns, attrs = {})
|
|
SOAPGenerator.assign_ns(attrs, ns, EnvelopeNamespace)
|
|
SOAPGenerator.assign_ns(attrs, ns, EncodingNamespace)
|
|
attrs[ns.name(AttrEncodingStyleName)] = EncodingNamespace
|
|
name = ns.name(@elename)
|
|
generator.encode_tag(name, attrs)
|
|
yield(self.faultcode, false)
|
|
yield(self.faultstring, false)
|
|
yield(self.faultactor, false)
|
|
yield(self.detail, false) if self.detail
|
|
generator.encode_tag_end(name, true)
|
|
end
|
|
end
|
|
|
|
|
|
class SOAPBody < SOAPStruct
|
|
include SOAPEnvelopeElement
|
|
|
|
def initialize(data = nil, is_fault = false)
|
|
super(nil)
|
|
@elename = EleBodyName
|
|
@encodingstyle = nil
|
|
if data
|
|
if data.respond_to?(:elename)
|
|
add(data.elename.name, data)
|
|
else
|
|
data.to_a.each do |datum|
|
|
add(datum.elename.name, datum)
|
|
end
|
|
end
|
|
end
|
|
@is_fault = is_fault
|
|
end
|
|
|
|
def encode(generator, ns, attrs = {})
|
|
name = ns.name(@elename)
|
|
generator.encode_tag(name, attrs)
|
|
if @is_fault
|
|
yield(@data, true)
|
|
else
|
|
@data.each do |data|
|
|
yield(data, true)
|
|
end
|
|
end
|
|
generator.encode_tag_end(name, true)
|
|
end
|
|
|
|
def root_node
|
|
@data.each do |node|
|
|
if node.root == 1
|
|
return node
|
|
end
|
|
end
|
|
# No specified root...
|
|
@data.each do |node|
|
|
if node.root != 0
|
|
return node
|
|
end
|
|
end
|
|
|
|
raise Parser::FormatDecodeError.new('no root element')
|
|
end
|
|
end
|
|
|
|
|
|
class SOAPHeaderItem < XSD::NSDBase
|
|
include SOAPEnvelopeElement
|
|
include SOAPCompoundtype
|
|
|
|
public
|
|
|
|
attr_accessor :element
|
|
attr_accessor :mustunderstand
|
|
attr_accessor :encodingstyle
|
|
|
|
def initialize(element, mustunderstand = true, encodingstyle = nil)
|
|
super()
|
|
@type = nil
|
|
@element = element
|
|
@mustunderstand = mustunderstand
|
|
@encodingstyle = encodingstyle
|
|
element.parent = self if element
|
|
end
|
|
|
|
def encode(generator, ns, attrs = {})
|
|
attrs.each do |key, value|
|
|
@element.extraattr[key] = value
|
|
end
|
|
@element.extraattr[ns.name(AttrMustUnderstandName)] =
|
|
(@mustunderstand ? '1' : '0')
|
|
if @encodingstyle
|
|
@element.extraattr[ns.name(AttrEncodingStyleName)] = @encodingstyle
|
|
end
|
|
@element.encodingstyle = @encodingstyle if !@element.encodingstyle
|
|
yield(@element, true)
|
|
end
|
|
end
|
|
|
|
|
|
class SOAPHeader < SOAPStruct
|
|
include SOAPEnvelopeElement
|
|
|
|
def initialize
|
|
super(nil)
|
|
@elename = EleHeaderName
|
|
@encodingstyle = nil
|
|
end
|
|
|
|
def encode(generator, ns, attrs = {})
|
|
name = ns.name(@elename)
|
|
generator.encode_tag(name, attrs)
|
|
@data.each do |data|
|
|
yield(data, true)
|
|
end
|
|
generator.encode_tag_end(name, true)
|
|
end
|
|
|
|
def add(name, value)
|
|
mu = (value.extraattr[AttrMustUnderstandName] == '1')
|
|
encstyle = value.extraattr[AttrEncodingStyleName]
|
|
item = SOAPHeaderItem.new(value, mu, encstyle)
|
|
super(name, item)
|
|
end
|
|
|
|
def length
|
|
@data.length
|
|
end
|
|
alias size length
|
|
end
|
|
|
|
|
|
class SOAPEnvelope < XSD::NSDBase
|
|
include SOAPEnvelopeElement
|
|
include SOAPCompoundtype
|
|
|
|
attr_reader :header
|
|
attr_reader :body
|
|
attr_reader :external_content
|
|
|
|
def initialize(header = nil, body = nil)
|
|
super()
|
|
@type = nil
|
|
@elename = EleEnvelopeName
|
|
@encodingstyle = nil
|
|
@header = header
|
|
@body = body
|
|
@external_content = {}
|
|
header.parent = self if header
|
|
body.parent = self if body
|
|
end
|
|
|
|
def header=(header)
|
|
header.parent = self
|
|
@header = header
|
|
end
|
|
|
|
def body=(body)
|
|
body.parent = self
|
|
@body = body
|
|
end
|
|
|
|
def encode(generator, ns, attrs = {})
|
|
SOAPGenerator.assign_ns(attrs, ns, EnvelopeNamespace, SOAPNamespaceTag)
|
|
name = ns.name(@elename)
|
|
generator.encode_tag(name, attrs)
|
|
|
|
yield(@header, true) if @header and @header.length > 0
|
|
yield(@body, true)
|
|
|
|
generator.encode_tag_end(name, true)
|
|
end
|
|
|
|
def to_ary
|
|
[header, body]
|
|
end
|
|
end
|
|
|
|
|
|
end
|