Skip Headers

Oracle9i XML API Reference - XDK and Oracle XML DB
Release 2 (9.2)

Part Number A96616-01
Go To Documentation Library
Home
Go To Product List
Book List
Go To Table Of Contents
Contents
Go To Index
Index

Master Index

Feedback

Go to previous page Go to next page

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:


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:

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:

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

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.


Go to previous page Go to next page
Oracle
Copyright © 2001, 2002 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Home
Go To Product List
Book List
Go To Table Of Contents
Contents
Go To Index
Index

Master Index

Feedback