9
XSQL Pages Publishing Framework for Java

The XSQL Pages Publishing Framework is contained in the oracle.xml.xsql package, also known as Oracle XSQL Servlet.

This chapter describes the following sections:

• XSQLActionHandler Interface
• XSQLActionHandlerImpl Class
• XSQLPageRequest Interface
• XSQLParserHelper Class
• XSQLRequest Class
• XSQLRequestObjectListener Interface
• XSQLServletPageRequest Class
• XSQLStylesheetProcessor Class
• XSQLConnectionManager Interface
• XSQLConnectionManagerFactory Interface
• XSQLDocumentSerializer Interface

  See Also: Oracle9i XML Developer's Kits Guide - XDK Oracle9i Supplied Java Packages Reference

---

oracle.xml.xsql Package

---

Description of oracle.xml.xsql

The Oracle XSQL Pages Publishing Framework engine. Table 9-1 summarizes the classes and interfaces of this package.

Table 9-1 Summary of Classes and Interfaces of oracle.xml.xsql

Class/Interface	Description
XSQLActionHandler Interface	Interface that must be implemented by all XSQL Action Element Handlers
XSQLActionHandlerImpl Class	Base Implementation of XSQLActionHandler that can be extended to create your own custom handlers.
XSQLPageRequest Interface	Interface representing a request for an XSQL Page
XSQLParserHelper Class	Common XML Parsing Routines
XSQLRequest Class	Programmatically process a request for an XSQL Page.
XSQLRequestObjectListener Interface	Interface that an object created by an action handler. Can implement to be notified when the current page request processing is completed.
XSQLServletPageRequest Class	Implementation of XSQLPageRequest for Servlet-based XSQL Page requests.
XSQLStylesheetProcessor Class	XSLT Stylesheet Processing Engine
XSQLConnectionManager Interfacet	Must be implemented to override the built-in connection manager implementation.
XSQLConnectionManagerFactory Interface	Must be implemented to override the built-in connection manager implementation.
XSQLDocumentSerializer Interface	Must be implemented by all XSQL Serializers which serialize an XSQL data page as an XML Document to a PrintWriter.

---

XSQLActionHandler Interface

---

Description of 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:

• Constructing an instance of the handler using the no-args constructor
• Invoking the XSQL Action Handler's handleAction() method

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

---

Syntax of XSQLActionHandler

public interface XSQLActionHandler

---

Implementing Classes of XSQLActionHandler

XSQLActionHandlerImpl Class

---

Methods of XSQLActionHandler

Table 9-2 Summary of Methods of XSDLAction Handler

Method	Description
handleAction()	Handle the action, typically by executing some code and appending new child DOM nodes to the rootNode.
init()	Initializes the Action Handler.

handleAction()

Description

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.

Syntax

public void handleAction( oracle.xml.xsql.Node rootNode);

Parameter	Description
rootNode	Root node of generated document fragment.

init()

Description

Initializes the Action Handler

Syntax

public void init( XSQLPageRequest env, 
                  oracle.xml.xsql.Element e);

Parameter	Description
env	XSQLPageRequest object.
e	DOM element representing the Action Element being handled.

---

XSQLActionHandlerImpl Class

---

Description of XSQLActionHandlerImpl

Base Implementation of XSQLActionHandler that can be extended to create custom handlers. Includes a set of useful helper methods. If there is an intent to extend this class and override the init() method, a call must be made to super.init(env,e).

---

Syntax of XSQLActionHandlerImpl

public abstract class XSQLActionHandlerImpl extends java.lang.Object implements 
XSQLActionHandler Interface
 
java.lang.Object
  |
  +--oracle.xml.xsql.XSQLActionHandlerImpl

---

Implemented Interfaces of XSQLActionHandlerImpl

XSQLActionHandler Interface

---

Methods of XSQLActionHandlerImpl

Table 9-3 Summary of Methods of XSQLActionHandlerImp  

