# == Author and Copyright
#
# Copyright (C) 2001-2004 by Michael Neumann (mailto:mneumann@ntecs.de)
#
# Released under the same term of license as Ruby.
#
# == Overview
#
# XMLRPC is a lightweight protocol that enables remote procedure calls over
# HTTP. It is defined at http://www.xmlrpc.com.
#
# XMLRPC allows you to create simple distributed computing solutions that span
# computer languages. Its distinctive feature is its simplicity compared to
# other approaches like SOAP and CORBA.
#
# The Ruby standard library package 'xmlrpc' enables you to create a server that
# implements remote procedures and a client that calls them. Very little code
# is required to achieve either of these.
#
# == Example
#
# Try the following code. It calls a standard demonstration remote procedure.
#
# require 'xmlrpc/client'
# require 'pp'
#
# server = XMLRPC::Client.new2("http://xmlrpc-c.sourceforge.net/api/sample.php")
# result = server.call("sample.sumAndDifference", 5, 3)
# pp result
#
# == Documentation
#
# See http://www.ntecs.de/projects/xmlrpc4r. There is plenty of detail there to
# use the client and implement a server.
#
# == Features of XMLRPC for Ruby
#
# * Extensions
# * Introspection
# * multiCall
# * optionally nil values and integers larger than 32 Bit
#
# * Server
# * Standalone XML-RPC server
# * CGI-based (works with FastCGI)
# * Apache mod_ruby server
# * WEBrick servlet
#
# * Client
# * synchronous/asynchronous calls
# * Basic HTTP-401 Authentification
# * HTTPS protocol (SSL)
#
# * Parsers
# * NQXML (XMLParser::NQXMLStreamParser, XMLParser::NQXMLTreeParser)
# * Expat (XMLParser::XMLStreamParser, XMLParser::XMLTreeParser)
# * REXML (XMLParser::REXMLStreamParser)
# * xml-scan (XMLParser::XMLScanStreamParser)
# * Fastest parser is Expat's XMLParser::XMLStreamParser!
#
# * General
# * possible to choose between XMLParser module (Expat wrapper) and REXML/NQXML (pure Ruby) parsers
# * Marshalling Ruby objects to Hashs and reconstruct them later from a Hash
# * SandStorm component architecture XMLRPC::Client interface
#
# == Howto
#
# === Client
#
# require "xmlrpc/client"
#
# # Make an object to represent the XML-RPC server.
# server = XMLRPC::Client.new( "xmlrpc-c.sourceforge.net", "/api/sample.php")
#
# # Call the remote server and get our result
# result = server.call("sample.sumAndDifference", 5, 3)
#
# sum = result["sum"]
# difference = result["difference"]
#
# puts "Sum: #{sum}, Difference: #{difference}"
#
# === XMLRPC::Client with XML-RPC fault-structure handling
#
# There are two possible ways, of handling a fault-structure:
#
# ==== by catching a XMLRPC::FaultException exception
#
# require "xmlrpc/client"
#
# # Make an object to represent the XML-RPC server.
# server = XMLRPC::Client.new( "xmlrpc-c.sourceforge.net", "/api/sample.php")
#
# begin
# # Call the remote server and get our result
# result = server.call("sample.sumAndDifference", 5, 3)
#
# sum = result["sum"]
# difference = result["difference"]
#
# puts "Sum: #{sum}, Difference: #{difference}"
#
# rescue XMLRPC::FaultException => e
# puts "Error: "
# puts e.faultCode
# puts e.faultString
# end
#
# ==== by calling "call2" which returns a boolean
#
# require "xmlrpc/client"
#
# # Make an object to represent the XML-RPC server.
# server = XMLRPC::Client.new( "xmlrpc-c.sourceforge.net", "/api/sample.php")
#
# # Call the remote server and get our result
# ok, result = server.call2("sample.sumAndDifference", 5, 3)
#
# if ok
# sum = result["sum"]
# difference = result["difference"]
#
# puts "Sum: #{sum}, Difference: #{difference}"
# else
# puts "Error: "
# puts result.faultCode
# puts result.faultString
# end
#
# === Using XMLRPC::Client::Proxy
#
# You can create a Proxy object onto which you can call methods. This way it
# looks nicer. Both forms, _call_ and _call2_ are supported through _proxy_ and
# _proxy2_. You can additionally give arguments to the Proxy, which will be
# given to each XML-RPC call using that Proxy.
#
# require "xmlrpc/client"
#
# # Make an object to represent the XML-RPC server.
# server = XMLRPC::Client.new( "xmlrpc-c.sourceforge.net", "/api/sample.php")
#
# # Create a Proxy object
# sample = server.proxy("sample")
#
# # Call the remote server and get our result
# result = sample.sumAndDifference(5,3)
#
# sum = result["sum"]
# difference = result["difference"]
#
# puts "Sum: #{sum}, Difference: #{difference}"
#
# === CGI-based server using XMLRPC::CGIServer
#
# There are also two ways to define handler, the first is
# like C/PHP, the second like Java, of course both ways
# can be mixed:
#
# ==== C/PHP-like (handler functions)
#
# require "xmlrpc/server"
#
# s = XMLRPC::CGIServer.new
#
# s.add_handler("sample.sumAndDifference") do |a,b|
# { "sum" => a + b, "difference" => a - b }
# end
#
# s.serve
#
# ==== Java-like (handler classes)
#
# require "xmlrpc/server"
#
# s = XMLRPC::CGIServer.new
#
# class MyHandler
# def sumAndDifference(a, b)
# { "sum" => a + b, "difference" => a - b }
# end
# end
#
# # NOTE: Security Hole (read below)!!!
# s.add_handler("sample", MyHandler.new)
# s.serve
#
#
# To return a fault-structure you have to raise an XMLRPC::FaultException e.g.:
#
# raise XMLRPC::FaultException.new(3, "division by Zero")
#
# ===== Security Note
#
# From Brian Candler:
#
# Above code sample has an extremely nasty security hole, in that you can now call
# any method of 'MyHandler' remotely, including methods inherited from Object
# and Kernel! For example, in the client code, you can use
#
# puts server.call("sample.send","`","ls")
#
# (backtick being the method name for running system processes). Needless to
# say, 'ls' can be replaced with something else.
#
# The version which binds proc objects (or the version presented below in the next section)
# doesn't have this problem, but people may be tempted to use the second version because it's
# so nice and 'Rubyesque'. I think it needs a big red disclaimer.
#
#
# From Michael:
#
# A solution is to undef insecure methods or to use
# XMLRPC::Service::PublicInstanceMethodsInterface as shown below:
#
# class MyHandler
# def sumAndDifference(a, b)
# { "sum" => a + b, "difference" => a - b }
# end
# end
#
# # ... server initialization ...
#
# s.add_handler(XMLRPC::iPIMethods("sample"), MyHandler.new)
#
# # ...
#
# This adds only public instance methods explicitly declared in class MyHandler
# (and not those inherited from any other class).
#
# ==== With interface declarations
#
# Code sample from the book Ruby Developer's Guide:
#
# require "xmlrpc/server"
#
# class Num
# INTERFACE = XMLRPC::interface("num") {
# meth 'int add(int, int)', 'Add two numbers', 'add'
# meth 'int div(int, int)', 'Divide two numbers'
# }
#
# def add(a, b) a + b end
# def div(a, b) a / b end
# end
#
#
# s = XMLRPC::CGIServer.new
# s.add_handler(Num::INTERFACE, Num.new)
# s.serve
#
# === Standalone XMLRPC::Server
#
# Same as CGI-based server, the only difference being
#
# server = XMLRPC::CGIServer.new
#
# must be changed to
#
# server = XMLRPC::Server.new(8080)
#
# if you want a server listening on port 8080.
# The rest is the same.
#
# === Choosing a different XMLParser or XMLWriter
#
# The examples above all use the default parser (which is now since 1.8
# XMLParser::REXMLStreamParser) and a default XMLRPC::XMLWriter.
# If you want to use a different XMLParser, then you have to call the
# ParserWriterChooseMixin#set_parser method of XMLRPC::Client instances
# or instances of subclasses of XMLRPC::BasicServer or by editing
# xmlrpc/config.rb.
#
# XMLRPC::Client Example:
#
# # ...
# server = XMLRPC::Client.new( "xmlrpc-c.sourceforge.net", "/api/sample.php")
# server.set_parser(XMLRPC::XMLParser::XMLParser.new)
# # ...
#
# XMLRPC::Server Example:
#
# # ...
# s = XMLRPC::CGIServer.new
# s.set_parser(XMLRPC::XMLParser::XMLStreamParser.new)
# # ...
#
# or:
#
# # ...
# server = XMLRPC::Server.new(8080)
# server.set_parser(XMLRPC::XMLParser::NQXMLParser.new)
# # ...
#
#
# Note that XMLParser::XMLStreamParser is incredible faster (and uses less memory) than any
# other parser and scales well for large documents. For example for a 0.5 MB XML
# document with many tags, XMLParser::XMLStreamParser is ~350 (!) times faster than
# XMLParser::NQXMLTreeParser and still ~18 times as fast as XMLParser::XMLTreeParser.
#
# You can change the XML-writer by calling method ParserWriterChooseMixin#set_writer.
module XMLRPC; end
| Name | Type | Size | Permission | Actions |
|---|---|---|---|---|
| bigdecimal | Folder | 0755 |
|
|
| cgi | Folder | 0755 |
|
|
| date | Folder | 0755 |
|
|
| digest | Folder | 0755 |
|
|
| dl | Folder | 0755 |
|
|
| drb | Folder | 0755 |
|
|
| fiddle | Folder | 0755 |
|
|
| io | Folder | 0755 |
|
|
| irb | Folder | 0755 |
|
|
| json | Folder | 0755 |
|
|
| matrix | Folder | 0755 |
|
|
| net | Folder | 0755 |
|
|
| openssl | Folder | 0755 |
|
|
| optparse | Folder | 0755 |
|
|
| psych | Folder | 0755 |
|
|
| racc | Folder | 0755 |
|
|
| rbconfig | Folder | 0755 |
|
|
| rexml | Folder | 0755 |
|
|
| rinda | Folder | 0755 |
|
|
| ripper | Folder | 0755 |
|
|
| rss | Folder | 0755 |
|
|
| shell | Folder | 0755 |
|
|
| syslog | Folder | 0755 |
|
|
| test | Folder | 0755 |
|
|
| uri | Folder | 0755 |
|
|
| vendor_ruby | Folder | 0755 |
|
|
| webrick | Folder | 0755 |
|
|
| xmlrpc | Folder | 0755 |
|
|
| yaml | Folder | 0755 |
|
|
| English.rb | File | 6.44 KB | 0644 |
|
| abbrev.rb | File | 3.31 KB | 0644 |
|
| base64.rb | File | 2.63 KB | 0644 |
|
| benchmark.rb | File | 17.94 KB | 0644 |
|
| cgi.rb | File | 9.39 KB | 0644 |
|
| cmath.rb | File | 7.22 KB | 0644 |
|
| complex.rb | File | 380 B | 0644 |
|
| csv.rb | File | 81.32 KB | 0644 |
|
| date.rb | File | 946 B | 0644 |
|
| debug.rb | File | 28.9 KB | 0644 |
|
| delegate.rb | File | 9.78 KB | 0644 |
|
| digest.rb | File | 2.24 KB | 0644 |
|
| dl.rb | File | 280 B | 0644 |
|
| drb.rb | File | 19 B | 0644 |
|
| e2mmap.rb | File | 3.8 KB | 0644 |
|
| erb.rb | File | 26.08 KB | 0644 |
|
| expect.rb | File | 2.14 KB | 0644 |
|
| fiddle.rb | File | 1.25 KB | 0644 |
|
| fileutils.rb | File | 46.35 KB | 0644 |
|
| find.rb | File | 2.08 KB | 0644 |
|
| forwardable.rb | File | 7.56 KB | 0644 |
|
| getoptlong.rb | File | 15.38 KB | 0644 |
|
| gserver.rb | File | 8.86 KB | 0644 |
|
| ipaddr.rb | File | 26.17 KB | 0644 |
|
| irb.rb | File | 20.03 KB | 0644 |
|
| json.rb | File | 1.74 KB | 0644 |
|
| kconv.rb | File | 5.74 KB | 0644 |
|
| logger.rb | File | 20.96 KB | 0644 |
|
| mathn.rb | File | 6.52 KB | 0644 |
|
| matrix.rb | File | 45.02 KB | 0644 |
|
| mkmf.rb | File | 78.13 KB | 0644 |
|
| monitor.rb | File | 6.93 KB | 0644 |
|
| mutex_m.rb | File | 2 KB | 0644 |
|
| observer.rb | File | 5.71 KB | 0644 |
|
| open-uri.rb | File | 23.66 KB | 0644 |
|
| open3.rb | File | 21.17 KB | 0644 |
|
| openssl.rb | File | 528 B | 0644 |
|
| optparse.rb | File | 51.27 KB | 0644 |
|
| ostruct.rb | File | 7.64 KB | 0644 |
|
| pathname.rb | File | 15.3 KB | 0644 |
|
| pp.rb | File | 13.14 KB | 0644 |
|
| prettyprint.rb | File | 9.63 KB | 0644 |
|
| prime.rb | File | 13.98 KB | 0644 |
|
| profile.rb | File | 205 B | 0644 |
|
| profiler.rb | File | 4.29 KB | 0644 |
|
| pstore.rb | File | 14.85 KB | 0644 |
|
| psych.rb | File | 11.45 KB | 0644 |
|
| rational.rb | File | 308 B | 0644 |
|
| resolv-replace.rb | File | 1.73 KB | 0644 |
|
| resolv.rb | File | 61.46 KB | 0644 |
|
| ripper.rb | File | 2.53 KB | 0644 |
|
| rss.rb | File | 2.84 KB | 0644 |
|
| scanf.rb | File | 23.52 KB | 0644 |
|
| securerandom.rb | File | 8.56 KB | 0644 |
|
| set.rb | File | 17.32 KB | 0644 |
|
| shell.rb | File | 10.3 KB | 0644 |
|
| shellwords.rb | File | 5.94 KB | 0644 |
|
| singleton.rb | File | 4.02 KB | 0644 |
|
| socket.rb | File | 25.76 KB | 0644 |
|
| sync.rb | File | 7.26 KB | 0644 |
|
| tempfile.rb | File | 10.15 KB | 0644 |
|
| thread.rb | File | 6.94 KB | 0644 |
|
| thwait.rb | File | 3.38 KB | 0644 |
|
| time.rb | File | 21.09 KB | 0644 |
|
| timeout.rb | File | 3.16 KB | 0644 |
|
| tmpdir.rb | File | 4.29 KB | 0644 |
|
| tracer.rb | File | 6.54 KB | 0644 |
|
| tsort.rb | File | 6.79 KB | 0644 |
|
| un.rb | File | 8.34 KB | 0644 |
|
| uri.rb | File | 3.07 KB | 0644 |
|
| weakref.rb | File | 3.23 KB | 0644 |
|
| webrick.rb | File | 6.7 KB | 0644 |
|
| xmlrpc.rb | File | 8.49 KB | 0644 |
|
| yaml.rb | File | 2.3 KB | 0644 |
|