com.atlassian.bamboo.deployments.environments.service

Interface EnvironmentTriggerService

All Known Implementing Classes:

EnvironmentTriggerServiceImpl

public interface EnvironmentTriggerService

Method Summary

Modifier and Type	Method and Description
TriggerDefinition	createEnvironmentTrigger(long environmentId, TriggerModuleDescriptor triggerModuleDescriptor, String userDescription, boolean isEnabled, Map<String,String> configuration) Create a trigger Definition and save it against the plan
void	deleteEnvironmentTrigger(long environmentId, long triggerId) Delete a given trigger Definition
TriggerDefinition	editEnvironmentTrigger(long environmentId, long triggerId, String userDescription, boolean isEnabled, Map<String,String> triggerConfigurationMap) Update the details of specific triggerDefinition
PlanKey	getCalculatedTriggeringPlanKey(InternalEnvironment environment, DeploymentTriggerBranchSelectionMode branchSelectionMode, PlanKey customBranchKey)

Method Detail

createEnvironmentTrigger

TriggerDefinition createEnvironmentTrigger(long environmentId,
                                           @NotNull
                                           TriggerModuleDescriptor triggerModuleDescriptor,
                                           @Nullable
                                           String userDescription,
                                           boolean isEnabled,
                                           @NotNull
                                           Map<String,String> configuration)
                                    throws IllegalArgumentException

Create a trigger Definition and save it against the plan

Parameters:

environmentId - id of an environment the triggerDefinition belongs to

triggerModuleDescriptor - for the TriggerDefinition to be added

userDescription - description the user has specified for this TriggerDefinition

isEnabled - set enabled/disabled state of the newly created trigger

configuration - configuration from the plugin for this TriggerDefinition

Returns:

the TriggerDefinition created

Throws:

IllegalArgumentException - if environmentId is invalid

deleteEnvironmentTrigger

void deleteEnvironmentTrigger(long environmentId,
                              long triggerId)
                       throws IllegalArgumentException,
                              IllegalStateException

Delete a given trigger Definition

Parameters:

environmentId - id of an environment the triggerDefinition belongs to

triggerId - of the TriggerDefinition to delete.

Throws:

IllegalArgumentException - if environmentId is invalid

IllegalStateException - if the task list has changed since submitting request, i.e the task isn't there to delete anymore.

editEnvironmentTrigger

TriggerDefinition editEnvironmentTrigger(long environmentId,
                                         long triggerId,
                                         @Nullable
                                         String userDescription,
                                         boolean isEnabled,
                                         @NotNull
                                         Map<String,String> triggerConfigurationMap)
                                  throws IllegalArgumentException

Update the details of specific triggerDefinition

Parameters:

environmentId - id of an environment the triggerDefinition belongs to

triggerId - the TriggerDefinition to edit

userDescription - new user description

isEnabled - set new enabled/disabled state

triggerConfigurationMap - new task Configuration

Returns:

TriggerDefinition with updates.

Throws:

IllegalArgumentException - if environmentId or triggerId is invalid.

getCalculatedTriggeringPlanKey

@NotNull
PlanKey getCalculatedTriggeringPlanKey(@NotNull
                                                InternalEnvironment environment,
                                                @NotNull
                                                DeploymentTriggerBranchSelectionMode branchSelectionMode,
                                                @Nullable
                                                PlanKey customBranchKey)
                                         throws DeploymentException

Throws:

DeploymentException