com.projectdarkstar.tools.dtc.service
Interface RuntimeExecutionsService

public interface RuntimeExecutionsService

This interface exposes operations to be used by the slave execution daemons in order to update results and log files for TestExecutions. It is intended to be a remote interface exposing a stateless session EJB3.0 bean.

Method Summary

void	addClientDataPoint(Long testExecutionResultId, TestExecutionResultClientDataDTO data) Add a new data point representing the number of realtime clients in the system at a single point in time.
void	addProbeDataPoint(Long probeLogId, TestExecutionResultProbeDataDTO data) Add a new data point collected by a probe.
void	appendClientLog(Long clientLogId, String chunk) Update the logFile attribute of the TestExecutionResultClientLog object with the given id by appending the given chunk of the log to the end
void	appendProbeLog(Long probeLogId, String chunk) Update the logFile attribute of the TestExecutionResultProbeLog object with the given id by appending the given chunk of the log to the end.
void	appendServerLog(Long serverLogId, String chunk) Update the logFile attribute of the TestExecutionResultServerLog object by appending the given chunk of the log to the end.
void	updateClientLog(Long clientLogId, LogFileDTO logFile) Update the logFile attribute of the TestExecutionResultClientLog object with the given id.
void	updateProbeLog(Long probeLogId, LogFileDTO logFile) Update the logFile attribute of the TestExecutionResultProbeLog object with the given id.
void	updateServerLog(Long serverLogId, LogFileDTO logFile) Update the logFile attribute of the TestExecutionResultServerLog object with the given id.
void	updateTestResult(Long testExecutionResultId, TestExecutionResultValueDTO result) Update the result of a test execution

Method Detail

updateServerLog

void updateServerLog(Long serverLogId,
                     LogFileDTO logFile)
                     throws DTCServiceException

Update the logFile attribute of the TestExecutionResultServerLog object with the given id.

Parameters:

serverLogId - id of the TestExecutionResultServerLog to update

logFile - new log file

Throws:

com.projectdarkstar.tools.dtc.service.DTCServiceException

DTCServiceException

appendServerLog

void appendServerLog(Long serverLogId,
                     String chunk)
                     throws DTCServiceException

Update the logFile attribute of the TestExecutionResultServerLog object by appending the given chunk of the log to the end.

Parameters:

serverLogId - id of the TestExecutionResultServerLog to update

chunk - piece of the log file to append to the end

Throws:

com.projectdarkstar.tools.dtc.service.DTCServiceException

DTCServiceException

updateClientLog

void updateClientLog(Long clientLogId,
                     LogFileDTO logFile)
                     throws DTCServiceException

Update the logFile attribute of the TestExecutionResultClientLog object with the given id.

Parameters:

clientLogId - id of the TestExecutionResultClientLog to update

logFile - new log file

Throws:

com.projectdarkstar.tools.dtc.service.DTCServiceException

DTCServiceException

appendClientLog

void appendClientLog(Long clientLogId,
                     String chunk)
                     throws DTCServiceException

Update the logFile attribute of the TestExecutionResultClientLog object with the given id by appending the given chunk of the log to the end

Parameters:

clientLogId - id of the TestExecutionResultClientLog to update

chunk - piece of the log file to append to the end

Throws:

com.projectdarkstar.tools.dtc.service.DTCServiceException

DTCServiceException

updateProbeLog

void updateProbeLog(Long probeLogId,
                    LogFileDTO logFile)
                    throws DTCServiceException

Update the logFile attribute of the TestExecutionResultProbeLog object with the given id.

Parameters:

probeLogId - id of the TestExecutionResultProbeLog to update

logFile - new log file

Throws:

com.projectdarkstar.tools.dtc.service.DTCServiceException

DTCServiceException

appendProbeLog

void appendProbeLog(Long probeLogId,
                    String chunk)
                    throws DTCServiceException

Update the logFile attribute of the TestExecutionResultProbeLog object with the given id by appending the given chunk of the log to the end.

Parameters:

probeLogId - id of the TestExecutionResultProbeLog to update

chunk - piece of the log file to append to the end

Throws:

com.projectdarkstar.tools.dtc.service.DTCServiceException

DTCServiceException

addClientDataPoint

void addClientDataPoint(Long testExecutionResultId,
                        TestExecutionResultClientDataDTO data)
                        throws DTCServiceException

Add a new data point representing the number of realtime clients in the system at a single point in time.

Parameters:

testExecutionResultId - id of TestExecutionResult which collects the data

data - data point to add to the list

Throws:

com.projectdarkstar.tools.dtc.service.DTCServiceException

DTCServiceException

addProbeDataPoint

void addProbeDataPoint(Long probeLogId,
                       TestExecutionResultProbeDataDTO data)
                       throws DTCServiceException

Add a new data point collected by a probe.

Parameters:

probeLogId - id of the probe log to update

data - data point to add to the probe log's list

Throws:

com.projectdarkstar.tools.dtc.service.DTCServiceException

DTCServiceException

updateTestResult

void updateTestResult(Long testExecutionResultId,
                      TestExecutionResultValueDTO result)
                      throws DTCServiceException

Update the result of a test execution

Parameters:

testExecutionResultId - id of the TestExecutionResult to update

result - value of the result

Throws:

com.projectdarkstar.tools.dtc.service.DTCServiceException

DTCServiceException