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
@NotNull Long	countAllProjectsRepositories() Count all project repositories.
PartialVcsRepositoryData	entityToUnmergedData(@NotNull RepositoryDataEntity entity)
@Nullable VcsRepositoryData	entityToVcsData(@Nullable RepositoryDataEntity input)
@NotNull List<Long>	findAllProjectsIdsUsingProjectRepositories() Find all project which are using project repositories.
@NotNull Set<Long>	findAllTopLevelRepositoriesIds() Get ids of all repositories that doesn't have parent repository (are either linked or are created on plan level)
@NotNull List<RepositoryDataEntity>	findRepositoriesByPluginKey(@NotNull 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.
@NotNull 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.
@NotNull 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.
@Nullable VcsRepositoryData	getLinkedRepositoryByName(String name) Find a linked repository by name.
@NotNull List<PartialVcsRepositoryData>	getPlanRepositoriesForExport(@NotNull PlanIdentifier plan) Get all repositories attached to a plan in form suitable for export.
@NotNull List<PlanRepositoryDefinition>	getPlanRepositoryDefinitions(@NotNull PlanIdentifier plan) Get all repositories attached to a plan ordered by position.
PlanRepositoryLink	getPlanRepositoryLink(@NotNull ImmutablePlan plan, long repositoryId) Get persistent representation of a relation between Plan and repository
PlanRepositoryLink	getPlanRepositoryLinkByName(@NotNull ImmutablePlan plan, @NotNull String repositoryName) Get persistent representation of a relation between Plan and repository
@NotNull List<PlanRepositoryLink>	getPlanRepositoryLinks(@NotNull ImmutablePlan plan) Get persistent representation of relation between Plan and repositories
List<PlanRepositoryLink>	getPlansUsingRepository(long repositoryId) Get PlanRepositoryLinks associated with repository.
@NotNull List<VcsRepositoryData>	getProjectRepositories(long projectId) Find all repositories in a project with given id.
@Nullable VcsRepositoryData	getProjectRepositoryByName(String name, Long projectId) Find a project repository by name in project associated with given projectId.
@Nullable RepositoryDataEntity	getRepositoryDataEntity(long id) Get persistent representation of a repository
@NotNull List<RepositoryDefinition>	getRepositoryDefinitionsForPlan(@NotNull ImmutablePlan plan) Get all repositories attached to a plan ordered by position.
@Nullable VcsRepositoryData	getVcsRepositoryData(long repositoryId) Get plugin-agnostic representation of a repository configuration.
VcsRepositoryData	getVcsRepositoryDataByOid(BambooEntityOid oid) Find a repository by oid.
@Nullable PartialVcsRepositoryData	getVcsRepositoryDataForEditing(long repositoryId)
boolean	isRepositoryOrItsDirectChildrenUsedInPlans(long repositoryId) Checks if repository is used in plans
void	removeRepositoriesForPlan(Plan plan) Remove all repositories from Plan that are not global repositories.
void	removeRepositoryFromPlan(@NotNull 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(@NotNull PlanRepositoryLink planRepository)
void	savePlanRepositoryLinks(@NotNull List<PlanRepositoryLink> planRepositories) Saves the collection of plan to repository relations.
long	savePlanRepositoryWithDefinition(@NotNull PlanRepositoryLink planRepository) Saves plan to repository relation definition with cascade to RepositoryDataEntity
long	saveRepositoryDefinition(RepositoryDataEntity repositoryData) Save repository definition.
void	saveRepositoryDefinitions(@NotNull 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
                                                @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
                                                      @NotNull ImmutablePlan plan,
                                                      @NotNull
                                                      @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 @NotNull List<PlanRepositoryLink> getPlanRepositoryLinks(@NotNull
                                                                         @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 @Nullable RepositoryDataEntity getRepositoryDataEntity(long id)

Description copied from interface: RepositoryDefinitionManager

Get persistent representation of a repository

Specified by:

getRepositoryDataEntity in interface RepositoryDefinitionManager

getRepositoryDefinitionsForPlan

@NotNull
public @NotNull List<RepositoryDefinition> getRepositoryDefinitionsForPlan(@NotNull
                                                                                    @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 @NotNull List<PlanRepositoryDefinition> getPlanRepositoryDefinitions(@NotNull
                                                                                     @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 @NotNull List<PartialVcsRepositoryData> getPlanRepositoriesForExport(@NotNull
                                                                                     @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 @NotNull 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

isRepositoryOrItsDirectChildrenUsedInPlans

public boolean isRepositoryOrItsDirectChildrenUsedInPlans(long repositoryId)

Description copied from interface: RepositoryDefinitionManager

Checks if repository is used in plans

Specified by:

isRepositoryOrItsDirectChildrenUsedInPlans 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 @NotNull 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 @Nullable VcsRepositoryData entityToVcsData(@Nullable
                                                             @Nullable RepositoryDataEntity input)

Specified by:

entityToVcsData in interface RepositoryDefinitionManager

getVcsRepositoryData

@Nullable
public @Nullable 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
                                                     @NotNull RepositoryDataEntity entity)

Specified by:

entityToUnmergedData in interface RepositoryDefinitionManager

Parameters:

entity - should be in decoded state.

getVcsRepositoryDataForEditing

@Nullable
public @Nullable 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
                                      @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
                                             @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
                                   @NotNull PlanRepositoryLink planRepository)

Specified by:

savePlanRepositoryLink in interface RepositoryDefinitionManager

savePlanRepositoryLinks

public void savePlanRepositoryLinks(@NotNull
                                    @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
                                     @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 @NotNull List<RepositoryDataEntity> findRepositoriesByPluginKey(@NotNull
                                                                                @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 @Nullable 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

findAllTopLevelRepositoriesIds

@NotNull
public @NotNull Set<Long> findAllTopLevelRepositoriesIds()

Description copied from interface: RepositoryDefinitionManager

Get ids of all repositories that doesn't have parent repository (are either linked or are created on plan level)

Specified by:

findAllTopLevelRepositoriesIds in interface RepositoryDefinitionManager

getProjectRepositoryByName

@Nullable
public @Nullable VcsRepositoryData getProjectRepositoryByName(String name,
                                                                        Long projectId)

Description copied from interface: RepositoryDefinitionManager

Find a project repository by name in project associated with given projectId.

Specified by:

getProjectRepositoryByName in interface RepositoryDefinitionManager

Returns:

RepositoryDataEntity if repository exists otherwise null.

countAllProjectsRepositories

@NotNull
public @NotNull Long countAllProjectsRepositories()

Description copied from interface: RepositoryDefinitionManager

Count all project repositories.

Specified by:

countAllProjectsRepositories in interface RepositoryDefinitionManager

Returns:

a Long count of all project repositories

getProjectRepositories

@NotNull
public @NotNull List<VcsRepositoryData> getProjectRepositories(long projectId)

Description copied from interface: RepositoryDefinitionManager

Find all repositories in a project with given id.

Specified by:

getProjectRepositories in interface RepositoryDefinitionManager

Returns:

a list of all project repositories

findAllProjectsIdsUsingProjectRepositories

@NotNull
public @NotNull List<Long> findAllProjectsIdsUsingProjectRepositories()

Description copied from interface: RepositoryDefinitionManager

Find all project which are using project repositories.

Specified by:

findAllProjectsIdsUsingProjectRepositories in interface RepositoryDefinitionManager

Returns:

a list of all projects IDs which are using project repositories