Method	Description
XSQLActionHandlerImpl()	Class constructor.
init()	Initializes the action handler.

XSQLActionHandlerImpl()

Description

Class constructor.

Syntax

public  XSQLActionHandlerImpl();

init()

Description

Initializes the action handler.

Syntax

public void init( XSQLPageRequest env,
                  oracle.xml.xsql.Element e);

Parameter	Description
env	The XSQLPageRequest context.
e	The action element

---

XSQLPageRequest Interface

---

Description of XSQLPageRequest

Interface representing a request for an XSQL Page.

---

Syntax of XSQLPageRequest

public interface XSQLPageRequest

---

Implementing Classes of XSQLPageRequest

XSQLPageRequestImpl Class

---

Methods of XSQLPageRequest

Table 9-4 Summary of Methods of XSQLPageRequest()  

Method	Description
createNestedRequest()	Returns an instance of a nested Request
getConnectionName()	Returns the name of the connection being used for this request May be null if no connection set/in-use.
getErrorWriter()	Returns a PrintWriter to print out errors processing this request
getJDBCConnection()	Gets the JDBC connection being used for this request (can be null)
getPageEncoding()	Returns encoding of source XSQL Page associated with this request
getParameter()	Returns the value of the requested parameter
getPostedDocument()	Returns the content of Posted XML for this request as an XML Document
getRequestParamsAsXMLDocument()	Returns the content of a Request parameters as an XML Document
getRequestType()	Returns a string identifying the type of page request being made.
getSourceDocumentURI()	Returns a String representation of the requested document's URI
getStylesheetParameter()	Gets a stylesheet parameter by name
getStylesheetParameters()	Gets an enumeration of stylesheet parameter names
getStylesheetURI()	Returns the URI of the stylesheet to be used to process the result.
getUserAgent()	Returns a String identifier of the requesting program
getWriter()	Returns a PrintWriter used for writing out the results of a page request
getXSQLConnection()	Gets the XSQLConnection Object being used for this request Might be null.
isIncludedRequest()	Returns true if this request is being included in another.
isOracleDriver()	Returns true if the current connection uses the Oracle JDBC Driver
printedErrorHeader()	Returns the state of whether an Error Header has been printed
requestProcessed()	Allows Page Request to Perform end-of-request processing
setConnectionName()	Sets the connection name to use for this request
setContentType()	Sets the content type of the resulting page
setIncludingRequest()	Sets the Including Page Request object for this request.
setPageEncoding()	Sets encoding of source XSQL page associated with this request.
setPageParam()	Sets a dynamic page parameter value.
setPostedDocument()	Allows programmatic setting of the Posted Document
setPrintedErrorHeader()	Sets whether an Error Header has been printed
setStylesheetParameter()	Sets the value of a parameter to be passed to the associated stylesheet
setStylesheetURI()	Sets the URI of the stylesheet to be used to process the result.
translateURL()	Returns a string representing an absolute URL resolved relative to the base URI for this request.
useConnectionPooling()	Returns true if connection pooling is desired for this request
useHTMLErrors()	Returns true if HTML-formatted error messages are desired for this request.
setRequestObject()	Sets a request-scope object.
getRequestObject()	Gets a request-scope object.

createNestedRequest()

Description

Returns an instance of a nested Request.

Syntax

public XSQLPageRequest createNestedRequest(
                   java.net.URL pageurl,
                   java.util.Dictionary params);

Parameter	Description
pageurl	The URL of the nested request.
params	Optional dictionary of additional parameters.

getConnectionName()

Description

Returns the name of the connection being used for this request May be null if no connection set/in-use.

Syntax

public java.lang.String getConnectionName();

getErrorWriter()

Description

Returns a PrintWriter to print out errors processing this request.

Syntax

public java.io.PrintWriter getErrorWriter();

getJDBCConnection()

Description

Gets the JDBC connection being used for this request (can be null).

Syntax

public java.sql.Connection getJDBCConnection();

