Home » Core Java » xml » XPath » XPath descendant example

About Chandan Singh

Chandan holds a degree in Computer Engineering and is a passionate software programmer. He has good experience in Java/J2EE Web-Application development for Banking and E-Commerce Domains.

XPath descendant example

In this example we shall talk about the Descendant axis specifier in XPath. An axis specifier indicates the direction of navigation in DOM tree of that XML document. This helps in effectively querying the XML document.

The Descendant axis selects all the descendants of the current node. The ‘descendant’ refers to the children and grand-children of the current node.

We will look at a few examples to see how descendant works.

Consider the XML file below for our example. The File has a number of <cricketer> nodes under the <cricketers> tag representing a cricket team:


<?xml version="1.0" encoding="UTF-8"?>

	<cricketer type="righty">
		<name>MS Dhoni</name>
	<cricketer type="lefty">
		<name>Shikhar Dhawan</name>
	<cricketer type="righty">
		<name>Virat Kohli</name>
	<cricketer type="righty">
	<cricketer type="lefty">
		<name>Zaheer Khan</name>

Now, we will try to display names of all the children under cricketers tag using the descendant XPath axis.


import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.xpath.XPath;
import javax.xml.xpath.XPathConstants;
import javax.xml.xpath.XPathExpression;
import javax.xml.xpath.XPathFactory;

import org.w3c.dom.Document;
import org.w3c.dom.NodeList;

public class XpathDescendantDemo
	public static void main(String[] args) throws Exception

		DocumentBuilderFactory documentBuilderFactory = DocumentBuilderFactory.newInstance();
		DocumentBuilder documentBuilder = documentBuilderFactory.newDocumentBuilder();
		Document doc = documentBuilder.parse("src/cricketTeam_info.xml");

		XPathFactory xpathFactory = XPathFactory.newInstance();
		XPath xpath = xpathFactory.newXPath();

		//XPath descendant example
		XPathExpression expr = xpath.compile("/cricketers//*/name/text()");
		NodeList result = (NodeList) expr.evaluate(doc, XPathConstants.NODESET);
		System.out.println("The cricketers in the team are: ");
		for(int i = 0; i < result.getLength(); i++)



The cricketers in the team are: 
1.MS Dhoni
2.Shikhar Dhawan
3.Virat Kohli
5.Zaheer Khan

The descendant axis is represented in Java XpathExpression using the // operator. The descendant axis here selected all the child nodes(represented by * operator). From the Node Set, we extract and display the value of the ‘name’ tag.

This axis can be used to select the nodes when there are not enough attributes/sub-tags to query or when all the descendants of that tag are to be selected.

Download the Eclipse project

Here, we studied about the Descendant axis in Xpath, and how we can use the same to effectively query the xml document.

You can download the source code of this example here: XpathDescendentDemo.zip

Do you want to know how to develop your skillset to become a Java Rockstar?

Subscribe to our newsletter to start Rocking right now!

To get you started we give you our best selling eBooks for FREE!


1. JPA Mini Book

2. JVM Troubleshooting Guide

3. JUnit Tutorial for Unit Testing

4. Java Annotations Tutorial

5. Java Interview Questions

6. Spring Interview Questions

7. Android UI Design


and many more ....


Receive Java & Developer job alerts in your Area


Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Inline Feedbacks
View all comments