Gecko [ nxtxgen.com ]

Name	Size	Permission
cgi	[ DIR ]	drwxr-xr-x
digest	[ DIR ]	drwxr-xr-x
drb	[ DIR ]	drwxr-xr-x
fiddle	[ DIR ]	drwxr-xr-x
io	[ DIR ]	drwxr-xr-x
irb	[ DIR ]	drwxr-xr-x
json	[ DIR ]	drwxr-xr-x
matrix	[ DIR ]	drwxr-xr-x
net	[ DIR ]	drwxr-xr-x
openssl	[ DIR ]	drwxr-xr-x
optparse	[ DIR ]	drwxr-xr-x
psych	[ DIR ]	drwxr-xr-x
racc	[ DIR ]	drwxr-xr-x
rake	[ DIR ]	drwxr-xr-x
rbconfig	[ DIR ]	drwxr-xr-x
rdoc	[ DIR ]	drwxr-xr-x
rexml	[ DIR ]	drwxr-xr-x
rinda	[ DIR ]	drwxr-xr-x
ripper	[ DIR ]	drwxr-xr-x
rss	[ DIR ]	drwxr-xr-x
rubygems	[ DIR ]	drwxr-xr-x
shell	[ DIR ]	drwxr-xr-x
syslog	[ DIR ]	drwxr-xr-x
unicode_normalize	[ DIR ]	drwxr-xr-x
uri	[ DIR ]	drwxr-xr-x
webrick	[ DIR ]	drwxr-xr-x
x86_64-linux	[ DIR ]	drwxr-xr-x
xmlrpc	[ DIR ]	drwxr-xr-x
yaml	[ DIR ]	drwxr-xr-x
English.rb	6.42 KB	-rw-r--r--
abbrev.rb	3.46 KB	-rw-r--r--
base64.rb	2.63 KB	-rw-r--r--
benchmark.rb	17.73 KB	-rw-r--r--
cgi.rb	9.77 KB	-rw-r--r--
cmath.rb	9.34 KB	-rw-r--r--
csv.rb	82.45 KB	-rw-r--r--
date.rb	980 B	-rw-r--r--
debug.rb	29.08 KB	-rw-r--r--
delegate.rb	10.71 KB	-rw-r--r--
digest.rb	2.79 KB	-rw-r--r--
drb.rb	19 B	-rw-r--r--
e2mmap.rb	3.77 KB	-rw-r--r--
erb.rb	26.35 KB	-rw-r--r--
expect.rb	2.14 KB	-rw-r--r--
fiddle.rb	1.65 KB	-rw-r--r--
fileutils.rb	47.46 KB	-rw-r--r--
find.rb	2.48 KB	-rw-r--r--
forwardable.rb	8.22 KB	-rw-r--r--
getoptlong.rb	15.38 KB	-rw-r--r--
ipaddr.rb	17.06 KB	-rw-r--r--
irb.rb	20.03 KB	-rw-r--r--
json.rb	1.74 KB	-rw-r--r--
kconv.rb	5.74 KB	-rw-r--r--
logger.rb	20.33 KB	-rw-r--r--
mathn.rb	3.84 KB	-rw-r--r--
matrix.rb	53.14 KB	-rw-r--r--
mkmf.rb	82.59 KB	-rw-r--r--
monitor.rb	6.93 KB	-rw-r--r--
mutex_m.rb	2 KB	-rw-r--r--
observer.rb	5.8 KB	-rw-r--r--
open-uri.rb	24.58 KB	-rw-r--r--
open3.rb	20.55 KB	-rw-r--r--
openssl.rb	528 B	-rw-r--r--
optionparser.rb	28 B	-rw-r--r--
optparse.rb	52.05 KB	-rw-r--r--
ostruct.rb	8.66 KB	-rw-r--r--
pathname.rb	15.58 KB	-rw-r--r--
pp.rb	14.16 KB	-rw-r--r--
prettyprint.rb	15.85 KB	-rw-r--r--
prime.rb	13.11 KB	-rw-r--r--
profile.rb	205 B	-rw-r--r--
profiler.rb	4.51 KB	-rw-r--r--
pstore.rb	14.55 KB	-rw-r--r--
psych.rb	14.88 KB	-rw-r--r--
rake.rb	2.23 KB	-rw-r--r--
rdoc.rb	4.96 KB	-rw-r--r--
resolv-replace.rb	1.73 KB	-rw-r--r--
resolv.rb	72.06 KB	-rw-r--r--
ripper.rb	2.53 KB	-rw-r--r--
rss.rb	2.84 KB	-rw-r--r--
rubygems.rb	31.85 KB	-rw-r--r--
scanf.rb	23.54 KB	-rw-r--r--
securerandom.rb	9.2 KB	-rw-r--r--
set.rb	19.15 KB	-rw-r--r--
shell.rb	11.3 KB	-rw-r--r--
shellwords.rb	5.96 KB	-rw-r--r--
singleton.rb	4.02 KB	-rw-r--r--
socket.rb	25.6 KB	-rw-r--r--
sync.rb	7.25 KB	-rw-r--r--
tempfile.rb	11.11 KB	-rw-r--r--
thwait.rb	3.31 KB	-rw-r--r--
time.rb	22.25 KB	-rw-r--r--
timeout.rb	3.64 KB	-rw-r--r--
tmpdir.rb	4.13 KB	-rw-r--r--
tracer.rb	6.4 KB	-rw-r--r--
tsort.rb	14.27 KB	-rw-r--r--
ubygems.rb	268 B	-rw-r--r--
un.rb	8.87 KB	-rw-r--r--
unicode_normalize.rb	3.16 KB	-rw-r--r--
uri.rb	3.07 KB	-rw-r--r--
weakref.rb	2.92 KB	-rw-r--r--
webrick.rb	6.69 KB	-rw-r--r--
xmlrpc.rb	8.49 KB	-rw-r--r--
yaml.rb	1.7 KB	-rw-r--r--

Code Editor : xmlrpc.rb

# == 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/ruby/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 Authentication
#   * 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

${this.title}

Code Editor : xmlrpc.rb