randoop

Class MethodReplacements

java.lang.Object

randoop.MethodReplacements

public class MethodReplacements
extends java.lang.Object

Class used to communicate values from the replacecall agent to Randoop.

Includes:

1. The signatures of methods replaced by the replacecall agent to Randoop so Randoop can omit direct calls to these methods. Any method that is being replaced shouldn't be directly called.
2. The absolute path to the agent jar, and the arguments used when the agent was run, which allow the agent to be run in the same way within Randoop.

Uses synchronized access to a static list of the signature strings, because the replacecall agent can run on multiple classes concurrently.

This list is set by ReplaceCallAgent.premain(String, Instrumentation) before the CallReplacementTransformer is added to the class loader, and the method setReplacedMethods(List) should only be called at that point. Randoop should add the result of getSignatureList() to the --omit-methods patterns before starting generation.

Constructor Summary

Constructors

Constructor and Description
MethodReplacements() Do not Create a MethodReplacements.

Method Summary

Modifier and Type	Method and Description
static @Nullable java.lang.String	getAgentArgs() Get the argument string for running the agent.
static @Nullable java.lang.String	getAgentPath() Get the path to the agent jar file.
static java.util.List<java.lang.String>	getSignatureList() Returns a copy of the signature list in this class.
static void	setAgentArgs(java.lang.String agentArgs) Set the argument string of the agent.
static void	setAgentPath(java.lang.String agentPath) Set the path of the agent jar file.
static void	setReplacedMethods(java.util.List<java.lang.String> sigList) Copies the given list of method signature strings to the list in this object, overwriting the previous list.

Methods inherited from class java.lang.Object

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

Constructor Detail

MethodReplacements

public MethodReplacements()

Do not Create a MethodReplacements.

Method Detail

setReplacedMethods

public static void setReplacedMethods(java.util.List<java.lang.String> sigList)

Copies the given list of method signature strings to the list in this object, overwriting the previous list.

Should only be called once.

Parameters:

sigList - the method signature list

getSignatureList

public static java.util.List<java.lang.String> getSignatureList()

Returns a copy of the signature list in this class.

Returns:

the list of signature strings set by setReplacedMethods(List), or the empty list if that method hasn't been called

setAgentPath

public static void setAgentPath(java.lang.String agentPath)

Set the path of the agent jar file.

Parameters:

agentPath - the agent jar file path

setAgentArgs

public static void setAgentArgs(java.lang.String agentArgs)

Set the argument string of the agent.

Parameters:

agentArgs - the argument string for the agent

getAgentPath

public static @Nullable java.lang.String getAgentPath()

Get the path to the agent jar file.

Returns:

the path to the agent jar file

getAgentArgs

public static @Nullable java.lang.String getAgentArgs()

Get the argument string for running the agent.

Returns:

the argument string