Package jetbrains.buildServer.vcs.impl

Class DeletedVcsRoot

java.lang.Object

jetbrains.buildServer.vcs.impl.VcsRootImpl

jetbrains.buildServer.vcs.impl.DeletedVcsRoot

All Implemented Interfaces:

Comparable<SVcsRoot>, Loggable, SPersistentEntity, LVcsRoot, SVcsRoot, SVcsRootAccess, SVcsRootEx, SVcsRootUpdate, SVcsRootUsages, VcsRoot

public class DeletedVcsRoot
extends VcsRootImpl
implements SVcsRootEx

Field Summary

Fields inherited from class jetbrains.buildServer.vcs.impl.VcsRootImpl

BRANCH_SPEC_PROP, CHECKOUT_ROOT, UNKNOWN_ROOT_NAME, VCS_NAME_PROP, VCS_ROOT_NAME_PROP

Fields inherited from interface jetbrains.buildServer.vcs.VcsRoot

SECURE_PROPERTY_PREFIX

Constructor Summary

Constructors

Constructor	Description
DeletedVcsRoot(long id, String extId, String name, String vcsName)

Method Summary

Modifier and Type	Method	Description
void	checkAccessibleFrom(SBuildType buildType)	Checks that VCS root can be attached to specified configuration.
void	checkAccessibleFrom(SProject project)	Checks that VCS root can be attached to configurations of specified project.
int	compareTo(SVcsRoot o)
ConfigAction	createConfigAction(SUser user, String description)	Creates a config action instance associated with this entity and having the specified description.
Set<SProject>	getAccessibleProjects()	Returns projects where this VCS root can be attached to a configuration
BranchSpec	getBranchSpec(ValueResolver valueResolver)	Returns branch specification if it is defined in VCS root and can be fully resolved.
String	getConfigId()	Returns the entity's config identifier.
File	getConfigurationFile()	Returns the configuration file where this entity instance is persisted (or will be persisted to).
File	getConfigurationFile(File projectsDir)	Returns the configuration file where this entity is persisted in custom projects directory
String	getDescription()
EntityId<Long>	getEntityId()
String	getExternalId()	Returns the external identifier.
AuditLogAction	getLastConfigModificationAction()
int	getModificationCheckInterval()	returns modification check interval in seconds
int	getNumberOfUsagesInProjects()
SPersistentEntity	getParent()	The parent entity.
ProjectEx	getProject()
ReadOnlyReason	getReadOnlyReason()
VcsRootScope	getScope()	Returns scope of this VCS root
Map<SBuildType,CheckoutRules>	getUsages()
List<SBuildType>	getUsagesInConfigurations()
Collection<SProject>	getUsagesInProjects()
String	getVcsDisplayName()	Returns VCS plugin display name
PersistentEntityVersion	getVersion()	Returns version of this entity which can be used to check if the entity was edited or persisted.
boolean	isAccessibleFrom(SBuildType buildType)	Returns true if VCS root can be attached to specified configuration.
boolean	isAccessibleFrom(SProject project)	Returns true if VCS root can be attached to configurations of specified project.
boolean	isAliasExternalId(String extId)
boolean	isBranchSpecDefined(ValueResolver valueResolver)	Returns true if after the properties resolution this VCS root has not empty branch specification
boolean	isEmptyUuid()
boolean	isReadOnly()
boolean	isUseDefaultModificationCheckInterval()	Returns if 'use default modification check interval' mode is enabled for the root.
boolean	isUsedInProjects()
void	markPersisted(long expectedEditId)	Marks entity as persisted
void	moveToProject(ConfigAction cause, SProject target)	Moves this VCS root to specified target project.
void	moveToProject(SProject target)	Moves this VCS root to specified target project.
void	persist()	Persists this VCS root on disk
void	persist(ConfigAction cause)	Persists this entity on disk.
void	remove()	Removes this VCS root from it's project.
void	restoreDefaultModificationCheckInterval()	Switched to 'use default modification check interval' mode.
PersistTask	schedulePersisting(String reason)	Schedules background persisting of this entity settings.
PersistTask	schedulePersisting(ConfigAction cause)	Schedules background persisting of this project settings.
PersistTask	scheduleRemove(ConfigAction cause)	Schedules remove of this persistent entity.
void	sendExtIdChangedEvents(ConfigAction cause, String oldExtId, String newExtId)	Sends external id changed event.
void	setExternalId(String externalId)	Changes external id of this VCS root and persists this VCS root configuration to disk
void	setExternalId(ConfigAction cause, String externalId)	Changes external id of this VCS root and persists this VCS root configuration to disk
void	setExternalId(ConfigAction cause, String externalId, boolean sendEvents)	Same as {SVcsRootUpdate.setExternalId(ConfigAction, String)} but provides control over events processing.
void	setModificationCheckInterval(int value)	Changes modification check interval for the root.
void	unregister()	Removes VCS root from project model but does not removes any configuration files from disk

