org.xmlecho.palomar
Interface ECHOConnection

All Known Implementing Classes:

ECHOConnectionImpl

public interface ECHOConnection

A connection to an ECHO Processor for a given User.

Method Summary

void	evalECHOString(java.lang.String request, org.xml.sax.ContentHandler response, ECHOContext context) treats the string as a well-formed ECHO command, wraps it in an ECHO Request object, and sends it to an ECHO processor for evaluation
void	evalECHOToSAX(org.xml.sax.XMLReader request, org.xml.sax.InputSource src, org.xml.sax.ContentHandler result, ECHOContext context) evaluates the ECHO request with the current context.
ECHOContext	getBaseContext() returns the original context, with bindings for the connection parameters.
User	getConnectedUser()
XProcessor	getECHO() return the ECHO XProcessor for this connection.
ECHOContext	getExtendedContext() returns a new context, with bindings for the connection parameters, and ready for extending with scoped bindings.

Method Detail

getConnectedUser

public User getConnectedUser()

Returns:

the User associated with this connection

getBaseContext

public ECHOContext getBaseContext()

returns the original context, with bindings for the connection parameters. Bindings made in this context persist for for the lifetime of this connection.

getExtendedContext

public ECHOContext getExtendedContext()

returns a new context, with bindings for the connection parameters, and ready for extending with scoped bindings.

evalECHOString

public void evalECHOString(java.lang.String request,
                           org.xml.sax.ContentHandler response,
                           ECHOContext context)
                    throws java.lang.Exception

treats the string as a well-formed ECHO command, wraps it in an ECHO Request object, and sends it to an ECHO processor for evaluation

Throws:

java.lang.Exception

evalECHOToSAX

public void evalECHOToSAX(org.xml.sax.XMLReader request,
                          org.xml.sax.InputSource src,
                          org.xml.sax.ContentHandler result,
                          ECHOContext context)
                   throws ECHOException

evaluates the ECHO request with the current context. writing the result as to the given ContentHandler

Throws:

ECHOException

getECHO

public XProcessor getECHO()

return the ECHO XProcessor for this connection.