oracle.xml.xsql
Interface XSQLActionHandler

All Known Implementing Classes:

XSQLActionHandlerImpl

public interface XSQLActionHandler

Interface that must be implemented by all XSQL Action Element Handlers

Upon encountering an XSQL Action Element of the form <xsql:xxxx> in an XSQL page, the XSQL Page Processor invokes the associated XSQL Action Handler by:

1. Constructing an instance of the handler using the no-args constructor
2. Invoking the XSQL Action Handler's init() method
3. Invoking the XSQL Action Handler's handleAction() method

NOTE: conn parameter can be null if no connection specified for the XSQL page being processed.

Method Summary

void	handleAction(Node rootNode) Handle the action, typically by executing some code and appending new child DOM nodes to the rootNode.
void	init(XSQLPageRequest env, Element e) Initialize the Action Handler

Method Detail

init

public void init(XSQLPageRequest env,
                 Element e)

Initialize the Action Handler

Parameters:

env - XSQLPageRequest object

e - DOM element representing the Action Element being handled

handleAction

public void handleAction(Node rootNode)
                  throws java.sql.SQLException

Handle the action, typically by executing some code and appending new child DOM nodes to the rootNode.

The XSQL Page Processor replaces the action element in the XSQL Page being processed with the document fragment of nodes that your handleAction method appends to the rootNode.

Parameters:

rootNode - Root node of generated document fragment

Throws:

java.sql.SQLException