Methods inherited from class jetbrains.buildServer.vcs.impl.VcsRootImpl

addProperty, describe, equals, getId, getName, getProperties, getProperty, getProperty, getVcsName, hashCode, isEquivalentRoots, setName, setProperties, setVcsName, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface jetbrains.buildServer.log.Loggable

describe

Methods inherited from interface jetbrains.buildServer.serverSide.SPersistentEntity

getName, isVirtual

Methods inherited from interface jetbrains.buildServer.vcs.SVcsRootUpdate

setName, setProperties, setVcsName

Methods inherited from interface jetbrains.buildServer.vcs.VcsRoot

getId, getName, getProperties, getProperty, getProperty, getVcsName

Constructor Detail

DeletedVcsRoot

public DeletedVcsRoot(long id,
                      @NotNull
                      String extId,
                      @NotNull
                      String name,
                      @NotNull
                      String vcsName)

Method Detail

compareTo

public int compareTo(@NotNull
                     SVcsRoot o)

Specified by:

compareTo in interface Comparable<SVcsRoot>

getConfigId

@NotNull
public String getConfigId()

Description copied from interface: SPersistentEntity

Returns the entity's config identifier. Config identifier uniquely identifies the entity across different TeamCity servers and can't be modified in contrast to external identifier.

Specified by:

getConfigId in interface SPersistentEntity

getExternalId

@NotNull
public String getExternalId()

Description copied from interface: SPersistentEntity

Returns the external identifier.

Specified by:

getExternalId in interface SPersistentEntity

Specified by:

getExternalId in interface VcsRoot

Overrides:

getExternalId in class VcsRootImpl

Returns:

externalID for this VCS Root, if it was set.

getScope

@NotNull
public VcsRootScope getScope()

Description copied from interface: SVcsRootUsages

Returns scope of this VCS root

Specified by:

getScope in interface SVcsRootUsages

Returns:

scope of this VCS root

getEntityId

@NotNull
public EntityId<Long> getEntityId()

Specified by:

getEntityId in interface SVcsRootEx

getProject

@NotNull
public ProjectEx getProject()
                     throws ProjectNotFoundException

Specified by:

getProject in interface SVcsRootEx

Specified by:

getProject in interface SVcsRootUsages

Returns:

project this VCS root belongs to

Throws:

ProjectNotFoundException

unregister

public void unregister()

Description copied from interface: SVcsRootEx

Removes VCS root from project model but does not removes any configuration files from disk

Specified by:

unregister in interface SVcsRootEx

getLastConfigModificationAction

@Nullable
public AuditLogAction getLastConfigModificationAction()

Specified by:

getLastConfigModificationAction in interface SVcsRootEx

getBranchSpec

@Nullable
public BranchSpec getBranchSpec(@NotNull
                                ValueResolver valueResolver)

Description copied from interface: SVcsRootEx

Returns branch specification if it is defined in VCS root and can be fully resolved. If branch spec is not defined or cannot be fully resolved returns null.

Specified by:

getBranchSpec in interface SVcsRootEx

Parameters:

valueResolver - value resolver to use

Returns:

see above

isBranchSpecDefined

public boolean isBranchSpecDefined(@NotNull
                                   ValueResolver valueResolver)

Description copied from interface: SVcsRootEx

Returns true if after the properties resolution this VCS root has not empty branch specification

Specified by:

isBranchSpecDefined in interface SVcsRootEx

Returns:

getModificationCheckInterval

public int getModificationCheckInterval()

Description copied from interface: SVcsRoot

returns modification check interval in seconds

Specified by:

getModificationCheckInterval in interface SVcsRoot

Returns:

