com.atlassian.bamboo.testutils.backdoor

Class PlansControl

java.lang.Object

com.atlassian.bamboo.testutils.backdoor.BackdoorControl<PlansControl>

com.atlassian.bamboo.testutils.backdoor.PlansControl

public class PlansControl
extends BackdoorControl<PlansControl>

Nested Class Summary

Nested classes/interfaces inherited from class com.atlassian.bamboo.testutils.backdoor.BackdoorControl

BackdoorControl.AddXsrfNoCheckTokenFilter, BackdoorControl.JsonMediaTypeFilter

Field Summary

Fields

Modifier and Type	Field and Description
static com.atlassian.pageobjects.elements.query.Poller.WaitTimeout	DEFAULT_BUILD_WAIT_TIMEOUT

Fields inherited from class com.atlassian.bamboo.testutils.backdoor.BackdoorControl

ADMIN_REST_PATH, API_REST_PATH, DEFAULT_REST_PATH, rootPath

Constructor Summary

Constructors

Constructor and Description
PlansControl(BambooEnvironmentData environmentData)

Method Summary

Modifier and Type	Method and Description
PlansControl	addCustomRequirement(PlanKey jobKey, String requirementKey)
PlansControl	addPlanVariable(PlanKey planKey, String variableName, String variableValue)
RestPlan	clonePlan(PlanKey planKeyToClone, PlanKey newPlanKey) Clone plan
PlansControl	createArtifact(PlanKey producerJobKey, Consumer<TestArtifactDetails.Builder> consumer)
RestPlanBranch	createBranch(PlanKey planKey, String vcsBranch, String branchName)
PlanKey	createPlan(TestBuildDetails buildDetails)
RestProject	createProject(String projectKey, String projectName)
PlansControl	deleteAllPlans() Marks all top level plans as deleted.
void	deleteBuildResult(PlanResultKey planResultKey)
PlansControl	deletePlan(PlanKey planKey) Delete plan
PlansControl	deletePlanQuietly(PlanKey planKey) Delete plan quietly
void	deleteProject(String projectKey)
PlansControl	disablePlan(PlanKey planKey) Disable plan
boolean	doesPlanExistAsRecord(PlanKey planKey)
PlansControl	enablePlan(PlanKey planKey) Enable plan
RestBranches	getAllBranches(PlanKey key) Get all branches for chain
RestPlanBranch	getBranchByName(PlanKey key, String branchName) Get branches with given name for chain
com.atlassian.pageobjects.elements.query.TimedQuery<RestPlanBranch>	getBranchByNameTimed(PlanKey key, String branchName) Get branches with given name for chain as a timed query
Result	getBuildResult(PlanKey planKey, int buildNumber) Get build result
Result	getBuildResult(PlanResultKey planResultKey) Get build result
List<RestJob>	getJobs(PlanKey planKey)
long	getPlanId(PlanKey key)
String	getPlanRootArtifactDirectory(PlanKey planKey) Get the plan directory information for the plan
List<RestVariableDefinition>	getPlanVariables(PlanKey planKey)
List<RestRequirement>	getRequirementsForJob(PlanKey jobKey)
RestStageList	getStages(PlanKey planKey)
void	tearDown() Cleanup resources
void	triggerBackgroundDeletionAndWait() Trigger background plan deletion and wait up to 30s for its completion.
TriggerPlanBuilder	triggerBuild()
PlansControl	triggerBuild(PlanKey planKey) Trigger build
PlansControl	triggerBuild(PlanKey planKey, Map<String,String> params) Trigger build
PlansControl	triggerBuildAndAwaitCompletion(PlanKey planKey) Trigger build and wait for the completion
PlansControl	triggerBuildAndAwaitCompletion(PlanKey planKey, com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout) Trigger build and wait for the completion
PlansControl	triggerBuildAndAwaitFailure(PlanKey planKey, int expectStatusCode)
PlansControl	triggerBuildAndAwaitSuccess(PlanKey planKey)
RestQueuedBuild	triggerBuildWithResponse(PlanKey planKey, Map<String,String> parameters) package scope so TriggerPlanBuilder can use it
io.restassured.path.json.JsonPath	waitForBuildWithResponse(PlanResultKey key, org.hamcrest.Matcher<io.restassured.path.json.JsonPath> matcher, com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)
PlansControl	waitForCompletedBuild(PlanKey planKey, int buildNumber) Waits for a build that is completed (builds stopped are not included)
PlansControl	waitForCompletedBuild(PlanKey planKey, int buildNumber, com.atlassian.pageobjects.elements.query.Poller.WaitTimeout waitTimeout)
PlansControl	waitForCompletedBuild(PlanResultKey key) Wait for a build to complete
PlansControl	waitForCompletedBuild(PlanResultKey key, com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)
io.restassured.path.json.JsonPath	waitForCompletedBuildWithResponse(PlanResultKey key, com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)
PlansControl	waitForFailedBuild(PlanKey planKey, int buildNumber)
PlansControl	waitForFailedBuild(PlanResultKey planResultKey)
PlansControl	waitForFailedBuild(PlanResultKey planResultKey, com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)
PlansControl	waitForFinishedBuild(PlanKey planKey, int buildNumber) Wait until build is finished (either completed or stopped)
PlansControl	waitForFinishedBuild(PlanResultKey key) Wait until build is finished (either completed or stopped)
PlansControl	waitForQueuedBuild(PlanResultKey key)
PlansControl	waitForQueuedBuild(PlanResultKey key, com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)
PlansControl	waitForQueuedOrStartedBuild(PlanResultKey key, com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)
PlansControl	waitForStartedBuild(PlanKey planKey, int buildNumber)
PlansControl	waitForStartedBuild(PlanResultKey key)
PlansControl	waitForStartedBuild(PlanResultKey key, com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)
PlansControl	waitForSuccessfulBuild(PlanKey planKey, int buildNumber)
PlansControl	waitForSuccessfulBuild(PlanResultKey planResultKey)
PlansControl	waitForSuccessfulBuild(PlanResultKey planResultKey, com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)