getPageEncoding()

Description

Returns encoding of source XSQL Page associated with this request.

Syntax

public java.lang.String getPageEncoding();

getParameter()

Description

Returns the value of the requested parameter.

Syntax

public String getParameter( String name);

Parameter	Description
name	The name of the parameter.

getPostedDocument()

Description

Returns the content of Posted XML for this request as an XML Document.

Syntax

public oracle.xml.xsql.Document getPostedDocument();

getRequestParamsAsXMLDocument()

Description

Returns the content of a Request parameters as an XML Document.

Syntax

public oracle.xml.xsql.Document getRequestParamsAsXMLDocument();

getRequestType()

Description

Returns a string identifying the type of page request being made.

Syntax

public String getRequestType();

getSourceDocumentURI()

Description

Returns a String representation of the requested document's URI.

Syntax

public String getSourceDocumentURI();

getStylesheetParameter()

Description

Gets a stylesheet parameter by name.

Syntax

public String getStylesheetParameter( String name);

Parameter	Description
name	The stylesheet parameter name.

getStylesheetParameters()

Description

Gets an enumeration of stylesheet parameter names.

Syntax

public java.util.Enumeration getStylesheetParameters();

getStylesheetURI()

Description

Returns the URI of the stylesheet to be used to process the result.

Syntax

public java.lang.String getStylesheetURI();

getUserAgent()

Description

Returns a String identifier of the requesting program.

Syntax

public java.lang.String getUserAgent();

getWriter()

Description

Returns a PrintWriter used for writing out the results of a page request.

Syntax

public java.io.PrintWriter getWriter();

getXSQLConnection()

Description

Gets the XSQLConnection Object being used for this request Might be null.

Syntax

public oracle.xml.xsql.XSQLConnection getXSQLConnection();

isIncludedRequest()

Description

Returns true if this request is being included in another.

Syntax

public boolean isIncludedRequest();

isOracleDriver()

Description

Returns true if the current connection uses the Oracle JDBC Driver.

Syntax

public boolean isOracleDriver();

printedErrorHeader()

Description

Returns the state of whether an Error Header has been printed.

Syntax

public boolean printedErrorHeader();

requestProcessed()

Description

Allows Page Request to Perform end-of-request processing.

Syntax

public void requestProcessed();

setConnectionName()

Description

Sets the connection name to use for this request.

Syntax

public void setConnectionName( String connName);

Parameter	Description
connName	The name of the connection.

setContentType()

Description

Sets the content type of the resulting page.

Syntax

public void setContentType( String mimetype);

Parameter	Description
mimetype	The MIME type that describes the content of the resulting page.

setIncludingRequest()

Description

Sets the Including Page Request object for this request.

Syntax

public void setIncludingRequest( XMLPageRequest includingEnv);

Parameter	Description
includingEnv	The XSQLPageRequest context of the including page.

setPageEncoding()

Description

Sets encoding of source XSQL page associated with this request.

Syntax

public void setPageEncoding( String enc);

Parameter	Description
enc	The encoding of the current page.

setPageParam()

Description

Sets encoding of source XSQL page associated with this request.

Syntax

public void setPageParam( String name, String value);

Parameter	Description
name	The name of the page-private parameter.
value	The value of the page-private parameter.

setPostedDocument()

Description

Allows programmatic setting of the Posted Document.

Syntax

public void setPostedDocument( org.w3c.dom.Document doc);

Parameter	Description
doc	The XML document that has been posted as part of this request.

setPrintedErrorHeader()

Description

Sets whether an Error Header has been printed.

Syntax

public void setPrintedErrorHeader( boolean yes);

Parameter	Description
yes	Sets whether the error header has been printed.

setStylesheetParameter()

Description

Sets the value of a parameter to be passed to the associated stylesheet.

Syntax

public void setStylesheetParameter( java.lang.String name,
                                    java.lang.String value);