modification check interval configured for the root.

setModificationCheckInterval

public void setModificationCheckInterval(int value)

Description copied from interface: SVcsRootUpdate

Changes modification check interval for the root.

Specified by:

setModificationCheckInterval in interface SVcsRootUpdate

Parameters:

value - seconds.

isUseDefaultModificationCheckInterval

public boolean isUseDefaultModificationCheckInterval()

Description copied from interface: SVcsRoot

Returns if 'use default modification check interval' mode is enabled for the root.

Specified by:

isUseDefaultModificationCheckInterval in interface SVcsRoot

Returns:

if 'use default modification check interval' mode is enabled for the root.

restoreDefaultModificationCheckInterval

public void restoreDefaultModificationCheckInterval()

Description copied from interface: SVcsRootUpdate

Switched to 'use default modification check interval' mode.

Specified by:

restoreDefaultModificationCheckInterval in interface SVcsRootUpdate

isAccessibleFrom

public boolean isAccessibleFrom(@NotNull
                                SBuildType buildType)

Description copied from interface: SVcsRootAccess

Returns true if VCS root can be attached to specified configuration.

Specified by:

isAccessibleFrom in interface SVcsRootAccess

Parameters:

buildType - build configuration

Returns:

true if VCS roots with this scope are accessible from the specified build configuration.

isAccessibleFrom

public boolean isAccessibleFrom(@NotNull
                                SProject project)

Description copied from interface: SVcsRootAccess

Returns true if VCS root can be attached to configurations of specified project.

Specified by:

isAccessibleFrom in interface SVcsRootAccess

Parameters:

project - project

Returns:

true if VCS roots with this scope are accessible from the specified project

getAccessibleProjects

@NotNull
public Set<SProject> getAccessibleProjects()

Description copied from interface: SVcsRootAccess

Returns projects where this VCS root can be attached to a configuration

Specified by:

getAccessibleProjects in interface SVcsRootAccess

Returns:

see above

checkAccessibleFrom

public void checkAccessibleFrom(@NotNull
                                SBuildType buildType)
                         throws InvalidVcsRootScopeException

Description copied from interface: SVcsRootAccess

Checks that VCS root can be attached to specified configuration.

Specified by:

checkAccessibleFrom in interface SVcsRootAccess

Parameters:

buildType - build configuration

Throws:

InvalidVcsRootScopeException - if VCS root is inaccessible

checkAccessibleFrom

public void checkAccessibleFrom(@NotNull
                                SProject project)
                         throws InvalidVcsRootScopeException

Description copied from interface: SVcsRootAccess

Checks that VCS root can be attached to configurations of specified project.

Specified by:

checkAccessibleFrom in interface SVcsRootAccess

Parameters:

project - project

Throws:

InvalidVcsRootScopeException - if VCS root is not accessible

getDescription

@NotNull
public String getDescription()

Specified by:

getDescription in interface LVcsRoot

Returns:

short human readable description of the root. Composed by underlying VCS support.

getVcsDisplayName

@NotNull
public String getVcsDisplayName()

Description copied from interface: LVcsRoot

Returns VCS plugin display name

Specified by:

getVcsDisplayName in interface LVcsRoot

Returns:

see above, returns null if VCS plugin corresponding to VCS root does not exist

getUsages

@NotNull
public Map<SBuildType,CheckoutRules> getUsages()

Specified by:

getUsages in interface SVcsRootUsages

Returns:

This method returns all usages of this VCS root in various build configurations + its checkout rules

getUsagesInConfigurations

@NotNull
public List<SBuildType> getUsagesInConfigurations()

Specified by:

getUsagesInConfigurations in interface SVcsRootUsages

Returns:

All configurations where this VCS Root is used (excluding VCS settings usages). Works faster than SVcsRootUsages.getUsages()

getNumberOfUsagesInProjects

public int getNumberOfUsagesInProjects()

Specified by:

getNumberOfUsagesInProjects in interface SVcsRootUsages

Returns:

number of projects using this VCS root in their templates or configurations.

isUsedInProjects

public boolean isUsedInProjects()

Specified by:

isUsedInProjects in interface SVcsRootUsages

Returns:

true if SVcsRootUsages.getNumberOfUsagesInProjects() is positive, but works faster because it does not count all of the usages

getUsagesInProjects

