net.ponder2
Interface PonderTalkInterface

All Superinterfaces:

java.rmi.Remote

public interface PonderTalkInterface
extends java.rmi.Remote

Interface for sending PonderTalk to the SMC. Retruns the result as a string if it is sucessful otherwise it throws a RemoteException

Version:

$Id:$

Author:

Kevin Twidle

Method Summary

java.lang.String	compile(java.lang.String ponderTalk) Takes a PonderTalk string and compiles it to internal XML.
java.lang.String	execute(java.lang.String ponderTalk) Takes a PonderTalk string, compiles and executes it.
java.lang.String	executeXML(java.lang.String xml) Takes a Ponder2 internal XML execution structure as a string, executes it and returns the result as a string.

Method Detail

execute

java.lang.String execute(java.lang.String ponderTalk)
                         throws java.rmi.RemoteException

Takes a PonderTalk string, compiles and executes it. Returns the result at a string.

Parameters:

ponderTalk - a string containing one or more PonderTalk statements separated by full-stops (periods).

Returns:

the result of the operation as a string

Throws:

java.rmi.RemoteException - if something goes wrong

compile

java.lang.String compile(java.lang.String ponderTalk)
                         throws java.rmi.RemoteException

Takes a PonderTalk string and compiles it to internal XML. The XML is returned as a string.

Parameters:

ponderTalk - a string containing one or more PonderTalk statements separated by full-stops (periods).

Returns:

the XML result of the compilation as a string

Throws:

java.rmi.RemoteException - if something goes wrong

executeXML

java.lang.String executeXML(java.lang.String xml)
                            throws java.rmi.RemoteException

Takes a Ponder2 internal XML execution structure as a string, executes it and returns the result as a string.

Parameters:

xml - a string containing a single XML structure to be executed

Returns:

the result of the operation as a string

Throws:

java.rmi.RemoteException - if something goes wrong