Methods inherited from class com.atlassian.bamboo.testutils.backdoor.BackdoorControl

client, createResource, createResourceForPath, get, getEnvironmentData, getRestModulePath, percentEncode, ping, post, resourceRoot

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_BUILD_WAIT_TIMEOUT

public static final com.atlassian.pageobjects.elements.query.Poller.WaitTimeout DEFAULT_BUILD_WAIT_TIMEOUT

Constructor Detail

PlansControl

public PlansControl(@NotNull
                    BambooEnvironmentData environmentData)

Method Detail

doesPlanExistAsRecord

public boolean doesPlanExistAsRecord(@NotNull
                                     PlanKey planKey)

deletePlan

public PlansControl deletePlan(@NotNull
                               PlanKey planKey)

Delete plan

Parameters:

planKey - key of a Plan

deletePlanQuietly

public PlansControl deletePlanQuietly(@NotNull
                                      PlanKey planKey)

Delete plan quietly

Parameters:

planKey - key of a Plan

enablePlan

public PlansControl enablePlan(@NotNull
                               PlanKey planKey)

Enable plan

Parameters:

planKey - key of a Plan

disablePlan

public PlansControl disablePlan(@NotNull
                                PlanKey planKey)

Disable plan

Parameters:

planKey - key of a Plan

deleteAllPlans

public PlansControl deleteAllPlans()

Marks all top level plans as deleted. To await the actual data deletion, use triggerBackgroundDeletionAndWait() afterwards.

triggerBackgroundDeletionAndWait

public void triggerBackgroundDeletionAndWait()

Trigger background plan deletion and wait up to 30s for its completion.

getBranchByName

public RestPlanBranch getBranchByName(PlanKey key,
                                      String branchName)
                               throws Exception

Get branches with given name for chain

Throws:

Exception

getBranchByNameTimed

public com.atlassian.pageobjects.elements.query.TimedQuery<RestPlanBranch> getBranchByNameTimed(PlanKey key,
                                                                                                String branchName)
                                                                                         throws Exception

Get branches with given name for chain as a timed query

Throws:

Exception

getAllBranches

public RestBranches getAllBranches(PlanKey key)
                            throws Exception

Get all branches for chain

Throws:

Exception

createBranch

public RestPlanBranch createBranch(PlanKey planKey,
                                   String vcsBranch,
                                   String branchName)

clonePlan

public RestPlan clonePlan(PlanKey planKeyToClone,
                          PlanKey newPlanKey)
                   throws Exception

Clone plan

Throws:

Exception

triggerBuild

public TriggerPlanBuilder triggerBuild()

triggerBuild

public PlansControl triggerBuild(PlanKey planKey)

Trigger build

Parameters:

planKey - which will be triggered

triggerBuildAndAwaitFailure

public PlansControl triggerBuildAndAwaitFailure(PlanKey planKey,
                                                int expectStatusCode)

triggerBuild

public PlansControl triggerBuild(PlanKey planKey,
                                 Map<String,String> params)

Trigger build

Parameters:

planKey - which will be triggered

params - additional params to be passed to the build

triggerBuildWithResponse

public RestQueuedBuild triggerBuildWithResponse(PlanKey planKey,
                                                Map<String,String> parameters)

package scope so TriggerPlanBuilder can use it

triggerBuildAndAwaitCompletion

public PlansControl triggerBuildAndAwaitCompletion(PlanKey planKey)

Trigger build and wait for the completion

Parameters:

planKey - key of the plan to trigger

triggerBuildAndAwaitCompletion

public PlansControl triggerBuildAndAwaitCompletion(PlanKey planKey,
                                                   com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)

Trigger build and wait for the completion

Parameters:

planKey - key of the plan to trigger

getBuildResult

public Result getBuildResult(PlanResultKey planResultKey)
                      throws Exception

Get build result

Throws:

Exception

getBuildResult

public Result getBuildResult(PlanKey planKey,
                             int buildNumber)
                      throws Exception

Get build result