@NotNull
public Collection<SProject> getUsagesInProjects()

Specified by:

getUsagesInProjects in interface SVcsRootUsages

Returns:

projects using this VCS root in their templates or configurations.

setExternalId

public void setExternalId(@NotNull
                          String externalId)
                   throws DuplicateExternalIdException

Description copied from interface: SVcsRootUpdate

Changes external id of this VCS root and persists this VCS root configuration to disk

Specified by:

setExternalId in interface SVcsRootUpdate

Overrides:

setExternalId in class VcsRootImpl

Parameters:

externalId - External ID for this VCS Root

Throws:

DuplicateExternalIdException - if newly specified external id already exists

setExternalId

public void setExternalId(@NotNull
                          ConfigAction cause,
                          @NotNull
                          String externalId)
                   throws DuplicateExternalIdException,
                          InvalidIdentifierException

Description copied from interface: SVcsRootUpdate

Changes external id of this VCS root and persists this VCS root configuration to disk

Specified by:

setExternalId in interface SVcsRootUpdate

Parameters:

cause - config action caused the change

externalId - new external id

Throws:

DuplicateExternalIdException - if newly specified external id already exists

InvalidIdentifierException

persist

public void persist()
             throws ProjectNotFoundException

Description copied from interface: SVcsRootUpdate

Persists this VCS root on disk

Specified by:

persist in interface SPersistentEntity

Specified by:

persist in interface SVcsRootUpdate

Throws:

ProjectNotFoundException - if project where this VCS root belongs does not exist

persist

public void persist(@NotNull
                    ConfigAction cause)
             throws PersistFailedException

Description copied from interface: SPersistentEntity

Persists this entity on disk.

Specified by:

persist in interface SPersistentEntity

Parameters:

cause - an action which caused persisting

Throws:

PersistFailedException - if persisting failed

schedulePersisting

@NotNull
public PersistTask schedulePersisting(@NotNull
                                      ConfigAction cause)
                               throws PersistFailedException

Description copied from interface: SPersistentEntity

Schedules background persisting of this project settings.

Specified by:

schedulePersisting in interface SPersistentEntity

Parameters:

cause - an action which caused persisting

Returns:

a task which can be used to track the operation progress or wait for the operation to complete

Throws:

PersistFailedException - if failed to schedule the operation

See Also:

SPersistentEntity.schedulePersisting(String)

schedulePersisting

@NotNull
public PersistTask schedulePersisting(@NotNull
                                      String reason)
                               throws PersistFailedException

Description copied from interface: SPersistentEntity

Schedules background persisting of this entity settings.

Specified by:

schedulePersisting in interface SPersistentEntity

Parameters:

reason - provides a reason why persist operation was called

Returns:

a task which can be used to track the operation progress or wait for the operation to complete

Throws:

PersistFailedException - if failed to schedule the operation

See Also:

SPersistentEntity.schedulePersisting(ConfigAction)

scheduleRemove

@NotNull
public PersistTask scheduleRemove(@NotNull
                                  ConfigAction cause)
                           throws PersistFailedException

Description copied from interface: SPersistentEntity

Schedules remove of this persistent entity. Returns task which can be used to wait for the operation to complete.

Specified by:

scheduleRemove in interface SPersistentEntity

Parameters:

cause - reason of the remove

Returns:

a task which can be used to track the operation progress or wait for the operation to complete

Throws:

PersistFailedException - if failed to schedule the operation

remove

public void remove()

Description copied from interface: SVcsRootUpdate

Removes this VCS root from it's project.

Specified by:

remove in interface SPersistentEntity

Specified by:

remove in interface SVcsRootUpdate

moveToProject

public void moveToProject(@NotNull
                          SProject target)
                   throws ScopeCannotBeChangedException

Description copied from interface: SVcsRootUpdate

Moves this VCS root to specified target project. Upon successful completion affected configuration settings will be persisted.

Specified by:

moveToProject in interface SVcsRootUpdate

Parameters:

target - target project

Throws:

ScopeCannotBeChangedException - if move is impossible because of VCS root usages

moveToProject

public void moveToProject(@NotNull
                          ConfigAction cause,
                          @NotNull
                          SProject target)
                   throws ScopeCannotBeChangedException,
                          DuplicateVcsRootNameException

Description copied from interface: SVcsRootUpdate

