WebLogic Server 6.1 API Reference

weblogic.apache.xalan.transformer
Class ResultTreeHandler

java.lang.Object
  |
  +--weblogic.apache.xalan.transformer.QueuedEvents
        |
        +--weblogic.apache.xalan.transformer.ResultTreeHandler

public class ResultTreeHandler

extends weblogic.apache.xalan.transformer.QueuedEvents

implements org.xml.sax.ContentHandler, org.xml.sax.ext.LexicalHandler, TransformState

This class is a layer between the direct calls to the result tree content handler, and the transformer. For one thing, we have to delay the call to getContentHandler().startElement(name, atts) because of the xsl:attribute and xsl:copy calls. In other words, the attributes have to be fully collected before you can call startElement.

This class is based on an implementation from the Apache XML Project. In future releases the XML parser, XSLT processor, and associated classes will likely be updated to be based on a later version of the Apache implementations. Since Apache does not guarantee backwards compatibility between versions of their software, we cannot guarantee backwards compatibility of any of the classes contained in the weblogic.apache package or sub-packages.

Field Summary

ClonerToResultTree

m_cloner This class clones nodes to the result tree.

Constructor Summary

ResultTreeHandler()
Null constructor for object pooling.

ResultTreeHandler(TransformerImpl transformer, org.xml.sax.ContentHandler realHandler)
Create a new result tree handler.

Method Summary

void	addAttribute(org.w3c.dom.Attr attr) Copy an DOM attribute to the created output element, executing attribute templates as need be, and processing the xsl:use attribute.
void	addAttribute(java.lang.String uri, java.lang.String localName, java.lang.String rawName, java.lang.String type, java.lang.String value) Add an attribute to the end of the list.
void	addAttributes(org.w3c.dom.Node src) Copy DOM attributes to the result element.
protected void	addNSDeclsToAttrs() Add the attributes that have been declared to the attribute list.
void	characters(char[] ch, int start, int length) Bottleneck the characters event.
void	cloneToResultTree(org.w3c.dom.Node node, boolean shouldCloneAttributes) Clone an element with or without children.
void	comment(char[] ch, int start, int length) Bottleneck the comment event.
void	comment(java.lang.String data) Bottleneck the comment event.
void	endCDATA() End the CDATA characters.
void	endDocument() Bottleneck the endDocument event.
void	endDTD() End the DTD.
void	endElement(java.lang.String ns, java.lang.String localName, java.lang.String name) Bottleneck the endElement event.
void	endEntity(java.lang.String name) End an entity.
void	endPrefixMapping(java.lang.String prefix) End the scope of a prefix-URI mapping.
void	entityReference(java.lang.String name) Entity reference event.
void	flushPending() Flush the pending element.
void	flushPending(int type) Flush the pending element.
org.xml.sax.ContentHandler	getContentHandler() Return the current content handler.
org.w3c.dom.traversal.NodeIterator	getContextNodeList() Get the current context node list.
ElemTemplateElement	getCurrentElement() Retrieves the stylesheet element that produced the SAX event.
org.w3c.dom.Node	getCurrentNode() This method retrieves the current context node in the source tree.
ElemTemplate	getCurrentTemplate() This method retrieves the xsl:template that is in effect, which may be a matched template or a named template.
org.w3c.dom.Node	getMatchedNode() Retrieves the node in the source tree that matched the template obtained via getMatchedTemplate().
ElemTemplate	getMatchedTemplate() This method retrieves the xsl:template that was matched.
org.xml.sax.helpers.NamespaceSupport	getNamespaceSupport() Get the NamespaceSupport object.
java.lang.String	getNewUniqueNSPrefix() Get new unique namespace prefix.
MutableAttrListImpl	getPendingAttributes() Get the pending attributes.
java.lang.String	getPrefix(java.lang.String namespace) Given a namespace, try and find a prefix.
javax.xml.transform.Transformer	getTransformer() Get the TrAX Transformer object in effect.
int	getUniqueNSValue() Get a unique namespace value.
java.lang.String	getURI(java.lang.String prefix) Given a prefix, return the namespace,
void	ignorableWhitespace(char[] ch, int start, int length) Bottleneck the ignorableWhitespace event.
void	init(TransformerImpl transformer, org.xml.sax.ContentHandler realHandler) Initializer method.
boolean	isDefinedNSDecl(org.w3c.dom.Attr attr) Returns whether a namespace is defined
boolean	isDefinedNSDecl(java.lang.String rawName, java.lang.String value) Return whether or not a namespace declaration is defined
boolean	isElementPending() Tell if an element is pending, to be output to the result tree.
void	outputResultTreeFragment(XObject obj, XPathContext support) Given a result tree fragment, walk the tree and output it to the result stream.
void	processingInstruction(java.lang.String target, java.lang.String data) Bottleneck the processingInstruction event.
void	processNSDecls(org.w3c.dom.Node src) Copy xmlns: attributes in if not already in scope.
protected void	sendEndPrefixMappings() Add the attributes that have been declared to the attribute list.
protected void	sendStartPrefixMappings() Add the attributes that have been declared to the attribute list.
void	setContentHandler(org.xml.sax.ContentHandler ch) Set the current content handler.
void	setDocumentLocator(org.xml.sax.Locator locator) To fullfill the FormatterListener interface...
void	skippedEntity(java.lang.String name) Receive notification of a skipped entity.
void	startCDATA() Start the CDATACharacters.
void	startDocument() Bottleneck the startDocument event.
void	startDTD(java.lang.String s1, java.lang.String s2, java.lang.String s3) Start the DTD.
void	startElement(java.lang.String ns, java.lang.String localName, java.lang.String name, org.xml.sax.Attributes atts) Bottleneck the startElement event.
void	startEntity(java.lang.String name) Start an entity.
void	startPrefixMapping(java.lang.String prefix, java.lang.String uri) Begin the scope of a prefix-URI Namespace mapping.
void	startPrefixMapping(java.lang.String prefix, java.lang.String uri, boolean shouldFlush) Begin the scope of a prefix-URI Namespace mapping.

