Class GroupBoundaryTester

  • Direct Known Subclasses:
    GroupAdjacentTester, GroupEndingTester, GroupStartingTester

    public abstract class GroupBoundaryTester
    extends java.lang.Object
    This feed supports xsl:for-each-group in streaming mode. It is supplied with all the nodes selected by the xsl:for-each-group instruction (in composed form); it decides whether a node is the first in a new group, and if so, triggers the start/end-of-group actions. It also feeds every node into a push pipeline that reflects the processing of the "current-group" variable.

    The items received by this Feed will generally be supplied by a CopyOfWatch. There is scope for future optimization to prevent the selected nodes being unnecessarily composed in memory.

    There are thus two destinations into which this class feeds. The first, identified by the usual result variable, receives every item in the group, and is notified of the start and end of a group by calling its open() and close() methods. This destination processes the instructions within the for-each-group instruction before and after the reference to the grouping variable. The second destination, identified by the variable outerFeed, has its open() method called at the beginning of processing the population, and its close() method called at the end of processing the population; its append() method is called with the items that result from evaluation of the for-each-group body.

    • Method Detail

      • getLocalContext

        protected XPathContext getLocalContext()
      • setControllingExpression

        public void setControllingExpression​(ForEachGroup controllingExpression)
      • getControllingExpression

        public ForEachGroup getControllingExpression()
      • notifyItem

        public abstract boolean notifyItem()
                                    throws XPathException
        Signal that a new item that matches the selection has been found. The new item will be the context item (and its position will be the context position) in the current iterator of the supplied context object
        Returns:
        true if this item is the start of a new group
        Throws:
        XPathException - May be raised if a dynamic error occurs