/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.commons.configuration.tree.xpath;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import org.apache.commons.configuration.tree.ConfigurationNode;
import org.apache.commons.jxpath.ri.Compiler;
import org.apache.commons.jxpath.ri.QName;
import org.apache.commons.jxpath.ri.compiler.NodeNameTest;
import org.apache.commons.jxpath.ri.compiler.NodeTest;
import org.apache.commons.jxpath.ri.compiler.NodeTypeTest;
import org.apache.commons.jxpath.ri.model.NodePointer;
import org.apache.commons.lang.StringUtils;
A specialized iterator implementation for the child nodes of a configuration
node.
Author: Commons
Configuration team Since: 1.3 Version: $Id: ConfigurationNodeIteratorChildren.java 1206493 2011-11-26 16:56:42Z oheger $
/**
* A specialized iterator implementation for the child nodes of a configuration
* node.
*
* @since 1.3
* @author <a
* href="http://commons.apache.org/configuration/team-list.html">Commons
* Configuration team</a>
* @version $Id: ConfigurationNodeIteratorChildren.java 1206493 2011-11-26 16:56:42Z oheger $
*/
class ConfigurationNodeIteratorChildren extends ConfigurationNodeIteratorBase
{
Creates a new instance of ConfigurationNodeIteratorChildren
and initializes it. Params: - parent – the parent pointer
- nodeTest – the test selecting the sub nodes
- reverse – the reverse flag
- startsWith – the first element of the iteration
/**
* Creates a new instance of {@code ConfigurationNodeIteratorChildren}
* and initializes it.
*
* @param parent the parent pointer
* @param nodeTest the test selecting the sub nodes
* @param reverse the reverse flag
* @param startsWith the first element of the iteration
*/
public ConfigurationNodeIteratorChildren(NodePointer parent,
NodeTest nodeTest, boolean reverse, NodePointer startsWith)
{
super(parent, reverse);
ConfigurationNode root = (ConfigurationNode) parent.getNode();
List<ConfigurationNode> childNodes = createSubNodeList(root, nodeTest);
initSubNodeList(childNodes);
if (startsWith != null)
{
setStartOffset(findStartIndex(root,
(ConfigurationNode) startsWith.getNode()));
}
}
Creates the list with sub nodes. This method gets called during
initialization phase. It finds out, based on the given test, which nodes
must be iterated over.
Params: - node – the current node
- test – the test object
Returns: a list with the matching nodes
/**
* Creates the list with sub nodes. This method gets called during
* initialization phase. It finds out, based on the given test, which nodes
* must be iterated over.
*
* @param node the current node
* @param test the test object
* @return a list with the matching nodes
*/
protected List<ConfigurationNode> createSubNodeList(ConfigurationNode node, NodeTest test)
{
List<ConfigurationNode> children = node.getChildren();
if (test == null)
{
return children;
}
else
{
if (test instanceof NodeNameTest)
{
NodeNameTest nameTest = (NodeNameTest) test;
QName name = nameTest.getNodeName();
if (name.getPrefix() == null)
{
if (nameTest.isWildcard())
{
return children;
}
List<ConfigurationNode> result = new ArrayList<ConfigurationNode>();
for (ConfigurationNode child : children)
{
if (StringUtils.equals(name.getName(), child.getName()))
{
result.add(child);
}
}
return result;
}
}
else if (test instanceof NodeTypeTest)
{
NodeTypeTest typeTest = (NodeTypeTest) test;
if (typeTest.getNodeType() == Compiler.NODE_TYPE_NODE
|| typeTest.getNodeType() == Compiler.NODE_TYPE_TEXT)
{
return children;
}
}
}
return Collections.emptyList();
}
Determines the start position of the iteration. Finds the index of the
given start node in the children of the root node.
Params: - node – the root node
- startNode – the start node
Returns: the start node's index
/**
* Determines the start position of the iteration. Finds the index of the
* given start node in the children of the root node.
*
* @param node the root node
* @param startNode the start node
* @return the start node's index
*/
protected int findStartIndex(ConfigurationNode node,
ConfigurationNode startNode)
{
for (int index = 0; index < node.getChildrenCount(); index++)
{
if (node.getChild(index) == startNode)
{
return index;
}
}
return -1;
}
}