com.puppycrawl.tools.checkstyle.xpath

Class XpathQueryGenerator

java.lang.Object

com.puppycrawl.tools.checkstyle.xpath.XpathQueryGenerator

public class XpathQueryGenerator
extends Object

Generates xpath queries. Xpath queries are generated based on received DetailAst element, line number and column number.

Example class

 public class Main {

     public String sayHello(String name) {
         return "Hello, " + name;
     }
 }
 

Following expression returns list of queries. Each query is the string representing full path to the node inside Xpath tree, whose line number is 3 and column number is 4.

     new XpathQueryGenerator(rootAst, 3, 4).generate();
 

Result list

• /CLASS_DEF[@text='Main']/OBJBLOCK/METHOD_DEF[@text='sayHello']
• /CLASS_DEF[@text='Main']/OBJBLOCK/METHOD_DEF[@text='sayHello']/MODIFIERS
• /CLASS_DEF[@text='Main']/OBJBLOCK/METHOD_DEF[@text='sayHello']/MODIFIERS/LITERAL_PUBLIC

Author:

Timur Tibeyev.

Constructor Summary

Constructors

Constructor and Description
XpathQueryGenerator(DetailAST rootAst, int lineNumber, int columnNumber, FileText fileText, int tabWidth) Creates a new XpathQueryGenerator instance.

Method Summary

Modifier and Type	Method and Description
List<String>	generate() Returns list of xpath queries of nodes, matching line and column number.

Methods inherited from class java.lang.Object

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

Constructor Detail

XpathQueryGenerator

public XpathQueryGenerator(DetailAST rootAst,
                           int lineNumber,
                           int columnNumber,
                           FileText fileText,
                           int tabWidth)

Creates a new XpathQueryGenerator instance.

Parameters:

rootAst - root ast

lineNumber - line number of the element for which the query should be generated

columnNumber - column number of the element for which the query should be generated

fileText - the FileText object

tabWidth - distance between tab stop position

Method Detail

generate

public List<String> generate()

Returns list of xpath queries of nodes, matching line and column number. This approach uses DetailAST traversal. DetailAST means detail abstract syntax tree.

Returns:

list of xpath queries of nodes, matching line and column number