com.atlassian.bamboo.repository

Class RepositoryDefinitionManagerImpl

java.lang.Object

com.atlassian.bamboo.repository.RepositoryDefinitionManagerImpl

All Implemented Interfaces:

RepositoryDefinitionAccessor, RepositoryDefinitionManager

public class RepositoryDefinitionManagerImpl
extends Object
implements RepositoryDefinitionManager

Constructor Summary

Constructors

Constructor and Description
RepositoryDefinitionManagerImpl(RepositoryDefinitionDao repositoryDefinitionDao, PlanRepositoryLinkDao planRepositoryLinkDao, RawRepositoryConfigurationXmlConverter rawRepositoryConfigurationXmlConverter, RssRepositoryPermissionDao rssRepositoryPermissionDao)

Method Summary

Modifier and Type	Method and Description
PartialVcsRepositoryData	entityToUnmergedData(RepositoryDataEntity entity)
VcsRepositoryData	entityToVcsData(RepositoryDataEntity input)
List<RepositoryDataEntity>	findRepositoriesByPluginKey(String pluginKey) Given a pluginKey this will get you all of the repositories in Bamboo that were created for that key.
List<RepositoryData>	getGlobalRepositoryDefinitions() Get all Shared repositories current user has permission to use in his plans.
List<RepositoryData>	getGlobalRepositoryDefinitionsForAdministration() Get all Shared repositories current user has permission to administrate.
List<RepositoryData>	getGlobalRepositoryDefinitionsUnrestricted() Get all Shared Repositories without permission checking.
List<PlanIdentifier>	getIdentifiersOfPlansUsingRepository(long repositoryId) Get identifiers of Plans referencing a repository.
List<PlanIdentifier>	getIdentifiersOfPlansUsingRepositoryOrItsDirectChildren(long repositoryId) Get identifiers of Chains referencing a repository, either directly or through inheritance (only direct parent-child relationship is checked) If the parameter refers to a linked repository, only TopLevelPlans are returned.
List<VcsRepositoryData>	getLinkedRepositories() Get all linked repositories current user has permission to use in his plans.
List<VcsRepositoryData>	getLinkedRepositoriesForAdministration() Get all Shared repositories current user has permission to administrate.
List<VcsRepositoryData>	getLinkedRepositoriesUnrestricted() Get all linked repositories without permission checking.
VcsRepositoryData	getLinkedRepositoryByName(String name) Find a linked repository by name.
List<PartialVcsRepositoryData>	getPlanRepositoriesForExport(PlanIdentifier plan) Get all repositories attached to a plan in form suitable for export.
List<PlanRepositoryDefinition>	getPlanRepositoryDefinitions(PlanIdentifier plan) Get all repositories attached to a plan ordered by position.
PlanRepositoryLink	getPlanRepositoryLink(ImmutablePlan plan, long repositoryId) Get persistent representation of a relation between Plan and repository
PlanRepositoryLink	getPlanRepositoryLinkByName(ImmutablePlan plan, String repositoryName) Get persistent representation of a relation between Plan and repository
List<PlanRepositoryLink>	getPlanRepositoryLinks(ImmutablePlan plan) Get persistent representation of relation between Plan and repositories
List<PlanRepositoryLink>	getPlansUsingRepository(long repositoryId) Get PlanRepositoryLinks associated with repository.
RepositoryDataEntity	getRepositoryDataEntity(long id) Get persistent representation of a repository
List<RepositoryDefinition>	getRepositoryDefinitionsForPlan(ImmutablePlan plan) Get all repositories attached to a plan ordered by position.
VcsRepositoryData	getVcsRepositoryData(long repositoryId) Get plugin-agnostic representation of a repository configuration.
VcsRepositoryData	getVcsRepositoryDataByOid(BambooEntityOid oid) Find a repository by oid.
PartialVcsRepositoryData	getVcsRepositoryDataForEditing(long repositoryId)
void	removeRepositoriesForPlan(Plan plan) Remove all repositories from Plan that are not global repositories.
void	removeRepositoryFromPlan(PlanRepositoryLink planRepository) Removes relation between repository and plan.
void	removeRepositoryIfUnused(RepositoryDataEntity repositoryDataEntity) Marks repository for deletion if it is referenced by a RepositoryChangeset, removes it otherwise.
void	removeUnusedRepositories() Removes all repositories that has been previously markedForDeletion and are no longer referenced by any RepositoryChangeset
void	savePlanRepositoryLink(PlanRepositoryLink planRepository)
void	savePlanRepositoryLinks(List<PlanRepositoryLink> planRepositories) Saves the collection of plan to repository relations.
long	savePlanRepositoryWithDefinition(PlanRepositoryLink planRepository) Saves plan to repository relation definition with cascade to RepositoryDataEntity
long	saveRepositoryDefinition(RepositoryDataEntity repositoryData) Save repository definition.
void	saveRepositoryDefinitions(Collection<RepositoryDataEntity> repositoriesBeingCreated) Saves all repository definitions in the collection.

