org.benf.cfr.reader.state

Class ClassFileSourceChained

java.lang.Object

org.benf.cfr.reader.state.ClassFileSourceChained

All Implemented Interfaces:

ClassFileSource, ClassFileSource2

public class ClassFileSourceChained
extends Object
implements ClassFileSource2

Nested Class Summary

Nested classes/interfaces inherited from interface org.benf.cfr.reader.api.ClassFileSource

ClassFileSource.Factory

Constructor Summary

Constructors

Constructor and Description
ClassFileSourceChained(Collection<ClassFileSource2> sources)

Method Summary

Modifier and Type	Method and Description
Collection<String>	addJar(String jarPath) CFR would like to know about all classes contained within the jar at jarPath
JarContent	addJarContent(String jarPath, AnalysisType analysisType) CFR would like to know about all classes contained within the jar at jarPath
Pair<byte[],String>	getClassFileContent(String path) Given a path to a class file, return a pair of * the content, as a byte array.
String	getPossiblyRenamedPath(String path) It's possible that an obfuscator might have generated a bizarre and magic file inside a jar such that it's path is too big to read.
void	informAnalysisRelativePathDetail(String usePath, String classFilePath) CFR has loaded your class, and it has decided that if it were in the correct location, it would instead be at classFilePath.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassFileSourceChained

public ClassFileSourceChained(Collection<ClassFileSource2> sources)

Method Detail

addJarContent

public JarContent addJarContent(String jarPath,
                                AnalysisType analysisType)

Description copied from interface: ClassFileSource2

CFR would like to know about all classes contained within the jar at jarPath

Specified by:

addJarContent in interface ClassFileSource2

Parameters:

jarPath - path to a jar.

Returns:

@{link JarContent} for this jar.

informAnalysisRelativePathDetail

public void informAnalysisRelativePathDetail(String usePath,
                                             String classFilePath)

Description copied from interface: ClassFileSource

CFR has loaded your class, and it has decided that if it were in the correct location, it would instead be at classFilePath. This information should be taken into account when loading any inner classes, or other classes that CFR tries to load in order to improve decompilation. Why do you care? Let's say you have a class in a top level outside its normal structure, Bob.class. It should be found at org/person/Bob.class. Implementors of this will be called back with "", and "org/person", telling you that org.person are implicit in your path. CFR may later ask you to load "org/person/Bob$1.class". You should adjust this path to match where Bob$1 actually is. This will also be called with null, null to reset.

Specified by:

informAnalysisRelativePathDetail in interface ClassFileSource

Parameters:

usePath - the path that was used to load a class file.

classFilePath - the path that CFR actually suspects it should have been, based on package name.

addJar

public Collection<String> addJar(String jarPath)

Description copied from interface: ClassFileSource

CFR would like to know about all classes contained within the jar at jarPath

Specified by:

addJar in interface ClassFileSource

Parameters:

jarPath - path to a jar.

Returns:

paths (inside jar) of all classes.

getPossiblyRenamedPath

public String getPossiblyRenamedPath(String path)

Description copied from interface: ClassFileSource

It's possible that an obfuscator might have generated a bizarre and magic file inside a jar such that it's path is too big to read. Or it's invalid. This allows you to remap paths.

Specified by:

getPossiblyRenamedPath in interface ClassFileSource

Parameters:

path - Path CFR would like to use

Returns:

Remapped path.

getClassFileContent

public Pair<byte[],String> getClassFileContent(String path)
                                        throws IOException

Description copied from interface: ClassFileSource

Given a path to a class file, return a pair of * the content, as a byte array. * the path where you found this.

Specified by:

getClassFileContent in interface ClassFileSource

Parameters:

path - relative path of class we wish to load.

Returns:

Pair<byte[], String> of class file content, and file location.

Throws:

IOException - if you can't find the class.