org.jenkinsci.bytecode.helper

Class ClassLoadingReferenceTypeHierachyReader

java.lang.Object

org.jenkinsci.bytecode.helper.ClassLoadingReferenceTypeHierachyReader

public class ClassLoadingReferenceTypeHierachyReader
extends Object

A TypeHierarchyReader that uses a given ClassLoader to locate class definitions. Like its super class this class does not load the class nor does it provide any caching - but it uses the specified ClassLoader in order to find the byte-code.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TypeHierarchyReader.TypeHierarchy

Constructor Summary

Constructors

Constructor and Description
ClassLoadingReferenceTypeHierachyReader(ClassLoader classLoader)

Method Summary

Modifier and Type	Method and Description
String	getCommonSuperClass(String type1, String type2)
org.kohsuke.asm6.Type	getSuperClass(org.kohsuke.asm6.Type t) Returns a Type representing the superclass of the given Type t.
TypeHierarchyReader.TypeHierarchy	hierarchyOf(org.kohsuke.asm6.Type t) Obtains the TypeHierarchyReader.TypeHierarchy for the given Type t.
boolean	isAssignableFrom(org.kohsuke.asm6.Type to, org.kohsuke.asm6.Type from) Determines if the Type to is the same class, a superclass, or superinterface of the given Type from.
boolean	isInterface(org.kohsuke.asm6.Type t) Returns true if the given Type represents an interface.
protected TypeHierarchyReader.TypeHierarchy	obtainHierarchyOf(org.kohsuke.asm6.ClassReader reader)
protected org.kohsuke.asm6.ClassReader	reader(org.kohsuke.asm6.Type t) Returns a ClassReader instance which has read the class file represented by the Type t.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassLoadingReferenceTypeHierachyReader

public ClassLoadingReferenceTypeHierachyReader(ClassLoader classLoader)

Parameters:

classLoader - the ClassLoader used to locate the byte-code to parse.

Method Detail

reader

protected org.kohsuke.asm6.ClassReader reader(org.kohsuke.asm6.Type t)
                                       throws IOException

Returns a ClassReader instance which has read the class file represented by the Type t. This implementation returns a ClassReader which has been initialised with the class data located using the classLoader provided in the constructor.

Throws:

IOException

See Also:

ClassReader.ClassReader(String), ClassReader.ClassReader(InputStream)

isInterface

public boolean isInterface(org.kohsuke.asm6.Type t)

Returns true if the given Type represents an interface.

See Also:

Class.isInterface()

getSuperClass

public org.kohsuke.asm6.Type getSuperClass(org.kohsuke.asm6.Type t)

Returns a Type representing the superclass of the given Type t.

Semantically equivalent to Class.getSuperclass(). That is, with Classes X and Y where X.getSuperclass() returns Y, and the Types tX and tY representing X and Y respectively, this.getSuperClass(tX) returns tY. It matches Class.getSuperclass()'s behaviour for primitive, array and void types, where the given Type's have the equivalent Type.getSort() values.

See Also:

Class.getSuperclass(), Type.getSort()

isAssignableFrom

public boolean isAssignableFrom(org.kohsuke.asm6.Type to,
                                org.kohsuke.asm6.Type from)

Determines if the Type to is the same class, a superclass, or superinterface of the given Type from. Semantically equivalent to Class.isAssignableFrom(Class), where to represents this Class object. That is, with any given Classes X and Y, and Types tX and tY, the following statements will always be true:
X.isAssignableFrom(Y) == this.isAssignableFrom(tX, tY)

Note that, in accordance with Class.isAssignableFrom(Class), this method does not return true for Type's representing primitives that can be converted (i.e. widened or narrowed) to represent the same type.

Returns:

true if instances of from can be legally assigned to instances of to, else false

getCommonSuperClass

public String getCommonSuperClass(String type1,
                                  String type2)

hierarchyOf

public TypeHierarchyReader.TypeHierarchy hierarchyOf(org.kohsuke.asm6.Type t)

Obtains the TypeHierarchyReader.TypeHierarchy for the given Type t.
This method represents a suitable point for caching TypeHierarchyReader.TypeHierarchy results.

obtainHierarchyOf

protected TypeHierarchyReader.TypeHierarchy obtainHierarchyOf(org.kohsuke.asm6.ClassReader reader)