com.atlassian.bamboo.deployments.environments.service
Interface EnvironmentTriggerService

All Known Implementing Classes:

EnvironmentTriggerServiceImpl

public interface EnvironmentTriggerService

Method Summary

BuildStrategy	createEnvironmentTrigger(long environmentId, String userDescription, Set<Long> triggeringRepositories, org.apache.commons.configuration.HierarchicalConfiguration configuration) Deprecated. since 5.8
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

createEnvironmentTrigger

@Deprecated
BuildStrategy createEnvironmentTrigger(long environmentId,
                                                  @NotNull
                                                  String userDescription,
                                                  @NotNull
                                                  Set<Long> triggeringRepositories,
                                                  @NotNull
                                                  org.apache.commons.configuration.HierarchicalConfiguration configuration)
                                       throws IllegalArgumentException

Deprecated. since 5.8

Creates a BuildStrategy and saves it in Environment configuration.

Throws:

IllegalArgumentException - if environmentId is invalid