proguard.evaluation

Class ExecutingInvocationUnit.Builder

java.lang.Object

proguard.evaluation.ExecutingInvocationUnit.Builder

Enclosing class:

ExecutingInvocationUnit

public static class ExecutingInvocationUnit.Builder
extends java.lang.Object

Builds an ExecutingInvocationUnit.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	enableSameInstanceIdApproximation
protected java.util.List<Executor.Builder<?>>	registeredExecutorBuilders
protected boolean	useDefaultStringReflectionExecutor

Constructor Summary

Constructors

Constructor and Description
Builder(@NotNull ClassPool programClassPool, @NotNull ClassPool libraryClassPool)

Method Summary

Modifier and Type	Method and Description
ExecutingInvocationUnit.Builder	addExecutor(Executor.Builder<?> executor) Add an Executor to be considered by the ExecutingInvocationUnit when trying to analyze a method call.
ExecutingInvocationUnit.Builder	addExecutors(Executor.Builder<?>... executors) Add multiple Executors to be considered by the ExecutingInvocationUnit when trying to analyze a method call.
ExecutingInvocationUnit	build(ValueFactory valueFactory) Build the ExecutingInvocationUnit defined by this builder instance.
ExecutingInvocationUnit	buildWithoutDefaults(ValueFactory valueFactory) Build the ExecutingInvocationUnit defined by this builder instance, do not add the default executor even if otherwise specified.
ExecutingInvocationUnit.Builder	setAllowNonFinalConstants(boolean allowNonFinalConstants) By default, the ExecutingInvocationUnit will read constant value attributes from static final fields.
ExecutingInvocationUnit.Builder	setEnableSameInstanceIdApproximation(boolean enableSameInstanceIdApproximation) For methods that are not supported by any executor, decide, whether a method with matching return and instance types should be treated as a method which returns its instance.
ExecutingInvocationUnit.Builder	useDefaultStringReflectionExecutor(boolean useDefaultStringReflectionExecutor) Set this flag to false if the ExecutingInvocationUnit should not use StringReflectionExecutor by default.

Methods inherited from class java.lang.Object

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

Field Detail

enableSameInstanceIdApproximation

protected boolean enableSameInstanceIdApproximation

useDefaultStringReflectionExecutor

protected boolean useDefaultStringReflectionExecutor

registeredExecutorBuilders

protected java.util.List<Executor.Builder<?>> registeredExecutorBuilders

Constructor Detail

Builder

public Builder(@NotNull
               @NotNull ClassPool programClassPool,
               @NotNull
               @NotNull ClassPool libraryClassPool)

Method Detail

setEnableSameInstanceIdApproximation

public ExecutingInvocationUnit.Builder setEnableSameInstanceIdApproximation(boolean enableSameInstanceIdApproximation)

For methods that are not supported by any executor, decide, whether a method with matching return and instance types should be treated as a method which returns its instance. In such a case, setting this flag to true will result in no new ID being created for the return value.

Parameters:

enableSameInstanceIdApproximation - whether the approximation should be enabled.

setAllowNonFinalConstants

public ExecutingInvocationUnit.Builder setAllowNonFinalConstants(boolean allowNonFinalConstants)

By default, the ExecutingInvocationUnit will read constant value attributes from static final fields. This method allows for reading constant value attributes from non-final static fields as well.

Parameters:

allowNonFinalConstants - whether reading from non-final constants should be enabled.

addExecutor

public ExecutingInvocationUnit.Builder addExecutor(Executor.Builder<?> executor)

Add an Executor to be considered by the ExecutingInvocationUnit when trying to analyze a method call.

N.B.: If a method is supported by different executors the first one added gets priority. If useDefaultStringReflectionExecutor(boolean) is not set to false the default StringReflectionExecutor has the highest priority.

Parameters:

executor - A Executor.Builder of the Executor to be added.

addExecutors

public ExecutingInvocationUnit.Builder addExecutors(Executor.Builder<?>... executors)

Add multiple Executors to be considered by the ExecutingInvocationUnit when trying to analyze a method call.

N.B.: If a method is supported by different executors the first one added gets priority. If useDefaultStringReflectionExecutor(boolean) is not set to false the default StringReflectionExecutor has the highest priority.

Parameters:

executors - Executor.Builders of the Executors to be added.

useDefaultStringReflectionExecutor

public ExecutingInvocationUnit.Builder useDefaultStringReflectionExecutor(boolean useDefaultStringReflectionExecutor)

Set this flag to false if the ExecutingInvocationUnit should not use StringReflectionExecutor by default.

Parameters:

useDefaultStringReflectionExecutor - whether a default StringReflectionExecutor should be used.

build

public ExecutingInvocationUnit build(ValueFactory valueFactory)

Build the ExecutingInvocationUnit defined by this builder instance.

Parameters:

valueFactory - The ValueFactory responsible for creating result values.

Returns:

The built ExecutingInvocationUnit

buildWithoutDefaults

public ExecutingInvocationUnit buildWithoutDefaults(ValueFactory valueFactory)

Build the ExecutingInvocationUnit defined by this builder instance, do not add the default executor even if otherwise specified.

Parameters:

valueFactory - The ValueFactory responsible for creating result values.

Returns:

The built ExecutingInvocationUnit