Package org.testng.internal

Class TestResult

java.lang.Object

org.testng.internal.TestResult

All Implemented Interfaces:

java.lang.Comparable<ITestResult>, IAttributes, ITestResult

public class TestResult
extends java.lang.Object
implements ITestResult

This class represents the result of a test.

Field Summary

Fields

Modifier and Type	Field	Description
private IAttributes	m_attributes
private ITestContext	m_context
private long	m_endMillis
private java.lang.String	m_host
private java.lang.String	m_instanceName
private ITestNGMethod	m_method
private java.lang.String	m_name
private java.lang.Object[]	m_parameters
private long	m_startMillis
private int	m_status
private java.lang.Throwable	m_throwable
private boolean	m_wasRetried
private int	parameterIndex
private boolean	skipAnalysed
private java.util.List<ITestNGMethod>	skippedDueTo

Fields inherited from interface org.testng.ITestResult

CREATED, FAILURE, SKIP, STARTED, SUCCESS, SUCCESS_PERCENTAGE_FAILURE

Constructor Summary

Constructors

Modifier	Constructor	Description
private	TestResult()

Method Summary

Modifier and Type	Method	Description
private boolean	belongToSameGroup(ITestResult result)
int	compareTo(ITestResult comparison)
(package private) static void	copyAttributes(ITestResult source, ITestResult target)
java.lang.Object	getAttribute(java.lang.String name)
java.util.Set<java.lang.String>	getAttributeNames()
long	getEndMillis()
java.lang.Object[]	getFactoryParameters()
java.lang.String	getHost()
java.lang.Object	getInstance()
java.lang.String	getInstanceName()
ITestNGMethod	getMethod()
java.lang.String	getName()
int	getParameterIndex()
java.lang.Object[]	getParameters()
java.util.List<ITestNGMethod>	getSkipCausedBy()
long	getStartMillis()
int	getStatus()
IClass	getTestClass()
ITestContext	getTestContext()
java.lang.String	getTestName()	If this result's related instance implements ITest or use @Test(testName=...), returns its test name, otherwise returns null.
java.lang.Throwable	getThrowable()
private void	init(ITestNGMethod method, ITestContext ctx, java.lang.Throwable t, long start, long end)
private static boolean	isGlobalFailure(ITestResult result)
private boolean	isRelated(ITestResult result)
boolean	isSuccess()
static TestResult	newContextAwareTestResult(ITestNGMethod method, ITestContext ctx)
static TestResult	newEmptyTestResult()
static TestResult	newEndTimeAwareTestResult(ITestNGMethod method, ITestContext ctx, java.lang.Throwable t, long start)
static TestResult	newTestResultFor(ITestNGMethod method)
static TestResult	newTestResultFrom(TestResult result, ITestNGMethod method, ITestContext ctx, long start)
static TestResult	newTestResultWithCauseAs(ITestNGMethod method, ITestContext ctx, java.lang.Throwable t)
java.lang.Object	removeAttribute(java.lang.String name)	Remove the attribute
void	setAttribute(java.lang.String name, java.lang.Object value)	Set a custom attribute.
void	setContext(ITestContext context)
void	setEndMillis(long millis)
void	setHost(java.lang.String host)
void	setMethod(ITestNGMethod method)
(package private) void	setParameterIndex(int parameterIndex)
void	setParameters(java.lang.Object[] parameters)
void	setStatus(int status)
void	setTestName(java.lang.String name)
void	setThrowable(java.lang.Throwable throwable)
void	setWasRetried(boolean wasRetried)
java.lang.String	toString()
private static java.lang.String	toString(int status)
boolean	wasRetried()

Methods inherited from class java.lang.Object

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

Field Detail

m_method

private ITestNGMethod m_method

skippedDueTo

private java.util.List<ITestNGMethod> skippedDueTo

skipAnalysed

private boolean skipAnalysed

m_status

private int m_status

m_throwable

private java.lang.Throwable m_throwable

m_startMillis

private long m_startMillis

m_endMillis

private long m_endMillis

m_name

private java.lang.String m_name

m_host

private java.lang.String m_host

m_parameters

private java.lang.Object[] m_parameters

m_instanceName

private java.lang.String m_instanceName

m_context

private ITestContext m_context

parameterIndex

private int parameterIndex

m_wasRetried

private boolean m_wasRetried

m_attributes

private final IAttributes m_attributes

Constructor Detail

TestResult

private TestResult()

Method Detail

newEmptyTestResult

public static TestResult newEmptyTestResult()

newTestResultFor

public static TestResult newTestResultFor(ITestNGMethod method)

newContextAwareTestResult

public static TestResult newContextAwareTestResult(ITestNGMethod method,
                                                   ITestContext ctx)

newTestResultWithCauseAs

public static TestResult newTestResultWithCauseAs(ITestNGMethod method,
                                                  ITestContext ctx,
                                                  java.lang.Throwable t)

newEndTimeAwareTestResult

public static TestResult newEndTimeAwareTestResult(ITestNGMethod method,
                                                   ITestContext ctx,
                                                   java.lang.Throwable t,
                                                   long start)

newTestResultFrom

public static TestResult newTestResultFrom(TestResult result,
                                           ITestNGMethod method,
                                           ITestContext ctx,
                                           long start)

init

