Package net.sourceforge.pmd.lang.java.ast

Class JavaQualifiedName

java.lang.Object

net.sourceforge.pmd.lang.java.ast.JavaQualifiedName

All Implemented Interfaces:

net.sourceforge.pmd.lang.ast.QualifiedName

public final class JavaQualifiedName
extends java.lang.Object
implements net.sourceforge.pmd.lang.ast.QualifiedName

Represents Qualified Names for use within the java metrics framework.

Method Summary

Modifier and Type	Method	Description
boolean	equals(java.lang.Object o)
java.lang.String[]	getClasses()	Returns the class specific part of the name.
JavaQualifiedName	getClassName()
java.lang.String	getOperation()	Returns the operation specific part of the name.
java.lang.String[]	getPackages()	Returns the packages.
int	hashCode()
boolean	isClass()
boolean	isLocalClass()	Returns true if this qname identifies a local class.
boolean	isOperation()
static JavaQualifiedName	ofClass(java.lang.Class<?> clazz)	Gets the qualified name of a class.
static JavaQualifiedName	ofString(java.lang.String name)	Parses a qualified name given in the format defined for this implementation.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

ofClass

public static JavaQualifiedName ofClass(java.lang.Class<?> clazz)

Gets the qualified name of a class.

Parameters:

clazz - Class object

Returns:

The qualified name of the class, or null if the class is null

ofString

public static JavaQualifiedName ofString(java.lang.String name)

Parses a qualified name given in the format defined for this implementation. The format is specified by a regex pattern (see FORMAT). Examples:

com.company.MyClass$Nested#myMethod(String, int)

• Packages are separated by full stops;
• Nested classes are separated by a dollar symbol;
• The optional method suffix is separated from the class with a hashtag;
• Method arguments are separated by a comma and a single space.

.MyClass$Nested

• A class in the unnamed package is preceded by a single full stop.

com.foo.Class$1LocalClass

• A local class' qualified name is assigned an index which identifies it within the scope of its enclosing class. The index is displayed after the separating dollar symbol.

Parameters:

name - The name to parse.

Returns:

A qualified name instance corresponding to the parsed string.

isClass

public boolean isClass()

Specified by:

isClass in interface net.sourceforge.pmd.lang.ast.QualifiedName

isOperation

public boolean isOperation()

Specified by:

isOperation in interface net.sourceforge.pmd.lang.ast.QualifiedName

isLocalClass

public boolean isLocalClass()

Returns true if this qname identifies a local class.

getPackages

public java.lang.String[] getPackages()

Returns the packages. This is specific to Java's package structure.

Returns:

The packages.

getClasses

public java.lang.String[] getClasses()

Returns the class specific part of the name. It identifies a class in the namespace it's declared in. If the class is nested inside another, then the array returned contains all enclosing classes in order.

Returns:

The class names array.

getOperation

public java.lang.String getOperation()

Returns the operation specific part of the name. It identifies an operation in its namespace.

Returns:

The operation string.

getClassName

public JavaQualifiedName getClassName()

Specified by:

getClassName in interface net.sourceforge.pmd.lang.ast.QualifiedName

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Specified by:

toString in interface net.sourceforge.pmd.lang.ast.QualifiedName

Overrides:

toString in class java.lang.Object