Package net.sf.saxon.tree.tiny

Class GraftedElement

  • All Implemented Interfaces:
    Iterable<NodeInfo>, Source, SourceLocator, Location, GroundedValue<NodeInfo>, Item<NodeInfo>, NodeInfo, Sequence<NodeInfo>, Locator
    public class GraftedElement
extends TinyElementImpl
    This class represents an element node in a TinyTree that is actually a reference to an element node held elsewhere. Some properties of the node come from the containing TinyTree (for example, document number, base URI, etc) while others are actually properties of the external node. Notably, the parent and siblings of the node are found in the containing tree, while the children and descendants (and attributes) are found in the external tree.

    • Constructor Detail

      • GraftedElement

        public GraftedElement​(TinyTree tree,
                      int nodeNr,
                      NodeInfo externalNode,
                      boolean copyNamespaces)
        Created a grafted element node
        Parameters:
        tree - the host tree that is to contain a reference to an external node
        nodeNr - the node number at which the external reference is to appear
        externalNode - the external node, in some other tree
        copyNamespaces - indicates whether namespaces in the external tree are retained in the virtual copy.

    • Method Detail

      • getExternalNode

        public NodeInfo getExternalNode()

      • copy

        public void copy​(Receiver receiver,
                 int copyOptions,
                 Location location)
          throws XPathException
        Description copied from class: TinyElementImpl
        Copy this node to a given receiver
        Specified by:
        copy in interface NodeInfo
        Overrides:
        copy in class TinyElementImpl
        Parameters:
        receiver - the Receiver to which the node should be copied. It is the caller's responsibility to ensure that this Receiver is open before the method is called (or that it is self-opening), and that it is closed after use.
        copyOptions - determines handling of namespaces, etc
        location - location information associated with the event
        Throws:
        XPathException - if any downstream error occurs

      • iterateAxis

        public AxisIterator iterateAxis​(byte axisNumber)
        Description copied from class: TinyNodeImpl
        Return an iterator over all the nodes reached by the given axis from this node
        Specified by:
        iterateAxis in interface NodeInfo
        Overrides:
        iterateAxis in class TinyNodeImpl
        Parameters:
        axisNumber - Identifies the required axis, eg. Axis.CHILD or Axis.PARENT
        Returns:
        a AxisIteratorImpl that scans the nodes reached by the axis in turn.
        See Also:
        AxisInfo

      • iterateAxis

        public AxisIterator iterateAxis​(byte axisNumber,
                                NodeTest nodeTest)
        Description copied from class: TinyNodeImpl
        Return an iterator over the nodes reached by the given axis from this node
        Specified by:
        iterateAxis in interface NodeInfo
        Overrides:
        iterateAxis in class TinyNodeImpl
        Parameters:
        axisNumber - Identifies the required axis, eg. Axis.CHILD or Axis.PARENT
        nodeTest - A pattern to be matched by the returned nodes.
        Returns:
        a AxisIteratorImpl that scans the nodes reached by the axis in turn.
        See Also:
        AxisInfo

      • getAttributeValue

        public String getAttributeValue​(int fp)
        Get the value of the attribute with a given fingerprint.
        Overrides:
        getAttributeValue in class TinyElementImpl
        Parameters:
        fp - the fingerprint of the required attribute
        Returns:
        the string value of the attribute if present, or null if absent

      • getAttributeValue

        public String getAttributeValue​(String uri,
                                String local)
        Description copied from class: TinyElementImpl
        Get the string value of a given attribute of this node
        Specified by:
        getAttributeValue in interface NodeInfo
        Overrides:
        getAttributeValue in class TinyElementImpl
        Parameters:
        uri - the namespace URI of the attribute name. Supply the empty string for an attribute that is in no namespace
        local - the local part of the attribute name.
        Returns:
        the attribute value if it exists, or null if it does not exist. Always returns null if this node is not an element.

      • hasDefaultNamespace

        public boolean hasDefaultNamespace()

      • getDeclaredNamespaces

        public NamespaceBinding[] getDeclaredNamespaces​(NamespaceBinding[] buffer)
        Description copied from class: TinyElementImpl
        Get all namespace undeclarations and undeclarations defined on this element.
        Specified by:
        getDeclaredNamespaces in interface NodeInfo
        Overrides:
        getDeclaredNamespaces in class TinyElementImpl
        Parameters:
        buffer - If this is non-null, and the result array fits in this buffer, then the result may overwrite the contents of this array, to avoid the cost of allocating a new array on the heap.
        Returns:
        An array of objects representing the namespace declarations and undeclarations present on this element. For a node other than an element, return null. Otherwise, the returned array is a sequence of namespace binding objects (essentially prefix/uri pairs) If the URI is null, then this is a namespace undeclaration rather than a declaration. The XML namespace is never included in the list. If the supplied array is larger than required, then the first unused entry will be set to null.