com.atlassian.bamboo.plan.vcsRevision
Interface PlanVcsRevisionHistoryDao

All Superinterfaces:

BambooObjectDao<PlanVcsRevisionHistoryItem>

All Known Implementing Classes:

PlanVcsRevisionHistoryHibernateDao

public interface PlanVcsRevisionHistoryDao
extends BambooObjectDao<PlanVcsRevisionHistoryItem>

Method Summary

void	cleanupUnusedEntriesForPlan(PlanKey planKey)
void	createChangeDetectionHistoryItem(PlanVcsRevisionHistoryItem planVcsRevisionHistoryItem) Inserts new history item.
void	createOrUpdateChangeDetectionHistoryItem(PlanVcsRevisionHistoryItem planVcsRevisionHistoryItem) If item with the same plan key and build number exists it is updated with vcs information from the current one.
void	deleteVcsRevisionHistoryForPlan(PlanKey planKey) Deletes entire revision history for a plan.
java.util.List<PlanVcsRevisionHistoryItem>	findLatestVcsRevisionHistoryItems(PlanKey planKey) Retrieves a list of history items with the highest build number.
java.util.List<PlanVcsRevisionHistoryItem>	findLatestVcsRevisionHistoryItemsBeforeBuildNumber(PlanKey planKey, int buildNumber) Retrieves a list of history items with the highest build number that is lower than the argument.
PlanVcsRevisionHistoryItem	findVcsRevisionHistoryItem(PlanKey planKey, long repositoryId, int buildNumber) Retrieves a specific history item.

Methods inherited from interface com.atlassian.bamboo.persistence3.BambooObjectDao

delete, deleteAll, executeReturnLong, findAll, findById, save, saveAll

Method Detail

findVcsRevisionHistoryItem

@Nullable
PlanVcsRevisionHistoryItem findVcsRevisionHistoryItem(@NotNull
                                                               PlanKey planKey,
                                                               long repositoryId,
                                                               int buildNumber)

Retrieves a specific history item.

Parameters:

planKey -

repositoryId -

buildNumber -

Returns:

findLatestVcsRevisionHistoryItems

@NotNull
java.util.List<PlanVcsRevisionHistoryItem> findLatestVcsRevisionHistoryItems(@NotNull
                                                                                     PlanKey planKey)

Retrieves a list of history items with the highest build number. Note: the highest build number is determined once per plan and not for each repository.

Parameters:

planKey -

Returns:

findLatestVcsRevisionHistoryItemsBeforeBuildNumber

@NotNull
java.util.List<PlanVcsRevisionHistoryItem> findLatestVcsRevisionHistoryItemsBeforeBuildNumber(@NotNull
                                                                                                      PlanKey planKey,
                                                                                                      int buildNumber)

Retrieves a list of history items with the highest build number that is lower than the argument. Note: the highest build number is determined once per plan and not for each repository.

Parameters:

planKey -

buildNumber -

Returns:

createChangeDetectionHistoryItem

void createChangeDetectionHistoryItem(@NotNull
                                      PlanVcsRevisionHistoryItem planVcsRevisionHistoryItem)

Inserts new history item.

Parameters:

planVcsRevisionHistoryItem -

createOrUpdateChangeDetectionHistoryItem

void createOrUpdateChangeDetectionHistoryItem(@NotNull
                                              PlanVcsRevisionHistoryItem planVcsRevisionHistoryItem)

If item with the same plan key and build number exists it is updated with vcs information from the current one. Otherwise new one is created.

Parameters:

planVcsRevisionHistoryItem -

deleteVcsRevisionHistoryForPlan

void deleteVcsRevisionHistoryForPlan(@NotNull
                                     PlanKey planKey)

Deletes entire revision history for a plan.

Parameters:

planKey -

cleanupUnusedEntriesForPlan

void cleanupUnusedEntriesForPlan(@NotNull
                                 PlanKey planKey)