com.atlassian.bamboo.plan.pullrequest

Interface VcsPullRequestDao

All Superinterfaces:

BambooObjectDao<MutableVcsPullRequest>

All Known Implementing Classes:

VcsPullRequestHibernateDao

public interface VcsPullRequestDao
extends BambooObjectDao<MutableVcsPullRequest>

Since:

6.0

Method Summary

Modifier and Type	Method and Description
PartialList<MutableVcsPullRequest>	closePullRequestsClosedInRepository(long targetRepositoryId, Set<String> openPrKeys) Synchronize status of PRs in DB and in remote repository.
Collection<? extends MutableVcsPullRequest>	findAll()
MutableVcsPullRequest	findById(long id)
List<MutableVcsPullRequest>	findByRepository(long repositoryId, boolean isOpen) Search pull requests by target repository and status.
MutableVcsPullRequest	findByRepositoryAndKey(long repositoryId, String pullRequestKey) Search pull request by pull request key (unique on repository level) and target repository id
List<MutableVcsPullRequest>	findByStatus(boolean isOpen, long startFromId, int limit) Search pull requests by status.
int	removeOrphanedPullRequests() Remove pull requests which are neither linked to any repository nor to any plan branch.

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

countAll, countWithRestriction, delete, deleteAll, findAll, findById, merge, save, saveAll

Method Detail

findAll

Collection<? extends MutableVcsPullRequest> findAll()

findByRepositoryAndKey

@Nullable
MutableVcsPullRequest findByRepositoryAndKey(long repositoryId,
                                                       @NotNull
                                                       String pullRequestKey)

Search pull request by pull request key (unique on repository level) and target repository id

Parameters:

repositoryId - target repository id

pullRequestKey - repository-specific pull request key

Returns:

pull request or null if not found

findByRepository

@NotNull
List<MutableVcsPullRequest> findByRepository(long repositoryId,
                                                      boolean isOpen)

Search pull requests by target repository and status.

Parameters:

repositoryId - target repository id

isOpen - status

Returns:

list of pull requests

findById

@Nullable
MutableVcsPullRequest findById(long id)

closePullRequestsClosedInRepository

@NotNull
PartialList<MutableVcsPullRequest> closePullRequestsClosedInRepository(long targetRepositoryId,
                                                                                @NotNull
                                                                                Set<String> openPrKeys)

Synchronize status of PRs in DB and in remote repository. Returns a PartialList of updated pull requests.

If the returned list is incomplete, this method should be called again.

Parameters:

targetRepositoryId - id of a remote repository

openPrKeys - keys of pull requests which have open state in remote repository

Returns:

list of modified pull request entities

findByStatus

@NotNull
List<MutableVcsPullRequest> findByStatus(boolean isOpen,
                                                  long startFromId,
                                                  int limit)

Search pull requests by status.

Parameters:

isOpen - status

startFromId - entity id to start query from

limit - maximum amount of values to be returned

Returns:

list of pull requests sorted by id

removeOrphanedPullRequests

int removeOrphanedPullRequests()

Remove pull requests which are neither linked to any repository nor to any plan branch.

Returns:

number of removed records