Package com.atlassian.bamboo.specs

Interface BambooSpecsManager

All Known Implementing Classes:

BambooSpecsManagerImpl

public interface BambooSpecsManager

Method Summary

Modifier and Type	Method	Description
void	detachPlanFromRss(long planId)	Detach plan from RSS.
Optional<VcsBambooSpecsSource>	findBambooSpecsSourceForPlan(long planId)	Find VcsBambooSpecsSource for a plan.
@NotNull List<VcsLocationBambooSpecsState>	findByVcsLocationIdOrderBySpecsExecutionDate(long repositoryId, @NotNull String branch, int limit)	Return latest limit entries for given repository and its branch
@NotNull Collection<Long>	findDeploymentProjectsInOtherStates(VcsLocationBambooSpecsState specsState)	Returns ids pf RSS-managed deployment projects that have been updated in RSS runs other than the one supplied.
Optional<VcsLocationBambooSpecsState>	findLatestState(long rootVcsRepositoryId, @NotNull String branch)	Find latest VcsLocationBambooSpecsState for given repository and branch
@NotNull Collection<PlanKey>	findPlansInOtherStates(VcsLocationBambooSpecsState specsState)	Returns RSS-managed plans that have been updated in RSS runs other than the one supplied.
Optional<VcsBambooSpecsSource>	findSourceById(long specsStateId)	Find VcsBambooSpecsSource by id.
@NotNull List<String>	findSpecsBranches(long rootVcsRepositoryId, @NotNull String searchTerm)	Get all branches from VcsLocationBambooSpecsState for given repository which match the search term
@NotNull List<VcsLocationBambooSpecsState>	getUnfinishedSpecsScans()	Get all VcsLocationBambooSpecsState that are in unfinished state
long	removeOrphanedSpecStatesNoTx()	Cleanup Bamboo Specs states DB records and log files.
void	save(VcsBambooSpecsSource vcsBambooSpecsSource)	Save new VcsBambooSpecsSource entity.
void	save(VcsLocationBambooSpecsState vcsLocationBambooSpecsState)	Save new VcsLocationBambooSpecsState entity.
void	updateAfterSpecsImport(VcsLocationBambooSpecsState vcsLocationBambooSpecsState, VcsLocationBambooSpecsState.SpecsImportState specsImportState, String logFilename)	Update given VcsLocationBambooSpecsState with specs import results and save it.
void	updateBambooSpecsSourceForPlan(@NotNull Chain plan, @NotNull VcsBambooSpecsSource vcsBambooSpecsSourceId)	Update VcsBambooSpecsSource for a plan.

Method Detail

findLatestState

Optional<VcsLocationBambooSpecsState> findLatestState(long rootVcsRepositoryId,
                                                      @NotNull
                                                      @NotNull String branch)

Find latest VcsLocationBambooSpecsState for given repository and branch

save

void save(VcsLocationBambooSpecsState vcsLocationBambooSpecsState)

Save new VcsLocationBambooSpecsState entity.

save

void save(VcsBambooSpecsSource vcsBambooSpecsSource)

Save new VcsBambooSpecsSource entity.

findSourceById

Optional<VcsBambooSpecsSource> findSourceById(long specsStateId)

Find VcsBambooSpecsSource by id.

findPlansInOtherStates

@NotNull
@NotNull Collection<PlanKey> findPlansInOtherStates(VcsLocationBambooSpecsState specsState)

Returns RSS-managed plans that have been updated in RSS runs other than the one supplied.

findDeploymentProjectsInOtherStates

@NotNull
@NotNull Collection<Long> findDeploymentProjectsInOtherStates(VcsLocationBambooSpecsState specsState)

Returns ids pf RSS-managed deployment projects that have been updated in RSS runs other than the one supplied.

findByVcsLocationIdOrderBySpecsExecutionDate

@NotNull
@NotNull List<VcsLocationBambooSpecsState> findByVcsLocationIdOrderBySpecsExecutionDate(long repositoryId,
                                                                                        @NotNull
                                                                                        @NotNull String branch,
                                                                                        int limit)

Return latest limit entries for given repository and its branch

updateAfterSpecsImport

void updateAfterSpecsImport(VcsLocationBambooSpecsState vcsLocationBambooSpecsState,
                            VcsLocationBambooSpecsState.SpecsImportState specsImportState,
                            String logFilename)

Update given VcsLocationBambooSpecsState with specs import results and save it.

removeOrphanedSpecStatesNoTx

@Internal
long removeOrphanedSpecStatesNoTx()

Cleanup Bamboo Specs states DB records and log files. It's not visible at interface to avoid usage by plugin developers.

Returns:

count of removed entries

getUnfinishedSpecsScans

@NotNull
@NotNull List<VcsLocationBambooSpecsState> getUnfinishedSpecsScans()

Get all VcsLocationBambooSpecsState that are in unfinished state

findSpecsBranches

@NotNull
@NotNull List<String> findSpecsBranches(long rootVcsRepositoryId,
                                        @NotNull
                                        @NotNull String searchTerm)

Get all branches from VcsLocationBambooSpecsState for given repository which match the search term

findBambooSpecsSourceForPlan

Optional<VcsBambooSpecsSource> findBambooSpecsSourceForPlan(long planId)

Find VcsBambooSpecsSource for a plan.

Since:

8.1

updateBambooSpecsSourceForPlan

void updateBambooSpecsSourceForPlan(@NotNull
                                    @NotNull Chain plan,
                                    @NotNull
                                    @NotNull VcsBambooSpecsSource vcsBambooSpecsSourceId)

Update VcsBambooSpecsSource for a plan.

Since:

8.1

detachPlanFromRss

void detachPlanFromRss(long planId)

Detach plan from RSS.

Since:

8.1