Moves this VCS root to specified target project. Upon successful completion affected configuration settings will be persisted.

Specified by:

moveToProject in interface SVcsRootUpdate

Parameters:

cause - config action caused the change

target - target project

Throws:

ScopeCannotBeChangedException - if move is impossible because of VCS root usages

DuplicateVcsRootNameException

getConfigurationFile

@NotNull
public File getConfigurationFile()

Description copied from interface: SPersistentEntity

Returns the configuration file where this entity instance is persisted (or will be persisted to).

Specified by:

getConfigurationFile in interface SPersistentEntity

Returns:

see above.

getConfigurationFile

@NotNull
public File getConfigurationFile(@NotNull
                                 File projectsDir)

Description copied from interface: SPersistentEntity

Returns the configuration file where this entity is persisted in custom projects directory

Specified by:

getConfigurationFile in interface SPersistentEntity

Parameters:

projectsDir - path to teamcity projects directory

Returns:

see above

getParent

@Nullable
public SPersistentEntity getParent()

Description copied from interface: SPersistentEntity

The parent entity.

Specified by:

getParent in interface SPersistentEntity

Returns:

see above.

getVersion

@NotNull
public PersistentEntityVersion getVersion()

Description copied from interface: SPersistentEntity

Returns version of this entity which can be used to check if the entity was edited or persisted.

Specified by:

getVersion in interface SPersistentEntity

Returns:

see above

markPersisted

public void markPersisted(long expectedEditId)

Description copied from interface: SPersistentEntity

Marks entity as persisted

Specified by:

markPersisted in interface SPersistentEntity

Parameters:

expectedEditId - expected editId in the end of persist. The entity will be marked as unedited if expected editId is the same as actual, ie. the entity wasn't edited while persist was running

createConfigAction

@NotNull
public ConfigAction createConfigAction(@Nullable
                                       SUser user,
                                       @NotNull
                                       String description)

Description copied from interface: SPersistentEntity

Creates a config action instance associated with this entity and having the specified description. The config action object can be used in SPersistentEntity.schedulePersisting(ConfigAction) or SPersistentEntity.scheduleRemove(ConfigAction) methods to describe the performed action.

Specified by:

createConfigAction in interface SPersistentEntity

Parameters:

user - user who performs operation, or null if operation is performed by the system

description - description to set to the config action object

Returns:

new config action

isReadOnly

public boolean isReadOnly()

Specified by:

isReadOnly in interface SPersistentEntity

Returns:

true if this entity settings are in read only mode

getReadOnlyReason

@Nullable
public ReadOnlyReason getReadOnlyReason()

Specified by:

getReadOnlyReason in interface SPersistentEntity

Returns:

reason why this entity settings are in read only state or null if they are not read only

isEmptyUuid

public boolean isEmptyUuid()

Specified by:

isEmptyUuid in interface SVcsRootEx

Returns:

true if this root has an empty uuid in its config on disk

isAliasExternalId

public boolean isAliasExternalId(@NotNull
                                 String extId)

Specified by:

isAliasExternalId in interface SVcsRootEx

Returns:

true if the provided external id is an alias for the current external id of this VCS root

setExternalId

public void setExternalId(@NotNull
                          ConfigAction cause,
                          @NotNull
                          String externalId,
                          boolean sendEvents)
                   throws DuplicateExternalIdException,
                          InvalidIdentifierException,
                          ObsoleteEntityException,
                          ReadOnlyEntityException

Description copied from interface: SVcsRootEx

Same as {SVcsRootUpdate.setExternalId(ConfigAction, String)} but provides control over events processing. If parameter sendEvents is false, then no events about changing of the external id will be sent. This mode can be useful if the events will be sent later, for instance, in case of bulk edit ids operation.

Specified by:

setExternalId in interface SVcsRootEx

Throws:

DuplicateExternalIdException

InvalidIdentifierException

ObsoleteEntityException

ReadOnlyEntityException

sendExtIdChangedEvents

public void sendExtIdChangedEvents(@NotNull
                                   ConfigAction cause,
                                   @NotNull
                                   String oldExtId,
                                   @NotNull
                                   String newExtId)

Description copied from interface: SVcsRootEx

Sends external id changed event.

Specified by:

sendExtIdChangedEvents in interface SVcsRootEx