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
176 lines
4.9 KiB
Ruby
176 lines
4.9 KiB
Ruby
# WSDL4R - WSDL to ruby mapping library.
|
|
# 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 'logger'
|
|
require 'xsd/qname'
|
|
require 'wsdl/importer'
|
|
require 'wsdl/soap/classDefCreator'
|
|
require 'wsdl/soap/servantSkeltonCreator'
|
|
require 'wsdl/soap/driverCreator'
|
|
require 'wsdl/soap/clientSkeltonCreator'
|
|
require 'wsdl/soap/standaloneServerStubCreator'
|
|
require 'wsdl/soap/cgiStubCreator'
|
|
|
|
|
|
module WSDL
|
|
module SOAP
|
|
|
|
|
|
class WSDL2Ruby
|
|
attr_accessor :location
|
|
attr_reader :opt
|
|
attr_accessor :logger
|
|
attr_accessor :basedir
|
|
|
|
def run
|
|
unless @location
|
|
raise RuntimeError, "WSDL location not given"
|
|
end
|
|
@wsdl = import(@location)
|
|
@name = @wsdl.name ? @wsdl.name.name : 'default'
|
|
create_file
|
|
end
|
|
|
|
private
|
|
|
|
def initialize
|
|
@location = nil
|
|
@opt = {}
|
|
@logger = Logger.new(STDERR)
|
|
@basedir = nil
|
|
@wsdl = nil
|
|
@name = nil
|
|
end
|
|
|
|
def create_file
|
|
create_classdef if @opt.key?('classdef')
|
|
create_servant_skelton(@opt['servant_skelton']) if @opt.key?('servant_skelton')
|
|
create_cgi_stub(@opt['cgi_stub']) if @opt.key?('cgi_stub')
|
|
create_standalone_server_stub(@opt['standalone_server_stub']) if @opt.key?('standalone_server_stub')
|
|
create_driver(@opt['driver']) if @opt.key?('driver')
|
|
create_client_skelton(@opt['client_skelton']) if @opt.key?('client_skelton')
|
|
end
|
|
|
|
def create_classdef
|
|
@logger.info { "Creating class definition." }
|
|
@classdef_filename = @name + '.rb'
|
|
check_file(@classdef_filename) or return
|
|
write_file(@classdef_filename) do |f|
|
|
f << WSDL::SOAP::ClassDefCreator.new(@wsdl).dump
|
|
end
|
|
end
|
|
|
|
def create_client_skelton(servicename)
|
|
@logger.info { "Creating client skelton." }
|
|
servicename ||= @wsdl.services[0].name.name
|
|
@client_skelton_filename = servicename + 'Client.rb'
|
|
check_file(@client_skelton_filename) or return
|
|
write_file(@client_skelton_filename) do |f|
|
|
f << shbang << "\n"
|
|
f << "require '#{@driver_filename}'\n\n" if @driver_filename
|
|
f << WSDL::SOAP::ClientSkeltonCreator.new(@wsdl).dump(
|
|
create_name(servicename))
|
|
end
|
|
end
|
|
|
|
def create_servant_skelton(porttypename)
|
|
@logger.info { "Creating servant skelton." }
|
|
@servant_skelton_filename = (porttypename || @name + 'Servant') + '.rb'
|
|
check_file(@servant_skelton_filename) or return
|
|
write_file(@servant_skelton_filename) do |f|
|
|
f << "require '#{@classdef_filename}'\n\n" if @classdef_filename
|
|
f << WSDL::SOAP::ServantSkeltonCreator.new(@wsdl).dump(
|
|
create_name(porttypename))
|
|
end
|
|
end
|
|
|
|
def create_cgi_stub(servicename)
|
|
@logger.info { "Creating CGI stub." }
|
|
servicename ||= @wsdl.services[0].name.name
|
|
@cgi_stubFilename = servicename + '.cgi'
|
|
check_file(@cgi_stubFilename) or return
|
|
write_file(@cgi_stubFilename) do |f|
|
|
f << shbang << "\n"
|
|
if @servant_skelton_filename
|
|
f << "require '#{@servant_skelton_filename}'\n\n"
|
|
end
|
|
f << WSDL::SOAP::CGIStubCreator.new(@wsdl).dump(create_name(servicename))
|
|
end
|
|
end
|
|
|
|
def create_standalone_server_stub(servicename)
|
|
@logger.info { "Creating standalone stub." }
|
|
servicename ||= @wsdl.services[0].name.name
|
|
@standalone_server_stub_filename = servicename + '.rb'
|
|
check_file(@standalone_server_stub_filename) or return
|
|
write_file(@standalone_server_stub_filename) do |f|
|
|
f << shbang << "\n"
|
|
f << "require '#{@servant_skelton_filename}'\n\n" if @servant_skelton_filename
|
|
f << WSDL::SOAP::StandaloneServerStubCreator.new(@wsdl).dump(
|
|
create_name(servicename))
|
|
end
|
|
end
|
|
|
|
def create_driver(porttypename)
|
|
@logger.info { "Creating driver." }
|
|
@driver_filename = (porttypename || @name) + 'Driver.rb'
|
|
check_file(@driver_filename) or return
|
|
write_file(@driver_filename) do |f|
|
|
f << "require '#{@classdef_filename}'\n\n" if @classdef_filename
|
|
f << WSDL::SOAP::DriverCreator.new(@wsdl).dump(
|
|
create_name(porttypename))
|
|
end
|
|
end
|
|
|
|
def write_file(filename)
|
|
if @basedir
|
|
filename = File.join(basedir, filename)
|
|
end
|
|
File.open(filename, "w") do |f|
|
|
yield f
|
|
end
|
|
end
|
|
|
|
def check_file(filename)
|
|
if @basedir
|
|
filename = File.join(basedir, filename)
|
|
end
|
|
if FileTest.exist?(filename)
|
|
if @opt.key?('force')
|
|
@logger.warn {
|
|
"File '#{filename}' exists but overrides it."
|
|
}
|
|
true
|
|
else
|
|
@logger.warn {
|
|
"File '#{filename}' exists. #{$0} did not override it."
|
|
}
|
|
false
|
|
end
|
|
else
|
|
@logger.info { "Creates file '#{filename}'." }
|
|
true
|
|
end
|
|
end
|
|
|
|
def shbang
|
|
"#!/usr/bin/env ruby"
|
|
end
|
|
|
|
def create_name(name)
|
|
name ? XSD::QName.new(@wsdl.targetnamespace, name) : nil
|
|
end
|
|
|
|
def import(location)
|
|
WSDL::Importer.import(location)
|
|
end
|
|
end
|
|
|
|
|
|
end
|
|
end
|