XMLRPC::CGIServer

Synopsis

require "xmlrpc/server"

s = XMLRPC::CGIServer.new

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

s.add_handler("michael.div") do |a,b|
  if b == 0
    raise XMLRPC::FaultException.new(1, "division by zero")
  else
    a / b
  end
end

s.set_default_handler do |name, *args|
  raise XMLRPC::FaultException.new(-99, "Method #{name} missing" +
                                   " or wrong number of parameters!")
end

s.serve

Description

Implements a CGI-based XML-RPC server.

Superclass

((<XMLRPC::BasicServer>))

Class Methods

Methods
H
N
S
Class Public methods
new(*a)

Source: show | on GitHub 

# File ../ruby/lib/xmlrpc/server.rb, line 438
def CGIServer.new(*a)
  @@obj = super(*a) if @@obj.nil?
  @@obj
end
new(*a)

Source: show | on GitHub 

# File ../ruby/lib/xmlrpc/server.rb, line 443
def initialize(*a)
  super(*a)
end
Instance Public methods
serve()

Source: show | on GitHub 

# File ../ruby/lib/xmlrpc/server.rb, line 447
def serve
  catch(:exit_serve) {
    length = ENV['CONTENT_LENGTH'].to_i

    http_error(405, "Method Not Allowed") unless ENV['REQUEST_METHOD'] == "POST"
    http_error(400, "Bad Request")        unless parse_content_type(ENV['CONTENT_TYPE']).first == "text/xml"
    http_error(411, "Length Required")    unless length > 0

    # TODO: do we need a call to binmode?
    $stdin.binmode if $stdin.respond_to? :binmode
    data = $stdin.read(length)

    http_error(400, "Bad Request")        if data.nil? or data.bytesize != length

    http_write(process(data), "Content-type" => "text/xml; charset=utf-8")
  }
end
Instance Private methods
http_error(status, message)

Source: show | on GitHub 

# File ../ruby/lib/xmlrpc/server.rb, line 468
def http_error(status, message)
  err = "#{status} #{message}"
  msg = <<-"MSGEND"
    <html>
      <head>
        <title>#{err}</title>
      </head>
      <body>
        <h1>#{err}</h1>
        <p>Unexpected error occured while processing XML-RPC request!</p>
      </body>
    </html>
  MSGEND

  http_write(msg, "Status" => err, "Content-type" => "text/html")
  throw :exit_serve # exit from the #serve method
end
http_write(body, header)

Source: show | on GitHub 

# File ../ruby/lib/xmlrpc/server.rb, line 486
def http_write(body, header)
  h = {}
  header.each {|key, value| h[key.to_s.capitalize] = value}
  h['Status']         ||= "200 OK"
  h['Content-length'] ||= body.bytesize.to_s

  str = ""
  h.each {|key, value| str << "#{key}: #{value}\r\n"}
  str << "\r\n#{body}"

  print str
end