org.apache.xerces.xpointer
Class XPointerHandler

java.lang.Object
  |
  +--org.apache.xerces.xinclude.XIncludeHandler
        |
        +--org.apache.xerces.xpointer.XPointerHandler

All Implemented Interfaces:

org.apache.xerces.xni.parser.XMLComponent, org.apache.xerces.xni.parser.XMLDocumentFilter, org.apache.xerces.xni.XMLDocumentHandler, org.apache.xerces.xni.parser.XMLDocumentSource, org.apache.xerces.xni.parser.XMLDTDFilter, org.apache.xerces.xni.XMLDTDHandler, org.apache.xerces.xni.parser.XMLDTDSource, XPointerProcessor

public final class XPointerHandler

extends XIncludeHandler

implements XPointerProcessor

This is a pipeline component which extends the XIncludeHandler to perform XPointer specific processing specified in the W3C XPointerFramework and element() Scheme Recommendations.

This component analyzes each event in the pipeline, looking for an element that matches a PointerPart in the parent XInclude element's xpointer attribute value. If the match succeeds, all children are passed by this component.

See the XPointer Framework Recommendation for more information on the XPointer Framework and ShortHand Pointers. See the XPointer element() Scheme Recommendation for more information on the XPointer element() Scheme.

INTERNAL:

Usage of this class is not supported. It may be altered or removed at any time.

Version:

$Id: XPointerHandler.java,v 1.1 2005/06/17 22:00:20 nddelima Exp $

Inner classes inherited from class org.apache.xerces.xinclude.XIncludeHandler

XIncludeHandler.Notation, XIncludeHandler.UnparsedEntity

Field Summary

protected org.apache.xerces.xni.parser.XMLErrorHandler	fErrorHandler
protected boolean	fFixupBase
protected boolean	fFixupLang
protected boolean	fFoundMatchingPtrPart
protected boolean	fIsXPointerResolved
protected SymbolTable	fSymbolTable
protected XMLErrorReporter	fXPointerErrorReporter
protected XPointerPart	fXPointerPart
protected java.util.Vector	fXPointerParts

Fields inherited from class org.apache.xerces.xinclude.XIncludeHandler

ALLOW_UE_AND_NOTATION_EVENTS, BUFFER_SIZE, CURRENT_BASE_URI, DYNAMIC_VALIDATION, ENTITY_RESOLVER, ERROR_REPORTER, fBaseURI, fBaseURIScope, fBufferSize, fChildConfig, fCurrentBaseURI, fCurrentLanguage, fDocLocation, fDocumentHandler, fDocumentSource, fDTDHandler, fDTDSource, fEntityResolver, fErrorReporter, fExpandedSystemID, fLanguageScope, fLanguageStack, fLiteralSystemID, fNamespaceContext, fParentRelativeURI, fParentXIncludeHandler, fSecurityManager, fSettings, fXInclude10TextReader, fXInclude11TextReader, fXIncludeChildConfig, fXIncludeMessageFormatter, fXPointerChildConfig, fXPtrProcessor, HTTP_ACCEPT, HTTP_ACCEPT_LANGUAGE, NEW_NS_ATTR_QNAME, PARSER_SETTINGS, SCHEMA_VALIDATION, SECURITY_MANAGER, SYMBOL_TABLE, VALIDATION, XINCLUDE_ATTR_ACCEPT, XINCLUDE_ATTR_ACCEPT_LANGUAGE, XINCLUDE_ATTR_ENCODING, XINCLUDE_ATTR_HREF, XINCLUDE_ATTR_PARSE, XINCLUDE_BASE, XINCLUDE_DEFAULT_CONFIGURATION, XINCLUDE_FALLBACK, XINCLUDE_FIXUP_BASE_URIS, XINCLUDE_FIXUP_LANGUAGE, XINCLUDE_INCLUDE, XINCLUDE_INCLUDED, XINCLUDE_LANG, XINCLUDE_NS_URI, XINCLUDE_PARSE_TEXT, XINCLUDE_PARSE_XML, XML_BASE_QNAME, XML_LANG_QNAME, XPOINTER

Fields inherited from interface org.apache.xerces.xpointer.XPointerProcessor

EVENT_ELEMENT_EMPTY, EVENT_ELEMENT_END, EVENT_ELEMENT_START

