daveb
committed
on 11 Jul 01
Initial import of ns_xmlrpc code.
ns_xmlrpc/README (+42 -1)
1   RBM: Placeholder file for the ns_xmlrpc module. Change this later :)
  1 ns_xmlrpc --    adds XML-RPC server and client features to
  2                 AOLserver/OpenACS
  3
  4 Requirements:   ns_xml 1.3
  5                 AOLserver 3. using nsd8x
  6                 OpenACS 3.2.5
  7
  8 Setup:  Copy the Tcl files into your private Tcl library, ie. /web/yoursite/tcl
  9         and start/restart AOLserver
  10
  11         To test the server go to http://validator.xmlrpc.com. Enter the
  12         domain of your server and click the validate button. Hopefully
  13         everything works. If it doesn't, check your server error log.
  14
  15         Call xmlrpc_register_proc with the procedure name for every Tcl
  16         procedure you want to be made available via XML-RPC.
  17
  18 How it works:   A registered proc is setup in validator.tcl that sends all
  19                 HTTP requests to /RPC2 to the XML-RPC handler. It checks to
  20                 make sure the methodName is registered as available via
  21                 XML-RPC. If the methodName is valid the XML-RPC request is
  22                 parsed and the parameters are passed to the procedure.
  23
  24                 The procedure does whatever processing is necessary and returns
  25                 a result to the XML-RPC handler which builds an XML-RPC
  26                 methodResponse and returns it.
  27
  28 Credits:        Ns_xml conversion by Dave Bauer (dave@thedesignexperience.org)
  29                 with help from Jerry Asher (jerry@theashergroup.com).
  30                 This code is based on the original Tcl-RPC by Steve Ball
  31                 with contributions by Aaron Swartz. The original Tcl-RPC
  32                 uses TclXML and TclDOM to parse the XML. It works fine but
  33                 since OpenACS-4 will use ns_xml I converted it.
  34                 
  35 Reference:      XML-RPC spec: http://www.xmlrpc.com/spec
  36                 OpenACS: http://openacs.org
  37                 AOLserver: http://www.aolserver.com     
  38                 OpenNSD: http://www.opennsd.org
  39                 ns_xml: http://acs-misc.sourceforge.net
  40
  41
  42