com.atlassian.bamboo.configuration.external

Class PlanConfigImportServiceImpl

java.lang.Object

com.atlassian.bamboo.configuration.external.PlanConfigImportServiceImpl

All Implemented Interfaces:

PlanConfigImportService

public class PlanConfigImportServiceImpl
extends Object
implements PlanConfigImportService

Nested Class Summary

Nested classes/interfaces inherited from interface com.atlassian.bamboo.configuration.external.PlanConfigImportService

PlanConfigImportService.ImportResult

Constructor Summary

Constructors

Constructor and Description
PlanConfigImportServiceImpl()

Method Summary

Modifier and Type	Method and Description
com.atlassian.bamboo.specs.api.model.plan.PlanProperties	convertYamlToPlan(String yaml) Converts data from a YAML document to top level plan properties.
PlanConfigImportService.ImportResult	importPlan(com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties, com.atlassian.user.User userForCreation, RssPermissions rssPermissions) Validates exported top level plan properties within Bamboo context (e.g.
PlanConfigImportService.ImportResult	importPlan(com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties, com.atlassian.user.User userForCreation, RssPermissions rssPermissions, boolean deferEvents, boolean noChangesInProperties) Validates exported top level plan properties within Bamboo context (e.g.
PlanConfigImportService.ImportResult	importPlanBranch(com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties, VcsBranch vcsBranch, com.atlassian.user.User user, RssPermissions rssPermissions) Import plan branch using specs.
void	sendEventsAndScheduleTriggersForBranchIfRequired(PlanConfigImportService.ImportResult importResult, com.atlassian.user.User user) Sends events related to branch creation or update and initialises triggers.
void	sendEventsAndScheduleTriggersIfRequired(PlanConfigImportService.ImportResult importResult) Sends events related to plan creation or update and initialises triggers.
PlanConfigImportService.ImportResult	switchToLightweightBranch(PlanKey planBranchKey) Convert a divergent branch to a lightweight branch.
PlanConfigImportService.ImportResult	updatePlanBranch(com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties, VcsBranch vcsBranch, com.atlassian.user.User user, RssPermissions rssPermissions, DivergentBranchDataBean branchCreationData, boolean deferEvents, boolean noChangesInProperties) Update plan branch using specs.
void	validatePlanBranchProperties(com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties, RssPermissions rssPermissions, VcsBranch vcsBranch) This method performs validation of YAML types and of the properties without Bamboo context (e.g.
void	validatePlanProperties(com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties, RssPermissions rssPermissions) This method performs validation of YAML types and of the properties without Bamboo context (e.g.

Methods inherited from class java.lang.Object

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

Constructor Detail

PlanConfigImportServiceImpl

public PlanConfigImportServiceImpl()

Method Detail

convertYamlToPlan

@NotNull
public com.atlassian.bamboo.specs.api.model.plan.PlanProperties convertYamlToPlan(@NotNull
                                                                                           String yaml)
                                                                                    throws com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException,
                                                                                           YamlValidationException

Description copied from interface: PlanConfigImportService

Converts data from a YAML document to top level plan properties.

Specified by:

convertYamlToPlan in interface PlanConfigImportService

Parameters:

yaml - YAML String containing definition of top level plan

Returns:

top level plan properties

Throws:

YamlValidationException - if the format of the YAML file is invalid

com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException

validatePlanProperties

public void validatePlanProperties(@NotNull
                                   com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties,
                                   @NotNull
                                   RssPermissions rssPermissions)
                            throws com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException,
                                   RssPermissionException

Description copied from interface: PlanConfigImportService

This method performs validation of YAML types and of the properties without Bamboo context (e.g. no database integrity is verified).

Specified by:

validatePlanProperties in interface PlanConfigImportService

Parameters:

planProperties - top level plan properties

rssPermissions - projects which can allowed for modification

Throws:

com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException - if the imported properties were not valid

RssPermissionException - if RSS is missing access to projects/repositories

validatePlanBranchProperties

public void validatePlanBranchProperties(@NotNull
                                         com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties,
                                         @NotNull
                                         RssPermissions rssPermissions,
                                         @NotNull
                                         VcsBranch vcsBranch)
                                  throws com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException,
                                         RssPermissionException

Description copied from interface: PlanConfigImportService

This method performs validation of YAML types and of the properties without Bamboo context (e.g. no database integrity is verified).

Specified by:

validatePlanBranchProperties in interface PlanConfigImportService

Parameters:

planProperties - plan branch properties

rssPermissions - projects which can allowed for modification

vcsBranch - imported vcs branch

Throws:

com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException - if the imported properties were not valid

RssPermissionException - if RSS is missing access to projects/repositories

importPlan

@NotNull
public PlanConfigImportService.ImportResult importPlan(@NotNull
                                                                com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties,
                                                                @Nullable
                                                                com.atlassian.user.User userForCreation,
                                                                @NotNull
                                                                RssPermissions rssPermissions)

Description copied from interface: PlanConfigImportService

Validates exported top level plan properties within Bamboo context (e.g. verifying database integrity), then imports the data into the database.

Specified by:

importPlan in interface PlanConfigImportService

Parameters:

planProperties - top level plan properties to import

userForCreation - user invoking the import

rssPermissions - projects which can allowed for modification; since 6.2

Returns:

saved top level plan entity and flag indicating if the plan is new

importPlan

@NotNull
public PlanConfigImportService.ImportResult importPlan(@NotNull
                                                                com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties,
                                                                @Nullable
                                                                com.atlassian.user.User userForCreation,
                                                                @NotNull
                                                                RssPermissions rssPermissions,
                                                                boolean deferEvents,
                                                                boolean noChangesInProperties)
                                                         throws com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException,
                                                                RssPermissionException

Description copied from interface: PlanConfigImportService

Validates exported top level plan properties within Bamboo context (e.g. verifying database integrity), then imports the data into the database.

Specified by:

importPlan in interface PlanConfigImportService

Parameters:

planProperties - top level plan properties to import

userForCreation - user invoking the import

rssPermissions - projects which can allowed for modification; since 6.2

deferEvents - when set to true, the import routine will not send creation events nor initialise plan triggers

Returns:

saved top level plan entity and flag indicating if the plan is new

Throws:

com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException - if data validation fails

RssPermissionException - if rss doesn't have access to dependant project

importPlanBranch

@NotNull
public PlanConfigImportService.ImportResult importPlanBranch(@NotNull
                                                                      com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties,
                                                                      @NotNull
                                                                      VcsBranch vcsBranch,
                                                                      @Nullable
                                                                      com.atlassian.user.User user,
                                                                      @NotNull
                                                                      RssPermissions rssPermissions)

Description copied from interface: PlanConfigImportService

Import plan branch using specs.

Specified by:

importPlanBranch in interface PlanConfigImportService

updatePlanBranch

@NotNull
public PlanConfigImportService.ImportResult updatePlanBranch(@NotNull
                                                                      com.atlassian.bamboo.specs.api.model.plan.PlanProperties planProperties,
                                                                      @NotNull
                                                                      VcsBranch vcsBranch,
                                                                      @Nullable
                                                                      com.atlassian.user.User user,
                                                                      @NotNull
                                                                      RssPermissions rssPermissions,
                                                                      @NotNull
                                                                      DivergentBranchDataBean branchCreationData,
                                                                      boolean deferEvents,
                                                                      boolean noChangesInProperties)

Description copied from interface: PlanConfigImportService

Update plan branch using specs. It is expected that plan branch already exists. (fails if it doesn't)

Specified by:

updatePlanBranch in interface PlanConfigImportService

sendEventsAndScheduleTriggersIfRequired

public void sendEventsAndScheduleTriggersIfRequired(@NotNull
                                                    PlanConfigImportService.ImportResult importResult)

Description copied from interface: PlanConfigImportService

Sends events related to plan creation or update and initialises triggers.

Specified by:

sendEventsAndScheduleTriggersIfRequired in interface PlanConfigImportService

sendEventsAndScheduleTriggersForBranchIfRequired

public void sendEventsAndScheduleTriggersForBranchIfRequired(@NotNull
                                                             PlanConfigImportService.ImportResult importResult,
                                                             @Nullable
                                                             com.atlassian.user.User user)

Description copied from interface: PlanConfigImportService

Sends events related to branch creation or update and initialises triggers.

Specified by:

sendEventsAndScheduleTriggersForBranchIfRequired in interface PlanConfigImportService

switchToLightweightBranch

@NotNull
public PlanConfigImportService.ImportResult switchToLightweightBranch(@NotNull
                                                                               PlanKey planBranchKey)

Description copied from interface: PlanConfigImportService

Convert a divergent branch to a lightweight branch.

Specified by:

switchToLightweightBranch in interface PlanConfigImportService