oracle.apps.fnd.appltest.diagfwk.engine.impl
Class TestRunImpl

java.lang.Object
  oracle.apps.fnd.appltest.diagfwk.engine.impl.DiagBObjImpl<T>
      oracle.apps.fnd.appltest.diagfwk.engine.impl.DiagJAXBXMLDoc<T>
          oracle.apps.fnd.appltest.diagfwk.engine.impl.DiagJAXBXMLDocReport<TestRun>
              oracle.apps.fnd.appltest.diagfwk.engine.impl.TestRunImpl

All Implemented Interfaces:

DiagConstants, DiagBObj<TestRun>, DiagTreeNode, TestRunTreeNode, DiagImplConstants, TestMoniterable<TestRun>, TestRun

public class TestRunImpl
extends DiagJAXBXMLDocReport<TestRun>
implements TestRun, DiagImplConstants

Since:

release specific (what release of product did this appear in)

Version:

$Header: atgpf/appltest/applications/Diagnostics/Engine/src/oracle/apps/fnd/appltest/diagfwk/engine/impl/TestRunImpl.java /main/29 2010/10/22 11:19:26 lwong Exp $

Author:

ppradhan

Nested Class Summary

Nested classes/interfaces inherited from interface oracle.apps.fnd.appltest.diagfwk.engine.TestRun

TestRun.ExecReportLinkProvider, TestRun.TestRunVisitor

Nested classes/interfaces inherited from interface oracle.apps.fnd.appltest.diagfwk.common.DiagConstants

DiagConstants.ExecutionMode, DiagConstants.Format, DiagConstants.LinkType, DiagConstants.Status

Nested classes/interfaces inherited from interface oracle.apps.fnd.appltest.diagfwk.engine.facade.TestRunTreeNode

TestRunTreeNode.NodeType

Field Summary

Fields inherited from class oracle.apps.fnd.appltest.diagfwk.engine.impl.DiagJAXBXMLDocReport

mTestReport, xmlSrcFile

Fields inherited from class oracle.apps.fnd.appltest.diagfwk.engine.impl.DiagJAXBXMLDoc

errMsgOnLoadXML, errMsgOnValXML

Fields inherited from interface oracle.apps.fnd.appltest.diagfwk.common.DiagConstants

APPS_MSG_ID_TAG_NAME, CFG_ADR_PROVIDER_CLASS, CFG_CACHE_PROVIDER_CLASS, CFG_CRED_PROVIDER_CLASS, CFG_DAO_FACTORY_CLASS, CFG_DB_CONN_INFO_PROVIDER_CLASS, CFG_DB_CONN_PROVIDER_CLASS, CFG_NLS_PROVIDER_CLASS, CFG_PLSQL_PROVIDER_CLASS, CFG_PROFILE_PROVIDER_CLASS, CFG_SECURITY_PROVIDER_CLASS, CFG_SESSION_INFO_PROVIDER_CLASS, CFG_URL_PROVIDER_FACTORY_CLASS, CFG_WLS_MBEANSRV_CONNINFO_PROVIDER_CLASS, DATA_SECURITY_PERMISSION_ALLOWED, DATA_SECURITY_PERMISSION_NOT_ALLOWED, DELIM_URL, EXEC_MODE_CLI, EXEC_MODE_ESS, EXEC_MODE_INCIDENT, EXEC_MODE_JAVA, EXEC_MODE_UI, EXECUTABLE_TYPE_JAVA, EXECUTABLE_TYPE_PLSQL, EXECUTABLE_TYPE_TESTREF, FORMAT_HTML, FORMAT_XML, GUID_ORACLE_MINUS1, GUID_ORACLE_ZERO, INPUTS_STATUS_ALL_OPT_INPUTS, INPUTS_STATUS_NO_INPUTS, INPUTS_STATUS_REQ_INPUTS_NO_DEFAULTS, INPUTS_STATUS_REQ_INPUTS_W_DEFAULTS, IO_FLAG_I, IO_FLAG_O, JMX_API_BASE_OBJECT_NAME, LINK_EXTERNAL, LINK_INTERNAL, LINK_METALINK, N, NLS_BUNDLE_JAVA_RES, NLS_BUNDLE_MSG_SVC, NLS_BUNDLE_RES_REF, NLS_BUNDLE_XLIFF, NO, NULL, ODF_MBEAN_DOMAIN_NAME, PARAM_MON_INTERVAL, PLSQL_DEBUG_ENABLED_SYSTEM_PROP, PREREQ_TYPE_TAG_VALUE, PREREQ_TYPE_TEST, SECONDS_IN_ONE_DAY, SECONDS_IN_ONE_HOUR, STATUS_CANCELED, STATUS_EXECERROR, STATUS_FAILURE, STATUS_RUNNING, STATUS_SUCCESS, STATUS_WARNING, SYS_PROP_MAX_MONITOR_INTERNVAL, SYS_PROP_MAX_NUM_THREADS, SYSPROP_APPCONNFILE, SYSPROP_DIAG_CONFIG_FILE, TAG_TYPE_DIAG, TAG_TYPE_TAXONOMY, TEST_TYPE_DECL, TEST_TYPE_JAVA, USER_NAME, WEB_APP_NAME_TAG_NAME, Y, YES

