jetbrains.buildServer.vcs

Interface SVcsRootUpdate

All Known Subinterfaces:

SVcsRoot

public interface SVcsRootUpdate

Created 22.08.13 17:18

Author:

Eugene Petrenko (eugene.petrenko@jetbrains.com)

Method Summary

Modifier and Type	Method and Description
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	remove() Removes this VCS root from it's project.
void	restoreDefaultModificationCheckInterval() Switched to 'use default modification check interval' mode.
void	setExternalId(ConfigAction cause, java.lang.String externalId) Changes external id of this VCS root and persists this VCS root configuration to disk
void	setExternalId(java.lang.String externalId) Changes external id of this VCS root and persists this VCS root configuration to disk
void	setModificationCheckInterval(int value) Changes modification check interval for the root.
void	setName(java.lang.String newName) Sets new name to this VCS root.
void	setProperties(java.util.Map<java.lang.String,java.lang.String> props) Sets new properties to this VCS root.
void	setVcsName(java.lang.String vcsName) Sets name of version control to this VCS root.

Method Detail

setModificationCheckInterval

void setModificationCheckInterval(int value)

Changes modification check interval for the root.

Parameters:

value - seconds.

restoreDefaultModificationCheckInterval

void restoreDefaultModificationCheckInterval()

Switched to 'use default modification check interval' mode.

setVcsName

void setVcsName(@NotNull
                java.lang.String vcsName)

Sets name of version control to this VCS root.

Parameters:

vcsName - name of version control

Since:

8.0

setName

void setName(@NotNull
             java.lang.String newName)
      throws DuplicateVcsRootNameException,
             InvalidNameException

Sets new name to this VCS root.

Parameters:

newName - new VCS root name

Throws:

DuplicateVcsRootNameException - if VCS root with such name already exists in VCS root project

InvalidNameException

Since:

8.0

setExternalId

void setExternalId(@NotNull
                   java.lang.String externalId)
            throws DuplicateExternalIdException,
                   InvalidIdentifierException,
                   ObsoleteEntityException

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

Parameters:

externalId - new external id

Throws:

DuplicateExternalIdException - if newly specified external id already exists

ObsoleteEntityException - when VCS root is not the same as the one in the project model (since 9.1.2)

InvalidIdentifierException

Since:

8.0

setExternalId

void setExternalId(@NotNull
                   ConfigAction cause,
                   @NotNull
                   java.lang.String externalId)
            throws DuplicateExternalIdException,
                   InvalidIdentifierException,
                   ObsoleteEntityException

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

Parameters:

cause - config action caused the change

externalId - new external id

Throws:

DuplicateExternalIdException - if newly specified external id already exists

ObsoleteEntityException - when VCS root is not the same as the one in the project model (since 9.1.2)

InvalidIdentifierException

Since:

9.0

setProperties

void setProperties(@NotNull
                   java.util.Map<java.lang.String,java.lang.String> props)

Sets new properties to this VCS root.

Parameters:

props - new VCS root properties

Since:

8.0

persist

void persist()
      throws ProjectNotFoundException

Persists this VCS root on disk

Throws:

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

Since:

8.0

remove

void remove()
     throws VcsRootUsedException,
            ProjectNotFoundException

Removes this VCS root from it's project.

Throws:

VcsRootUsedException - if VCS root is used in some configuration or template and cannot be removed

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

Since:

8.0

moveToProject

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

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

Parameters:

target - target project

Throws:

ScopeCannotBeChangedException - if move is impossible because of VCS root usages

DuplicateVcsRootNameException

Since:

8.0

moveToProject

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

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

Parameters:

cause - config action caused the change

target - target project

Throws:

ScopeCannotBeChangedException - if move is impossible because of VCS root usages

DuplicateExternalIdException - if newly specified external id already exists

DuplicateVcsRootNameException

Since:

9.0