ro.sync.contentcompletion.xml
Class Context

java.lang.Object
  ro.sync.contentcompletion.xml.Context

All Implemented Interfaces:

java.lang.Cloneable

Direct Known Subclasses:

WhatElementsCanGoHereContext

@API(type=EXTENDABLE,
     src=PRIVATE)
public class Context
extends java.lang.Object
implements java.lang.Cloneable

The context for a node contains:

• elementStack - the stack with ContextElement up to the root. These represent the ancestors of the element for which the Context was built.
• previousSiblingElements - the list with the ContextElement representing the siblings of the element for which the Context was built.
• proxyNamespaceMapping - The mapping between namespace prefixes and URI's to the point where the Context was built.

Field Summary

protected java.util.Stack<ContextElement>	elementStack The stack with the ContextElement objects, ancestors of the element for which the Context was built.
protected ProxyNamespaceMapping	prefixNamespaceMapping The mapping between namespace prefixes and URI's determined to the point where the Context was built.
protected java.util.List<ContextElement>	previousSiblingElements The list of ContextElement objects representing the previous siblings (in document order) of the element for which the Context was built.
protected org.xml.sax.XMLReader	xmlReader The XMLReader used to create sources for executing XPath expressions in the Context.

Constructor Summary

Context()

Method Summary

java.lang.Object	clone()
java.util.List<java.lang.String>	executeXPath(java.lang.String expression, java.lang.String[] prefixNamespaceMappings) Executes an XPath expression over a simplified version of the entire document.
java.util.Stack<ContextElement>	getElementStack() Gets the stack of ContextElement representing the ancestors of the element for which the Context was built.
java.util.List	getIdValuesList()
ProxyNamespaceMapping	getPrefixNamespaceMapping() Gets the mapping between namespace prefixes and URI's to the point the Context was built.
java.util.List<ContextElement>	getPreviousSiblingElements() Get the list of previous sibling elements of the element the Context was built for.
Attribute[]	getRootAttributes() Get the list with the attributes of the root element.
void	pushContextElement(ContextElement element, java.util.List<ContextElement> previousSiblingElements) Updates the context by adding the given element in the context.
void	setElementStack(java.util.Stack<ContextElement> elementStack) Sets the stack consisting of ContextElement representing the ancestor elements of the element for which the Context was built.
void	setIdValuesList(java.util.List idValuesList)
void	setPrefixNamespaceMapping(ProxyNamespaceMapping prefixNamespaceMapping) Sets the mapping between the namespace prefixes and URI's to the point where the Context was built.
void	setPreviousSiblingElements(java.util.List<ContextElement> previousSiblingElements) Sets the list of ContextElement representing the previous siblings (in document order) of the element the Context was built for.
void	setXMLReader(org.xml.sax.XMLReader xmlReader) Set the XMLReader used for creating a SAX source.

Methods inherited from class java.lang.Object

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

Field Detail

elementStack

protected java.util.Stack<ContextElement> elementStack

The stack with the ContextElement objects, ancestors of the element for which the Context was built.

prefixNamespaceMapping

protected ProxyNamespaceMapping prefixNamespaceMapping

The mapping between namespace prefixes and URI's determined to the point where the Context was built.

previousSiblingElements

protected java.util.List<ContextElement> previousSiblingElements

The list of ContextElement objects representing the previous siblings (in document order) of the element for which the Context was built.

xmlReader

protected org.xml.sax.XMLReader xmlReader

The XMLReader used to create sources for executing XPath expressions in the Context.

Constructor Detail

Context

public Context()

Method Detail

setElementStack

public void setElementStack(java.util.Stack<ContextElement> elementStack)

Sets the stack consisting of ContextElement representing the ancestor elements of the element for which the Context was built. The root is always added the first on the stack.

Parameters:

elementStack - The stack of ancestor ContextElement.

getElementStack

public java.util.Stack<ContextElement> getElementStack()

Gets the stack of ContextElement representing the ancestors of the element for which the Context was built. The root is always added the first on the stack.

Returns:

The stack with the ancestor ContextElement.

setPrefixNamespaceMapping

public void setPrefixNamespaceMapping(ProxyNamespaceMapping prefixNamespaceMapping)

Sets the mapping between the namespace prefixes and URI's to the point where the Context was built.

Parameters:

prefixNamespaceMapping - The new mapping to be set.

getPrefixNamespaceMapping

public ProxyNamespaceMapping getPrefixNamespaceMapping()

Gets the mapping between namespace prefixes and URI's to the point the Context was built.

Returns:

The mapping between namespace prefixes and URI's.

getRootAttributes

public Attribute[] getRootAttributes()

Get the list with the attributes of the root element.

Returns:

A list of Attribute objects representing the attributes of the root element.

setPreviousSiblingElements

public void setPreviousSiblingElements(java.util.List<ContextElement> previousSiblingElements)

Sets the list of ContextElement representing the previous siblings (in document order) of the element the Context was built for.

Parameters:

previousSiblingElements - The list of previous sibling ContextElement.

getPreviousSiblingElements

public java.util.List<ContextElement> getPreviousSiblingElements()

Get the list of previous sibling elements of the element the Context was built for.

Returns:

The list of previous sibling ContextElement, or null if no previous siblings exist for the current element.

executeXPath

public java.util.List<java.lang.String> executeXPath(java.lang.String expression,
                                                     java.lang.String[] prefixNamespaceMappings)

Executes an XPath expression over a simplified version of the entire document. The XML Reader over which the XPath is run does not contain any text nodes so this method is useful only for gathering attribute values which adhere to certain conditions (like //@id).

Parameters:

expression - The XPath expression to be executed.

prefixNamespaceMappings - An array of prefixes followed by namespace URI's representing the namespace mappings to the point of the Context.
Example:
{"xsl", "http://www.w3.org/1999/XSL/Transform", "xsd", "http://www.w3.org/2001/XMLSchema"}

Returns:

A list of strings representing the XPath results, never null.

setXMLReader

public void setXMLReader(org.xml.sax.XMLReader xmlReader)

Set the XMLReader used for creating a SAX source. The content completion proposals for XSD and XSL documents are obtained by running XPath queries on this SAX source.

Parameters:

xmlReader - The new XMLReader.

pushContextElement

public void pushContextElement(ContextElement element,
                               java.util.List<ContextElement> previousSiblingElements)

Updates the context by adding the given element in the context. The new context can be used to get what elements can be added in the given element after the given previous children.

Parameters:

element - Context element to be added.

previousSiblingElements - Previous siblings for the new insert position. They are children of the given element and the insertion position is after them.

clone

public java.lang.Object clone()

Overrides:

clone in class java.lang.Object

See Also:

Object.clone()

setIdValuesList

public void setIdValuesList(java.util.List idValuesList)

Parameters:

idValuesList - The list of string values representing all ID's collected from the XML document.

getIdValuesList

public java.util.List getIdValuesList()

Returns:

Returns a list of string values representing all ID's collected from the XML document.