Fields inherited from interface oracle.apps.fnd.appltest.diagfwk.engine.impl.DiagImplConstants

KEY_I_PARAM_DEF_REF, KEY_O_PARAM_DEF_REF, KEY_REF_TEST_DEF_TABLE, KEY_STEP_INPUT_PARAM_SECRET, SECRET_MASK, STEP_REP_EXEC_NAME_ENGINE, STEP_REP_NAME_ENGINE_LOG, TOKEN_DELIM, TOKEN_OUTPUTS, TOKEN_STEP, TOKEN_TEST_INPUTS, TOKEN_TEST_OUTPUTS

Constructor Summary

TestRunImpl()

Method Summary

void	cancel() Attempts to cancel this test run by setting the status for this run to canceled in the test repository.
boolean	checkCanceled() Checks (by querying the repository) if this moniterable has been canceled.
boolean	checkDone() Checks (by querying the repository) if this moniterable is still running.
void	completeReport() Completes the status for this run.
void	computeLinksInReport() Computes links within this report
void	copy(TestRun t) Copies the contents of the given TestRun into this object
void	copyT(java.lang.Object pObj) Copies the contents of the given object into this object
void	delete() Deletes the this test run.
void	fetch() Fetches the contents of a TestRun.
void	fetch(boolean pFetchExecutions) Fetches the contents of a TestRun.
void	fetch(boolean pFetchExecutions, boolean bLoadReport) Fetches the contents of a TestRun.
java.lang.String	generateXMLReport() Generates the XML Report for the Run from the JAXB content tree and returns it as a String
protected java.util.List<DiagJAXBXMLDocReport>	getChildList() Returns the list of nested entities
java.util.List<TestRunTreeNode>	getChildren() Gets the immediate children for this node.
java.lang.String	getDiagStatus() Gets the diagnostic status code for this node
java.lang.String	getDisplayName() Gets the display name for this node.
java.lang.String	getElapsedTime() Returns the difference between endTime and startTime for this node in "HH:MM:SS" format.
java.util.Date	getEndTime() Gets the end time
java.lang.String	getExecMode() Gets the execution mode
TestRun.ExecReportLinkProvider	getExecReportLinkProvider() Gets the execution report link provider that may have been set previously on this run by calling setExecReportLinkProvider().
java.lang.String	getExecStatus() Gets the execution status code for this node
java.lang.String	getID() Gets the ID for this node.
int	getMonitorInterval() Get the Monitor interval Run Parameter for this run
java.lang.String	getName() Gets the name for this node.
TestReportExtn	getNodeReportObj() Gets the report for this node.
TestRunTreeNode.NodeType	getNodeType() Returns the type of the current node
int	getNumberOfThreads() Get the Number of Threads Run Parameter for this run
java.lang.String	getRequestId() Gets the request id
java.lang.String	getRunBy() Who ran the run, for now simply another accessor to the created by element.
java.lang.String	getRunId() Gets the run ID
java.lang.String	getRunName() Gets the run description
java.lang.String	getRunReport() Gets the run report
java.util.Date	getStartTime() Gets the start time
java.lang.String	getStatus() Gets the status
TestExecList	getTestExecList() Returns the list of associated child executions
java.lang.Boolean	getViewReportAllowed() Returns a boolean representing whether the salient details of a report may be viewed.
protected java.lang.String	getXmlSourceIdentifier() Returns an identifier for the current loaded XML source document
boolean	hasChildren() Returns a flag to indicate if this node has any children
boolean	hasReport() Checks to see if this node has a report
void	initializeReport(NameValueList pRunArgs) Initializes the run report and logs the given run arguments into the report.
boolean	isDone() Returns true if the moniterable is done.
protected void	loadReport() Loads report into JAXB objects from fetched report XML.
void	logError(oracle.apps.fnd.appllcm.sdk.common.ResourceRef pErrMsg, java.lang.Throwable t) Logs the given error message and stack trace to the Run Report's Engine Log Section.
void	logMessage(oracle.apps.fnd.appllcm.sdk.common.ResourceRef pMsg) Logs the given message to the Run Report's Engine Log Section.
protected void	populate(java.lang.String pXMLMetadata)
void	save() Saves the status and contents of the moniterable to the repository.
void	setEndTime(java.util.Date pEndTime) Sets the end time
void	setExecMode(java.lang.String pExecMode) Sets the execution mode
void	setExecReportLinkProvider(TestRun.ExecReportLinkProvider provider) Sets an execution report link provider for this run to be used in order to generate links to the execution reports for this run that can be embedded into this run report
protected void	setJAXBMetadataStr(java.lang.String pXMLStr) Sets the marshalled XML document for the metadata in String format
void	setMonitorInterval(int value) Set the Monitor interval Run Parameter for this run
void	setNumberOfThreads(int value) Set the Number of Threads Run Parameter for this run
void	setRequestId(java.lang.String pRequestId) Sets the request id
void	setRunId(java.lang.String pRunId) Sets the Run ID
void	setRunName(java.lang.String pRunName) Sets the run description
void	setRunReport(java.lang.String pRunReport) Sets the run report
void	setStartTime(java.util.Date pStartTime) Sets the start time
void	setStatus(java.lang.String pStatus) Sets the status
void	setTestExecList(TestExecList pTestExecList) Sets the test execution list for the test run
void	translateReport() Translates the translatable contents of this report to user's session language.
void	visitAll(TestRun.TestRunVisitor pVisitor) Traverses this Run as well as all Exections under this Run and invokes the appropriate "visit()" method on the TestRunVisitor for each node.
java.lang.String	writeReportHTML(java.lang.String pOutDir, boolean pWriteChildren) Writes out the report content in HTML format to the given output directory.

