com.atlassian.bamboo.build

Interface PlanDependencyManager

All Known Implementing Classes:

PlanDependencyManagerImpl

public interface PlanDependencyManager

Method Summary

Modifier and Type	Method and Description
void	adjustChildDependencyList(String dependencyType, Plan plan, Set<PlanKey> newChildPlanKeys, boolean overwriteExisting) Update the existing children dependencies of the given plan and dependency Type to match the provided list of new children.
void	adjustParentDependencyList(String dependencyType, Plan plan, Set<PlanKey> newParentPlanKeys, boolean overwriteExisting) Update the existing parent dependencies of the given plan and dependency Type to match the provided list of new parents.
Set<PlanDependency>	getAllDependencies() Retrieves all dependency relationships in the system regardless of the plans involved
Set<String>	getChildChainKeys(PlanIdentifier plan) Retrieves all chain that are children of the current plan
Set<PlanDependency>	getChildPlanDependencies(PlanIdentifier plan) Retrieves all plan dependencies in which the given plan features as a parent
Set<String>	getChildPlanKeys(PlanIdentifier plan) Retrievs all plan that are children of the current plan
Set<ImmutablePlan>	getEffectiveChildPlans(ImmutablePlan chain)
Set<ImmutablePlan>	getEffectiveParentPlans(ImmutablePlan chain)
Set<String>	getNotEditableChildKeys(PlanIdentifier plan) Retrieves a list of keys representing the children that are not editable of the given plan
Set<String>	getNotEditableParentKeys(PlanIdentifier plan) Retrieves a list of keys representing the children that are not editable of the given plan
Set<String>	getParentChainKeys(PlanIdentifier plan) Retrieves all chain that are children of the current plan
Set<PlanDependency>	getParentPlanDependencies(PlanIdentifier plan) Retrieves all plan dependencies in which the given plan features as a child
Set<String>	getParentPlanKeys(PlanIdentifier plan) Retrievs all plans that are a parent of the current plan
void	removeAllDependenciesForPlan(PlanIdentifier plan) Deletes any existing dependency featuring the given plan.
boolean	savePlanDependency(PlanDependency dependency) Save the given dependency.
ErrorCollection	validateChildDependencyList(String dependencyType, Plan plan, Set<PlanKey> newChildPlanKeys, boolean overwriteExisting) Validate child dependency list

Method Detail

getAllDependencies

@NotNull
Set<PlanDependency> getAllDependencies()

Retrieves all dependency relationships in the system regardless of the plans involved

Returns:

all plan dependencies.

getChildPlanDependencies

@NotNull
Set<PlanDependency> getChildPlanDependencies(@NotNull
                                                      PlanIdentifier plan)

Retrieves all plan dependencies in which the given plan features as a parent

Parameters:

plan - - the parent

Returns:

set of all children of the given plan

getParentPlanDependencies

@NotNull
Set<PlanDependency> getParentPlanDependencies(@NotNull
                                                       PlanIdentifier plan)

Retrieves all plan dependencies in which the given plan features as a child

Parameters:

plan - - the child

Returns:

newly created set of all parents to the given plan

removeAllDependenciesForPlan

void removeAllDependenciesForPlan(@NotNull
                                  PlanIdentifier plan)

Deletes any existing dependency featuring the given plan. Used when deleting a plan.

Parameters:

plan - to be removed

getChildPlanKeys

@NotNull
Set<String> getChildPlanKeys(@NotNull
                                      PlanIdentifier plan)

Retrievs all plan that are children of the current plan

Parameters:

plan - - the parent

Returns:

set of plan keys representing all children of the given plan

getParentPlanKeys

@NotNull
Set<String> getParentPlanKeys(@NotNull
                                       PlanIdentifier plan)

Retrievs all plans that are a parent of the current plan

Parameters:

plan - - the child

Returns:

set of plan keys representing all parents of the given plan

getChildChainKeys

@NotNull
Set<String> getChildChainKeys(@NotNull
                                       PlanIdentifier plan)

Retrieves all chain that are children of the current plan

Parameters:

plan - - the parent

Returns:

set of chain keys representing all children of the given plan

getParentChainKeys

@NotNull
Set<String> getParentChainKeys(@NotNull
                                        PlanIdentifier plan)

Retrieves all chain that are children of the current plan

Parameters:

plan - - the parent

Returns:

set of chain keys representing all children of the given plan

savePlanDependency

boolean savePlanDependency(@Nullable
                           PlanDependency dependency)

Save the given dependency. Will check if it exists or if the dependency is invalid.

Parameters:

dependency - to save

Returns:

true if it saved it, false otherwise

getNotEditableChildKeys

@NotNull
Set<String> getNotEditableChildKeys(@NotNull
                                             PlanIdentifier plan)

Retrieves a list of keys representing the children that are not editable of the given plan

Parameters:

plan - parent

Returns:

Set of un-editable dependencies representing the children of the given plan

getNotEditableParentKeys

@NotNull
Set<String> getNotEditableParentKeys(@NotNull
                                              PlanIdentifier plan)

Retrieves a list of keys representing the children that are not editable of the given plan

Parameters:

plan - parent

Returns:

Set of un-editable dependencies representing the children of the given plan

validateChildDependencyList

@NotNull
ErrorCollection validateChildDependencyList(@NotNull
                                                     String dependencyType,
                                                     @NotNull
                                                     Plan plan,
                                                     @NotNull
                                                     Set<PlanKey> newChildPlanKeys,
                                                     boolean overwriteExisting)

Validate child dependency list

adjustChildDependencyList

void adjustChildDependencyList(@NotNull
                               String dependencyType,
                               @NotNull
                               Plan plan,
                               @NotNull
                               Set<PlanKey> newChildPlanKeys,
                               boolean overwriteExisting)

Update the existing children dependencies of the given plan and dependency Type to match the provided list of new children.

Parameters:

dependencyType - of the dependencies being adjusted

plan - parent

newChildPlanKeys - the new list of parents (as plan keys)

overwriteExisting - whether or not to overwrite any existing dependencies (of a different type) with one of the new type

adjustParentDependencyList

void adjustParentDependencyList(@NotNull
                                String dependencyType,
                                @NotNull
                                Plan plan,
                                @NotNull
                                Set<PlanKey> newParentPlanKeys,
                                boolean overwriteExisting)

Update the existing parent dependencies of the given plan and dependency Type to match the provided list of new parents.

Parameters:

dependencyType - of the dependencies being adjusted

plan - parent

newParentPlanKeys - the new list of parents (as plan keys)

overwriteExisting - whether or not to overwrite any existing dependencies (of a different type) with one of the new type

getEffectiveChildPlans

Set<ImmutablePlan> getEffectiveChildPlans(@NotNull
                                          ImmutablePlan chain)

Since:

4.2

getEffectiveParentPlans

Set<ImmutablePlan> getEffectiveParentPlans(@NotNull
                                           ImmutablePlan chain)

Since:

4.2