Fields inherited from interface org.apache.xerces.xni.XMLDTDHandler

CONDITIONAL_IGNORE, CONDITIONAL_INCLUDE

Constructor Summary

XPointerHandler()

XPointerHandler(SymbolTable symbolTable, org.apache.xerces.xni.parser.XMLErrorHandler errorHandler, XMLErrorReporter errorReporter)

Method Summary

void	characters(org.apache.xerces.xni.XMLString text, org.apache.xerces.xni.Augmentations augs) Character content.
void	comment(org.apache.xerces.xni.XMLString text, org.apache.xerces.xni.Augmentations augs) If the comment is a child of a matched element, then pass else return.
void	emptyElement(org.apache.xerces.xni.QName element, org.apache.xerces.xni.XMLAttributes attributes, org.apache.xerces.xni.Augmentations augs) An empty element.
void	endCDATA(org.apache.xerces.xni.Augmentations augs) The end of a CDATA section.
void	endElement(org.apache.xerces.xni.QName element, org.apache.xerces.xni.Augmentations augs) The end of an element.
java.util.Vector	getPointerParts() Returns a Vector of XPointerPart objects
XPointerPart	getXPointerPart() Returns the pointer part used to resolve the document fragment.
void	ignorableWhitespace(org.apache.xerces.xni.XMLString text, org.apache.xerces.xni.Augmentations augs) Ignorable whitespace.
protected void	init() Initializes the XPointer Processor;
protected void	initErrorReporter() Initializes error handling objects
boolean	isChildFragmentResolved() Returns true if the XPointer expression resolves to a non-element child of the current resource fragment.
boolean	isFragmentResolved() Returns true if the Node fragment is resolved.
boolean	isXPointerResolved() Returns true if the XPointer successfully found a sub-resource .
void	parseXPointer(java.lang.String xpointer) Parses the XPointer framework expression and delegates scheme specific parsing.
void	processingInstruction(java.lang.String target, org.apache.xerces.xni.XMLString data, org.apache.xerces.xni.Augmentations augs) A processing instruction.
boolean	resolveXPointer(org.apache.xerces.xni.QName element, org.apache.xerces.xni.XMLAttributes attributes, org.apache.xerces.xni.Augmentations augs, int event) Evaluates an XML resource with respect to an XPointer expressions by checking if it's element and attributes parameters match the criteria specified in the xpointer expression.
void	setProperty(java.lang.String propertyId, java.lang.Object value) Sets the value of a property.
void	startCDATA(org.apache.xerces.xni.Augmentations augs) The start of a CDATA section.
void	startElement(org.apache.xerces.xni.QName element, org.apache.xerces.xni.XMLAttributes attributes, org.apache.xerces.xni.Augmentations augs) The start of an element.

Methods inherited from class org.apache.xerces.xinclude.XIncludeHandler

addNotation, addUnparsedEntity, attributeDecl, checkAndSendNotation, checkAndSendUnparsedEntity, checkNotation, checkUnparsedEntity, copyFeatures, copyFeatures, doctypeDecl, elementDecl, endAttlist, endConditional, endDocument, endDTD, endExternalSubset, endGeneralEntity, endParameterEntity, externalEntityDecl, getBaseURI, getDocumentHandler, getDocumentSource, getDTDHandler, getDTDSource, getFeatureDefault, getLanguage, getPropertyDefault, getRecognizedFeatures, getRecognizedProperties, getRelativeBaseURI, getRelativeURI, getSawFallback, getSawInclude, getState, getState, handleFallbackElement, handleIncludeElement, hasXIncludeNamespace, ignoredCharacters, internalEntityDecl, isFallbackElement, isIncludeElement, isRootDocument, isTopLevelIncludedItem, isTopLevelIncludedItemViaFallback, isTopLevelIncludedItemViaInclude, modifyAugmentations, modifyAugmentations, notationDecl, processAttributes, processXMLBaseAttributes, processXMLLangAttributes, reportFatalError, reportFatalError, reportResourceError, reportResourceError, reset, restoreBaseURI, restoreLanguage, sameBaseURIAsIncludeParent, sameLanguageAsIncludeParent, saveBaseURI, saveLanguage, searchForRecursiveIncludes, setDocumentHandler, setDocumentSource, setDTDHandler, setDTDSource, setFeature, setParent, setSawFallback, setSawInclude, setState, startAttlist, startConditional, startDocument, startDTD, startExternalSubset, startGeneralEntity, startParameterEntity, textDecl, unparsedEntityDecl, xmlDecl