Methods inherited from class weblogic.apache.xalan.transformer.QueuedEvents

reInitEvents, reset

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

m_cloner

public ClonerToResultTree m_cloner

This class clones nodes to the result tree.

Constructor Detail

ResultTreeHandler

public ResultTreeHandler()

Null constructor for object pooling.

ResultTreeHandler

public ResultTreeHandler(TransformerImpl transformer,
                         org.xml.sax.ContentHandler realHandler)

Create a new result tree handler. The real content handler will be the ContentHandler passed as an argument.

Parameters:

transformer - non-null transformer instance

realHandler - Content Handler instance

Method Detail

init

public void init(TransformerImpl transformer,
                 org.xml.sax.ContentHandler realHandler)

Initializer method.

Parameters:

transformer - non-null transformer instance

realHandler - Content Handler instance

startDocument

public void startDocument()
                   throws org.xml.sax.SAXException

Bottleneck the startDocument event.

Specified by:

startDocument in interface org.xml.sax.ContentHandler

Throws:

org.xml.sax.SAXException -

endDocument

public void endDocument()
                 throws org.xml.sax.SAXException

Bottleneck the endDocument event. This may be called more than once in order to make sure the pending start document is called.

Specified by:

endDocument in interface org.xml.sax.ContentHandler

Throws:

org.xml.sax.SAXException -

startElement

public void startElement(java.lang.String ns,
                         java.lang.String localName,
                         java.lang.String name,
                         org.xml.sax.Attributes atts)
                  throws org.xml.sax.SAXException

Bottleneck the startElement event. This is used to "pend" an element, so that attributes can still be added to it before the real "startElement" is called on the result tree listener.

Specified by:

startElement in interface org.xml.sax.ContentHandler

Parameters:

ns - Namespace URI of element

localName - Local part of qname of element

name - Name of element

atts - List of attributes for the element

Throws:

org.xml.sax.SAXException -

endElement

public void endElement(java.lang.String ns,
                       java.lang.String localName,
                       java.lang.String name)
                throws org.xml.sax.SAXException

Bottleneck the endElement event.

Specified by:

endElement in interface org.xml.sax.ContentHandler

Parameters:

ns - Namespace URI of element

localName - Local part of qname of element

name - Name of element

Throws:

org.xml.sax.SAXException -

startPrefixMapping

public void startPrefixMapping(java.lang.String prefix,
                               java.lang.String uri)
                        throws org.xml.sax.SAXException

Begin the scope of a prefix-URI Namespace mapping.

The information from this event is not necessary for normal Namespace processing: the SAX XML reader will automatically replace prefixes for element and attribute names when the http://xml.org/sax/features/namespaces feature is true (the default).

There are cases, however, when applications need to use prefixes in character data or in attribute values, where they cannot safely be expanded automatically; the start/endPrefixMapping event supplies the information to the application to expand prefixes in those contexts itself, if necessary.

