Package com.cloudbees.jenkins.plugins.bitbucket

Class BitbucketSCMSource

java.lang.Object

hudson.model.AbstractDescribableImpl<jenkins.scm.api.SCMSource>

jenkins.scm.api.SCMSource

com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSource

All Implemented Interfaces:

ExtensionPoint, Describable<jenkins.scm.api.SCMSource>

public class BitbucketSCMSource
extends jenkins.scm.api.SCMSource

SCM source implementation for Bitbucket. It provides a way to discover/retrieve branches and pull requests through the Bitbucket REST API which is much faster than the plain Git SCM source implementation.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BitbucketSCMSource.DescriptorImpl

Nested classes/interfaces inherited from class jenkins.scm.api.SCMSource

jenkins.scm.api.SCMSource.SourceByItem

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class jenkins.scm.api.SCMSource

PRONOUN

Constructor Summary

Constructors

Constructor	Description
BitbucketSCMSource(String repoOwner, String repository)	Constructor.
BitbucketSCMSource(String id, String repoOwner, String repository)	Deprecated. use BitbucketSCMSource(String, String) and SCMSource.setId(String)

Method Summary

Modifier and Type	Method	Description
void	afterSave()
SCM	build(jenkins.scm.api.SCMHead head, jenkins.scm.api.SCMRevision revision)
BitbucketApi	buildBitbucketClient()
BitbucketApi	buildBitbucketClient(PullRequestSCMHead head)
BitbucketApi	buildBitbucketClient(String repoOwner, String repository)
String	getCredentialsId()
BitbucketSCMSource.DescriptorImpl	getDescriptor()
String	getEndpointJenkinsRootURL()	Deprecated, for removal: This API element is subject to removal in a future version.
static int	getEventDelaySeconds()	Returns how long to delay events received from Bitbucket in order to allow the API caches to sync.
String	getMirrorId()
protected String	getProjectKey()
String	getRepoOwner()
String	getRepository()
String	getServerUrl()
List<jenkins.scm.api.trait.SCMSourceTrait>	getTraits()
jenkins.scm.api.SCMRevision	getTrustedRevision(jenkins.scm.api.SCMRevision revision, TaskListener listener)
boolean	isCloud()	Deprecated, for removal: This API element is subject to removal in a future version.
jenkins.scm.api.SCMHeadOrigin	originOf(String repoOwner, String repository)
protected jenkins.scm.api.SCMRevision	retrieve(jenkins.scm.api.SCMHead head, TaskListener listener)
protected void	retrieve(jenkins.scm.api.SCMSourceCriteria criteria, jenkins.scm.api.SCMHeadObserver observer, jenkins.scm.api.SCMHeadEvent<?> event, TaskListener listener)
protected List<Action>	retrieveActions(jenkins.scm.api.SCMHead head, jenkins.scm.api.SCMHeadEvent event, TaskListener listener)
protected List<Action>	retrieveActions(jenkins.scm.api.SCMSourceEvent event, TaskListener listener)
void	setCredentialsId(String credentialsId)
static void	setEventDelaySeconds(int eventDelaySeconds)	Sets how long to delay events received from Bitbucket in order to allow the API caches to sync.
void	setMirrorId(String mirrorId)
void	setServerUrl(String serverUrl)
void	setTraits(List<jenkins.scm.api.trait.SCMSourceTrait> traits)

Methods inherited from class jenkins.scm.api.SCMSource

build, canProbe, checkInterrupt, createProbe, defaultListener, equals, fetch, fetch, fetch, fetch, fetch, fetch, fetch, fetch, fetchActions, fetchActions, fetchActions, fetchRevisions, fetchRevisions, fromSCMFileSystem, getCategories, getCriteria, getId, getOwner, getPronoun, hashCode, hasId, isCategoryEnabled, newProbe, parentHeads, parentRevisions, retrieve, retrieve, retrieve, retrieve, retrieve, retrieve, retrieveActions, retrieveRevisions, retrieveRevisions, setId, setOwner, toString, withId

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

BitbucketSCMSource

@DataBoundConstructor
public BitbucketSCMSource(@NonNull
 String repoOwner,
 @NonNull
 String repository)

Constructor.

Parameters:

repoOwner - the repository owner.

repository - the repository name.

Since:

2.2.0

BitbucketSCMSource

@Deprecated
public BitbucketSCMSource(@CheckForNull
 String id,
 @NonNull
 String repoOwner,
 @NonNull
 String repository)

Deprecated.

use BitbucketSCMSource(String, String) and SCMSource.setId(String)

Legacy Constructor.

Parameters:

id - the id.

repoOwner - the repository owner.

repository - the repository name.

Method Details

getCredentialsId

@CheckForNull
public String getCredentialsId()

setCredentialsId

