| |
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 |
|