com.atlassian.bamboo.vcs.configuration.service

Class VcsRepositoryConfigurationServiceImpl

java.lang.Object

com.atlassian.bamboo.vcs.configuration.service.VcsRepositoryConfigurationServiceImpl

All Implemented Interfaces:

VcsRepositoryConfigurationService

public class VcsRepositoryConfigurationServiceImpl
extends Object
implements VcsRepositoryConfigurationService

Field Summary

Fields inherited from interface com.atlassian.bamboo.vcs.configuration.service.VcsRepositoryConfigurationService

LEGACY_VCS_PLUGINS_USED_BANDANA_KEY

Constructor Summary

Constructors

Constructor and Description

VcsRepositoryConfigurationServiceImpl(RepositoryDefinitionManager repositoryDefinitionManager, AuditLogService auditLogService, HibernateMutableAclService aclService, RawRepositoryConfigurationXmlConverter rawRepositoryConfigurationXmlConverter, ImmutablePlanCacheService immutablePlanCacheService, ScopedExclusionService scopedExclusionService, TriggerConfigurationService triggerConfigurationService, TaskConfigurationService taskConfigurationService, ChainBranchManager chainBranchManager, EnvironmentTaskService environmentTaskService, BuildDefinitionManager buildDefinitionManager, com.atlassian.event.api.EventPublisher eventPublisher, BranchDetectionService branchDetectionService, VcsRepositoryManager vcsRepositoryManager)

Method Summary

Modifier and Type	Method and Description
ErrorCollection	configureRssDetection(long repositoryId, PartialVcsRepositoryData vcsRepositoryData, boolean isEnabled) Sets detection of Bamboo Specs for repository and saves new config.
PartialVcsRepositoryData	convertToNewRepositoryConfiguration(PartialVcsRepositoryData vcsRepositoryData) If repository data represents a repository implemented in the old system and appropriate new plugin exists, the data is converted to the new plugin.
PartialVcsRepositoryData	createLinkedRepository(PartialVcsRepositoryData newVcsRepository, com.atlassian.user.User user, RepositoryConfigurationService.LinkedRepositoryAccess accessOption) Creates new linked repository.
org.acegisecurity.acls.MutableAcl	createNewSharedRepositoryDefaultAcl(com.atlassian.user.User user, long repositoryId, RepositoryConfigurationService.LinkedRepositoryAccess accessOption) Creates a defualt Acl for a specific repository which has: - READ permissions for the creator (if applicable) - READ permission to logged in users if ALL_USERS option is specified
PartialVcsRepositoryData	createPlanRepository(Plan plan, PartialVcsRepositoryData newVcsConfiguration) Creates "plan local" repository and adds it to a plan.
void	deleteLinkedRepository(long repositoryId) Removes linked repository.
void	deleteRepository(Plan plan, long repositoryId, Long replacementRepositoryId) Removes repository definition from a plan
PartialVcsRepositoryData	editLinkedRepository(long repositoryId, PartialVcsRepositoryData newVcsConfiguration) Edits existing linked repository
PartialVcsRepositoryData	editRepository(Plan plan, long repositoryId, PartialVcsRepositoryData newVcsConfiguration) Edits existing "plan local" repository.
protected List<PlanRepositoryLink>	getNewRepositoryList(List<PlanRepositoryLink> originalRepositories, PlanRepositoryLink toMove, long beforeId, long afterId)
Map<ImmutableJob,List<TaskDefinition>>	getRelevantJobsForRepositoryIdChange(ImmutablePlan plan, long repositoryId) Gets list of jobs using a repository.
PartialVcsRepositoryData	linkRepositoryToPlan(Plan plan, long selectedRepositoryId) Connects a linked repository to a plan by creating a new repository that inherits all the data from the linked repository and adding it to the plan.
PartialVcsRepositoryData	mergeLinkedRepository(PartialVcsRepositoryData vcsRepositoryData) Merges the state of the given linked repository into the database.
void	mergePlanRepositories(Plan plan, List<PartialVcsRepositoryData> vcsRepositoryDataList) Merges the state of the given plan repositories into the database.
void	moveRepository(Plan plan, long repositoryId, long beforePosition, long afterPosition) Changes position of repository in the repository list.
PartialVcsRepositoryData	replaceRepositoryInPlan(Plan plan, VcsRepositoryData parentRepository, PartialVcsRepositoryData oldRepository, PartialVcsRepositoryData newRepository) Replaces uses of a repository with another one.
void	setParentOfPlanRepository(ImmutablePlan plan, long repositoryId, long parentRepositoryId) Creates or changes parent-child relationship for a plan repository.
void	shareRepository(Plan plan, PartialVcsRepositoryData repositoryData, String repositoryName, String userDescription, com.atlassian.user.User user) Converts existing Plan repository to Linked repository.
void	validateLinkedRepository(PartialVcsRepositoryData vcsRepositoryData) Validate linked repository before saving it in database.
boolean	validateLinkedRepositoryName(String repositoryName, BambooIdProvider vcsRepositoryData) Checks if name of a linked repository is unique.
void	validatePlanRepository(Plan plan, PartialVcsRepositoryData vcsRepositoryData) Validate plan repository before saving it in database.
boolean	validateRepositoryName(ImmutablePlan immutablePlan, String repositoryName, BambooIdProvider repositoryDefinition) Checks if provided name for repository is unique in the Plan
boolean	validateRestartableStatus(ResultsSummary resultSummary) Checks that repositories referenced by a result still exists in Bamboo db.