Methods inherited from class java.lang.Object

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

Constructor Detail

RepositoryDefinitionManagerImpl

public RepositoryDefinitionManagerImpl(RepositoryDefinitionDao repositoryDefinitionDao,
                                       PlanRepositoryLinkDao planRepositoryLinkDao,
                                       RawRepositoryConfigurationXmlConverter rawRepositoryConfigurationXmlConverter,
                                       RssRepositoryPermissionDao rssRepositoryPermissionDao)

Method Detail

getPlanRepositoryLink

public PlanRepositoryLink getPlanRepositoryLink(@NotNull
                                                ImmutablePlan plan,
                                                long repositoryId)

Description copied from interface: RepositoryDefinitionManager

Get persistent representation of a relation between Plan and repository

Specified by:

getPlanRepositoryLink in interface RepositoryDefinitionManager

getPlanRepositoryLinkByName

public PlanRepositoryLink getPlanRepositoryLinkByName(@NotNull
                                                      ImmutablePlan plan,
                                                      @NotNull
                                                      String repositoryName)

Description copied from interface: RepositoryDefinitionManager

Get persistent representation of a relation between Plan and repository

Specified by:

getPlanRepositoryLinkByName in interface RepositoryDefinitionManager

getPlanRepositoryLinks

@NotNull
public List<PlanRepositoryLink> getPlanRepositoryLinks(@NotNull
                                                                ImmutablePlan plan)

Description copied from interface: RepositoryDefinitionManager

Get persistent representation of relation between Plan and repositories

Specified by:

getPlanRepositoryLinks in interface RepositoryDefinitionManager

getRepositoryDataEntity

@Nullable
public RepositoryDataEntity getRepositoryDataEntity(long id)

Description copied from interface: RepositoryDefinitionManager

Get persistent representation of a repository

Specified by:

getRepositoryDataEntity in interface RepositoryDefinitionManager

getRepositoryDefinitionsForPlan

@NotNull
public List<RepositoryDefinition> getRepositoryDefinitionsForPlan(@NotNull
                                                                           ImmutablePlan plan)

Description copied from interface: RepositoryDefinitionManager

Get all repositories attached to a plan ordered by position.

Specified by:

getRepositoryDefinitionsForPlan in interface RepositoryDefinitionManager

getPlanRepositoryDefinitions

@NotNull
public List<PlanRepositoryDefinition> getPlanRepositoryDefinitions(@NotNull
                                                                            PlanIdentifier plan)

Description copied from interface: RepositoryDefinitionManager

Get all repositories attached to a plan ordered by position.

Specified by:

getPlanRepositoryDefinitions in interface RepositoryDefinitionManager

getPlanRepositoriesForExport

@NotNull
public List<PartialVcsRepositoryData> getPlanRepositoriesForExport(@NotNull
                                                                            PlanIdentifier plan)

Description copied from interface: RepositoryDefinitionManager

Get all repositories attached to a plan in form suitable for export.

Specified by:

getPlanRepositoriesForExport in interface RepositoryDefinitionManager

getPlansUsingRepository

public List<PlanRepositoryLink> getPlansUsingRepository(long repositoryId)

Description copied from interface: RepositoryDefinitionManager

Get PlanRepositoryLinks associated with repository. This method should only be used when editing the list of repositories associated with a Plan. This method only direct associations. This means, that since Bamboo 5.14, it will return no results for linked repository. See also RepositoryDefinitionManager.getIdentifiersOfPlansUsingRepositoryOrItsDirectChildren(long)

Specified by:

getPlansUsingRepository in interface RepositoryDefinitionManager

