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


Copyright © 2008 Imperial College. All Rights Reserved.