Methods inherited from class oracle.apps.fnd.appltest.diagfwk.engine.impl.DiagJAXBXMLDocReport

getErrorMsgOnLoadXmlErr, getErrorMsgOnXmlValErr, getJAXBMetadataObj, getJAXBPkg, getReportObj, performPostLoad, saveReportHTML, saveReportHTML, saveReportXML, saveReportXML, setJAXBMetadataObj, setReportObj, stripExtn, writeReport, writeReport, writeReportHTML, writeReportXML, writeReportXML

Methods inherited from class oracle.apps.fnd.appltest.diagfwk.engine.impl.DiagJAXBXMLDoc

getErrMsgOnLoadXML, getErrMsgOnValXML, load, reactToValidationEvents, saveJAXB, saveToFile, setErrMsgOnLoadXML, setErrMsgOnValXML

Methods inherited from class oracle.apps.fnd.appltest.diagfwk.engine.impl.DiagBObjImpl

copyCommon, getCreatedBy, getCreationDate, getLastUpdateDate, getLastUpdatedBy, getLastUpdateLogin, isCreatedByOracle, setCreatedBy, setCreationDate, setLastUpdateDate, setLastUpdatedBy, setLastUpdateLogin

Methods inherited from class java.lang.Object

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

Methods inherited from interface oracle.apps.fnd.appltest.diagfwk.engine.TestRun

getReportObj, writeReport, writeReport, writeReportHTML, writeReportXML, writeReportXML

Methods inherited from interface oracle.apps.fnd.appltest.diagfwk.engine.DiagBObj

getCreatedBy, getCreationDate, getLastUpdateDate, getLastUpdatedBy, getLastUpdateLogin, isCreatedByOracle, setCreatedBy, setCreationDate, setLastUpdateDate, setLastUpdatedBy, setLastUpdateLogin

Methods inherited from interface oracle.apps.fnd.appltest.diagfwk.engine.facade.TestRunTreeNode

getCreatedBy