Parameter	Description
name	The name of the stylesheet parameter.
value	The value of the stylesheet parameter.

setStylesheetURI()

Description

Sets the URI of the stylesheet to be used to process the result.

Syntax

public void setStylesheetURI( String uri);

Parameter	Description
uri	The uri of the stylesheet to be used to transform this request.

translateURL()

Description

Returns a string representing an absolute URL resolved relative to the base URI for this request.

Syntax

public String translateURL( String url);

Parameter	Description
url	The url of the stylesheet to be used to translate this request.

useConnectionPooling()

Description

Returns true if connection pooling is desired for this request.

Syntax

public boolean useConnectionPooling();

useHTMLErrors()

Description

Returns true if HTML-formatted error messages are desired for this request.

Syntax

public boolean useHTMLErrors();

setRequestObject()

Description

Sets a request-scope object.

Syntax

void setRequestObject( String name,
                       Object obj);

Parameter	Description
name	Name of the request-scope object to set.
obj	The request-scope object itself.

getRequestObject()

Description

Gets a request-scope object.

Syntax

Object getRequestObject( String name);

Parameter	Description
name	Name of the request-scope object to retrieve.

---

XSQLParserHelper Class

---

Description of XSQLParserHelper

Common XML Parsing Routines.

---

Syntax of XSQLParserHelper

public final class XSQLParserHelper extends java.lang.Object
 
java.lang.Object
  |
  +--oracle.xml.xsql.XSQLParserHelper

---

Methods of XSQLParserHelper

Table 9-5 Summary of Methods of XSQLParserHelper  

Method	Description
XSQLParserHelper()	Class constructor.
newDocument()	Returns a new, empty XML document.
parse()	Parses an XML document from a variety of sources.
parseFromString()	Parses an XML document from a string.
print()	Prints an XML document.

XSQLParserHelper()

Description

Class constructor.

Syntax

public  XSQLParserHelper();

newDocument()

Description

Returns a new, empty XML document.

Syntax

public static oracle.xml.xsql.Document newDocument();

parse()

Description

Parses an XML document from a variety of sources. The options are described in the following table.

Syntax	Description
public static oracle.xml.xsql.Document parse( InputStream is, URL baseUrl, PrintWriter errorWriter);	Parses an XML document from an InputStream object.
public static oracle.xml.xsql.Document parse( Reader r, PrintWriter errorWriter);	Parses an XML document from a Reader object.
public static oracle.xml.xsql.Document parse( URL url, PrintWriter errorWriter);	Parses an XML document from a URL.

Parameter	Description
is	Input stream containing XML to parse.
baseUrl	The base URL of the XML document.
errorWriter	PrintWriter to receive any error messages.
r	Reader containing XML to parse.
url	URL of the XML document to parse.

parseFromString()

Description

Parses an XML document from a string. The options are described in the following table.

Syntax	Description
public static oracle.xml.xsql.Document parseFromString( StringBuffer xmlString, PrintWriter errorWriter);	Parses from a StringBuffer.
public static oracle.xml.xsql.Document parseFromString( String xmlString, PrintWriter errorWriter);	Parses from a String.

Parameter	Description
xmlString	String containing XML to parser.
errorWriter	PrintWriter to receive any error messages.

print()

Description

Prints an XML document.

Syntax

public static void print(  org.w3c.docm.Document doc,

                               java.io.PrintWriter out);

Parameter	Description
doc	The XML document to print.
out	The PrintWirter to use for serializing the document.

---

XSQLRequest Class

---

Description of XSQLRequest

Programmatically process a request for an XSQL Page.

---

Syntax of XSQLRequest

public class XSQLRequest extends java.lang.Object
 
java.lang.Object
  |
  +--oracle.xml.xsql.XSQLRequest

---

Methods of XSQLRequest

Table 9-6 Summary of Methods of XSQLRequest