private void init(ITestNGMethod method,
                  ITestContext ctx,
                  java.lang.Throwable t,
                  long start,
                  long end)

setEndMillis

public void setEndMillis(long millis)

Specified by:

setEndMillis in interface ITestResult

getTestName

public java.lang.String getTestName()

If this result's related instance implements ITest or use @Test(testName=...), returns its test name, otherwise returns null.

Specified by:

getTestName in interface ITestResult

Returns:

The test name if this result's related instance implements ITest or use @Test(testName=...), null otherwise.

getName

public java.lang.String getName()

Specified by:

getName in interface ITestResult

Returns:

The name of this TestResult, typically identical to the name of the method.

getMethod

public ITestNGMethod getMethod()

Specified by:

getMethod in interface ITestResult

Returns:

Returns the method.

setMethod

public void setMethod(ITestNGMethod method)

Parameters:

method - The method to set.

getStatus

public int getStatus()

Specified by:

getStatus in interface ITestResult

Returns:

Returns the status.

setStatus

public void setStatus(int status)

Specified by:

setStatus in interface ITestResult

Parameters:

status - The status to set.

isSuccess

public boolean isSuccess()

Specified by:

isSuccess in interface ITestResult

Returns:

true if if this test run is a SUCCESS

getTestClass

public IClass getTestClass()

Specified by:

getTestClass in interface ITestResult

Returns:

Returns the testClass.

getThrowable

public java.lang.Throwable getThrowable()

Specified by:

getThrowable in interface ITestResult

Returns:

Returns the throwable.

setThrowable

public void setThrowable(java.lang.Throwable throwable)

Specified by:

setThrowable in interface ITestResult

Parameters:

throwable - The throwable to set.

getEndMillis

public long getEndMillis()

Specified by:

getEndMillis in interface ITestResult

Returns:

Returns the endMillis.

getStartMillis

public long getStartMillis()

Specified by:

getStartMillis in interface ITestResult

Returns:

Returns the startMillis.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toString

private static java.lang.String toString(int status)

getHost

public java.lang.String getHost()

Specified by:

getHost in interface ITestResult

Returns:

The host where this suite was run, or null if it was run locally. The returned string has the form: host:port

setHost

public void setHost(java.lang.String host)

getParameters

public java.lang.Object[] getParameters()

Specified by:

getParameters in interface ITestResult

Returns:

The parameters this method was invoked with.

setParameters

public void setParameters(java.lang.Object[] parameters)

Specified by:

setParameters in interface ITestResult

getInstance

public java.lang.Object getInstance()

Specified by:

getInstance in interface ITestResult

Returns:

The instance on which this method was run.

getFactoryParameters

public java.lang.Object[] getFactoryParameters()

Specified by:

getFactoryParameters in interface ITestResult

Returns:

- A parameter array that was passed to a factory method (or) an empty object array otherwise.

getAttribute

public java.lang.Object getAttribute(java.lang.String name)

Specified by:

getAttribute in interface IAttributes

Parameters:

name - The name of the attribute to return

Returns:

The attribute

setAttribute

public void setAttribute(java.lang.String name,
                         java.lang.Object value)

Description copied from interface: IAttributes

Set a custom attribute.

Specified by:

setAttribute in interface IAttributes

Parameters:

name - The attribute name

value - The attribute value

getAttributeNames

public java.util.Set<java.lang.String> getAttributeNames()

Specified by:

getAttributeNames in interface IAttributes

Returns:

all the attributes names.

removeAttribute

public java.lang.Object removeAttribute(java.lang.String name)

Description copied from interface: IAttributes

Remove the attribute

Specified by:

removeAttribute in interface IAttributes

Parameters:

name - The attribute name

Returns:

the attribute value if found, null otherwise

getTestContext

public ITestContext getTestContext()

Specified by:

getTestContext in interface ITestResult

Returns:

the ITestContext for this test result.

setContext

public void setContext(ITestContext context)

compareTo

public int compareTo(@Nonnull
                     ITestResult comparison)

Specified by:

compareTo in interface java.lang.Comparable<ITestResult>

getInstanceName

public java.lang.String getInstanceName()

Specified by:

getInstanceName in interface ITestResult

setTestName

public void setTestName(java.lang.String name)

Specified by:

setTestName in interface ITestResult

Parameters:

name - - The new name to be used as a test name

setParameterIndex

void setParameterIndex(int parameterIndex)

getParameterIndex

public int getParameterIndex()

wasRetried

public boolean wasRetried()

Specified by:

wasRetried in interface ITestResult

Returns:

- true if the test was retried again by an implementation of IRetryAnalyzer

setWasRetried

public void setWasRetried(boolean wasRetried)

Specified by:

setWasRetried in interface ITestResult

Parameters:

wasRetried - - true if the test was retried and false otherwise.

getSkipCausedBy

public java.util.List<ITestNGMethod> getSkipCausedBy()

Specified by:

getSkipCausedBy in interface ITestResult

Returns:

- The list of either upstream method(s) or configuration method(s) whose failure led to the current method being skipped. An empty list is returned when the current method is not a skipped method.

isGlobalFailure

private static boolean isGlobalFailure(ITestResult result)

isRelated

private boolean isRelated(ITestResult result)

belongToSameGroup

private boolean belongToSameGroup(ITestResult result)

copyAttributes

static void copyAttributes(ITestResult source,
                           ITestResult target)