soot.jbco.jimpleTransformations

Class ClassRenamer

java.lang.Object

soot.Transformer

soot.SceneTransformer

soot.jbco.jimpleTransformations.ClassRenamer

All Implemented Interfaces:

IJbcoTransform

public class ClassRenamer
extends SceneTransformer
implements IJbcoTransform

SceneTransformer that renames class names as well as packages.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	name

Fields inherited from interface soot.jbco.IJbcoTransform

debug, out, output

Constructor Summary

Constructors

Constructor and Description
ClassRenamer(Singletons.Global global) Singleton constructor.

Method Summary

Modifier and Type	Method and Description
void	addClassNameMapping(java.lang.String classNameSource, java.lang.String classNameTarget) Adds mapping for class name.
java.util.Map<java.lang.String,java.lang.String>	getClassNameMapping(java.util.function.BiPredicate<java.lang.String,java.lang.String> predicate) Gets mapping by predicate.
java.lang.String[]	getDependencies() Gets array of jbco transformer code names on which current transformer depends on.
java.lang.String	getName() Gets the code name of jbco transformer implementation.
java.lang.String	getNewName(java.lang.String packageName, java.lang.String className) Generates new unique name that have not existed before and mapping for it.
static java.lang.String	getPackageName(java.lang.String fullyQualifiedClassName) Extracts package name from class name.
protected void	internalTransform(java.lang.String phaseName, java.util.Map<java.lang.String,java.lang.String> options) Performs the transformation on the Scene, under the given phaseName and with the given Options.
boolean	isRemovePackages() Checks if transformer must remove package from fully qualified class name.
boolean	isRenamePackages() Checks if transformer must rename package in fully qualified class name.
void	outputSummary() Prints summary of the produced changes.
void	setRemovePackages(boolean removePackages) Sets flag indicating that transformer must remove package from fully qualified class name.
void	setRenamePackages(boolean renamePackages) Sets flag indicating that transformer must rename package in fully qualified class name.
static ClassRenamer	v() Singleton getter.

Methods inherited from class soot.SceneTransformer

transform, transform, transform

Methods inherited from class java.lang.Object

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

Methods inherited from interface soot.jbco.IJbcoTransform

isDebugEnabled, isVerbose

Field Detail

name

public static final java.lang.String name

See Also:

Constant Field Values

Constructor Detail

ClassRenamer

public ClassRenamer(Singletons.Global global)

Singleton constructor.

Parameters:

global - the singletons container. Must not be null

Throws:

java.lang.NullPointerException - when global argument is null

Method Detail

v

public static ClassRenamer v()

Singleton getter.

Returns:

returns instance of ClassRenamer

getName

public java.lang.String getName()

Description copied from interface: IJbcoTransform

Gets the code name of jbco transformer implementation.

Specified by:

getName in interface IJbcoTransform

Returns:

the code name of jbco transformer

getDependencies

public java.lang.String[] getDependencies()

Description copied from interface: IJbcoTransform

Gets array of jbco transformer code names on which current transformer depends on.

Specified by:

getDependencies in interface IJbcoTransform

Returns:

array of code names

outputSummary

public void outputSummary()

Description copied from interface: IJbcoTransform

Prints summary of the produced changes.

Specified by:

outputSummary in interface IJbcoTransform

isRemovePackages

public boolean isRemovePackages()

Checks if transformer must remove package from fully qualified class name.

Returns:

true if ClassRenamer removes packages from fully qualified class name; false otherwise

setRemovePackages

public void setRemovePackages(boolean removePackages)

Sets flag indicating that transformer must remove package from fully qualified class name.

Parameters:

removePackages - the flag value

isRenamePackages

public boolean isRenamePackages()

Checks if transformer must rename package in fully qualified class name.

Returns:

true if ClassRenamer renames packages in fully qualified class name; false otherwise

setRenamePackages

public void setRenamePackages(boolean renamePackages)

Sets flag indicating that transformer must rename package in fully qualified class name.

Parameters:

renamePackages - the flag value

addClassNameMapping

public void addClassNameMapping(java.lang.String classNameSource,
                                java.lang.String classNameTarget)

Adds mapping for class name.

Parameters:

classNameSource - the class name to rename

classNameTarget - the new class name

getClassNameMapping

public java.util.Map<java.lang.String,java.lang.String> getClassNameMapping(java.util.function.BiPredicate<java.lang.String,java.lang.String> predicate)

Gets mapping by predicate.

Parameters:

predicate - the predicate to decide if mapping should be filtered. Can be null

internalTransform

protected void internalTransform(java.lang.String phaseName,
                                 java.util.Map<java.lang.String,java.lang.String> options)

Description copied from class: SceneTransformer

Performs the transformation on the Scene, under the given phaseName and with the given Options.

Specified by:

internalTransform in class SceneTransformer

getNewName

public java.lang.String getNewName(java.lang.String packageName,
                                   java.lang.String className)

Generates new unique name that have not existed before and mapping for it.

Parameters:

packageName - the package where class is located. Can be null

className - the class name (without package) to create mapping for. Can be null

Returns:

the new unique name

getPackageName

public static java.lang.String getPackageName(java.lang.String fullyQualifiedClassName)

Extracts package name from class name.

Parameters:

fullyQualifiedClassName - the fully qualified class name. Can be null

Returns:

package name or empty string when class name is null or no '.' in name