Method	Description
XSQLRequest()	Class constructor. Create a Request for an XSQL Page
process()	Process the request, writing output/errors.
processToXML()	Process the request, writing output/errors.
setPostedDocument()	Programmatically set an XML Document to be treated the same as if it were posted as part of the request.

XSQLRequest()

Description

Constructs an instance of XSQLRequest from various sources.

Syntax

public  XSQLRequest( java.lang.String url);

Parameter	Description
url	The URL for the XSQL Page source to process.

process()

Description

Process the request, writing output/errors. The options are described in the following table.

Syntax	Description
public void process();	Process the request, writing output/errors to System.out/System.err.
public void process( Dictionary params);	Process the request, writing output/errors to System.out/System.err.
public void process( Dictionary params, PrintWriter out, PrintWriter err);	Process the request, writing output/errors to respective PrintWriters.
public void process( PrintWriter out, PrintWriter err);	Process the request, writing output/errors to respective PrintWriters.

Parameter	Description
params	Dictionary with XSQL Page parameters.
out	PrintWriter to use to write the resulting page results.
err	PrintWriter to use to write the resulting page errors.

processToXML()

Description

Process the request, writing output/errors. The options are described in the following table.

Syntax	Description
public org.w3c.dom.Document processToXML()	Process the request, writing output/errors to System.out/System.err
public org.w3c.dom.Document processToXML( Dictionary params)	Process the request, writing output/errors to System.out/System.err
public org.w3c.dom.Document processToXML( Dictionary params, PrintWriter err)	Process the request, writing output/errors to respective PrintWriters
public org.w3c.dom.Document processToXML( PrintWriter err);	Process the request, writing errors to respective PrintWriters

Parameter	Description
params	Dictionary with XSQL Page parameters
err	PrintWriter to use to write the resulting page errors

setPostedDocument()

Description

Programmatically set an XML Document to be treated the same as if it were posted as part of the request.

Syntax

public void setPostedDocument( org.w3c.dom.Document postedDoc)

Parameter	Description
postedDoc	DOM Document

---

XSQLRequestObjectListener Interface

---

Description of XSQLRequestObjectListener

Interface that an object created by an action handler. Can implement to be notified when the current page request processing is completed. Objects that implement this interface and which are added to the current request context using XSQLPageRequest::setRequestObject() will be notified when the page processing of the outermost page is completed.

---

Methods of XSQLRequestObjectListener

pageProcessingCompleted()

Description

Callback method that allows Request scope objects to be notified when the page processing is complete so they can clean up any allocated resources. Any request-scope object that implements the XSQLRequestObjectListener interface will be notified this manner.

Syntax

void pageProcessingCompleted();

---

XSQLServletPageRequest Class

---

Syntax of XSQLServletPageRequest

public final class XSQLServletPageRequest extends XSQLPageRequestImpl
 
java.lang.Object
  |
  +--XSQLPageRequestImpl
        |
        +--oracle.xml.xsql.XSQLServletPageRequest

---

Implemented Interfaces of XSQLServletPageRequest

XSQLPageRequest Interface

---

Methods of XSQLServletPageRequest

Table 9-7 Summary of Methods of XSQLServletPageRequest  

Method	Description
XSQLServletPageRequest()	Creates a Servlet-specific XSQL Page request.
createNestedRequest()	Returns an instance of a nested Request.
getCookie()	Gets a vale of an HTTP Request cookie.
getHttpServletRequest()	Get the HttpServletRequest that initiated this XSQL Page Request.
getHttpServletResponse()	Get the HttpServletResponse that is associated with this XSQL Page Request.
getParameter()	Use HTTP Parameters as the source of parameters instead.
getPostedDocument()	Retrieves a posted XML document for this request.
getRequestParamsAsXMLDocument()	Retrieves request parameters as an XML document.
getRequestType()	Returns the type of request.
getUserAgent()	Returns the user agent string passed in from the browser.
setContentType()	Sets the content type of the resulting page.
setPageEncoding()	Sets the page encoding.
translateURL()	Returns a string representing an absolute URL resolved relative to the base URI for this request.
useHTMLErrors()	Sets whether HTML-formatted errors should be used.