Methods inherited from class java.lang.Object

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

Field Detail

fXPointerParts

protected java.util.Vector fXPointerParts

fXPointerPart

protected XPointerPart fXPointerPart

fFoundMatchingPtrPart

protected boolean fFoundMatchingPtrPart

fXPointerErrorReporter

protected XMLErrorReporter fXPointerErrorReporter

fErrorHandler

protected org.apache.xerces.xni.parser.XMLErrorHandler fErrorHandler

fSymbolTable

protected SymbolTable fSymbolTable

fIsXPointerResolved

protected boolean fIsXPointerResolved

fFixupBase

protected boolean fFixupBase

fFixupLang

protected boolean fFixupLang

Constructor Detail

XPointerHandler

public XPointerHandler()

XPointerHandler

public XPointerHandler(SymbolTable symbolTable,
                       org.apache.xerces.xni.parser.XMLErrorHandler errorHandler,
                       XMLErrorReporter errorReporter)

Method Detail

parseXPointer

public void parseXPointer(java.lang.String xpointer)
                   throws org.apache.xerces.xni.XNIException

Parses the XPointer framework expression and delegates scheme specific parsing.

Specified by:

parseXPointer in interface XPointerProcessor

See Also:

XPointerProcessor.parseXPointer(java.lang.String)

resolveXPointer

public boolean resolveXPointer(org.apache.xerces.xni.QName element,
                               org.apache.xerces.xni.XMLAttributes attributes,
                               org.apache.xerces.xni.Augmentations augs,
                               int event)
                        throws org.apache.xerces.xni.XNIException

Description copied from interface: XPointerProcessor

Evaluates an XML resource with respect to an XPointer expressions by checking if it's element and attributes parameters match the criteria specified in the xpointer expression.

Specified by:

resolveXPointer in interface XPointerProcessor

See Also:

XPointerProcessor.resolveXPointer(org.apache.xerces.xni.QName, org.apache.xerces.xni.XMLAttributes, org.apache.xerces.xni.Augmentations, int event)

isFragmentResolved

public boolean isFragmentResolved()
                           throws org.apache.xerces.xni.XNIException

Returns true if the Node fragment is resolved.

Specified by:

isFragmentResolved in interface XPointerProcessor

See Also:

XPointerProcessor.isFragmentResolved()

isChildFragmentResolved

public boolean isChildFragmentResolved()
                                throws org.apache.xerces.xni.XNIException

Returns true if the XPointer expression resolves to a non-element child of the current resource fragment.

See Also:

XPointerPart.isChildFragmentResolved()

isXPointerResolved

public boolean isXPointerResolved()
                           throws org.apache.xerces.xni.XNIException

Returns true if the XPointer successfully found a sub-resource .

Specified by:

isXPointerResolved in interface XPointerProcessor

See Also:

XPointerProcessor.isFragmentResolved()

getXPointerPart

public XPointerPart getXPointerPart()

Returns the pointer part used to resolve the document fragment.

Returns:

String - The pointer part used to resolve the document fragment.

initErrorReporter

protected void initErrorReporter()

Initializes error handling objects

init

protected void init()

Initializes the XPointer Processor;

getPointerParts

public java.util.Vector getPointerParts()

Returns a Vector of XPointerPart objects

Returns:

A Vector of XPointerPart objects.

comment

public void comment(org.apache.xerces.xni.XMLString text,
                    org.apache.xerces.xni.Augmentations augs)
             throws org.apache.xerces.xni.XNIException

If the comment is a child of a matched element, then pass else return.

Overrides:

comment in class XIncludeHandler

Parameters:

text - The text in the comment.

augs - Additional information that may include infoset augmentations

Throws:

org.apache.xerces.xni.XNIException - Thrown by application to signal an error.

processingInstruction

public void processingInstruction(java.lang.String target,
                                  org.apache.xerces.xni.XMLString data,
                                  org.apache.xerces.xni.Augmentations augs)
                           throws org.apache.xerces.xni.XNIException

A processing instruction. Processing instructions consist of a target name and, optionally, text data. The data is only meaningful to the application.

