com.atlassian.bamboo.resultsummary.tests

Interface TestCaseResultDao

All Superinterfaces:

BambooObjectDao<TestCaseResult>

All Known Implementing Classes:

TestCaseResultHibernateDao

public interface TestCaseResultDao
extends BambooObjectDao<TestCaseResult>

Method Summary

Modifier and Type	Method and Description
long	countTestCaseResultErrors() Count all TestCaseResultErrors
long	countTestCaseResults() Count all TestCaseResults
TestCaseResult	findById(long id) Find a specific testCaseResult by id
List<Pair<TestCaseResult,Integer>>	getLastNFailingResultsForTestCase(TestCase testCase, int number) Retrieve the last n failing testResults for this given test case, latest first.
List<Pair<TestCaseResult,Integer>>	getLastNFailingResultsForTestCaseAndBuildResults(TestCase testCase, List<BuildResultsSummary> buildResults, int number) Retrieve the last n failing testResults for this given test case, but only those that occurred within the provided build results.
List<TestCaseResult>	getQuarantinedTestCasesForBuildResult(BuildResultsSummary buildResultsSummary) Provide a list of the quarantined tests for a build result
List<TestCaseResult>	getQuarantinedTestCasesForChainResult(ChainResultsSummary chainResultsSummary) Provide a list of the quarantined tests for a chain result
List<TestCaseResultStatisticsProvider>	getResultStatisticsForTestCase(TestCase testCase) Returns a list of wrapped TestCaseResult and BuildResultSummary for a particular test case, for use by e.g.
List<TestCaseResultStatisticsProvider>	getResultStatisticsForTestCaseAndBuilds(TestCase testCase, List<BuildResultsSummary> buildResults) Returns a list of wrapped TestCaseResult and BuildResultSummary for a particular test case and contained within a specific span of build result summaries.
BuildResultsSummary	getSucceedingSinceBuildResultSummary(TestCase testCase) Find the build in which the given test has been successful since.
TestCaseResult	getTestCaseResult(TestCase testCase, long buildNumber) Deprecated. since 3.3 use getTestCaseResults(TestCase, long)
List<TestCaseResult>	getTestCaseResults(TestCase testCase, long buildNumber) Find a specific run of a testCase
List<TestCaseResult>	getTestCaseResultsForTestCase(TestCase testCase) Return a list of TestCaseResults for a given TestCase
List<TestCaseResult>	getTestCaseResultsForTestCaseAndBuilds(TestCase testCase, List<BuildResultsSummary> buildResults) Return a list of TestCaseResults for a given TestCase constrained to a specific set of Build Result Summaries
List<TestCaseResult>	getTestsForBuildResultByDeltaState(ResultsSummary summary, TestDeltaState deltaState, int firstResult, int maxCount) Retrieves a list of testCaseResults for a BuildResultSummary based on their delta state (e.g BROKEN, FIXED)
List<TestCaseResult>	getTestsForBuildResultByState(ResultsSummary summary, TestState state) Retrieves a list of testCaseResults for a BuildResultSummary based on their state (e.f FAILED or SUCCESS)
List<TestCaseResult>	getTestsForBuildResultByState(ResultsSummary summary, TestState state, int firstResult, int maxCount) Retrieves a list of testCaseResults for a BuildResultSummary based on their state (e.f FAILED or SUCCESS).
List<TestCaseResult>	getTestsForBuildResultSummary(BuildResultsSummary summary) Retrieves a list of all testCaseResults for a BuildResultSummary
List<TestCaseResult>	getTestsForChainResultByDeltaStates(ChainResultsSummary summary, TestDeltaState[] deltaStates, int firstResult, int maxCount) Retrieves a list of testCaseResults for a ChainResultSummary based on their delta state (e.g BROKEN, FIXED)
List<TestCaseResult>	getTestsForChainResultByState(ChainResultsSummary summary, TestState testState, int firstResult, int maxCount) Retrieves a list of testCaseResults for a ChainResultSummary based on their TestState
long	scrollTestCaseResultErrorsForExport(com.google.common.base.Function<TestCaseResultError,Void> function) Scroll through and execute function for each of TestCaseResultErrors Objects passed to function are not fully initialized.
long	scrollTestCaseResultsForExport(com.google.common.base.Function<TestCaseResult,Void> function) Scroll through and execute function for each of TestCaseResults Objects passed to function are not fully initialized.

Methods inherited from interface com.atlassian.bamboo.persistence3.BambooObjectDao

countAll, countWithRestriction, delete, deleteAll, executeReturnInt, executeReturnLong, findAll, findById, save, saveAll

