com.atlassian.bamboo.resultsummary.tests
Interface TestCaseResultDao

All Superinterfaces:
BambooObjectDao<TestCaseResult>
All Known Implementing Classes:
TestCaseResultHibernateDao

public interface TestCaseResultDao
extends BambooObjectDao<TestCaseResult>


Method Summary
 long countTestCaseResultErrors()
          Count all TestCaseResultErrors
 long countTestCaseResults()
          Count all TestCaseResults
 TestCaseResult findById(long id)
          Find a specific testCaseResult by id
 java.util.List<Pair<TestCaseResult,java.lang.Integer>> getLastNFailingResultsForTestCase(TestCase testCase, int number)
          Retrieve the last n failing testResults for this given test case, latest first.
 java.util.List<Pair<TestCaseResult,java.lang.Integer>> getLastNFailingResultsForTestCaseAndBuildResults(TestCase testCase, java.util.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.
 java.util.List<TestCaseResult> getQuarantinedTestCasesForBuildResult(BuildResultsSummary buildResultsSummary)
          Provide a list of the quarantined tests for a build result
 java.util.List<TestCaseResult> getQuarantinedTestCasesForChainResult(ChainResultsSummary chainResultsSummary)
          Provide a list of the quarantined tests for a chain result
 java.util.List<TestCaseResultStatisticsProvider> getResultStatisticsForTestCase(TestCase testCase)
          Returns a list of wrapped TestCaseResult and BuildResultSummary for a particular test case, for use by e.g.
 java.util.List<TestCaseResultStatisticsProvider> getResultStatisticsForTestCaseAndBuilds(TestCase testCase, java.util.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)
 java.util.List<TestCaseResult> getTestCaseResults(TestCase testCase, long buildNumber)
          Find a specific run of a testCase
 java.util.List<TestCaseResult> getTestCaseResultsForTestCase(TestCase testCase)
          Return a list of TestCaseResults for a given TestCase
 java.util.List<TestCaseResult> getTestCaseResultsForTestCaseAndBuilds(TestCase testCase, java.util.List<BuildResultsSummary> buildResults)
          Return a list of TestCaseResults for a given TestCase constrained to a specific set of Build Result Summaries
 java.util.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)
 java.util.List<TestCaseResult> getTestsForBuildResultByState(ResultsSummary summary, TestState state)
          Retrieves a list of testCaseResults for a BuildResultSummary based on their state (e.f FAILED or SUCCESS)
 java.util.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).
 java.util.List<TestCaseResult> getTestsForBuildResultSummary(BuildResultsSummary summary)
          Retrieves a list of all testCaseResults for a BuildResultSummary
 java.util.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)
 java.util.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,java.lang.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,java.lang.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
delete, deleteAll, 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
java.util.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
java.util.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
java.util.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
java.util.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
java.util.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
java.util.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
java.util.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
java.util.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
java.util.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 for each TestCaseResult found for the TestCase

getResultStatisticsForTestCaseAndBuilds

@NotNull
java.util.List<TestCaseResultStatisticsProvider> getResultStatisticsForTestCaseAndBuilds(@NotNull
                                                                                                 TestCase testCase,
                                                                                                 @NotNull
                                                                                                 java.util.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 for each TestCaseResult found for the TestCase

getTestCaseResultsForTestCase

@NotNull
java.util.List<TestCaseResult> getTestCaseResultsForTestCase(@NotNull
                                                                     TestCase testCase)
Return a list of TestCaseResults for a given TestCase

Parameters:
testCase - to look for
Returns:
List for the given TestCase

getTestCaseResultsForTestCaseAndBuilds

@NotNull
java.util.List<TestCaseResult> getTestCaseResultsForTestCaseAndBuilds(@NotNull
                                                                              TestCase testCase,
                                                                              @NotNull
                                                                              java.util.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 for the given TestCase

getLastNFailingResultsForTestCase

@NotNull
java.util.List<Pair<TestCaseResult,java.lang.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
java.util.List<Pair<TestCaseResult,java.lang.Integer>> getLastNFailingResultsForTestCaseAndBuildResults(@NotNull
                                                                                                                TestCase testCase,
                                                                                                                @NotNull
                                                                                                                java.util.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
java.util.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,java.lang.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,java.lang.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


Copyright © 2013 Atlassian Software Systems Pty Ltd. All Rights Reserved.