Typically, a processing instruction's data will contain a series of pseudo-attributes. These pseudo-attributes follow the form of element attributes but are not parsed or presented to the application as anything other than text. The application is responsible for parsing the data.

Overrides:

processingInstruction in class XIncludeHandler

Parameters:

target - The target.

data - The data or null if none specified.

augs - Additional information that may include infoset augmentations

Throws:

org.apache.xerces.xni.XNIException - Thrown by handler to signal an error.

startElement

public void startElement(org.apache.xerces.xni.QName element,
                         org.apache.xerces.xni.XMLAttributes attributes,
                         org.apache.xerces.xni.Augmentations augs)
                  throws org.apache.xerces.xni.XNIException

The start of an element.

Overrides:

startElement in class XIncludeHandler

Parameters:

element - The name of the element.

attributes - The element attributes.

augs - Additional information that may include infoset augmentations

Throws:

org.apache.xerces.xni.XNIException - Thrown by handler to signal an error.

emptyElement

public void emptyElement(org.apache.xerces.xni.QName element,
                         org.apache.xerces.xni.XMLAttributes attributes,
                         org.apache.xerces.xni.Augmentations augs)
                  throws org.apache.xerces.xni.XNIException

An empty element.

Overrides:

emptyElement in class XIncludeHandler

Parameters:

element - The name of the element.

attributes - The element attributes.

augs - Additional information that may include infoset augmentations

Throws:

org.apache.xerces.xni.XNIException - Thrown by handler to signal an error.

characters

public void characters(org.apache.xerces.xni.XMLString text,
                       org.apache.xerces.xni.Augmentations augs)
                throws org.apache.xerces.xni.XNIException

Character content.

Overrides:

characters in class XIncludeHandler

Parameters:

text - The content.

augs - Additional information that may include infoset augmentations

Throws:

org.apache.xerces.xni.XNIException - Thrown by handler to signal an error.

ignorableWhitespace

public void ignorableWhitespace(org.apache.xerces.xni.XMLString text,
                                org.apache.xerces.xni.Augmentations augs)
                         throws org.apache.xerces.xni.XNIException

Ignorable whitespace. For this method to be called, the document source must have some way of determining that the text containing only whitespace characters should be considered ignorable. For example, the validator can determine if a length of whitespace characters in the document are ignorable based on the element content model.

Overrides:

ignorableWhitespace in class XIncludeHandler

Parameters:

text - The ignorable whitespace.

augs - Additional information that may include infoset augmentations

Throws:

org.apache.xerces.xni.XNIException - Thrown by handler to signal an error.

endElement

public void endElement(org.apache.xerces.xni.QName element,
                       org.apache.xerces.xni.Augmentations augs)
                throws org.apache.xerces.xni.XNIException

The end of an element.

Overrides:

endElement in class XIncludeHandler

Parameters:

element - The name of the element.

augs - Additional information that may include infoset augmentations

Throws:

org.apache.xerces.xni.XNIException - Thrown by handler to signal an error.

startCDATA

public void startCDATA(org.apache.xerces.xni.Augmentations augs)
                throws org.apache.xerces.xni.XNIException

The start of a CDATA section.

Overrides:

startCDATA in class XIncludeHandler

Parameters:

augs - Additional information that may include infoset augmentations

Throws:

org.apache.xerces.xni.XNIException - Thrown by handler to signal an error.

endCDATA

public void endCDATA(org.apache.xerces.xni.Augmentations augs)
              throws org.apache.xerces.xni.XNIException

The end of a CDATA section.

Overrides:

endCDATA in class XIncludeHandler

Parameters:

augs - Additional information that may include infoset augmentations

Throws:

org.apache.xerces.xni.XNIException - Thrown by handler to signal an error.

setProperty

public void setProperty(java.lang.String propertyId,
                        java.lang.Object value)
                 throws org.apache.xerces.xni.parser.XMLConfigurationException

Sets the value of a property. This method is called by the component manager any time after reset when a property changes value.

Note: Components should silently ignore properties that do not affect the operation of the component.

Overrides:

setProperty in class XIncludeHandler

Parameters:

propertyId - The property identifier.

value - The value of the property.

Throws:

org.apache.xerces.xni.parser.XMLConfigurationException - Thrown for configuration error. In general, components should only throw this exception if it is really a critical error.