ruby--ruby/lib/soap/rpc/router.rb

=begin
SOAP4R - RPC Routing library
Copyright (C) 2001, 2002  NAKAMURA, Hiroshi.

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PRATICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 675 Mass
Ave, Cambridge, MA 02139, USA.
=end


require 'soap/soap'
require 'soap/processor'
require 'soap/mapping'
require 'soap/rpc/rpc'
require 'soap/rpc/element'


module SOAP
module RPC


class Router
  include SOAP

  attr_reader :actor
  attr_accessor :allow_unqualified_element
  attr_accessor :default_encodingstyle
  attr_accessor :mapping_registry

  def initialize(actor)
    @actor = actor
    @receiver = {}
    @method_name = {}
    @method = {}
    @allow_unqualified_element = false
    @default_encodingstyle = nil
    @mapping_registry = nil
  end

  def add_method(receiver, qname, soapaction, name, param_def)
    fqname = fqname(qname)
    @receiver[fqname] = receiver
    @method_name[fqname] = name
    @method[fqname] = RPC::SOAPMethodRequest.new(qname, param_def, soapaction)
  end

  def add_header_handler
    raise NotImplementedError.new
  end

  # Routing...
  def route(soap_string, charset = nil)
    opt = options
    opt[:charset] = charset
    is_fault = false
    begin
      header, body = Processor.unmarshal(soap_string, opt)
      # So far, header is omitted...
      soap_request = body.request
      unless soap_request.is_a?(SOAPStruct)
	raise RPCRoutingError.new("Not an RPC style.")
      end
      soap_response = dispatch(soap_request)
    rescue Exception
      soap_response = fault($!)
      is_fault = true
    end

    header = SOAPHeader.new
    body = SOAPBody.new(soap_response)
    response_string = Processor.marshal(header, body, opt)

    return response_string, is_fault
  end

  # Create fault response string.
  def create_fault_response(e, charset = nil)
    header = SOAPHeader.new
    soap_response = fault(e)
    body = SOAPBody.new(soap_response)
    opt = options
    opt[:charset] = charset
    Processor.marshal(header, body, opt)
  end

private

  # Create new response.
  def create_response(qname, result)
    name = fqname(qname)
    if (@method.key?(name))
      method = @method[name]
    else
      raise RPCRoutingError.new("Method: #{ name } not defined.")
    end

    soap_response = method.create_method_response
    if soap_response.have_outparam?
      unless result.is_a?(Array)
	raise RPCRoutingError.new("Out parameter was not returned.")
      end
      outparams = {}
      i = 1
      soap_response.each_param_name('out', 'inout') do |outparam|
	outparams[outparam] = Mapping.obj2soap(result[i], @mapping_registry)
	i += 1
      end
      soap_response.set_outparam(outparams)
      soap_response.retval = Mapping.obj2soap(result[0], @mapping_registry)
    else
      soap_response.retval = Mapping.obj2soap(result, @mapping_registry)
    end
    soap_response
  end

  # Create fault response.
  def fault(e)
    detail = Mapping::SOAPException.new(e)
    SOAPFault.new(
      SOAPString.new('Server'),
      SOAPString.new(e.to_s),
      SOAPString.new(@actor),
      Mapping.obj2soap(detail, @mapping_registry))
  end

  # Dispatch to defined method.
  def dispatch(soap_method)
    request_struct = Mapping.soap2obj(soap_method, @mapping_registry)
    values = soap_method.collect { |key, value| request_struct[key] }
    method = lookup(soap_method.elename, values)
    unless method
      raise RPCRoutingError.new(
	"Method: #{ soap_method.elename } not supported.")
    end

    result = method.call(*values)
    create_response(soap_method.elename, result)
  end

  # Method lookup
  def lookup(qname, values)
    name = fqname(qname)
    # It may be necessary to check all part of method signature...
    if @method.member?(name)
      @receiver[name].method(@method_name[name].intern)
    else
      nil
    end
  end

  def fqname(qname)
    "#{ qname.namespace }:#{ qname.name }"
  end

  def options
    opt = {}
    opt[:default_encodingstyle] = @default_encodingstyle
    if @allow_unqualified_element
      opt[:allow_unqualified_element] = true
    end
    opt
  end
end


end
end