Constructor Detail

TestRunImpl

public TestRunImpl()

Method Detail

getRunId

public java.lang.String getRunId()

Description copied from interface: TestRun

Gets the run ID

Specified by:

getRunId in interface TestRun

Returns:

the run ID

getRunName

public java.lang.String getRunName()

Description copied from interface: TestRun

Gets the run description

Specified by:

getRunName in interface TestRun

Returns:

the run name

getExecMode

public java.lang.String getExecMode()

Description copied from interface: TestRun

Gets the execution mode

Specified by:

getExecMode in interface TestRun

Returns:

the execution mode

getStatus

public java.lang.String getStatus()

Description copied from interface: TestRun

Gets the status

Specified by:

getStatus in interface TestRunTreeNode

Specified by:

getStatus in interface TestMoniterable<TestRun>

Specified by:

getStatus in interface TestRun

Returns:

the status

getStartTime

public java.util.Date getStartTime()

Description copied from interface: TestRun

Gets the start time

Specified by:

getStartTime in interface TestRunTreeNode

Specified by:

getStartTime in interface TestRun

Returns:

the start time

getEndTime

public java.util.Date getEndTime()

Description copied from interface: TestRun

Gets the end time

Specified by:

getEndTime in interface TestRunTreeNode

Specified by:

getEndTime in interface TestRun

Returns:

the end time

getRequestId

public java.lang.String getRequestId()

Description copied from interface: TestRun

Gets the request id

Specified by:

getRequestId in interface TestRun

Returns:

the request id

getRunReport

public java.lang.String getRunReport()

Description copied from interface: TestRun

Gets the run report

Specified by:

getRunReport in interface TestRun

Returns:

the run report

getRunBy

public java.lang.String getRunBy()

Description copied from interface: TestRunTreeNode

Who ran the run, for now simply another accessor to the created by element.

Specified by:

getRunBy in interface TestRunTreeNode

Returns:

the user identifier for who ran this Run

getTestExecList

public TestExecList getTestExecList()

Description copied from interface: TestRun

Returns the list of associated child executions

Specified by:

getTestExecList in interface TestRun

Returns:

the list of associated child executions

getMonitorInterval

public int getMonitorInterval()

Description copied from interface: TestRun

Get the Monitor interval Run Parameter for this run

Specified by:

getMonitorInterval in interface TestRun

Returns:

getNumberOfThreads

public int getNumberOfThreads()

Description copied from interface: TestRun

Get the Number of Threads Run Parameter for this run

Specified by:

getNumberOfThreads in interface TestRun

Returns:

setNumberOfThreads

public void setNumberOfThreads(int value)

Description copied from interface: TestRun

Set the Number of Threads Run Parameter for this run

Specified by:

setNumberOfThreads in interface TestRun

setMonitorInterval

public void setMonitorInterval(int value)

Description copied from interface: TestRun

Set the Monitor interval Run Parameter for this run

Specified by:

setMonitorInterval in interface TestRun

setRunId

public void setRunId(java.lang.String pRunId)

Description copied from interface: TestRun

Sets the Run ID

Specified by:

setRunId in interface TestRun

Parameters:

pRunId - the Run ID

setRunName

public void setRunName(java.lang.String pRunName)

Description copied from interface: TestRun

Sets the run description

Specified by:

setRunName in interface TestRun

Parameters:

pRunName - the run description

setExecMode

public void setExecMode(java.lang.String pExecMode)

Description copied from interface: TestRun

Sets the execution mode

Specified by:

setExecMode in interface TestRun

Parameters:

pExecMode - the execution mode

setStatus

public void setStatus(java.lang.String pStatus)

Description copied from interface: TestRun

Sets the status

Specified by:

setStatus in interface TestRun

Parameters:

pStatus - the status

setStartTime

public void setStartTime(java.util.Date pStartTime)

Description copied from interface: TestRun

Sets the start time

Specified by:

setStartTime in interface TestRun

Parameters:

pStartTime - the start time

setEndTime

public void setEndTime(java.util.Date pEndTime)

Description copied from interface: TestRun

Sets the end time

Specified by:

setEndTime in interface TestRun

Parameters:

pEndTime - the end time

setRequestId

public void setRequestId(java.lang.String pRequestId)

Description copied from interface: TestRun

Sets the request id

Specified by:

setRequestId in interface TestRun

Parameters:

pRequestId - the request id

setRunReport

public void setRunReport(java.lang.String pRunReport)

Description copied from interface: TestRun

Sets the run report

Specified by:

setRunReport in interface TestRun

Parameters:

pRunReport - the run report

setTestExecList

public void setTestExecList(TestExecList pTestExecList)

Description copied from interface: TestRun

Sets the test execution list for the test run

Specified by:

setTestExecList in interface TestRun

Parameters:

pTestExecList - the run execution list

getViewReportAllowed

public java.lang.Boolean getViewReportAllowed()

Description copied from class: DiagJAXBXMLDocReport

Returns a boolean representing whether the salient details of a report may be viewed. For a run, all details are viewable but for an execution, step reports, summaries, etc are masked or hidden.

Specified by:

getViewReportAllowed in interface TestRunTreeNode

Specified by:

getViewReportAllowed in interface TestRun

Specified by:

getViewReportAllowed in class DiagJAXBXMLDocReport<TestRun>

Returns:

true if viewing allowed for the current user

fetch

public void fetch()

Description copied from interface: TestRun

Fetches the contents of a TestRun. Either a run_id or a run_name must be set on this object prior to calling this API. This API fetches all executions under this run as well. and it checks for view report security permission

Specified by:

fetch in interface TestRun

fetch

public void fetch(boolean pFetchExecutions)

Description copied from interface: TestRun

Fetches the contents of a TestRun. Either a run_id or a run_name must be set on this object prior to calling this API. This API fetches data with view report security check

Specified by:

fetch in interface TestRun

Parameters:

pFetchExecutions - flag to indicate whether the API should fetch included executions or not. If false, only fetches attributes of the run. Otherwise fetches all incldues executions under this run as well.

fetch

public void fetch(boolean pFetchExecutions,
                  boolean bLoadReport)

Description copied from interface: TestRun

Fetches the contents of a TestRun. Either a run_id or a run_name must be set on this object prior to calling this API.

Specified by:

fetch in interface TestRun

Parameters:

pFetchExecutions - flag to indicate whether the API should fetch included executions or not. If false, only fetches attributes of the run. Otherwise fetches all incldues executions under this run as well.

bLoadReport - flag to indicate whether the test report should be loaded on the fetch. If it should be loaded, the report view permission will be checked.

loadReport

protected void loadReport()

Loads report into JAXB objects from fetched report XML. Loads reports of child executions recursively as well if any exist.

populate

protected void populate(java.lang.String pXMLMetadata)

copy

public void copy(TestRun t)

Description copied from interface: TestRun

Copies the contents of the given TestRun into this object

Specified by:

copy in interface TestRun

Specified by:

copy in class DiagBObjImpl<TestRun>

Parameters:

t - The TestRun instance to copy from.

copyT

public void copyT(java.lang.Object pObj)

Description copied from interface: DiagBObj

Copies the contents of the given object into this object

Specified by:

copyT in interface DiagBObj<TestRun>

Parameters:

pObj - the contents of the given object into this object

getXmlSourceIdentifier

protected java.lang.String getXmlSourceIdentifier()

Description copied from class: DiagJAXBXMLDocReport

Returns an identifier for the current loaded XML source document

Specified by:

getXmlSourceIdentifier in class DiagJAXBXMLDocReport<TestRun>

Returns:

an identifier for the current loaded XML source document

setJAXBMetadataStr

protected void setJAXBMetadataStr(java.lang.String pXMLStr)

Description copied from class: DiagJAXBXMLDoc

Sets the marshalled XML document for the metadata in String format

Specified by:

setJAXBMetadataStr in class DiagJAXBXMLDoc<TestRun>

Parameters:

pXMLStr - marshalled XML document

save

public void save()

Description copied from interface: TestMoniterable

Saves the status and contents of the moniterable to the repository.

Specified by:

save in interface TestMoniterable<TestRun>

generateXMLReport

public java.lang.String generateXMLReport()

Description copied from interface: TestRun

Generates the XML Report for the Run from the JAXB content tree and returns it as a String

Specified by:

generateXMLReport in interface TestRun

Returns:

XML report for the run

isDone

public boolean isDone()

Description copied from interface: TestMoniterable

Returns true if the moniterable is done. Otherwise returns false.

Specified by:

isDone in interface TestRunTreeNode

Specified by:

isDone in interface TestMoniterable<TestRun>

Returns:

true if the moniterable is done. Otherwise returns false.

completeReport

public void completeReport()

Description copied from interface: TestRun

Completes the status for this run. Updates the final status on the test run report as well as on this object.

Specified by:

completeReport in interface TestRun

initializeReport

public void initializeReport(NameValueList pRunArgs)

Description copied from interface: TestRun

Initializes the run report and logs the given run arguments into the report. Also sets other internal attributes into the report such as run id etc.

Specified by:

initializeReport in interface TestRun

Parameters:

pRunArgs - parameter name values that were used to invoke this run.

logMessage

public void logMessage(oracle.apps.fnd.appllcm.sdk.common.ResourceRef pMsg)

Description copied from interface: TestRun

Logs the given message to the Run Report's Engine Log Section. The Report must be initialized prior to calling this method otherwise an IllegalStateException will be thrown.

Specified by:

logMessage in interface TestRun

Parameters:

pMsg - Message to log.

logError

public void logError(oracle.apps.fnd.appllcm.sdk.common.ResourceRef pErrMsg,
                     java.lang.Throwable t)

Description copied from interface: TestRun

Logs the given error message and stack trace to the Run Report's Engine Log Section. The Report must be initialized prior to calling this method otherwise an IllegalStateException will be thrown.

Specified by:

logError in interface TestRun

Parameters:

pErrMsg - Error message to log

t - Throwable whose stack trace will be logged.

writeReportHTML

public java.lang.String writeReportHTML(java.lang.String pOutDir,
                                        boolean pWriteChildren)

Description copied from class: DiagJAXBXMLDocReport

Writes out the report content in HTML format to the given output directory. Also writes the report content for any child executions if pWriteChildren is set to true.

Specified by:

writeReportHTML in interface TestRun

Overrides:

writeReportHTML in class DiagJAXBXMLDocReport<TestRun>

Parameters:

pOutDir - output directory

pWriteChildren - if true writes the report for children if any.

Returns:

full file path for the output file

See Also:

TestRun.writeReport(String, boolean), TestExec.writeReport(String, boolean)

getChildList

protected java.util.List<DiagJAXBXMLDocReport> getChildList()

Description copied from class: DiagJAXBXMLDocReport

Returns the list of nested entities

Specified by:

getChildList in class DiagJAXBXMLDocReport<TestRun>

translateReport

public void translateReport()

Translates the translatable contents of this report to user's session language.

Specified by:

translateReport in interface TestRun

Overrides:

translateReport in class DiagJAXBXMLDocReport<TestRun>

computeLinksInReport

public void computeLinksInReport()

Description copied from class: DiagJAXBXMLDocReport

Computes links within this report

Specified by:

computeLinksInReport in interface TestRun

Overrides:

computeLinksInReport in class DiagJAXBXMLDocReport<TestRun>

getID

public java.lang.String getID()

Description copied from interface: TestRunTreeNode

Gets the ID for this node. This is normally the run ID for a test run or the execution ID for a test execution.

Specified by:

getID in interface TestRunTreeNode

Returns:

the ID for this node

getName

public java.lang.String getName()

Description copied from interface: TestRunTreeNode

Gets the name for this node. This is the run name for a test run and the test name for a test execution.

Specified by:

getName in interface TestRunTreeNode

Returns:

the name for this node

getDisplayName

public java.lang.String getDisplayName()

Description copied from interface: TestRunTreeNode

Gets the display name for this node. This is the run name for a test run. For a test execution node, this is the test display name. For a step node, this is just the step name.

Specified by:

getDisplayName in interface TestRunTreeNode

Returns:

the display name for this node.

getExecStatus

public java.lang.String getExecStatus()

Description copied from interface: TestRunTreeNode

Gets the execution status code for this node

Specified by:

getExecStatus in interface TestRunTreeNode

Returns:

the execution status code for this node.

getDiagStatus

public java.lang.String getDiagStatus()

Description copied from interface: TestRunTreeNode

Gets the diagnostic status code for this node

Specified by:

getDiagStatus in interface TestRunTreeNode

Returns:

the diagnostic status code for this node

getChildren

public java.util.List<TestRunTreeNode> getChildren()

Description copied from interface: TestRunTreeNode