Methods inherited from class java.lang.Object

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

Constructor Detail

VcsRepositoryConfigurationServiceImpl

public VcsRepositoryConfigurationServiceImpl(RepositoryDefinitionManager repositoryDefinitionManager,
                                             AuditLogService auditLogService,
                                             HibernateMutableAclService aclService,
                                             RawRepositoryConfigurationXmlConverter rawRepositoryConfigurationXmlConverter,
                                             ImmutablePlanCacheService immutablePlanCacheService,
                                             ScopedExclusionService scopedExclusionService,
                                             TriggerConfigurationService triggerConfigurationService,
                                             TaskConfigurationService taskConfigurationService,
                                             ChainBranchManager chainBranchManager,
                                             EnvironmentTaskService environmentTaskService,
                                             BuildDefinitionManager buildDefinitionManager,
                                             com.atlassian.event.api.EventPublisher eventPublisher,
                                             BranchDetectionService branchDetectionService,
                                             VcsRepositoryManager vcsRepositoryManager)

Method Detail

createPlanRepository

@NotNull
public PartialVcsRepositoryData createPlanRepository(@NotNull
                                                              Plan plan,
                                                              @NotNull
                                                              PartialVcsRepositoryData newVcsConfiguration)

Description copied from interface: VcsRepositoryConfigurationService

Creates "plan local" repository and adds it to a plan.

Specified by:

createPlanRepository in interface VcsRepositoryConfigurationService

Returns:

editRepository

@NotNull
public PartialVcsRepositoryData editRepository(@NotNull
                                                        Plan plan,
                                                        long repositoryId,
                                                        @NotNull
                                                        PartialVcsRepositoryData newVcsConfiguration)

Description copied from interface: VcsRepositoryConfigurationService

Edits existing "plan local" repository.

Specified by:

editRepository in interface VcsRepositoryConfigurationService

Returns:

setParentOfPlanRepository

public void setParentOfPlanRepository(@NotNull
                                      ImmutablePlan plan,
                                      long repositoryId,
                                      long parentRepositoryId)

Description copied from interface: VcsRepositoryConfigurationService

Creates or changes parent-child relationship for a plan repository.

Specified by:

setParentOfPlanRepository in interface VcsRepositoryConfigurationService

replaceRepositoryInPlan

public PartialVcsRepositoryData replaceRepositoryInPlan(@NotNull
                                                        Plan plan,
                                                        @NotNull
                                                        VcsRepositoryData parentRepository,
                                                        @NotNull
                                                        PartialVcsRepositoryData oldRepository,
                                                        @NotNull
                                                        PartialVcsRepositoryData newRepository)

Description copied from interface: VcsRepositoryConfigurationService

Replaces uses of a repository with another one.

Specified by:

replaceRepositoryInPlan in interface VcsRepositoryConfigurationService

Returns:

linkRepositoryToPlan

@NotNull
public PartialVcsRepositoryData linkRepositoryToPlan(@NotNull
                                                              Plan plan,
                                                              long selectedRepositoryId)

Description copied from interface: VcsRepositoryConfigurationService

Connects a linked repository to a plan by creating a new repository that inherits all the data from the linked repository and adding it to the plan.

Specified by:

linkRepositoryToPlan in interface VcsRepositoryConfigurationService

Returns:

createLinkedRepository

