*/
class XMLRPC extends JS {
- /** the url to connect to */
- protected String url = null;
+ public XMLRPC(String url, String method) { this(url, method, new HTTP(url)); }
+ public XMLRPC(String url, String method, HTTP http) { this.http = http; this.url = url; this.method = method; }
+ public Object get(Object name) { return new XMLRPC(url, (method.equals("") ? "" : method + ".") + name.toString(), http); }
- /** the method name to invoke on the remove server */
- protected String methodname = null;
/** this holds character content as we read it in -- since there is only one per instance, we don't support mixed content */
protected AccessibleCharArrayWriter content = new AccessibleCharArrayWriter(100);
+ protected String url = null; ///< the url to connect to
+ protected String method = null; ///< the method name to invoke on the remove server
+ protected HTTP http = null; ///< the HTTP connection to use
+ private Hash tracker; ///< used to detect multi-ref data
+ protected boolean fault = false; ///< True iff the return value is a fault (and should be thrown as an exception)
- /** the HTTP connection to use */
- protected HTTP http = null;
/** The object stack. As we process xml elements, pieces of the
* return value are pushed onto and popped off of this stack.
*/
protected Vec objects = null;
- /** used to detect multi-ref data */
- private Hash tracker;
- /** True iff the return value is a fault (and should be thrown as an exception) */
- protected boolean fault = false;
-
-
- // Methods to Recieve and parse XML-RPC Response ////////////////////////////////////////////////////
+ // Recieve ////////////////////////////////////////////////////////////////
private class Helper extends XML {
public Helper() { super(BUFFER_SIZE); }
public void startElement(XML.Element c) {
content.reset();
- //#switch(c.localName)
+ //#switch(c.getLocalName())
case "fault": fault = true;
case "struct": objects.setElementAt(new JS(), objects.size() - 1);
case "array": objects.setElementAt(null, objects.size() - 1);
}
public void endElement(XML.Element c) {
- //#switch(c.localName)
+ //#switch(c.getLocalName())
case "int": objects.setElementAt(new Integer(new String(content.getBuf(), 0, content.size())), objects.size() - 1);
case "i4": objects.setElementAt(new Integer(new String(content.getBuf(), 0, content.size())), objects.size() - 1);
case "boolean": objects.setElementAt(content.getBuf()[0] == '1' ? Boolean.TRUE : Boolean.FALSE, objects.size() - 1);
objects.setElementAt(nd, objects.size() - 1);
} catch (Exception e) {
- if (Log.on) Log.log(this, "error parsing date : " + s);
- if (Log.on) Log.log(this, e);
+ if (Log.on) Log.info(this, "error parsing date : " + s);
+ if (Log.on) Log.info(this, e);
}
case "member":
Object memberValue = objects.elementAt(objects.size() - 1);
public void characters(char[] ch, int start, int length) {
try { content.write(ch, start, length); }
catch (Exception e) {
- if (Log.on) Log.log(this, "Exception in XMLRPC.content() -- this should never happen");
- if (Log.on) Log.log(this, e);
+ if (Log.on) Log.info(this, "Exception in XMLRPC.content() -- this should never happen");
+ if (Log.on) Log.info(this, e);
}
}
public void whitespace(char[] ch, int start, int length) {}
}
- // Methods to make outbound XML-RPC request ///////////////////////////////////////////////////
+ // Send ///////////////////////////////////////////////////////////////////////////
+
+ protected String buildRequest(JSArray args) throws JSExn, IOException {
+ StringBuffer content = new StringBuffer();
+ content.append("\r\n");
+ content.append("<?xml version=\"1.0\"?>\n");
+ content.append(" <methodCall>\n");
+ content.append(" <method>");
+ content.append(method);
+ content.append("</method>\n");
+ content.append(" <params>\n");
+ for(int i=0; i<args.length(); i++) {
+ content.append(" <param>\n");
+ appendObject(args.elementAt(i), content);
+ content.append(" </param>\n");
+ }
+ content.append(" </params>\n");
+ content.append(" </methodCall>");
+ return content.toString();
+ }
/** Appends the XML-RPC representation of <code>o</code> to <code>sb</code> */
void appendObject(Object o, StringBuffer sb) throws JSExn {
}
sb.append("\n </base64></value>\n");
} catch (IOException e) {
- if (Log.on) Log.log(this, "caught IOException while attempting to send a ByteStream via XML-RPC");
- if (Log.on) Log.log(this, e);
+ if (Log.on) Log.info(this, "caught IOException while attempting to send a ByteStream via XML-RPC");
+ if (Log.on) Log.info(this, e);
throw new JSExn("caught IOException while attempting to send a ByteStream via XML-RPC");
}
}
}
- public Object call_(JSArray args) throws JSExn, IOException {
- if (Log.verbose) Log.log(this, "call to " + url + " : " + methodname);
-
- if (tracker == null) tracker = new Hash();
- else tracker.clear();
-
- if (objects == null) objects = new Vec();
- else objects.setSize(0);
- final String content = send(args, http);
- if (Log.verbose) {
- String s;
- BufferedReader br2 = new BufferedReader(new StringReader(content));
- while ((s = br2.readLine()) != null) Log.log(this, "send: " + s);
- }
-
- InputStream is = http.POST("text/xml", content);
- try {
- BufferedReader br = !Log.verbose ?
- new BufferedReader(new InputStreamReader(is)) :
- new BufferedReader(new FilterReader(new InputStreamReader(is)) {
- public int read() throws IOException {
- int i = super.read();
- if (Log.on) Log.log(this, "recv: " + ((char)i));
- return i;
- }
- public int read(char[] c, int off, int len) throws IOException {
- int ret = super.read(c, off, len);
- if (ret == -1) return ret;
- String s;
- BufferedReader br2 = new BufferedReader(new StringReader(new String(c, off, ret)));
- while ((s = br2.readLine()) != null) Log.log(this, "recv: " + s);
- return ret;
- }
- });
- return null;
- } finally {
- is.close();
- }
- }
-
- protected String send(JSArray args, HTTP http) throws JSExn, IOException {
- StringBuffer content = new StringBuffer();
- content.append("\r\n");
- content.append("<?xml version=\"1.0\"?>\n");
- content.append(" <methodCall>\n");
- content.append(" <methodName>");
- content.append(methodname);
- content.append("</methodName>\n");
- content.append(" <params>\n");
- for(int i=0; i<args.length(); i++) {
- content.append(" <param>\n");
- appendObject(args.elementAt(i), content);
- content.append(" </param>\n");
- }
- content.append(" </params>\n");
- content.append(" </methodCall>");
- return content.toString();
- }
-
- protected Object recieve(BufferedReader br) throws JSExn, IOException {
- // parse XML reply
- try {
- new Helper().parse(br);
- } catch (XML.XMLException e) {
- if (Log.on) Log.log(this, "reply from server was not well-formed XML: " + e);
- throw new JSExn("reply from server was not well-formed XML: " + e);
- }
-
- if (fault) throw new JSExn(objects.elementAt(0));
- if (objects.size() == 0) return null;
- return objects.elementAt(0);
- }
+ // Call Sequence //////////////////////////////////////////////////////////////////////////
public final Object call(Object a0, Object a1, Object a2, Object[] rest, int nargs) throws JSExn {
JSArray args = new JSArray();
for(int i=0; i<nargs; i++) args.addElement(i==0?a0:i==1?a1:i==2?a2:rest[i-3]);
return call(args);
}
+
public final Object call(final JSArray args) throws JSExn {
try {
final JS.UnpauseCallback callback = JS.pause();
- new java.lang.Thread() {
- public void run() {
- try {
- try {
- final Object ret = call_(args);
- Scheduler.add(new Scheduler.Task() {
- public void perform() {
- try {
- callback.unpause(null);
- } catch (JS.PausedException pe) {
- // okay
- } catch (JSExn e) {
- // FIXME
- throw new Error("FIXME");
- }
- }
- });
- } catch (IOException se) {
- if (Log.on) Log.log(this, se);
- throw new JSExn("socket exception: " + se);
- }
- } catch (JSExn e) {
- // FIXME
- throw new Error("FIXME");
- }
- } }.start();
- return null;
+ new java.lang.Thread() { public void run() { call(callback, args); } }.start();
+ return null; // doesn't matter since we paused
} catch (NotPauseableException npe) {
throw new JSExn("cannot invoke an XML-RPC call in the foreground thread");
}
}
- /** When you get a property from an XMLRPC, it just returns another XMLRPC with the property name tacked onto methodname. */
- public Object get(Object name) {
- return new XMLRPC(url, (methodname.equals("") ? "" : methodname + ".") + name.toString(), http);
- }
-
- public XMLRPC(String url, String methodname) {
- this(url, methodname, new HTTP(url));
- }
-
- public XMLRPC(String url, String methodname, HTTP http) {
- this.http = http;
- this.url = url;
- this.methodname = methodname;
- }
-
-
- // Helper Classes ///////////////////////////////////////////////////////////////////////////////////
-
- /** CharArrayWriter that lets us touch its buffer */
- protected static class AccessibleCharArrayWriter extends CharArrayWriter {
- public char[] getBuf() { return buf; }
- public AccessibleCharArrayWriter(int i) { super(i); }
+ final void call(final JS.UnpauseCallback callback, final JSArray args) {
+ try {
+ if (Log.verbose) Log.info(this, "call to " + url + " : " + method);
+ String request = buildRequest(args);
+ if (Log.verbose) Log.info(this, "send:\n" + request);
+ InputStream is = http.POST("text/xml", request);
+ BufferedReader br = new BufferedReader(new InputStreamReader(is));
+ if (tracker == null) tracker = new Hash();
+ if (objects == null) objects = new Vec();
+ try {
+ new Helper().parse(br);
+ final Object result = fault ? new JSExn(objects.elementAt(0)) : objects.size() == 0 ? null : objects.elementAt(0);
+ Scheduler.add(new Scheduler.Task() { public void perform() throws Exception { callback.unpause(result); }});
+ } finally {
+ tracker.clear();
+ objects.setSize(0);
+ }
+ } catch (final JSExn e) {
+ Scheduler.add(new Scheduler.Task() { public void perform() throws Exception { callback.unpause(e); }});
+ } catch (final IOException e) {
+ Scheduler.add(new Scheduler.Task() { public void perform() throws Exception { callback.unpause(new JSExn(e)); }});
+ } catch (final XML.Exn e) {
+ Scheduler.add(new Scheduler.Task() { public void perform() throws Exception { callback.unpause(new JSExn(e)); }});
+ }
}
-
}