public interface

PullRequestMergeConfig

com.atlassian.bitbucket.pull.PullRequestMergeConfig

Class Overview

Describes the configuration for how pull requests will be merged in a given repository. For cross-repository pull requests, the target repository's configuration controls merge behavior.

The SCM backing each repository may expose one or more strategies that are available when merging pull requests. For SCMs which support multiple strategies, administrators can configure which strategy (or strategies) should be available. Any enabled strategy may be selected when merging a pull request. If an explicit strategy is not requested, the default will be used.

The strategies to use may be configured for a specific repository, all repositories in a given project which share the same SCM, or for all repositories of a specific SCM in all projects. If configuration has not been applied at any of those levels, defaults provided by the SCM are used. The type can be used to determine what level configuration was applied at.

Summary

Public Methods
@Nonnull PullRequestMergeStrategy getDefaultStrategy()
Retrieves the default strategy, which will be used automatically when merging pull requests if an explicit strategy is not requested.
@Nonnull Set<PullRequestMergeStrategy> getStrategies()
Retrieves the complete set of merge strategies supported by the SCM, including the default strategy.
@Nonnull PullRequestMergeConfigType getType()
Retrieves the configuration type, identifying the level the configuration was applied at.

Public Methods

@Nonnull public PullRequestMergeStrategy getDefaultStrategy ()

Retrieves the default strategy, which will be used automatically when merging pull requests if an explicit strategy is not requested. The default strategy is always enabled.

Returns
  • the default merge strategy

@Nonnull public Set<PullRequestMergeStrategy> getStrategies ()

Retrieves the complete set of merge strategies supported by the SCM, including the default strategy. Some of the returned strategies may not be enabled. Only enabled strategies may be requested when merging pull requests, so callers should check before using a strategy from the returned set.

Returns
  • the complete set of supported strategies for the backing SCM, including the default, each of which may or may not be enabled

@Nonnull public PullRequestMergeConfigType getType ()

Retrieves the configuration type, identifying the level the configuration was applied at. Since configuration is inherited, the type may be less specific than what was requested.

Returns
  • the configuration type, used to determine what level configuration was applied at