XSQLServletPageRequest()

Description

Creates a Servlet-specific XSQL Page request.

Syntax

public XSQLServletPageRequest( 
                    oracle.xml.xsql.HttpServletRequest req,
                    oracle.xml.xsql.HttpServletResponse resp);

Parameter	Description
req	Request.
resp	Response.

createNestedRequest()

Description

Returns an instance of a nested Request.

Syntax

public XSQLPageRequest createNestedRequest(
                    java.net.URL pageurl,
                    java.util.Dictionary params)

Parameter	Description
pageurl	Page URL.
prams	Parameters of the request.

getCookie()

Description

Gets a vale of an HTTP Request cookie.

Syntax

public java.lang.String getCookie(   String name);

Parameter	Description
name	Name of the cookie to get.

getHttpServletRequest()

Description

Get the HttpServletRequest that initiated this XSQL Page Request.

Syntax

public oracle.xml.xsql.HttpServletRequest getHttpServletRequest();

getHttpServletResponse()

Description

Get the HttpServletResponse that is associated with this XSQL Page Request.

Syntax

public oracle.xml.xsql.HttpServletResponse getHttpServletResponse();

getParameter()

Description

Use HTTP Parameters as the source of parameters instead.

Syntax

public java.lang.String getParameter( String name);

Parameter	Description
name	Name of the paramete4r whose value is to be retrieved.

getPostedDocument()

Description

Retrieves a posted XML document for this request. Returns NULL if there is none.

Syntax

public oracle.xml.xsql.Document getPostedDocument();

getRequestParamsAsXMLDocument()

Description

Retrieves request parameters as an XML document.

Syntax

public oracle.xml.xsql.Document getRequestParamsAsXMLDocument();

getRequestType()

Description

Returns the type of request ("Servlet", "Programmatic", "Command Line", or "Custorm").

Syntax

public java.lang.String getRequestType();

getUserAgent()

Description

Returns the user agent string passed in from the browser.

Syntax

public java.lang.String getUserAgent();

setContentType()

Description

Sets the content type of the resulting page.

Syntax

public void setContentType( String mimetype);

Parameter	Description
mimtype	The MIME type that describes the content of the resulting page.

setPageEncoding()

Description

Sets the page encoding.

Syntax

public void setPageEncoding( String enc);

Parameter	Description
enc	The page encoding.

translateURL()

Description

Returns a string representing an absolute URL resolved relative to the base URI for this request.

Syntax

public java.lang.String translateURL( String path);

Parameter	Description
path	The relative URL which will be translated to an absolute URL.

useHTMLErrors()

Description

Sets whether HTML-formatted errors should be used.

Syntax

public boolean useHTMLErrors();

---

XSQLStylesheetProcessor Class

---

Description of XSQLStylesheetProcessor

XSLT Stylesheet Processing Engine

---

Syntax of XSQLStylesheetProcessor

public final class XSQLStylesheetProcessor extends java.lang.Object
 
java.lang.Object
  |
  +--oracle.xml.xsql.XSQLStylesheetProcessor

---

Methods of XSQLStylesheetProcessor

Table 9-8 Summary of Methods of XSQLStylesheetProcessor  

Method	Description
XSQLStylesheetProcessor()	Processes CSLT stylesheet transformations.
processToDocument()	Transforms an XML document by an XSLT stylesheet and returns the result as an XML document.
processToWriter()	Transforms an CML Document by an XSLT stylesheet and writes the result to a PrintWriter.
getServletContext()	Gets the Http Servlet Context.

XSQLStylesheetProcessor()

Description

Processes CSLT stylesheet transformations.

Syntax

public  XSQLStylesheetProcessor();

processToDocument()

Description

Transforms an XML document by an XSLT stylesheet and returns the result as an XML document.

Syntax