Gets the immediate children for this node. For a run node this is the list of child executions. For an execution node, this is the list of nested child executions (if any).

If the children are already fetch this method will not re-execute a query to the database. If the children are not yet fetched for this node, this method will fetch the children from the database.

Specified by:

getChildren in interface TestRunTreeNode

Returns:

the children for this node.

hasChildren

public boolean hasChildren()

Description copied from interface: DiagTreeNode

Returns a flag to indicate if this node has any children

Specified by:

hasChildren in interface DiagTreeNode

Returns:

true if the node has children. returns false otherwise.

getNodeReportObj

public TestReportExtn getNodeReportObj()

Description copied from interface: TestRunTreeNode

Gets the report for this node. The report is the run report for a run node and the execution report for a test execution node.

Specified by:

getNodeReportObj in interface TestRunTreeNode

Returns:

the report for this node.

getNodeType

public TestRunTreeNode.NodeType getNodeType()

Description copied from interface: TestRunTreeNode

Returns the type of the current node

Specified by:

getNodeType in interface TestRunTreeNode

hasReport

public boolean hasReport()

Description copied from interface: TestRunTreeNode

Checks to see if this node has a report

Specified by:

hasReport in interface TestRunTreeNode

Returns:

true if a report exists for this node. Otherwise returns false.

setExecReportLinkProvider

public void setExecReportLinkProvider(TestRun.ExecReportLinkProvider provider)

Description copied from interface: TestRun

Sets an execution report link provider for this run to be used in order to generate links to the execution reports for this run that can be embedded into this run report

Specified by:

setExecReportLinkProvider in interface TestRun

Parameters:

provider - an instance of ExecReportLinkProvider that can be used to create links to the execution reports.

getExecReportLinkProvider

public TestRun.ExecReportLinkProvider getExecReportLinkProvider()

Description copied from interface: TestRun

Gets the execution report link provider that may have been set previously on this run by calling setExecReportLinkProvider(). If no such provider exists, then returns null.

Specified by:

getExecReportLinkProvider in interface TestRun

Returns:

the execution report link provider that may have been set previously on this run by calling setExecReportLinkProvider(). If no such provider exists, then returns null.

cancel

public void cancel()

Description copied from interface: TestRun

Attempts to cancel this test run by setting the status for this run to canceled in the test repository. Caller must have set the test ID or test Name on this object prior to invoking this method.

Specified by:

cancel in interface TestRun

delete

public void delete()
            throws DiagfwkException

Description copied from interface: TestRun

Deletes the this test run. Only allows delete if the run is not currently in running status. If delete is called on a currently running test run a DiagfwkException will be thrown

Specified by:

delete in interface TestRun

Throws:

DiagfwkException - when any error occurs during the deletion process.

checkCanceled

public boolean checkCanceled()

Description copied from interface: TestMoniterable

Checks (by querying the repository) if this moniterable has been canceled. If canceled, also sets the canceled status on the current object.

Specified by:

checkCanceled in interface TestMoniterable<TestRun>

Returns:

true if the monitoerable is canceled. Otherwise returns false.

checkDone

public boolean checkDone()

Description copied from interface: TestMoniterable

Checks (by querying the repository) if this moniterable is still running.

Specified by:

checkDone in interface TestMoniterable<TestRun>

Returns:

true if the monitoerable is complete. Otherwise returns false.

getElapsedTime

public java.lang.String getElapsedTime()

Description copied from interface: TestRunTreeNode

Returns the difference between endTime and startTime for this node in "HH:MM:SS" format. If end time is not yet available (e.g. in cases where the run or execution is still in progress) then difference between the current system time and the start time is returned.

Specified by:

getElapsedTime in interface TestRunTreeNode

Returns:

the elapsed time between start time and end time (if end time exists) or between start time and current time in "HH:MM:SS" format.

visitAll

public void visitAll(TestRun.TestRunVisitor pVisitor)

Description copied from interface: TestRun

Traverses this Run as well as all Exections under this Run and invokes the appropriate "visit()" method on the TestRunVisitor for each node.

This method initially invokes pVisitor.visit(TestRun) with this run object. Subsequently, it invokes pVisitor.visit(TestExec) for each execution in the run including nested executions (if any).

Specified by:

visitAll in interface TestRun

Parameters:

pVisitor - TestRunVisitor performing the visit on this run.