Method Detail

findById

TestCaseResult findById(long id)

Find a specific testCaseResult by id

Parameters:

id - of the test you want to find

Returns:

the testCaseResult corresponding to the id provided.

getTestsForBuildResultByState

@NotNull
List<TestCaseResult> getTestsForBuildResultByState(ResultsSummary summary,
                                                            TestState state)

Retrieves a list of testCaseResults for a BuildResultSummary based on their state (e.f FAILED or SUCCESS)

Parameters:

summary - the BuildResultsSaummary to get the tests for

state - - The TestState to search for.

Returns:

a list of testCaseResults for a BuildResultSummary with the given state

getTestsForBuildResultByState

@NotNull
List<TestCaseResult> getTestsForBuildResultByState(ResultsSummary summary,
                                                            TestState state,
                                                            int firstResult,
                                                            int maxCount)

Retrieves a list of testCaseResults for a BuildResultSummary based on their state (e.f FAILED or SUCCESS). To be used whenever pagination is required.

Parameters:

summary - the BuildResultsSummary to get the tests for

state - the TestState to search for.

firstResult - the first record to be retrieved. Negative values are treated as 0.

maxCount - maximum amount of records to be retrieved. Values less than or equal to 0 are ignored.

Returns:

a list of testCaseResults for a BuildResultSummary with the given state

getTestsForBuildResultByDeltaState

@NotNull
List<TestCaseResult> getTestsForBuildResultByDeltaState(ResultsSummary summary,
                                                                 TestDeltaState deltaState,
                                                                 int firstResult,
                                                                 int maxCount)

Retrieves a list of testCaseResults for a BuildResultSummary based on their delta state (e.g BROKEN, FIXED)

Parameters:

summary - the BuildResultsSummary to get the tests for

deltaState - the TestDeltaState to search for.

firstResult - the first record to be retrieved. Negative values are treated as 0.

maxCount - maximum amount of records to be retrieved. Values less than or equal to 0 are ignored.

Returns:

a list of testCaseResults for a BuildResultSummary with the given delta state

getTestsForChainResultByDeltaStates

@NotNull
List<TestCaseResult> getTestsForChainResultByDeltaStates(ChainResultsSummary summary,
                                                                  TestDeltaState[] deltaStates,
                                                                  int firstResult,
                                                                  int maxCount)

Retrieves a list of testCaseResults for a ChainResultSummary based on their delta state (e.g BROKEN, FIXED)

Parameters:

summary -

deltaStates -

firstResult - - index of the first result

maxCount - - maximum amount of records returned

Returns:

testCaseResults

getTestsForChainResultByState

@NotNull
List<TestCaseResult> getTestsForChainResultByState(@NotNull
                                                            ChainResultsSummary summary,
                                                            @NotNull
                                                            TestState testState,
                                                            int firstResult,
                                                            int maxCount)

Retrieves a list of testCaseResults for a ChainResultSummary based on their TestState

Parameters:

summary -

testState -

firstResult -

maxCount -

Returns:

testCaseResults

getQuarantinedTestCasesForChainResult

@NotNull
List<TestCaseResult> getQuarantinedTestCasesForChainResult(@NotNull
                                                                    ChainResultsSummary chainResultsSummary)

Provide a list of the quarantined tests for a chain result

Parameters:

chainResultsSummary - to search for the tests.

Returns:

List of TestCases

getTestsForBuildResultSummary

@NotNull
List<TestCaseResult> getTestsForBuildResultSummary(BuildResultsSummary summary)

Retrieves a list of all testCaseResults for a BuildResultSummary

Parameters:

summary - the BuildResultsSummary to get the tests for

Returns:

a list of all testCaseResults for the BuildResultSummary

getQuarantinedTestCasesForBuildResult

@NotNull
List<TestCaseResult> getQuarantinedTestCasesForBuildResult(@NotNull
                                                                    BuildResultsSummary buildResultsSummary)

Provide a list of the quarantined tests for a build result

Parameters:

buildResultsSummary - to search for the tests.

Returns:

List of TestCases

getResultStatisticsForTestCase

@NotNull
List<TestCaseResultStatisticsProvider> getResultStatisticsForTestCase(@NotNull
                                                                               TestCase testCase)

Returns a list of wrapped TestCaseResult and BuildResultSummary for a particular test case, for use by e.g. graphs

Parameters:

testCase - to find the results for

Returns:

list of $TestCaseResultStatisticsProviderfor each TestCaseResult found for the TestCase

getResultStatisticsForTestCaseAndBuilds