Throws:

Exception

triggerBuildAndAwaitSuccess

public PlansControl triggerBuildAndAwaitSuccess(@NotNull
                                                PlanKey planKey)

waitForSuccessfulBuild

public PlansControl waitForSuccessfulBuild(@NotNull
                                           PlanResultKey planResultKey)

waitForSuccessfulBuild

public PlansControl waitForSuccessfulBuild(@NotNull
                                           PlanKey planKey,
                                           int buildNumber)

waitForSuccessfulBuild

public PlansControl waitForSuccessfulBuild(@NotNull
                                           PlanResultKey planResultKey,
                                           com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)

waitForFailedBuild

public PlansControl waitForFailedBuild(@NotNull
                                       PlanResultKey planResultKey)

waitForFailedBuild

public PlansControl waitForFailedBuild(@NotNull
                                       PlanKey planKey,
                                       int buildNumber)

waitForFailedBuild

public PlansControl waitForFailedBuild(@NotNull
                                       PlanResultKey planResultKey,
                                       com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)

waitForCompletedBuild

public PlansControl waitForCompletedBuild(PlanResultKey key)

Wait for a build to complete

Parameters:

key - plan result key

waitForCompletedBuild

public PlansControl waitForCompletedBuild(PlanResultKey key,
                                          com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)

Throws:

AssertionError - if build is not completed

waitForCompletedBuildWithResponse

public io.restassured.path.json.JsonPath waitForCompletedBuildWithResponse(PlanResultKey key,
                                                                           com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)

Throws:

AssertionError - if build is not completed

waitForCompletedBuild

public PlansControl waitForCompletedBuild(PlanKey planKey,
                                          int buildNumber)

Waits for a build that is completed (builds stopped are not included)

waitForCompletedBuild

public PlansControl waitForCompletedBuild(PlanKey planKey,
                                          int buildNumber,
                                          com.atlassian.pageobjects.elements.query.Poller.WaitTimeout waitTimeout)

waitForStartedBuild

public PlansControl waitForStartedBuild(PlanKey planKey,
                                        int buildNumber)

waitForStartedBuild

@NotNull
public PlansControl waitForStartedBuild(PlanResultKey key)

waitForStartedBuild

@NotNull
public PlansControl waitForStartedBuild(PlanResultKey key,
                                                 com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)

waitForQueuedBuild

@NotNull
public PlansControl waitForQueuedBuild(PlanResultKey key)

waitForQueuedBuild

@NotNull
public PlansControl waitForQueuedBuild(PlanResultKey key,
                                                com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)

waitForQueuedOrStartedBuild

@NotNull
public PlansControl waitForQueuedOrStartedBuild(PlanResultKey key,
                                                         com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)

waitForFinishedBuild

public PlansControl waitForFinishedBuild(PlanKey planKey,
                                         int buildNumber)

Wait until build is finished (either completed or stopped)

waitForFinishedBuild

public PlansControl waitForFinishedBuild(PlanResultKey key)

Wait until build is finished (either completed or stopped)

waitForBuildWithResponse

public io.restassured.path.json.JsonPath waitForBuildWithResponse(PlanResultKey key,
                                                                  org.hamcrest.Matcher<io.restassured.path.json.JsonPath> matcher,
                                                                  com.atlassian.pageobjects.elements.query.Poller.WaitTimeout timeout)

getStages

public RestStageList getStages(PlanKey planKey)
                        throws Exception

Throws:

Exception

getJobs

public List<RestJob> getJobs(PlanKey planKey)
                      throws Exception

Throws:

Exception

createPlan

public PlanKey createPlan(TestBuildDetails buildDetails)
                   throws Exception

Throws:

Exception

tearDown

public void tearDown()

Description copied from class: BackdoorControl

Cleanup resources

Overrides:

tearDown in class BackdoorControl<PlansControl>

deleteBuildResult

public void deleteBuildResult(@NotNull
                              PlanResultKey planResultKey)
                       throws Exception

Throws:

Exception

getPlanVariables

@NotNull
public List<RestVariableDefinition> getPlanVariables(@NotNull
                                                              PlanKey planKey)

addPlanVariable

public PlansControl addPlanVariable(PlanKey planKey,
                                    String variableName,
                                    String variableValue)

createArtifact

public PlansControl createArtifact(PlanKey producerJobKey,
                                   Consumer<TestArtifactDetails.Builder> consumer)

getPlanRootArtifactDirectory

public String getPlanRootArtifactDirectory(PlanKey planKey)

Get the plan directory information for the plan

Parameters:

planKey -

Returns:

addCustomRequirement

public PlansControl addCustomRequirement(@NotNull
                                         PlanKey jobKey,
                                         @NotNull
                                         String requirementKey)

getRequirementsForJob

public List<RestRequirement> getRequirementsForJob(@NotNull
                                                   PlanKey jobKey)

createProject

public RestProject createProject(String projectKey,
                                 String projectName)

deleteProject

public void deleteProject(String projectKey)

getPlanId

public long getPlanId(PlanKey key)