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.
void	sendEventsAndScheduleTriggersIfRequired(PlanConfigImportService.ImportResult importResult) Sends events related to plan creation or update and initialises triggers.
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,
                                   YamlValidationException,
                                   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

YamlValidationException - if the format of the YAML file is invalid

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

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