@DataBoundSetter
public void setCredentialsId(@CheckForNull
 String credentialsId)

getMirrorId

public String getMirrorId()

setMirrorId

@DataBoundSetter
public void setMirrorId(String mirrorId)

getRepoOwner

@NonNull
public String getRepoOwner()

getRepository

@NonNull
public String getRepository()

getServerUrl

@NonNull
public String getServerUrl()

setServerUrl

@DataBoundSetter
public void setServerUrl(@CheckForNull
 String serverUrl)

getEndpointJenkinsRootURL

@Restricted(org.kohsuke.accmod.restrictions.NoExternalUse.class)
@Deprecated(forRemoval=true)
@NonNull
public String getEndpointJenkinsRootURL()

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

getTraits

@NonNull
public List<jenkins.scm.api.trait.SCMSourceTrait> getTraits()

Overrides:

getTraits in class jenkins.scm.api.SCMSource

setTraits

@DataBoundSetter
public void setTraits(@CheckForNull
 List<jenkins.scm.api.trait.SCMSourceTrait> traits)

Overrides:

setTraits in class jenkins.scm.api.SCMSource

buildBitbucketClient

public BitbucketApi buildBitbucketClient()

buildBitbucketClient

public BitbucketApi buildBitbucketClient(PullRequestSCMHead head)

buildBitbucketClient

public BitbucketApi buildBitbucketClient(String repoOwner,
 String repository)

afterSave

public void afterSave()

Overrides:

afterSave in class jenkins.scm.api.SCMSource

retrieve

protected void retrieve(@CheckForNull
 jenkins.scm.api.SCMSourceCriteria criteria,
 @NonNull
 jenkins.scm.api.SCMHeadObserver observer,
 @CheckForNull
 jenkins.scm.api.SCMHeadEvent<?> event,
 @NonNull
 TaskListener listener)
                 throws IOException,
InterruptedException

Specified by:

retrieve in class jenkins.scm.api.SCMSource

Throws:

IOException

InterruptedException

retrieve

protected jenkins.scm.api.SCMRevision retrieve(jenkins.scm.api.SCMHead head,
 TaskListener listener)
                                        throws IOException,
InterruptedException

Overrides:

retrieve in class jenkins.scm.api.SCMSource

Throws:

IOException

InterruptedException

build

public SCM build(@NonNull
 jenkins.scm.api.SCMHead head,
 @CheckForNull
 jenkins.scm.api.SCMRevision revision)

Specified by:

build in class jenkins.scm.api.SCMSource

getProjectKey

@CheckForNull
@Restricted(org.kohsuke.accmod.restrictions.ProtectedExternally.class)
protected String getProjectKey()

getTrustedRevision

@NonNull
public jenkins.scm.api.SCMRevision getTrustedRevision(@NonNull
 jenkins.scm.api.SCMRevision revision,
 @NonNull
 TaskListener listener)
                                               throws IOException,
InterruptedException

Overrides:

getTrustedRevision in class jenkins.scm.api.SCMSource

Throws:

IOException

InterruptedException

getDescriptor

public BitbucketSCMSource.DescriptorImpl getDescriptor()

Specified by:

getDescriptor in interface Describable<jenkins.scm.api.SCMSource>

Overrides:

getDescriptor in class jenkins.scm.api.SCMSource

retrieveActions

@NonNull
protected List<Action> retrieveActions(@CheckForNull
 jenkins.scm.api.SCMSourceEvent event,
 @NonNull
 TaskListener listener)
                                throws IOException,
InterruptedException

Overrides:

retrieveActions in class jenkins.scm.api.SCMSource

Throws:

IOException

InterruptedException

retrieveActions

@NonNull
protected List<Action> retrieveActions(@NonNull
 jenkins.scm.api.SCMHead head,
 @CheckForNull
 jenkins.scm.api.SCMHeadEvent event,
 @NonNull
 TaskListener listener)
                                throws IOException,
InterruptedException

Overrides:

retrieveActions in class jenkins.scm.api.SCMSource

Throws:

IOException

InterruptedException

originOf

@NonNull
public jenkins.scm.api.SCMHeadOrigin originOf(@NonNull
 String repoOwner,
 @NonNull
 String repository)

getEventDelaySeconds

public static int getEventDelaySeconds()

Returns how long to delay events received from Bitbucket in order to allow the API caches to sync.

Returns:

how long to delay events received from Bitbucket in order to allow the API caches to sync.

setEventDelaySeconds

@Restricted(org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static void setEventDelaySeconds(int eventDelaySeconds)

Sets how long to delay events received from Bitbucket in order to allow the API caches to sync.

Parameters:

eventDelaySeconds - number of seconds to delay, will be restricted into a value within the range [0,300] inclusive

isCloud

@Deprecated(since="936.0.0",
            forRemoval=true)
public boolean isCloud()

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