Package com.cloudbees.jenkins.plugins.bitbucket.endpoints

Class BitbucketEndpointConfiguration

java.lang.Object

hudson.model.Descriptor<GlobalConfiguration>

jenkins.model.GlobalConfiguration

com.cloudbees.jenkins.plugins.bitbucket.endpoints.BitbucketEndpointConfiguration

All Implemented Interfaces:

ExtensionPoint, Describable<GlobalConfiguration>, Saveable, Loadable, OnMaster

@Extension
public class BitbucketEndpointConfiguration
extends GlobalConfiguration

Represents the global configuration of Bitbucket Cloud and Bitbucket Server endpoints.

Since:

2.2.0

Nested Class Summary

Nested classes/interfaces inherited from class hudson.model.Descriptor

Descriptor.FormException, Descriptor.PropertyType, Descriptor.Self

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class hudson.model.Descriptor

clazz

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

Constructors

Constructor	Description
BitbucketEndpointConfiguration()	Constructor.

Method Summary

Modifier and Type	Method	Description
boolean	addEndpoint(BitbucketEndpoint endpoint)	Adds an endpoint.
boolean	configure(org.kohsuke.stapler.StaplerRequest2 req, net.sf.json.JSONObject json)
static BitbucketEndpointConfiguration	get()	Gets the BitbucketEndpointConfiguration singleton.
BitbucketEndpoint	getDefaultEndpoint()
ListBoxModel	getEndpointItems()	Deprecated. Use BitbucketEndpointProvider.listEndpoints() instead of this.
List<AbstractBitbucketEndpoint>	getEndpoints()	Gets the list of endpoints.
Permission	getRequiredGlobalConfigPagePermission()
boolean	isEndpointSelectable()	Returns true if and only if there is more than one configured endpoint.
static String	normalizeServerUrl(String serverURL)	Deprecated, for removal: This API element is subject to removal in a future version. Do not use at all, endpoint URL are already managed internally
String	readResolveServerUrl(String serverURL)	Called from a readResolve() method only to convert the old bitbucketServerUrl field into the new serverUrl field.
boolean	removeEndpoint(BitbucketEndpoint endpoint)	Removes an endpoint.
boolean	removeEndpoint(String serverURL)	Removes an endpoint.
void	setEndpoints(List<? extends BitbucketEndpoint> endpoints)	Sets the list of endpoints.
void	updateEndpoint(BitbucketEndpoint endpoint)	Updates an existing endpoint (or adds if missing).

Methods inherited from class jenkins.model.GlobalConfiguration

all, configure, getDescriptor, getGlobalConfigPage

Methods inherited from class hudson.model.Descriptor

addHelpFileRedirect, bindJSON, bindJSON, calcAutoCompleteSettings, calcFillSettings, configure, doHelp, doHelp, find, find, findByDescribableClassName, findById, getCategory, getCheckMethod, getCheckUrl, getConfigFile, getConfigPage, getCurrentDescriptorByNameUrl, getDescriptorFullUrl, getDescriptorUrl, getDisplayName, getGlobalPropertyType, getHelpFile, getHelpFile, getHelpFile, getId, getJsonSafeClassName, getKlass, getPlugin, getPossibleViewNames, getPropertyType, getPropertyType, getPropertyTypeOrDie, getStaticHelpUrl, getStaticHelpUrl, getT, getViewPage, isInstance, isSubTypeOf, load, newInstance, newInstance, newInstance, newInstancesFromHeteroList, newInstancesFromHeteroList, newInstancesFromHeteroList, newInstancesFromHeteroList, save, self, toArray, toList, toMap

Methods inherited from class java.lang.Object

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

Constructor Details

BitbucketEndpointConfiguration

public BitbucketEndpointConfiguration()

Constructor.

Method Details

get

public static BitbucketEndpointConfiguration get()

Gets the BitbucketEndpointConfiguration singleton.

Returns:

the BitbucketEndpointConfiguration singleton.

getRequiredGlobalConfigPagePermission

@NonNull
public Permission getRequiredGlobalConfigPagePermission()

Overrides:

getRequiredGlobalConfigPagePermission in class Descriptor<GlobalConfiguration>

readResolveServerUrl

@Restricted(org.kohsuke.accmod.restrictions.NoExternalUse.class)
@NonNull
public String readResolveServerUrl(@CheckForNull
 String serverURL)

Called from a readResolve() method only to convert the old bitbucketServerUrl field into the new serverUrl field. When called from ACL.SYSTEM this will update the configuration with the missing definitions of resolved URLs.

Parameters:

serverURL - the value of the old url field.

Returns:

the value of the new url field.

isEndpointSelectable

public boolean isEndpointSelectable()

Returns true if and only if there is more than one configured endpoint.

Returns:

true if and only if there is more than one configured endpoint.

getEndpointItems

@Deprecated
public ListBoxModel getEndpointItems()

Deprecated.

Use BitbucketEndpointProvider.listEndpoints() instead of this.

Populates a ListBoxModel with the endpoints.

Returns:

A ListBoxModel with all the endpoints

configure

public boolean configure(org.kohsuke.stapler.StaplerRequest2 req,
 net.sf.json.JSONObject json)
                  throws Descriptor.FormException

Overrides:

configure in class GlobalConfiguration

Throws:

Descriptor.FormException

getEndpoints

@NonNull
public List<AbstractBitbucketEndpoint> getEndpoints()

Gets the list of endpoints.

Returns:

the list of endpoints

setEndpoints

public void setEndpoints(@CheckForNull
 List<? extends BitbucketEndpoint> endpoints)

Sets the list of endpoints.

Parameters:

endpoints - the list of endpoints.

addEndpoint

public boolean addEndpoint(@NonNull
 BitbucketEndpoint endpoint)

Adds an endpoint.

Parameters:

endpoint - the endpoint to add.

Returns:

true if the list of endpoints was modified

updateEndpoint

public void updateEndpoint(@NonNull
 BitbucketEndpoint endpoint)

Updates an existing endpoint (or adds if missing).

Parameters:

endpoint - the endpoint to update.

removeEndpoint

public boolean removeEndpoint(@NonNull
 BitbucketEndpoint endpoint)

Removes an endpoint.

Parameters:

endpoint - the endpoint to remove.

Returns:

true if the list of endpoints was modified

removeEndpoint

public boolean removeEndpoint(@CheckForNull
 String serverURL)

Removes an endpoint.

Parameters:

serverURL - the server URL to remove.

Returns:

true if the list of endpoints was modified

getDefaultEndpoint

@NonNull
public BitbucketEndpoint getDefaultEndpoint()

normalizeServerUrl

@CheckForNull
@Deprecated(forRemoval=true)
public static String normalizeServerUrl(@CheckForNull
 String serverURL)

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

Do not use at all, endpoint URL are already managed internally

Fix a serverUrl.

Parameters:

serverURL - the server URL.

Returns:

the normalized server URL.