class XMLRPC::Server

Implements a standalone XML-RPC server. The method XMLRPC::Server#serve is left if a SIGHUP is sent to the program.

 require "xmlrpc/server"

s =

s.add_handler("michael.add") do |a,b|
  a + b

s.add_handler("michael.div") do |a,b|
  if b == 0
    raise, "division by zero")
    a / b

s.set_default_handler do |name, *args|
  raise, "Method #{name} missing" +
                                   " or wrong number of parameters!")


Public Class Methods

new(port=8080, host="", maxConnections=4, stdlog=$stdout, audit=true, debug=true, *a) click to toggle source

Creates a new XMLRPC::Server instance, which is a XML-RPC server listening on the given port and accepts requests for the given host, which is localhost by default.

The server is not started, to start it you have to call XMLRPC::Server#serve.

The optional audit and debug parameters are obsolete!

All additionally provided parameters in *a are by-passed to

Calls superclass method XMLRPC::WEBrickServlet::new
# File xmlrpc-0.3.0/lib/xmlrpc/server.rb, line 575
def initialize(port=8080, host="", maxConnections=4, stdlog=$stdout, audit=true, debug=true, *a)
  require 'webrick'
  @server = => port, :BindAddress => host, :MaxClients => maxConnections,
                                    :Logger =>
  @server.mount("/", self)

Public Instance Methods

serve() click to toggle source

Call this after you have added all you handlers to the server. This method starts the server to listen for XML-RPC requests and answer them.

# File xmlrpc-0.3.0/lib/xmlrpc/server.rb, line 585
def serve
  signals = %w[INT TERM HUP] & Signal.list.keys
  signals.each { |signal| trap(signal) { @server.shutdown } }

shutdown() click to toggle source

Stops and shuts the server down.

# File xmlrpc-0.3.0/lib/xmlrpc/server.rb, line 593
def shutdown