getIdentifiersOfPlansUsingRepositoryOrItsDirectChildren

@NotNull
public List<PlanIdentifier> getIdentifiersOfPlansUsingRepositoryOrItsDirectChildren(long repositoryId)

Description copied from interface: RepositoryDefinitionManager

Get identifiers of Chains referencing a repository, either directly or through inheritance (only direct parent-child relationship is checked) If the parameter refers to a linked repository, only TopLevelPlans are returned. If the parameter refers to a plan local repository, it will return the plan the repository is linked to and all its ChainBranches

Specified by:

getIdentifiersOfPlansUsingRepositoryOrItsDirectChildren in interface RepositoryDefinitionManager

getGlobalRepositoryDefinitions

public List<RepositoryData> getGlobalRepositoryDefinitions()

Description copied from interface: RepositoryDefinitionManager

Get all Shared repositories current user has permission to use in his plans.

Specified by:

getGlobalRepositoryDefinitions in interface RepositoryDefinitionManager

getGlobalRepositoryDefinitionsForAdministration

public List<RepositoryData> getGlobalRepositoryDefinitionsForAdministration()

Description copied from interface: RepositoryDefinitionManager

Get all Shared repositories current user has permission to administrate.

Specified by:

getGlobalRepositoryDefinitionsForAdministration in interface RepositoryDefinitionManager

getGlobalRepositoryDefinitionsUnrestricted

public List<RepositoryData> getGlobalRepositoryDefinitionsUnrestricted()

Description copied from interface: RepositoryDefinitionManager

Get all Shared Repositories without permission checking.

Specified by:

getGlobalRepositoryDefinitionsUnrestricted in interface RepositoryDefinitionManager

getLinkedRepositories

@NotNull
public List<VcsRepositoryData> getLinkedRepositories()

Description copied from interface: RepositoryDefinitionManager

Get all linked repositories current user has permission to use in his plans.

Specified by:

getLinkedRepositories in interface RepositoryDefinitionAccessor

Specified by:

getLinkedRepositories in interface RepositoryDefinitionManager

getLinkedRepositoriesForAdministration

public List<VcsRepositoryData> getLinkedRepositoriesForAdministration()

Description copied from interface: RepositoryDefinitionManager

Get all Shared repositories current user has permission to administrate.

Specified by:

getLinkedRepositoriesForAdministration in interface RepositoryDefinitionManager

entityToVcsData

@Nullable
public VcsRepositoryData entityToVcsData(@Nullable
                                                   RepositoryDataEntity input)

Specified by:

entityToVcsData in interface RepositoryDefinitionManager

getVcsRepositoryData

@Nullable
public VcsRepositoryData getVcsRepositoryData(long repositoryId)

Description copied from interface: RepositoryDefinitionManager

Get plugin-agnostic representation of a repository configuration.

Specified by:

getVcsRepositoryData in interface RepositoryDefinitionManager

entityToUnmergedData

public PartialVcsRepositoryData entityToUnmergedData(@NotNull
                                                     RepositoryDataEntity entity)

Specified by:

entityToUnmergedData in interface RepositoryDefinitionManager

Parameters:

entity - should be in decoded state.

getVcsRepositoryDataForEditing

@Nullable
public PartialVcsRepositoryData getVcsRepositoryDataForEditing(long repositoryId)

Specified by:

getVcsRepositoryDataForEditing in interface RepositoryDefinitionManager

getLinkedRepositoriesUnrestricted

public List<VcsRepositoryData> getLinkedRepositoriesUnrestricted()

Description copied from interface: RepositoryDefinitionManager

Get all linked repositories without permission checking.

Specified by:

getLinkedRepositoriesUnrestricted in interface RepositoryDefinitionManager

saveRepositoryDefinition

public long saveRepositoryDefinition(RepositoryDataEntity repositoryData)

Description copied from interface: RepositoryDefinitionManager

Save repository definition.

Specified by:

saveRepositoryDefinition in interface RepositoryDefinitionManager

Returns:

id of saved definition

saveRepositoryDefinitions

public void saveRepositoryDefinitions(@NotNull
                                      Collection<RepositoryDataEntity> repositoriesBeingCreated)

Description copied from interface: RepositoryDefinitionManager

Saves all repository definitions in the collection.

Specified by:

saveRepositoryDefinitions in interface RepositoryDefinitionManager