@NotNull
List<TestCaseResultStatisticsProvider> getResultStatisticsForTestCaseAndBuilds(@NotNull
                                                                                        TestCase testCase,
                                                                                        @NotNull
                                                                                        List<BuildResultsSummary> buildResults)

Returns a list of wrapped TestCaseResult and BuildResultSummary for a particular test case and contained within a specific span of build result summaries. For use by e.g. graphs

Parameters:

testCase - to find the results for

buildResults - to contain search to (this list must not be empty)

Returns:

list of $TestCaseResultStatisticsProvider for each TestCaseResult found for the TestCase

getTestCaseResultsForTestCase

@NotNull
List<TestCaseResult> getTestCaseResultsForTestCase(@NotNull
                                                            TestCase testCase)

Return a list of TestCaseResults for a given TestCase

Parameters:

testCase - to look for

Returns:

list of TestCaseResult for the given TestCase

getTestCaseResultsForTestCaseAndBuilds

@NotNull
List<TestCaseResult> getTestCaseResultsForTestCaseAndBuilds(@NotNull
                                                                     TestCase testCase,
                                                                     @NotNull
                                                                     List<BuildResultsSummary> buildResults)

Return a list of TestCaseResults for a given TestCase constrained to a specific set of Build Result Summaries

Parameters:

testCase - to look for

buildResults - to contain search to

Returns:

list of TestCaseResult for the given TestCase

getLastNFailingResultsForTestCase

@NotNull
List<Pair<TestCaseResult,Integer>> getLastNFailingResultsForTestCase(@NotNull
                                                                              TestCase testCase,
                                                                              int number)

Retrieve the last n failing testResults for this given test case, latest first.

Parameters:

testCase - to look for the results for.

number - of results to retrieve

Returns:

List of pairs containing the offending TestCaseResult and the build number it occurred in.

getLastNFailingResultsForTestCaseAndBuildResults

@NotNull
List<Pair<TestCaseResult,Integer>> getLastNFailingResultsForTestCaseAndBuildResults(@NotNull
                                                                                             TestCase testCase,
                                                                                             @NotNull
                                                                                             List<BuildResultsSummary> buildResults,
                                                                                             int number)

Retrieve the last n failing testResults for this given test case, but only those that occurred within the provided build results. Latest first.

Parameters:

testCase - to look for the results for.

buildResults - to search in for the tests.

number - of results to retrieve

Returns:

List of pairs containing the offending TestCaseResult and the build number it occurred in.

getTestCaseResult

@Nullable
 @Deprecated
TestCaseResult getTestCaseResult(TestCase testCase,
                                                        long buildNumber)

Deprecated. since 3.3 use getTestCaseResults(TestCase, long)

Find a specific run of a testCase

Parameters:

testCase - to look for

buildNumber - of the build the run should have occurred in

Returns:

the TestCaseResult for the given test case, if it ran in the given build.

getTestCaseResults

@NotNull
List<TestCaseResult> getTestCaseResults(TestCase testCase,
                                                 long buildNumber)

Find a specific run of a testCase

Parameters:

testCase - to look for

buildNumber - of the build the run should have occurred in

Returns:

the TestCaseResult for the given test case, if it ran in the given build.

getSucceedingSinceBuildResultSummary

@Nullable
BuildResultsSummary getSucceedingSinceBuildResultSummary(TestCase testCase)

Find the build in which the given test has been successful since. AKA the last recored "FIXED" test run. Will return null if the test has never failed (ie being successful since the beginning)

Parameters:

testCase - to search history for.

Returns:

the BuildResultSummary that this test has been successful since.

countTestCaseResults

long countTestCaseResults()

Count all TestCaseResults

Returns:

number of TestCaseResults

countTestCaseResultErrors

long countTestCaseResultErrors()

Count all TestCaseResultErrors

Returns:

number of TestCaseResultErrors

scrollTestCaseResultsForExport

long scrollTestCaseResultsForExport(@NotNull
                                    com.google.common.base.Function<TestCaseResult,Void> function)

Scroll through and execute function for each of TestCaseResults Objects passed to function are not fully initialized. Collections are empty and related objects have only id set.

Parameters:

function - function to be executed on each of the TestClassResults

Returns:

number of traversed rows

scrollTestCaseResultErrorsForExport

long scrollTestCaseResultErrorsForExport(@NotNull
                                         com.google.common.base.Function<TestCaseResultError,Void> function)

Scroll through and execute function for each of TestCaseResultErrors Objects passed to function are not fully initialized. Collections are empty and related objects have only id set.

Parameters:

function - function to be executed on each of the TestClassResults

Returns:

number of traversed rows