public interface TestRunsRepository
TestRunsRepository is the entry point for test run information.
Test runs are organized around lists of events. An event denoting a single fact in a test run:
import started, import finished, functional result, etc.
NOTE: When searching for multi-value information, such as the Event.HIERARCHY field, the order
in which those values are ordered has no significance. For now, we assume test suites do not have names that
can be mixed, such as [ "xebialabs", "com", "TestSuite" ],
[ "com", "xebialabs", "TestSuite" ],
[ "com", "xebialabs", "intermediate", "TestSuite" ].
When performing a query on [ "com", "xebialabs", "TestSuite" ], all three fields will be considered
a hit.
| Modifier and Type | Method and Description |
|---|---|
java.util.List<Event> |
getEventsBetween(long startTime,
long endTime,
java.util.Map<java.lang.String,java.lang.Object> propertyFilter) |
java.util.List<Event> |
getEventsForTestRun(TestRun testRun,
java.util.Map<java.lang.String,java.lang.Object> propertyFilter) |
java.util.List<TestRun> |
getLaterTestRuns(TestRun testRun,
int max)
Get at most max
TestRuns after 'testRun'. |
Event |
getLatestEventOfType(java.lang.String testSpecificationName,
java.lang.String eventType,
long startTime,
long endTime)
Find the most recent event within the given time span of a particular type.
|
TestRun |
getLatestTestRun(java.lang.String testSpecificationName,
long startTime) |
TestRun |
getLatestTestRun(java.lang.String testSpecificationName,
long startTime,
long endTime) |
java.util.List<TestRun> |
getPreviousTestRuns(TestRun testRun,
int max)
Get at most max
TestRuns before 'testRun'. |
java.util.List<Event> |
getResultEventsThatChangedFromLastRun(TestRun testRun)
Deprecated.
|
TestRun |
getTestRun(java.lang.String testRunId) |
java.util.List<TestRun> |
getTestRuns(java.util.Map<java.lang.String,java.lang.Object> eventParameters,
long startTime,
long endTime)
Obtain all test runs within the given time span, based on a specific set of event parameters.
|
java.util.List<TestRun> |
getTestRunsBetween(java.lang.String testSpecificationName,
long startTime,
long endTime)
Obtain all test runs within the given time span.
|
boolean |
hasTestRuns(java.lang.String testSpecificationName)
Returns true if the test specification has at least one complete test run.
|
void |
refreshIndex()
Calls the index on Elastic Search to ensure data consistency.
|
TestRun getTestRun(java.lang.String testRunId)
TestRun getLatestTestRun(java.lang.String testSpecificationName, long startTime, long endTime)
TestRun getLatestTestRun(java.lang.String testSpecificationName, long startTime)
java.util.List<TestRun> getPreviousTestRuns(TestRun testRun, int max)
TestRuns before 'testRun'.testRun - a test runmax - the maximum number of test runs to retrieve.java.util.List<TestRun> getLaterTestRuns(TestRun testRun, int max)
TestRuns after 'testRun'.
Keep max as small as possible to reduce performance overhead.testRun - a test runmax - maximum number of runs to return.java.util.List<TestRun> getTestRunsBetween(java.lang.String testSpecificationName, long startTime, long endTime)
testSpecificationName - name (identifier) of the test specification to look forstartTime - start of the time interval to query for resultsendTime - end of the time interval to query for resultsboolean hasTestRuns(java.lang.String testSpecificationName)
testSpecificationName - name (identifier) of the test specification to look for.java.util.List<TestRun> getTestRuns(java.util.Map<java.lang.String,java.lang.Object> eventParameters, long startTime, long endTime)
eventParameters - parameters on 'importStarted' or 'executionStarted' events that should matchstartTime - start of the time interval to query for resultsendTime - end of the time interval to query for resultsEvent getLatestEventOfType(java.lang.String testSpecificationName, java.lang.String eventType, long startTime, long endTime)
testSpecificationName - name (identifier) of the test specification to look foreventType - type of event. E.g. 'importStarted', 'functionalResult'.startTime - start of the time interval to query for resultsendTime - end of the time interval to query for resultsnull if no event can be foundjava.util.List<Event> getEventsBetween(long startTime, long endTime, java.util.Map<java.lang.String,java.lang.Object> propertyFilter)
startTime - start of the time interval to query for resultsendTime - end of the time interval to query for resultspropertyFilter - A map { field: value }. Note that multi-value fields (such as lists)
are handled as described in the note above.java.util.List<Event> getEventsForTestRun(TestRun testRun, java.util.Map<java.lang.String,java.lang.Object> propertyFilter)
testRun - The test run whose events should be queried forpropertyFilter - A map { field: value }. Note that multi-value fields (such as lists)
are handled as described in the note above.@Deprecated java.util.List<Event> getResultEventsThatChangedFromLastRun(TestRun testRun)
void refreshIndex()
This API is *not* for public use.