Note that start/endPrefixMapping events are not guaranteed to be properly nested relative to each-other: all startPrefixMapping events will occur before the corresponding startElement event, and all endPrefixMapping events will occur after the corresponding endElement event, but their order is not guaranteed.

Specified by:

startPrefixMapping in interface org.xml.sax.ContentHandler

Parameters:

prefix - The Namespace prefix being declared.

uri - The Namespace URI the prefix is mapped to.

Throws:

org.xml.sax.SAXException - The client may throw an exception during processing.

See Also:

endPrefixMapping(java.lang.String), startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)

startPrefixMapping

public void startPrefixMapping(java.lang.String prefix,
                               java.lang.String uri,
                               boolean shouldFlush)
                        throws org.xml.sax.SAXException

Begin the scope of a prefix-URI Namespace mapping.

Parameters:

prefix - The Namespace prefix being declared.

uri - The Namespace URI the prefix is mapped to.

shouldFlush - Indicate whether pending events needs to be flushed first

Throws:

org.xml.sax.SAXException - The client may throw an exception during processing.

endPrefixMapping

public void endPrefixMapping(java.lang.String prefix)
                      throws org.xml.sax.SAXException

End the scope of a prefix-URI mapping.

See startPrefixMapping for details. This event will always occur after the corresponding endElement event, but the order of endPrefixMapping events is not otherwise guaranteed.

Specified by:

endPrefixMapping in interface org.xml.sax.ContentHandler

Parameters:

prefix - The prefix that was being mapping.

Throws:

org.xml.sax.SAXException - The client may throw an exception during processing.

See Also:

startPrefixMapping(java.lang.String, java.lang.String), endElement(java.lang.String, java.lang.String, java.lang.String)

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws org.xml.sax.SAXException

Bottleneck the characters event.

Specified by:

characters in interface org.xml.sax.ContentHandler

Parameters:

ch - Array of characters to process

start - start of characters in the array

length - Number of characters in the array

Throws:

org.xml.sax.SAXException -

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws org.xml.sax.SAXException

Bottleneck the ignorableWhitespace event.

Specified by:

ignorableWhitespace in interface org.xml.sax.ContentHandler

Parameters:

ch - Array of characters to process

start - start of characters in the array

length - Number of characters in the array

Throws:

org.xml.sax.SAXException -

processingInstruction

public void processingInstruction(java.lang.String target,
                                  java.lang.String data)
                           throws org.xml.sax.SAXException

Bottleneck the processingInstruction event.

Specified by:

processingInstruction in interface org.xml.sax.ContentHandler

Parameters:

target - Processing instruction target name

data - Processing instruction data

Throws:

org.xml.sax.SAXException -

comment

public void comment(java.lang.String data)
             throws org.xml.sax.SAXException

Bottleneck the comment event.

Parameters:

data - Comment data

Throws:

org.xml.sax.SAXException -

comment

public void comment(char[] ch,
                    int start,
                    int length)
             throws org.xml.sax.SAXException

Bottleneck the comment event.

Specified by:

comment in interface org.xml.sax.ext.LexicalHandler

Parameters:

ch - Character array with comment data

start - start of characters in the array

length - number of characters in the array

Throws:

org.xml.sax.SAXException -

entityReference

public void entityReference(java.lang.String name)
                     throws org.xml.sax.SAXException

Entity reference event.

Parameters:

name - Name of entity

Throws:

org.xml.sax.SAXException -

startEntity

public void startEntity(java.lang.String name)
                 throws org.xml.sax.SAXException

Start an entity.

Specified by:

startEntity in interface org.xml.sax.ext.LexicalHandler

Parameters:

name - Name of the entity

Throws:

org.xml.sax.SAXException -

endEntity

public void endEntity(java.lang.String name)
               throws org.xml.sax.SAXException

End an entity.

Specified by:

endEntity in interface org.xml.sax.ext.LexicalHandler

Parameters:

name - Name of the entity

Throws:

org.xml.sax.SAXException -

startDTD

public void startDTD(java.lang.String s1,
                     java.lang.String s2,
                     java.lang.String s3)
              throws org.xml.sax.SAXException

Start the DTD.

Specified by:

startDTD in interface org.xml.sax.ext.LexicalHandler

Parameters:

s1 - The document type name.

s2 - The declared public identifier for the external DTD subset, or null if none was declared.

s3 - The declared system identifier for the external DTD subset, or null if none was declared.

Throws:

org.xml.sax.SAXException -

endDTD

public void endDTD()
            throws org.xml.sax.SAXException

End the DTD.

Specified by:

endDTD in interface org.xml.sax.ext.LexicalHandler

Throws:

org.xml.sax.SAXException -

startCDATA

public void startCDATA()
                throws org.xml.sax.SAXException

Start the CDATACharacters.

Specified by:

startCDATA in interface org.xml.sax.ext.LexicalHandler

Throws:

org.xml.sax.SAXException -

endCDATA

public void endCDATA()
              throws org.xml.sax.SAXException

End the CDATA characters.

Specified by:

endCDATA in interface org.xml.sax.ext.LexicalHandler

Throws:

org.xml.sax.SAXException -

skippedEntity

public void skippedEntity(java.lang.String name)
                   throws org.xml.sax.SAXException

Receive notification of a skipped entity.

The Parser will invoke this method once for each entity skipped. Non-validating processors may skip entities if they have not seen the declarations (because, for example, the entity was declared in an external DTD subset). All processors may skip external entities, depending on the values of the http://xml.org/sax/features/external-general-entities and the http://xml.org/sax/features/external-parameter-entities properties.

Specified by:

skippedEntity in interface org.xml.sax.ContentHandler

Parameters:

name - The name of the skipped entity. If it is a parameter entity, the name will begin with '%'.

Throws:

org.xml.sax.SAXException - Any SAX exception, possibly wrapping another exception.

flushPending

public void flushPending()
                  throws org.xml.sax.SAXException

Flush the pending element.

Throws:

org.xml.sax.SAXException -

flushPending

public void flushPending(int type)
                  throws org.xml.sax.SAXException

Flush the pending element.

Parameters:

type - Event type

Throws:

org.xml.sax.SAXException -

outputResultTreeFragment

public void outputResultTreeFragment(XObject obj,
                                     XPathContext support)
                              throws org.xml.sax.SAXException

Given a result tree fragment, walk the tree and output it to the result stream.

Parameters:

obj - Result tree fragment object

support - XPath context for the result tree fragment

Throws:

org.xml.sax.SAXException -

cloneToResultTree

public void cloneToResultTree(org.w3c.dom.Node node,
                              boolean shouldCloneAttributes)
                       throws org.xml.sax.SAXException

Clone an element with or without children.

Parameters:

node - Element to clone

shouldCloneAttributes - Whether or not to clone with children

Throws:

org.xml.sax.SAXException -

setDocumentLocator

public void setDocumentLocator(org.xml.sax.Locator locator)

To fullfill the FormatterListener interface... no action for the moment.

Specified by:

setDocumentLocator in interface org.xml.sax.ContentHandler

Parameters:

locator - Document locator

sendStartPrefixMappings

protected void sendStartPrefixMappings()
                                throws org.xml.sax.SAXException