savePlanRepositoryWithDefinition

public long savePlanRepositoryWithDefinition(@NotNull
                                             PlanRepositoryLink planRepository)

Description copied from interface: RepositoryDefinitionManager

Saves plan to repository relation definition with cascade to RepositoryDataEntity

Specified by:

savePlanRepositoryWithDefinition in interface RepositoryDefinitionManager

Returns:

new repository entity id

savePlanRepositoryLink

public void savePlanRepositoryLink(@NotNull
                                   PlanRepositoryLink planRepository)

Specified by:

savePlanRepositoryLink in interface RepositoryDefinitionManager

savePlanRepositoryLinks

public void savePlanRepositoryLinks(@NotNull
                                    List<PlanRepositoryLink> planRepositories)

Description copied from interface: RepositoryDefinitionManager

Saves the collection of plan to repository relations.

Specified by:

savePlanRepositoryLinks in interface RepositoryDefinitionManager

removeRepositoryFromPlan

public void removeRepositoryFromPlan(@NotNull
                                     PlanRepositoryLink planRepository)

Description copied from interface: RepositoryDefinitionManager

Removes relation between repository and plan. If the repository is not a global repository, RepositoryDefinitionManager.removeRepositoryIfUnused(RepositoryDataEntity) is called.

Specified by:

removeRepositoryFromPlan in interface RepositoryDefinitionManager

removeRepositoryIfUnused

public void removeRepositoryIfUnused(RepositoryDataEntity repositoryDataEntity)

Description copied from interface: RepositoryDefinitionManager

Marks repository for deletion if it is referenced by a RepositoryChangeset, removes it otherwise.

Specified by:

removeRepositoryIfUnused in interface RepositoryDefinitionManager

removeUnusedRepositories

public void removeUnusedRepositories()

Description copied from interface: RepositoryDefinitionManager

Removes all repositories that has been previously markedForDeletion and are no longer referenced by any RepositoryChangeset

Specified by:

removeUnusedRepositories in interface RepositoryDefinitionManager

removeRepositoriesForPlan

public void removeRepositoriesForPlan(Plan plan)

Description copied from interface: RepositoryDefinitionManager

Remove all repositories from Plan that are not global repositories.

Specified by:

removeRepositoriesForPlan in interface RepositoryDefinitionManager

getIdentifiersOfPlansUsingRepository

public List<PlanIdentifier> getIdentifiersOfPlansUsingRepository(long repositoryId)

Description copied from interface: RepositoryDefinitionManager

Get identifiers of Plans referencing a repository. This is faster than getPlansUsingRepository() and should be preferred for 'view' actions. This method only returns plans that are directly linked to the repository. This means, that since Bamboo 5.14, it will return no results for linked repository. See also RepositoryDefinitionManager.getIdentifiersOfPlansUsingRepositoryOrItsDirectChildren(long)

Specified by:

getIdentifiersOfPlansUsingRepository in interface RepositoryDefinitionManager

findRepositoriesByPluginKey

@NotNull
public List<RepositoryDataEntity> findRepositoriesByPluginKey(@NotNull
                                                                       String pluginKey)

Description copied from interface: RepositoryDefinitionManager

Given a pluginKey this will get you all of the repositories in Bamboo that were created for that key. Irrespective of whether:

• The plugin module with that plugin key is currently disabled.
• The repository is marked for deletion.
• The repository is marked as global or not.

In short it will get you every single repository that matches the provided plugin key.

Specified by:

findRepositoriesByPluginKey in interface RepositoryDefinitionManager

Parameters:

pluginKey - The plugin key to search for.

Returns:

All of the repositories that match that plugin key.

getVcsRepositoryDataByOid

public VcsRepositoryData getVcsRepositoryDataByOid(BambooEntityOid oid)

Description copied from interface: RepositoryDefinitionAccessor

Find a repository by oid.

Specified by:

getVcsRepositoryDataByOid in interface RepositoryDefinitionAccessor

Returns:

getLinkedRepositoryByName

@Nullable
public VcsRepositoryData getLinkedRepositoryByName(String name)

Description copied from interface: RepositoryDefinitionManager

Find a linked repository by name.

Specified by:

getLinkedRepositoryByName in interface RepositoryDefinitionManager

Parameters:

name - of linked repository

Returns:

linked repository