org.eclipse.hyades.test.tools.plugin.runner
Class EclipseTesterAgent

java.lang.Object
  org.eclipse.hyades.test.tools.plugin.runner.EclipseTesterAgent

public class EclipseTesterAgent

extends java.lang.Object

This agent handles commands for loading and unloading bundles, as well as launching tests. It is embedded in the target eclipse instance and used to communicate with the "local" eclipse instance, for the purpose of launching tests and sending back the test logs.

Nested Class Summary

class

EclipseTesterAgent.Commandhandler

Field Summary

protected org.eclipse.hyades.internal.execution.remote.RemoteComponentSkeleton

agent

Constructor Summary

EclipseTesterAgent(java.lang.String agentName, IPluginRunnerFactory factory)
Enables the agent.

Method Summary

void	doHandleCommand(org.eclipse.hyades.internal.execution.local.common.CustomCommand command)
void	launchTest(java.lang.String bundleLocations, java.lang.String testBundleSymbolicName, java.lang.String className, java.lang.String testID, java.lang.String agentName)
protected void	reportException(java.lang.Throwable t)
protected void	reportExceptionAsTestLog(java.lang.String agentName, java.lang.Throwable exception) This method runs a test that logs a unique exception message within a Plugin Runner.
protected void	reportProblem(java.lang.String message)
protected void	reportProblemAsTestLog(java.lang.String agentName, java.lang.String problem) This method runs a test that logs a unique error message within a Plugin Runner.
void	startProcessing(int timeOut)

Methods inherited from class java.lang.Object

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

Field Detail

agent

protected org.eclipse.hyades.internal.execution.remote.RemoteComponentSkeleton agent

Constructor Detail

EclipseTesterAgent

public EclipseTesterAgent(java.lang.String agentName,
                          IPluginRunnerFactory factory)

Enables the agent. This method prepares the platform to receive commands to load or unload bundles, and launch tests. This method has no effect if an agent (whatever its name is) is already enabled in this eclipse instance.

Parameters:

agentName - The name of the agent, used to uniquely identify the agent that is running in this instance of eclipse.

Method Detail

startProcessing

public void startProcessing(int timeOut)

doHandleCommand

public void doHandleCommand(org.eclipse.hyades.internal.execution.local.common.CustomCommand command)

launchTest

public void launchTest(java.lang.String bundleLocations,
                       java.lang.String testBundleSymbolicName,
                       java.lang.String className,
                       java.lang.String testID,
                       java.lang.String agentName)

reportProblem

protected void reportProblem(java.lang.String message)

reportException

protected void reportException(java.lang.Throwable t)

reportProblemAsTestLog

protected void reportProblemAsTestLog(java.lang.String agentName,
                                      java.lang.String problem)

This method runs a test that logs a unique error message within a Plugin Runner. It should be used when an early problem has been detected (i.e. when the real runner or the real test could not be instantiated). Other kinds of problems should be logged by the real runner when running the real test.

Parameters:

agentName - The agent name that should be used to send the log.

problem - A descriptive message.

reportExceptionAsTestLog

protected void reportExceptionAsTestLog(java.lang.String agentName,
                                        java.lang.Throwable exception)

This method runs a test that logs a unique exception message within a Plugin Runner. It should be used when an early problem has been detected (i.e. when the real runner or the real test could not be instantiated). Other kinds of problems should be logged by the real runner when running the real test.

Parameters:

agentName - The agent name that should be used to send the log.

exception - The exception to log.