Add the attributes that have been declared to the attribute list. (Seems like I shouldn't have to do this...)

Throws:

org.xml.sax.SAXException -

sendEndPrefixMappings

protected void sendEndPrefixMappings()
                              throws org.xml.sax.SAXException

Add the attributes that have been declared to the attribute list. (Seems like I shouldn't have to do this...)

Throws:

org.xml.sax.SAXException -

addNSDeclsToAttrs

protected void addNSDeclsToAttrs()

Add the attributes that have been declared to the attribute list. (Seems like I shouldn't have to do this...)

processNSDecls

public void processNSDecls(org.w3c.dom.Node src)
                    throws javax.xml.transform.TransformerException

Copy xmlns: attributes in if not already in scope.

Parameters:

src - Source Node

Throws:

javax.xml.transform.TransformerException -

getURI

public java.lang.String getURI(java.lang.String prefix)

Given a prefix, return the namespace,

Parameters:

prefix - Given prefix name

Returns:

Namespace associated with the given prefix, or null

getPrefix

public java.lang.String getPrefix(java.lang.String namespace)

Given a namespace, try and find a prefix.

Parameters:

namespace - Given namespace URI

Returns:

Prefix name associated with namespace URI

getNamespaceSupport

public org.xml.sax.helpers.NamespaceSupport getNamespaceSupport()

Get the NamespaceSupport object.

Returns:

NamespaceSupport object.

getContentHandler

public org.xml.sax.ContentHandler getContentHandler()

Return the current content handler.

Returns:

The current content handler, or null if none has been registered.

See Also:

setContentHandler(org.xml.sax.ContentHandler)

setContentHandler

public void setContentHandler(org.xml.sax.ContentHandler ch)

Set the current content handler.

Parameters:

ch - Content Handler to be set

Returns:

The current content handler, or null if none has been registered.

See Also:

getContentHandler()

getUniqueNSValue

public int getUniqueNSValue()

Get a unique namespace value.

Returns:

a unique namespace value to be used with a fabricated prefix

getNewUniqueNSPrefix

public java.lang.String getNewUniqueNSPrefix()

Get new unique namespace prefix.

Returns:

Unique fabricated prefix.

getPendingAttributes

public MutableAttrListImpl getPendingAttributes()

Get the pending attributes. We have to delay the call to m_flistener.startElement(name, atts) because of the xsl:attribute and xsl:copy calls. In other words, the attributes have to be fully collected before you can call startElement.

Returns:

the pending attributes.

addAttribute

public void addAttribute(java.lang.String uri,
                         java.lang.String localName,
                         java.lang.String rawName,
                         java.lang.String type,
                         java.lang.String value)
                  throws javax.xml.transform.TransformerException

Add an attribute to the end of the list.

Do not pass in xmlns decls to this function!

For the sake of speed, this method does no checking to see if the attribute is already in the list: that is the responsibility of the application.

Parameters:

uri - The Namespace URI, or the empty string if none is available or Namespace processing is not being performed.

localName - The local name, or the empty string if Namespace processing is not being performed.

rawName - The raw XML 1.0 name, or the empty string if raw names are not available.

type - The attribute type as a string.

value - The attribute value.

Throws:

javax.xml.transform.TransformerException -

isDefinedNSDecl

public boolean isDefinedNSDecl(java.lang.String rawName,
                               java.lang.String value)

Return whether or not a namespace declaration is defined

Parameters:

rawName - Raw name of namespace element

value - URI of given namespace

Returns:

True if the namespace is already defined in list of namespaces

isDefinedNSDecl

public boolean isDefinedNSDecl(org.w3c.dom.Attr attr)

Returns whether a namespace is defined

Parameters:

attr - Namespace attribute node

Returns:

True if the namespace is already defined in list of namespaces

addAttribute

public void addAttribute(org.w3c.dom.Attr attr)
                  throws javax.xml.transform.TransformerException

Copy an DOM attribute to the created output element, executing attribute templates as need be, and processing the xsl:use attribute.

Parameters:

attr - Attribute node to add to result tree

Throws:

javax.xml.transform.TransformerException -

addAttributes

public void addAttributes(org.w3c.dom.Node src)
                   throws javax.xml.transform.TransformerException

Copy DOM attributes to the result element.

Parameters:

src - Source node with the attributes

Throws:

javax.xml.transform.TransformerException -

isElementPending

public boolean isElementPending()

Tell if an element is pending, to be output to the result tree.

Returns:

True if an element is pending

getCurrentElement

public ElemTemplateElement getCurrentElement()

Retrieves the stylesheet element that produced the SAX event.

Please note that the ElemTemplateElement returned may be in a default template, and thus may not be defined in the stylesheet.

Specified by:

getCurrentElement in interface TransformState

Returns:

the stylesheet element that produced the SAX event.

getCurrentNode

public org.w3c.dom.Node getCurrentNode()

This method retrieves the current context node in the source tree.

Specified by:

getCurrentNode in interface TransformState

Returns:

the current context node in the source tree.

getCurrentTemplate

public ElemTemplate getCurrentTemplate()

This method retrieves the xsl:template that is in effect, which may be a matched template or a named template.

Please note that the ElemTemplate returned may be a default template, and thus may not have a template defined in the stylesheet.

Specified by:

getCurrentTemplate in interface TransformState

Returns:

the xsl:template that is in effect

getMatchedTemplate

public ElemTemplate getMatchedTemplate()

This method retrieves the xsl:template that was matched. Note that this may not be the same thing as the current template (which may be from getCurrentElement()), since a named template may be in effect.

Please note that the ElemTemplate returned may be a default template, and thus may not have a template defined in the stylesheet.

Specified by:

getMatchedTemplate in interface TransformState

Returns:

the xsl:template that was matched.

getMatchedNode

public org.w3c.dom.Node getMatchedNode()

Retrieves the node in the source tree that matched the template obtained via getMatchedTemplate().

Specified by:

getMatchedNode in interface TransformState

Returns:

the node in the source tree that matched the template obtained via getMatchedTemplate().

getContextNodeList

public org.w3c.dom.traversal.NodeIterator getContextNodeList()

Get the current context node list.

Specified by:

getContextNodeList in interface TransformState

Returns:

the current context node list.

getTransformer

public javax.xml.transform.Transformer getTransformer()

Get the TrAX Transformer object in effect.

Specified by:

getTransformer in interface TransformState

Returns:

the TrAX Transformer object in effect.