public static oracle.xml.xsql.Document processToDocument(
                    org.w3c.dom.Document xml,
                    String xslURI,
                    XSQLPageResuest env);

Parameter	Description
xml	The XML document.
xslURI	The XSL stylesheet URI.
env	The XSQLPageRequest context.

processToWriter()

Description

Transforms an CML Document by an XSLT stylesheet and writes the result to a PrintWriter.

Syntax

public static void processToWriter( 
                    oracle.xml.xsql.Document xml,
                    String xslURI,
                    XSQLPageResuest env);

Parameter	Description
xml	The XML document.
xslURI	The XSL stylesheet URI.
env	The XSQLPageRequest context.

getServletContext()

Description

Gets the Http Servlet Context.

Syntax

javax.servlet.ServletContext getServletContext();

---

XSQLConnectionManager Interface

---

Description of XSQLConnectionManager

One of two interfaces that must be implemented to override the built-in connection manager implementation. The XSQL Page Processor asks the XSQLConnectionManagerFactory associated with each request to create() an instance of an XSQLConnectionManager to service the current request.

In multithreaded environments, the implementation of XSQLConnectionManager must insure that an XSQLConnection instance returned by getConnection() is not used by another thread until it has been released by the XSQL Page Processor after the call to releaseConnection().

---

Syntax of XSQLConnectionManager

public interface XSQLConnectionManager;

---

Method of XSQLConnectionManager

Table 9-9 Summary of Methods of XSQLConnectionManager

Method	Description
getConnection()	Gets a connection from the connection manager.
releaseConnection()	Releases the connection.

getConnection()

Description

Gets a connection from the connection manager.

Syntax

XSQLConnection getConnection( String connName,
                              XSQLPageRequest env);

Parameter	Description
connName	The connection name.
env	The XSQLPageRequest context.

releaseConnection()

Description

Releases the connection.

Syntax

void releaseConnection( XSQLConnection theConn,
                        XSQLPageRequest env);

Parameter	Description
theConn	The XSQL Connection object to be released.
env	The XSQLPageRequest context.

---

XSQLConnectionManagerFactory Interface

---

Description of XSQLConnectionManagerFactory

One of two interfaces that must be implemented to override the built-in connection manager implementation. The XSQL Page Processor asks the XSQLConnectionManagerFactory associated with each request to create() an instance of an XSQLConnectionManager to service the current request.

---

Syntax of XSQLConnectionManagerFactory

public interface XSQLConnectionManagerFactory

---

Methods of XSQLConnectionManagerFactory

create()

Description

Returns an instance of an XSQLConnectionManager. Implementation can decide whether it is a new XSQLConnectionManager or a shared singleton.

Syntax

XSQLConnectionManager create();

---

XSQLDocumentSerializer Interface

---

Description of XSQLDocumentSerializer

Interface that must be implemented by all XSQL Serializers which serialize an XSQL data page as an XML Document to a PrintWriter.

Upon encountering a serializer="XXX" pseudo-attribute in an <?xml-stylesheet?> processing instruction, the XSQL Page Processor invokes the associated serializer by:

• Constructing an instance of the serializer using the no-args constructor
• Invoking the XSQL document serializer's serialize() method

NOTE: An implementation of XSQLDocumentSerializer is expected to do the following actions.

• First, call env.setContentType() to set the content type
• Then, call env.getWriter() to get the Writer to write to

If the serializer throws an unhandled exception, the XSQL Page Processor will format the stacktrace.

See oracle.xml.xsql.src.serializers.XSQLSampleSerializer for an example.

---

Syntax of XSQLDocumentSerializer

public interface XSQLDocumentSerializer

---

Method of XSQLDocumentSerialize

serialize()

Description

Serializes the resulting XML document for the output writer.

Syntax

void serialize( org.w3c.dom.Document doc,
                XSQLPageRequest env);

Parameter	Description
doc	The XML document to serialize.
env	The XSQLPageRequest context.