Package com.cloudbees.jenkins.plugins.bitbucket.client

Class BitbucketCloudApiClient

java.lang.Object

com.cloudbees.jenkins.plugins.bitbucket.impl.client.AbstractBitbucketApi

com.cloudbees.jenkins.plugins.bitbucket.client.BitbucketCloudApiClient

All Implemented Interfaces:

BitbucketApi, AutoCloseable

public class BitbucketCloudApiClient
extends AbstractBitbucketApi
implements BitbucketApi

Field Summary

Fields inherited from class com.cloudbees.jenkins.plugins.bitbucket.impl.client.AbstractBitbucketApi

logger

Constructor Summary

Constructors

Constructor	Description
BitbucketCloudApiClient(boolean enableCache, int teamCacheDuration, int repositoriesCacheDuration, String owner, String projectKey, String repositoryName, BitbucketAuthenticator authenticator)

Method Summary

Modifier and Type	Method	Description
boolean	checkPathExists(String branchOrHash, String path)	Checks if the given path exists in the repository at the specified branch.
static void	clearCaches()
jenkins.scm.impl.avatars.AvatarImage	getAvatar(String url)	Returns an Avatar image from the given URL.
BitbucketCloudBranch	getBranch(String branchName)	Returns a branch in the repository.
List<BitbucketCloudBranch>	getBranches()	Returns the branches in the repository.
List<BitbucketCloudBranch>	getBranchesByRef(String nodePath)
protected org.apache.hc.client5.http.impl.classic.CloseableHttpClient	getClient()
List<BitbucketCloudCommit>	getCommits(String fromCommit, String toCommit)	Return a set of base informations between the two given commits.
protected org.apache.hc.client5.http.io.HttpClientConnectionManager	getConnectionManager()
String	getDefaultBranch()	Gets the default branch in the repository.
Iterable<jenkins.scm.api.SCMFile>	getDirectoryContent(BitbucketSCMFile parent)	Returns a list of all children file for the given folder.
jenkins.scm.api.SCMFile	getFile(BitbucketSCMFile file)	Return the metadata for the given file.
InputStream	getFileContent(BitbucketSCMFile file)	Return an input stream for the given file.
protected org.apache.hc.core5.http.HttpHost	getHost()
String	getOwner()	Returns the owner name for the repository.
BitbucketPullRequest	getPullRequestById(Integer id)	Returns a specific pull request.
List<BitbucketCloudPullRequest>	getPullRequests()	Returns the pull requests in the repository.
List<BitbucketCloudRepository>	getRepositories()	Returns all the repositories for the current owner (even if it's a regular user or a team).
List<BitbucketCloudRepository>	getRepositories(UserRoleInRepository role)	Returns the repositories where the user has the given role.
BitbucketRepository	getRepository()	Returns the repository details.
String	getRepositoryName()	Returns the repository name.
BitbucketCloudBranch	getTag(String tagName)	Returns a tag in the repository.
List<BitbucketCloudBranch>	getTags()	Returns the tags in the repository.
BitbucketTeam	getTeam()	Returns the team of the current owner or null if the current owner is not a team.
jenkins.scm.impl.avatars.AvatarImage	getTeamAvatar()	Deprecated, for removal: This API element is subject to removal in a future version.
List<BitbucketCloudHook>	getWebHooks()	Returns the webhooks defined in the repository.
boolean	isPrivate()	Returns true if and only if the repository is private.
protected boolean	isSupportedAuthenticator(BitbucketAuthenticator authenticator)	Implementation must validate if the configured authenticator is supported by this client implementation.
void	postBuildStatus(BitbucketBuildStatus status)	Set the build status for the given commit hash.
void	postCommitComment(String hash, String comment)	Post a comment to a given commit hash.
void	registerCommitWebHook(BitbucketWebHook hook)	Register a webhook on the repository.
void	removeCommitWebHook(BitbucketWebHook hook)	Remove the webhook (ID field required) from the repository.
BitbucketCommit	resolveCommit(BitbucketPullRequest pull)	Resolve the head commit object of the pull request source repository branch.
BitbucketCommit	resolveCommit(String hash)	Resolve the commit object given its hash.
String	resolveSourceFullHash(BitbucketPullRequest pull)	Resolve the head commit hash of the pull request source repository branch.
static List<String>	stats()
void	updateCommitWebHook(BitbucketWebHook hook)	Update a webhook on the repository.

Methods inherited from class com.cloudbees.jenkins.plugins.bitbucket.impl.client.AbstractBitbucketApi

buildResponseException, close, connectionManagerBuilder, deleteRequest, executeMethod, getAuthenticator, getRequest, getRequestAsInputStream, getResponseContent, headRequestStatus, postRequest, postRequest, putRequest, setClientProxyParams, setupClientBuilder

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.cloudbees.jenkins.plugins.bitbucket.api.BitbucketApi

close

Constructor Details

BitbucketCloudApiClient

public BitbucketCloudApiClient(boolean enableCache,
 int teamCacheDuration,
 int repositoriesCacheDuration,
 String owner,
 String projectKey,
 String repositoryName,
 BitbucketAuthenticator authenticator)

Method Details

stats

public static List<String> stats()

clearCaches

public static void clearCaches()

isSupportedAuthenticator

protected boolean isSupportedAuthenticator(@CheckForNull
 BitbucketAuthenticator authenticator)

Description copied from class: AbstractBitbucketApi

Implementation must validate if the configured authenticator is supported by this client implementation.

Specified by:

isSupportedAuthenticator in class AbstractBitbucketApi

getOwner

@NonNull
public String getOwner()

Returns the owner name for the repository.

Specified by:

getOwner in interface BitbucketApi

Returns:

the repository owner name.

getRepositoryName

@CheckForNull
public String getRepositoryName()

Returns the repository name.

Specified by:

getRepositoryName in interface BitbucketApi

Returns:

the repository name.

getPullRequests

@NonNull
public List<BitbucketCloudPullRequest> getPullRequests()
                                                throws IOException

Returns the pull requests in the repository.

Specified by:

getPullRequests in interface BitbucketApi

Returns:

the list of pull requests in the repository.

Throws:

IOException - if there was a network communications error.

getPullRequestById

@NonNull
public BitbucketPullRequest getPullRequestById(@NonNull
 Integer id)
                                        throws IOException

Returns a specific pull request.

Specified by:

getPullRequestById in interface BitbucketApi

Parameters:

id - the pull request ID

Returns:

the pull request or null if the PR does not exist

Throws:

IOException - if there was a network communications error.

getRepository

@NonNull
public BitbucketRepository getRepository()
                                  throws IOException

Returns the repository details.

Specified by:

getRepository in interface BitbucketApi

Returns:

the repository specified by BitbucketApi.getOwner()/BitbucketApi.getRepositoryName() (or null if repositoryName is not set)

Throws:

IOException - if there was a network communications error.

postCommitComment

public void postCommitComment(@NonNull
 String hash,
 @NonNull
 String comment)
                       throws IOException

Post a comment to a given commit hash.

Specified by:

postCommitComment in interface BitbucketApi

Parameters:

hash - commit hash

comment - string to post as comment

Throws:

IOException - if there was a network communications error.

checkPathExists

public boolean checkPathExists(@NonNull
 String branchOrHash,
 @NonNull
 String path)
                        throws IOException

Checks if the given path exists in the repository at the specified branch.

Specified by:

checkPathExists in interface BitbucketApi

Parameters:

branchOrHash - the branch name or commit hash

path - the path to check for

Returns:

true if the path exists

Throws:

IOException - if there was a network communications error.

getDefaultBranch

@CheckForNull
public String getDefaultBranch()
                        throws IOException

Gets the default branch in the repository.

Specified by:

getDefaultBranch in interface BitbucketApi

Returns:

the default branch in the repository or null if no default branch set

Throws:

IOException - if there was a network communications error.

getTag

public BitbucketCloudBranch getTag(@NonNull
 String tagName)
                            throws IOException

Returns a tag in the repository.

Specified by:

getTag in interface BitbucketApi

Returns:

a tag in the repository.

Throws:

IOException - if there was a network communications error.

getTags

@NonNull
public List<BitbucketCloudBranch> getTags()
                                   throws IOException

Returns the tags in the repository.

Specified by:

getTags in interface BitbucketApi

Returns:

the list of tags in the repository.

Throws:

IOException - if there was a network communications error.

getBranch

public BitbucketCloudBranch getBranch(@NonNull
 String branchName)
                               throws IOException

Returns a branch in the repository.

Specified by:

getBranch in interface BitbucketApi

Returns:

a branch in the repository.

Throws:

IOException - if there was a network communications error.

getBranches

@NonNull
public List<BitbucketCloudBranch> getBranches()
                                       throws IOException

Returns the branches in the repository.

Specified by:

getBranches in interface BitbucketApi

Returns:

the list of branches in the repository.

Throws:

IOException - if there was a network communications error.

getBranchesByRef

public List<BitbucketCloudBranch> getBranchesByRef(String nodePath)
                                            throws IOException

Throws:

IOException

resolveCommit

@CheckForNull
public BitbucketCommit resolveCommit(@NonNull
 String hash)
                              throws IOException

Resolve the commit object given its hash.

Specified by:

resolveCommit in interface BitbucketApi

Parameters:

hash - the hash to resolve

Returns:

the commit object or null if the hash does not exist

Throws:

IOException - if there was a network communications error.

resolveSourceFullHash

@NonNull
public String resolveSourceFullHash(@NonNull
 BitbucketPullRequest pull)
                             throws IOException

Resolve the head commit hash of the pull request source repository branch.

Specified by:

resolveSourceFullHash in interface BitbucketApi

Parameters:

pull - the pull request to resolve the source hash from

Returns:

the source head hash

Throws:

IOException - if there was a network communications error.

resolveCommit

@NonNull
public BitbucketCommit resolveCommit(@NonNull
 BitbucketPullRequest pull)
                              throws IOException

Resolve the head commit object of the pull request source repository branch.

Specified by:

resolveCommit in interface BitbucketApi

Parameters:

pull - the pull request to resolve the source hash from

Returns:

the source head commit object

Throws:

IOException - if there was a network communications error.

registerCommitWebHook

public void registerCommitWebHook(@NonNull
 BitbucketWebHook hook)
                           throws IOException

Register a webhook on the repository.

Specified by:

registerCommitWebHook in interface BitbucketApi

Parameters:

hook - the webhook object

Throws:

IOException - if there was a network communications error.

updateCommitWebHook

public void updateCommitWebHook(@NonNull
 BitbucketWebHook hook)
                         throws IOException

Update a webhook on the repository.

Specified by:

updateCommitWebHook in interface BitbucketApi

Parameters:

hook - the webhook object

Throws:

IOException - if there was a network communications error.

removeCommitWebHook

public void removeCommitWebHook(@NonNull
 BitbucketWebHook hook)
                         throws IOException

Remove the webhook (ID field required) from the repository.

Specified by:

removeCommitWebHook in interface BitbucketApi

Parameters:

hook - the webhook object

Throws:

IOException - if there was a network communications error.

getWebHooks

@NonNull
public List<BitbucketCloudHook> getWebHooks()
                                     throws IOException

Returns the webhooks defined in the repository.

Specified by:

getWebHooks in interface BitbucketApi

Returns:

the list of webhooks registered in the repository.

Throws:

IOException - if there was a network communications error.

postBuildStatus

public void postBuildStatus(@NonNull
 BitbucketBuildStatus status)
                     throws IOException

Set the build status for the given commit hash.

Specified by:

postBuildStatus in interface BitbucketApi

Parameters:

status - the status object to be serialized

Throws:

IOException - if there was a network communications error.

isPrivate

public boolean isPrivate()
                  throws IOException

Returns true if and only if the repository is private.

Specified by:

isPrivate in interface BitbucketApi

Returns:

true if the repository (BitbucketApi.getOwner()/BitbucketApi.getRepositoryName()) is private.

Throws:

IOException - if there was a network communications error.

getTeam

@CheckForNull
public BitbucketTeam getTeam()
                      throws IOException

Returns the team of the current owner or null if the current owner is not a team.

Specified by:

getTeam in interface BitbucketApi

Returns:

the team profile of the current owner, or null if BitbucketApi.getOwner() is not a team ID.

Throws:

IOException - if there was a network communications error.

getTeamAvatar

@Deprecated(since="935.0.0",
            forRemoval=true)
@CheckForNull
public jenkins.scm.impl.avatars.AvatarImage getTeamAvatar()
                                                   throws IOException

Deprecated, for removal: This API element is subject to removal in a future version.

Returns the team Avatar of the current owner or null if the current owner is not a team.

Specified by:

getTeamAvatar in interface BitbucketApi

Returns:

the team profile of the current owner, or null if BitbucketApi.getOwner() is not a team ID.

Throws:

IOException - if there was a network communications error.

getAvatar

@CheckForNull
public jenkins.scm.impl.avatars.AvatarImage getAvatar(@CheckForNull
 String url)
                                               throws IOException

Description copied from interface: BitbucketApi

Returns an Avatar image from the given URL.

The URL link could come from repository, project, workspace or user links.

Specified by:

getAvatar in interface BitbucketApi

Returns:

the resource image.

Throws:

IOException - if there was a network communications error.

getRepositories

@NonNull
public List<BitbucketCloudRepository> getRepositories(@CheckForNull
 UserRoleInRepository role)
                                               throws IOException

Description copied from interface: BitbucketApi

Returns the repositories where the user has the given role.

Specified by:

getRepositories in interface BitbucketApi

Parameters:

role - Filter repositories by the owner having this role in. See UserRoleInRepository for more information. Use role = null if the repoOwner is a team ID.

Returns:

the repositories list (it can be empty)

Throws:

IOException - if there was a network communications error.

getRepositories

@NonNull
public List<BitbucketCloudRepository> getRepositories()
                                               throws IOException

Returns all the repositories for the current owner (even if it's a regular user or a team).

Specified by:

getRepositories in interface BitbucketApi

Returns:

all repositories for the current BitbucketApi.getOwner()

Throws:

IOException - if there was a network communications error.

getConnectionManager

protected org.apache.hc.client5.http.io.HttpClientConnectionManager getConnectionManager()

Specified by:

getConnectionManager in class AbstractBitbucketApi

getHost

@NonNull
protected org.apache.hc.core5.http.HttpHost getHost()

Specified by:

getHost in class AbstractBitbucketApi

getClient

@NonNull
protected org.apache.hc.client5.http.impl.classic.CloseableHttpClient getClient()

Specified by:

getClient in class AbstractBitbucketApi

getDirectoryContent

public Iterable<jenkins.scm.api.SCMFile> getDirectoryContent(BitbucketSCMFile parent)
                                                      throws IOException

Description copied from interface: BitbucketApi

Returns a list of all children file for the given folder.

Specified by:

getDirectoryContent in interface BitbucketApi

Parameters:

parent - to list

Returns:

an iterable of SCMFile children of the given folder.

Throws:

IOException - if there was a network communications error.

getFileContent

public InputStream getFileContent(@NonNull
 BitbucketSCMFile file)
                           throws IOException

Description copied from interface: BitbucketApi

Return an input stream for the given file.

Specified by:

getFileContent in interface BitbucketApi

Parameters:

file - an instance of SCM file

Returns:

the stream of the given SCMFile

Throws:

IOException - if there was a network communications error.

getFile

@NonNull
public jenkins.scm.api.SCMFile getFile(@NonNull
 BitbucketSCMFile file)
                                throws IOException

Description copied from interface: BitbucketApi

Return the metadata for the given file.

Specified by:

getFile in interface BitbucketApi

Parameters:

file - an instance of SCM file

Returns:

a SCMFile file with updated the metadata

Throws:

IOException - if there was a network communications error.

getCommits

@NonNull
public List<BitbucketCloudCommit> getCommits(@CheckForNull
 String fromCommit,
 @NonNull
 String toCommit)
                                      throws IOException

Description copied from interface: BitbucketApi

Return a set of base informations between the two given commits.

Specified by:

getCommits in interface BitbucketApi

Parameters:

fromCommit - the commit or reference containing the changes we wish to preview or null to get changes since the beginning.

toCommit - the commit or reference representing the state to which we want to compare the first commit

Returns:

the list of commit between first commit and second source commit.

Throws:

IOException - if there was a network communications error.