@NotNull
public PartialVcsRepositoryData createLinkedRepository(@NotNull
                                                                PartialVcsRepositoryData newVcsRepository,
                                                                @NotNull
                                                                com.atlassian.user.User user,
                                                                @NotNull
                                                                RepositoryConfigurationService.LinkedRepositoryAccess accessOption)

Description copied from interface: VcsRepositoryConfigurationService

Creates new linked repository.

Specified by:

createLinkedRepository in interface VcsRepositoryConfigurationService

Returns:

editLinkedRepository

@NotNull
public PartialVcsRepositoryData editLinkedRepository(long repositoryId,
                                                              @NotNull
                                                              PartialVcsRepositoryData newVcsConfiguration)

Description copied from interface: VcsRepositoryConfigurationService

Edits existing linked repository

Specified by:

editLinkedRepository in interface VcsRepositoryConfigurationService

Returns:

deleteLinkedRepository

public void deleteLinkedRepository(long repositoryId)

Description copied from interface: VcsRepositoryConfigurationService

Removes linked repository.

Specified by:

deleteLinkedRepository in interface VcsRepositoryConfigurationService

validateLinkedRepositoryName

public boolean validateLinkedRepositoryName(@NotNull
                                            String repositoryName,
                                            @Nullable
                                            BambooIdProvider vcsRepositoryData)

Description copied from interface: VcsRepositoryConfigurationService

Checks if name of a linked repository is unique.

Specified by:

validateLinkedRepositoryName in interface VcsRepositoryConfigurationService

Returns:

validateRepositoryName

public boolean validateRepositoryName(@NotNull
                                      ImmutablePlan immutablePlan,
                                      @NotNull
                                      String repositoryName,
                                      @Nullable
                                      BambooIdProvider repositoryDefinition)

Description copied from interface: VcsRepositoryConfigurationService

Checks if provided name for repository is unique in the Plan

Specified by:

validateRepositoryName in interface VcsRepositoryConfigurationService

createNewSharedRepositoryDefaultAcl

public org.acegisecurity.acls.MutableAcl createNewSharedRepositoryDefaultAcl(@NotNull
                                                                             com.atlassian.user.User user,
                                                                             long repositoryId,
                                                                             RepositoryConfigurationService.LinkedRepositoryAccess accessOption)

Creates a defualt Acl for a specific repository which has: - READ permissions for the creator (if applicable) - READ permission to logged in users if ALL_USERS option is specified

Parameters:

user - to create acl for

accessOption -

Returns:

MutableAcl representing a default permission set

deleteRepository

public void deleteRepository(@NotNull
                             Plan plan,
                             long repositoryId,
                             Long replacementRepositoryId)

Description copied from interface: VcsRepositoryConfigurationService

Removes repository definition from a plan

Specified by:

deleteRepository in interface VcsRepositoryConfigurationService

replacementRepositoryId - repository id to replace removed one in tasks depending on it

moveRepository

public void moveRepository(@NotNull
                           Plan plan,
                           long repositoryId,
                           long beforePosition,
                           long afterPosition)
                    throws IllegalArgumentException,
                           IllegalStateException

Description copied from interface: VcsRepositoryConfigurationService

Changes position of repository in the repository list. Important for setting default repository

Specified by:

moveRepository in interface VcsRepositoryConfigurationService

repositoryId - the RepositoryDefinition to move

beforePosition - position of the RepositoryDefinition that will be before the moving Repository, -1 if the beginning of the list

afterPosition - position of the RepositoryDefinition that will be after the moving Repository, -1 if the end of the list

Throws:

IllegalArgumentException

IllegalStateException

getNewRepositoryList

@NotNull
protected List<PlanRepositoryLink> getNewRepositoryList(@NotNull
                                                                 List<PlanRepositoryLink> originalRepositories,
                                                                 @NotNull
                                                                 PlanRepositoryLink toMove,
                                                                 long beforeId,
                                                                 long afterId)

shareRepository

public void shareRepository(@NotNull
                            Plan plan,
                            @NotNull
                            PartialVcsRepositoryData repositoryData,
                            @NotNull
                            String repositoryName,
                            @Nullable
                            String userDescription,
                            @NotNull
                            com.atlassian.user.User user)

Description copied from interface: VcsRepositoryConfigurationService

Converts existing Plan repository to Linked repository.

Specified by:

shareRepository in interface VcsRepositoryConfigurationService

Parameters:

plan - plan that owns the repository

repositoryData - repository to share

repositoryName - new name of the repository

userDescription - of the repository

validateRestartableStatus

public boolean validateRestartableStatus(@NotNull
                                         ResultsSummary resultSummary)

Description copied from interface: VcsRepositoryConfigurationService

Checks that repositories referenced by a result still exists in Bamboo db.

Specified by:

validateRestartableStatus in interface VcsRepositoryConfigurationService

Returns:

getRelevantJobsForRepositoryIdChange

public Map<ImmutableJob,List<TaskDefinition>> getRelevantJobsForRepositoryIdChange(@NotNull
                                                                                   ImmutablePlan plan,
                                                                                   long repositoryId)

Description copied from interface: VcsRepositoryConfigurationService

Gets list of jobs using a repository.

Specified by:

getRelevantJobsForRepositoryIdChange in interface VcsRepositoryConfigurationService

convertToNewRepositoryConfiguration

public PartialVcsRepositoryData convertToNewRepositoryConfiguration(@NotNull
                                                                    PartialVcsRepositoryData vcsRepositoryData)

Description copied from interface: VcsRepositoryConfigurationService

If repository data represents a repository implemented in the old system and appropriate new plugin exists, the data is converted to the new plugin. Otherwise, original data is returned.

Specified by:

convertToNewRepositoryConfiguration in interface VcsRepositoryConfigurationService

Returns:

validateLinkedRepository

public void validateLinkedRepository(@NotNull
                                     PartialVcsRepositoryData vcsRepositoryData)
                              throws com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException

Description copied from interface: VcsRepositoryConfigurationService

Validate linked repository before saving it in database.

Specified by:

validateLinkedRepository in interface VcsRepositoryConfigurationService

Parameters:

vcsRepositoryData - imported linked repository

Throws:

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

mergeLinkedRepository

public PartialVcsRepositoryData mergeLinkedRepository(@NotNull
                                                      PartialVcsRepositoryData vcsRepositoryData)
                                               throws com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException

Description copied from interface: VcsRepositoryConfigurationService

Merges the state of the given linked repository into the database.

This service will attempt to merge the entity based on ImmutableEntityWithOid.getOid(), and if there's no match, based on DescriptionProvider.getName(). If an existing entity is found, then it will be updated. Otherwise, a new database entity will be created. It's assumed that this method is used in specs import only as it's sending analytic event.

Specified by:

mergeLinkedRepository in interface VcsRepositoryConfigurationService

Parameters:

vcsRepositoryData - imported linked repository

Returns:

an object after persisting to the database - either the newly created or updated database object

Throws:

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

validatePlanRepository

public void validatePlanRepository(@NotNull
                                   Plan plan,
                                   @NotNull
                                   PartialVcsRepositoryData vcsRepositoryData)
                            throws com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException

Description copied from interface: VcsRepositoryConfigurationService

Validate plan repository before saving it in database.

Specified by:

validatePlanRepository in interface VcsRepositoryConfigurationService

vcsRepositoryData - imported plan repository

Throws:

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

mergePlanRepositories

public void mergePlanRepositories(@NotNull
                                  Plan plan,
                                  @NotNull
                                  List<PartialVcsRepositoryData> vcsRepositoryDataList)
                           throws com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException

Description copied from interface: VcsRepositoryConfigurationService

Merges the state of the given plan repositories into the database.

This service will attempt to merge the entities based on ImmutableEntityWithOid.getOid(), and if there's no match, based on PartialVcsRepositoryData.getParentId()}. If an existing entity is found, then it will be updated. Otherwise, a new database entity will be created. All other repositories in plan will be removed.

Specified by:

mergePlanRepositories in interface VcsRepositoryConfigurationService

vcsRepositoryDataList - list of imported plan repositories

Throws:

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

configureRssDetection

@NotNull
public ErrorCollection configureRssDetection(long repositoryId,
                                                      PartialVcsRepositoryData vcsRepositoryData,
                                                      boolean isEnabled)

Description copied from interface: VcsRepositoryConfigurationService

Sets detection of Bamboo Specs for repository and saves new config. Validates if repository supports RSS.

Specified by:

configureRssDetection in interface VcsRepositoryConfigurationService

Parameters:

repositoryId - id of repository

vcsRepositoryData - repository configuration, remains unchanged

isEnabled - true if Specs detection should be enabled, false otherwise

Returns:

a list of errors.