com.atlassian.bamboo.vcs.runtime

Interface VcsPullRequestDetector

All Superinterfaces:

IdentifyingExecutor<VcsPullRequestDetector>

All Known Implementing Classes:

BitbucketCloudPullRequestDetector, BitbucketServerPullRequestDetector

public interface VcsPullRequestDetector
extends IdentifyingExecutor<VcsPullRequestDetector>

Executor responsible for pull request detection. Used by server-side. Implementation should be stateless.

Since:

6.0

Method Summary

Modifier and Type	Method and Description
List<VcsPullRequest>	getOpenPullRequests(VcsRepositoryData repositoryData) List of open pull requests that are discovered in the repository.
default boolean	usePollingForPullRequestDetection(VcsRepositoryData repositoryData) Check if Bamboo needs to actively poll in order to detect new/deleted pull requests for specific repository configuration.

Methods inherited from interface com.atlassian.bamboo.vcs.runtime.IdentifyingExecutor

getVcsIdForExecutor

Method Detail

usePollingForPullRequestDetection

default boolean usePollingForPullRequestDetection(@NotNull
                                                  VcsRepositoryData repositoryData)

Check if Bamboo needs to actively poll in order to detect new/deleted pull requests for specific repository configuration.

Parameters:

repositoryData - repository

Returns:

- true if Bamboo need periodically contact the remote repository in order to update list of known pull requests. - false if repository is capable of detecting pull requests using one of available "push" method, e.g. REST resource, remote event.

getOpenPullRequests

@NotNull
List<VcsPullRequest> getOpenPullRequests(@NotNull
                                                  VcsRepositoryData repositoryData)
                                           throws RepositoryException

List of open pull requests that are discovered in the repository. Used for monitoring repositories for new PRs.

Parameters:

repositoryData - repository

Returns:

List of open pull requests. May be empty.

Throws:

RepositoryException