uk.ac.cam.cl.whb21.iworkbook
Interface AppletXmlRpcCaller

All Known Implementing Classes:

ClientControllerApplet, ServerClientTranslationApplet

public interface AppletXmlRpcCaller

Interface for allowing limited bidirectional XML-RPC support to an applet.

Applets can make actionCalls to the server. These actionCalls permit the server to return a list of XML strings, which are treated as if they were XML-RPC calls the server was making to the client. Applets can also make returnCalls, which are ordinary XML-RPC calls.

Author:

William Billingsley

Method Summary

void	actionCall(java.lang.String name, java.util.Vector arguments) Implements an XML-RPC call to the server where the server's return object is expected to be a set of XML-RPC calls.
java.lang.Object	returnCall(java.lang.String name, java.util.Vector arguments) Implements an ordinary XML-RPC call to the server, expecting a return object back.
void	testResponseCall(java.lang.String response) Does not perform an XMLRPC, but behaves as if it has just received the response from an actionCall.

Method Detail

returnCall

public java.lang.Object returnCall(java.lang.String name,
                                   java.util.Vector arguments)

Implements an ordinary XML-RPC call to the server, expecting a return object back.

Parameters:

name - - the name of the server function to call.

arguments - - the arguments to call the function with.

Returns:

the returned object.

actionCall

public void actionCall(java.lang.String name,
                       java.util.Vector arguments)

Implements an XML-RPC call to the server where the server's return object is expected to be a set of XML-RPC calls. The calling applet will not receive a return object. The class which implements AppletXmlRpcCaller will interpret the returned XML and make calls to applets accordingly (as if the XML was a list of XML-RPCs the server was making to the client).

Parameters:

name - - the name of the server function to call.

arguments - - the arguments to call the function with.

testResponseCall

public void testResponseCall(java.lang.String response)

Does not perform an XMLRPC, but behaves as if it has just received the response from an actionCall.

Parameters:

response - - the faked up response