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
149 lines
4.4 KiB
Ruby
149 lines
4.4 KiB
Ruby
# WSDL4R - WSDL additional definitions for SOAP.
|
|
# Copyright (C) 2002-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 'wsdl/info'
|
|
require 'xsd/namedelements'
|
|
require 'soap/mapping'
|
|
|
|
|
|
module WSDL
|
|
|
|
|
|
class Definitions < Info
|
|
def self.soap_rpc_complextypes
|
|
types = XSD::NamedElements.new
|
|
types << array_complextype
|
|
types << fault_complextype
|
|
types << exception_complextype
|
|
types
|
|
end
|
|
|
|
def self.array_complextype
|
|
type = XMLSchema::ComplexType.new(::SOAP::ValueArrayName)
|
|
type.complexcontent = XMLSchema::ComplexContent.new
|
|
type.complexcontent.base = ::SOAP::ValueArrayName
|
|
attr = XMLSchema::Attribute.new
|
|
attr.ref = ::SOAP::AttrArrayTypeName
|
|
anytype = XSD::AnyTypeName.dup
|
|
anytype.name += '[]'
|
|
attr.arytype = anytype
|
|
type.complexcontent.attributes << attr
|
|
type
|
|
end
|
|
|
|
=begin
|
|
<xs:complexType name="Fault" final="extension">
|
|
<xs:sequence>
|
|
<xs:element name="faultcode" type="xs:QName" />
|
|
<xs:element name="faultstring" type="xs:string" />
|
|
<xs:element name="faultactor" type="xs:anyURI" minOccurs="0" />
|
|
<xs:element name="detail" type="tns:detail" minOccurs="0" />
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
=end
|
|
def self.fault_complextype
|
|
type = XMLSchema::ComplexType.new(::SOAP::EleFaultName)
|
|
faultcode = XMLSchema::Element.new(::SOAP::EleFaultCodeName, XSD::XSDQName::Type)
|
|
faultstring = XMLSchema::Element.new(::SOAP::EleFaultStringName, XSD::XSDString::Type)
|
|
faultactor = XMLSchema::Element.new(::SOAP::EleFaultActorName, XSD::XSDAnyURI::Type)
|
|
faultactor.minoccurs = 0
|
|
detail = XMLSchema::Element.new(::SOAP::EleFaultDetailName, XSD::AnyTypeName)
|
|
detail.minoccurs = 0
|
|
type.all_elements = [faultcode, faultstring, faultactor, detail]
|
|
type.final = 'extension'
|
|
type
|
|
end
|
|
|
|
def self.exception_complextype
|
|
type = XMLSchema::ComplexType.new(XSD::QName.new(
|
|
::SOAP::Mapping::RubyCustomTypeNamespace, 'SOAPException'))
|
|
excn_name = XMLSchema::Element.new(XSD::QName.new(nil, 'excn_type_name'), XSD::XSDString::Type)
|
|
cause = XMLSchema::Element.new(XSD::QName.new(nil, 'cause'), XSD::AnyTypeName)
|
|
backtrace = XMLSchema::Element.new(XSD::QName.new(nil, 'backtrace'), ::SOAP::ValueArrayName)
|
|
message = XMLSchema::Element.new(XSD::QName.new(nil, 'message'), XSD::XSDString::Type)
|
|
type.all_elements = [excn_name, cause, backtrace, message]
|
|
type
|
|
end
|
|
|
|
def soap_rpc_complextypes(binding)
|
|
types = rpc_operation_complextypes(binding)
|
|
types + self.class.soap_rpc_complextypes
|
|
end
|
|
|
|
def collect_faulttypes
|
|
result = []
|
|
collect_fault_messages.each do |name|
|
|
faultparts = message(name).parts
|
|
if faultparts.size != 1
|
|
raise RuntimeError.new("expecting fault message to have only 1 part")
|
|
end
|
|
if result.index(faultparts[0].type).nil?
|
|
result << faultparts[0].type
|
|
end
|
|
end
|
|
result
|
|
end
|
|
|
|
private
|
|
|
|
def collect_fault_messages
|
|
result = []
|
|
porttypes.each do |porttype|
|
|
porttype.operations.each do |operation|
|
|
operation.fault.each do |fault|
|
|
if result.index(fault.message).nil?
|
|
result << fault.message
|
|
end
|
|
end
|
|
end
|
|
end
|
|
result
|
|
end
|
|
|
|
def rpc_operation_complextypes(binding)
|
|
types = XSD::NamedElements.new
|
|
binding.operations.each do |op_bind|
|
|
if op_bind_rpc?(op_bind)
|
|
operation = op_bind.find_operation
|
|
if op_bind.input
|
|
type = XMLSchema::ComplexType.new(op_bind.soapoperation_name)
|
|
message = messages[operation.input.message]
|
|
type.sequence_elements = elements_from_message(message)
|
|
types << type
|
|
end
|
|
if op_bind.output
|
|
type = XMLSchema::ComplexType.new(operation.outputname)
|
|
message = messages[operation.output.message]
|
|
type.sequence_elements = elements_from_message(message)
|
|
types << type
|
|
end
|
|
end
|
|
end
|
|
types
|
|
end
|
|
|
|
def op_bind_rpc?(op_bind)
|
|
op_bind.soapoperation_style == :rpc
|
|
end
|
|
|
|
def elements_from_message(message)
|
|
message.parts.collect { |part|
|
|
if part.element
|
|
collect_elements[part.element]
|
|
elsif part.name.nil? or part.type.nil?
|
|
raise RuntimeError.new("part of a message must be an element or typed")
|
|
else
|
|
qname = XSD::QName.new(nil, part.name)
|
|
XMLSchema::Element.new(qname, part.type)
|
|
end
|
|
}
|
|
end
|
|
end
|
|
|
|
|
|
end
|