Package com.atlassian.bitbucket.pull

Class PullRequestMergeRequest

java.lang.Object

com.atlassian.bitbucket.pull.AbstractPullRequestRequest

com.atlassian.bitbucket.pull.PullRequestMergeRequest

public class PullRequestMergeRequest
extends AbstractPullRequestRequest

Describes a request to merge a PullRequest.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PullRequestMergeRequest.Builder

Nested classes/interfaces inherited from class com.atlassian.bitbucket.pull.AbstractPullRequestRequest

AbstractPullRequestRequest.AbstractBuilder<T extends AbstractPullRequestRequest.AbstractBuilder<T>>

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	PullRequestMergeRequest(PullRequestMergeRequest.Builder builder)

Method Summary

Modifier and Type	Method	Description
String	getMessage()	Retrieves the commit message to use when merging the pull request.
String	getStrategyId()	Retrieves the ID of the strategy to use when merging the pull request.
int	getVersion()	Retrieves the expected version for the pull request.
boolean	isAutoSubject()	Retrieves a flag indicating whether the system should prepend an auto-generated subject to the provided message.

Methods inherited from class com.atlassian.bitbucket.pull.AbstractPullRequestRequest

getPullRequestId, getRepositoryId

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

PullRequestMergeRequest

protected PullRequestMergeRequest(PullRequestMergeRequest.Builder builder)

Method Details

getMessage

@Nullable
public String getMessage()

Retrieves the commit message to use when merging the pull request.

If isAutoSubject() is true, the system will prepend an auto-generated subject to the message provided here. Otherwise, if it's false, the provided message will be used as-is.

While this is part of the API for merging pull requests, the underlying SCM performing the merge ultimately decides the exact shape of the final commit message. For example, when performing a fast-forward "merge" in Git, any commit message provided here is ignored because the "merge" does not actually create a new commit. Additionally, the SCM may, at its own discretion, augment the provided commit message with more detail. For example, the Git SCM appends the summary from each merged commit to the message.

Returns:

the commit message for the pull request

getStrategyId

@Nullable
public String getStrategyId()

Retrieves the ID of the strategy to use when merging the pull request. If a strategy has not been specified, the default strategy for the target repository is used. Only enabled strategies may be requested.

Returns:

the strategy to use when merging the pull request, or null to use the default

Since:

4.9

getVersion

public int getVersion()

Retrieves the expected version for the pull request. If the pull request's actual version does not match, a PullRequestOutOfDateException will be thrown to indicate that the merge was requested on stale data.

Returns:

the pull request version to merge

isAutoSubject

public boolean isAutoSubject()

Retrieves a flag indicating whether the system should prepend an auto-generated subject to the provided message. If no message is provided, this will always be true.

Returns:

true if no message was provided, or if an auto-generated subject should be prepended to it; otherwise, false to use the provided message as-is

Since:

5.7