org.apache.xalan.processor
public class StylesheetHandler extends DefaultHandler implements TemplatesHandler, PrefixResolver, NodeConsumer
UNKNOWN: advanced
Field Summary | |
---|---|
static int | STYPE_IMPORT
If getStylesheetType returns this value, the current stylesheet
is an imported stylesheet. |
static int | STYPE_INCLUDE
If getStylesheetType returns this value, the current stylesheet
is an included stylesheet. |
static int | STYPE_ROOT
If getStylesheetType returns this value, the current stylesheet
is a root stylesheet. |
Constructor Summary | |
---|---|
StylesheetHandler(TransformerFactoryImpl processor)
Create a StylesheetHandler object, creating a root stylesheet
as the target.
|
Method Summary | |
---|---|
void | characters(char[] ch, int start, int length)
Receive notification of character data inside an element.
|
XPath | createXPath(String str, ElemTemplateElement owningTemplate)
Process an expression string into an XPath.
|
void | endDocument()
Receive notification of the end of the document.
|
void | endElement(String uri, String localName, String rawName)
Receive notification of the end of an element.
|
void | endPrefixMapping(String prefix)
Receive notification of the end of a Namespace mapping.
|
void | error(SAXParseException e)
Receive notification of a recoverable XSLT processing error.
|
void | fatalError(SAXParseException e)
Report a fatal XSLT processing error.
|
String | getBaseIdentifier()
Return the base identifier.
|
boolean | getIncremental() |
SAXSourceLocator | getLocator()
Get the current stylesheet Locator object.
|
String | getNamespaceForPrefix(String prefix)
Given a namespace, get the corrisponding prefix from the current
namespace support context.
|
String | getNamespaceForPrefix(String prefix, Node context)
Given a namespace, get the corrisponding prefix. |
boolean | getOptimize() |
Node | getOriginatingNode()
Set the node that is originating the SAX event.
|
XSLTSchema | getSchema()
Get the root of the XSLT Schema, which tells us how to
transition content handlers, create elements, etc.
|
boolean | getSource_location() |
TransformerFactoryImpl | getStylesheetProcessor()
Get the XSLT TransformerFactoryImpl for needed services.
|
StylesheetRoot | getStylesheetRoot()
Return the stylesheet root that this handler is constructing.
|
String | getSystemId()
Get the base ID (URI or system ID) from where relative
URLs will be resolved.
|
Templates | getTemplates()
When this object is used as a ContentHandler or ContentHandler, it will
create a Templates object, which the caller can get once
the SAX events have been completed. |
boolean | handlesNullPrefixes() |
void | ignorableWhitespace(char[] ch, int start, int length)
Receive notification of ignorable whitespace in element content.
|
boolean | isStylesheetParsingComplete()
Test whether the _last_ endDocument() has been processed.
|
void | notationDecl(String name, String publicId, String systemId)
Receive notification of a notation declaration.
|
void | processingInstruction(String target, String data)
Receive notification of a processing instruction.
|
void | pushStylesheet(Stylesheet s)
Push the current stylesheet being constructed. |
InputSource | resolveEntity(String publicId, String systemId)
Resolve an external entity.
|
void | setDocumentLocator(Locator locator)
Receive a Locator object for document events.
|
void | setOriginatingNode(Node n)
Set the node that is originating the SAX event.
|
void | setSystemId(String baseID)
Set the base ID (URL or system ID) for the stylesheet
created by this builder. |
void | skippedEntity(String name)
Receive notification of a skipped entity.
|
void | startDocument()
Receive notification of the beginning of the document.
|
void | startElement(String uri, String localName, String rawName, Attributes attributes)
Receive notification of the start of an element.
|
void | startPrefixMapping(String prefix, String uri)
Receive notification of the start of a Namespace mapping.
|
void | unparsedEntityDecl(String name, String publicId, String systemId, String notationName)
Receive notification of an unparsed entity declaration.
|
void | warn(String msg, Object[] args)
Warn the user of an problem.
|
void | warning(SAXParseException e)
Receive notification of a XSLT processing warning.
|
UNKNOWN: internal
UNKNOWN: internal
UNKNOWN: internal
Parameters: processor non-null reference to the transformer factory that owns this handler.
Throws: TransformerConfigurationException if a StylesheetRoot can not be constructed for some reason.
Parameters: ch The characters. start The start position in the character array. length The number of characters to use from the character array.
Throws: org.xml.sax.SAXException Any SAX exception, possibly wrapping another exception.
See Also: org.xml.sax.ContentHandler#characters
Parameters: str A non-null reference to a valid or invalid XPath expression string.
Returns: A non-null reference to an XPath object that represents the string argument.
Throws: javax.xml.transform.TransformerException if the expression can not be processed.
Throws: org.xml.sax.SAXException Any SAX exception, possibly wrapping another exception.
See Also: org.xml.sax.ContentHandler#endDocument
Parameters: uri The Namespace URI, or an empty string. localName The local name (without prefix), or empty string if not namespace processing. rawName The qualified name (with prefix).
Throws: org.xml.sax.SAXException Any SAX exception, possibly wrapping another exception.
See Also: org.xml.sax.ContentHandler#endElement
By default, do nothing. Application writers may override this method in a subclass to take specific actions at the start of each element (such as allocating a new tree node or writing output to a file).
Parameters: prefix The Namespace prefix being declared.
Throws: org.xml.sax.SAXException Any SAX exception, possibly wrapping another exception.
See Also: org.xml.sax.ContentHandler#endPrefixMapping
Parameters: e The error information encoded as an exception.
Throws: org.xml.sax.SAXException that wraps a javax.xml.transform.TransformerException if the current javax.xml.transform.ErrorListener#error method chooses to flag this condition as an error.
Parameters: e The error information encoded as an exception.
Throws: org.xml.sax.SAXException that wraps a javax.xml.transform.TransformerException if the current javax.xml.transform.ErrorListener#fatalError method chooses to flag this condition as an error.
Returns: The base identifier of the current stylesheet.
Returns: Incremental flag
Returns: non-null reference to the current locator object.
Parameters: prefix The prefix to look up, which may be an empty string ("") for the default Namespace.
Returns: The associated Namespace URI, or null if the prefix is undeclared in this context.
Parameters: prefix The prefix to look up, which may be an empty string ("") for the default Namespace. context The node context from which to look up the URI.
Returns: The associated Namespace URI, or null if the prefix is undeclared in this context.
Returns: Optimization flag
Returns: Reference to node that originated the current event.
See Also: NodeConsumer
Returns: The root XSLT Schema, which should never be null.
UNKNOWN: internal
Returns: Source Location flag
Returns: The TransformerFactoryImpl that owns this handler.
Returns: The root stylesheet of the stylesheets tree.
Returns: The systemID that was set with StylesheetHandler.
Returns: The stylesheet object that was created during the SAX event process, or null if no stylesheet has been created. Author Scott Boag
See Also: handlesNullPrefixes
Parameters: ch The whitespace characters. start The start position in the character array. length The number of characters to use from the character array.
Throws: org.xml.sax.SAXException Any SAX exception, possibly wrapping another exception.
See Also: org.xml.sax.ContentHandler#ignorableWhitespace
Returns: true iff the complete stylesheet tree has been built.
By default, do nothing. Application writers may override this method in a subclass if they wish to keep track of the notations declared in a document.
Parameters: name The notation name. publicId The notation public identifier, or null if not available. systemId The notation system identifier.
See Also: org.xml.sax.DTDHandler#notationDecl
The Parser will invoke this method once for each processing instruction found: note that processing instructions may occur before or after the main document element.
A SAX parser should never report an XML declaration (XML 1.0, section 2.8) or a text declaration (XML 1.0, section 4.3.1) using this method.
By default, do nothing. Application writers may override this method in a subclass to take specific actions for each processing instruction, such as setting status variables or invoking other methods.
Parameters: target The processing instruction target. data The processing instruction data, or null if none is supplied.
Throws: org.xml.sax.SAXException Any SAX exception, possibly wrapping another exception.
See Also: org.xml.sax.ContentHandler#processingInstruction
Parameters: s non-null reference to a stylesheet.
Parameters: publicId The public identifer, or null if none is available. systemId The system identifier provided in the XML document.
Returns: The new input source, or null to require the default behaviour.
Throws: org.xml.sax.SAXException if the entity can not be resolved.
Parameters: locator A locator for all SAX document events.
See Also: org.xml.sax.ContentHandler#setDocumentLocator org.xml.sax.Locator
Parameters: n Reference to node that originated the current event.
See Also: NodeConsumer
Parameters: baseID Base URL for this stylesheet.
By default, do nothing. Application writers may override this method in a subclass to take specific actions for each processing instruction, such as setting status variables or invoking other methods.
Parameters: name The name of the skipped entity.
Throws: org.xml.sax.SAXException Any SAX exception, possibly wrapping another exception.
See Also: org.xml.sax.ContentHandler#processingInstruction
Throws: org.xml.sax.SAXException Any SAX exception, possibly wrapping another exception.
See Also: org.xml.sax.ContentHandler#startDocument
Parameters: uri The Namespace URI, or an empty string. localName The local name (without prefix), or empty string if not namespace processing. rawName The qualified name (with prefix). attributes The specified or defaulted attributes.
Throws: org.xml.sax.SAXException
By default, do nothing. Application writers may override this method in a subclass to take specific actions at the start of each element (such as allocating a new tree node or writing output to a file).
Parameters: prefix The Namespace prefix being declared. uri The Namespace URI mapped to the prefix.
Throws: org.xml.sax.SAXException Any SAX exception, possibly wrapping another exception.
See Also: org.xml.sax.ContentHandler#startPrefixMapping
Parameters: name The entity name. publicId The entity public identifier, or null if not available. systemId The entity system identifier. notationName The name of the associated notation.
See Also: org.xml.sax.DTDHandler#unparsedEntityDecl
Parameters: msg An key into the XSLTErrorResources table, that is one of the WG_ prefixed definitions. args An array of arguments for the given warning.
Throws: org.xml.sax.SAXException that wraps a javax.xml.transform.TransformerException if the current javax.xml.transform.ErrorListener#warning method chooses to flag this condition as an error.
UNKNOWN: internal
Parameters: e The warning information encoded as an exception.
Throws: org.xml.sax.SAXException that wraps a javax.xml.transform.TransformerException if the current javax.xml.transform.ErrorListener#warning method chooses to flag this condition as an error.