Skip to content
This repository

From 1.1.0, Handsoap supports asynchronous calls. To take proper advantage of this, you should use the Eventmachine HTTP driver. Services that use the async interface looks slightly different than the regular blocking ones. A service with an async action might look like this:


class MyService < Handsoap::Service
  def get_foos(name, &block)
    async(block) do |dispatcher|
      dispatcher.request("x:GetFoos") do |m|
        m.add "name", name
      end
      dispatcher.response do |response|
        (response/"//ns:GetFoosResponse/foo").map {|foo| parse_foo(foo) }
      end
    end
  end
  def parse_foo(node)
    { :id = node[:foo_id], :name => node[:name] }
  end
end

Instead of returning a result right away, the method get_foos yields a Deferred. The code that uses this service would thus look like this:


MyService.get_foos("lorem ipsum") do |d|
  d.callback do |foos|
    puts "Got #{foos.size} foo's back"
  end
  d.errback do |error|
    puts "Oh noes!"
  end
end
Something went wrong with that request. Please try again.