Package jetbrains.buildServer.serverSide.impl

Class MockVcsModification

java.lang.Object

jetbrains.buildServer.serverSide.impl.MockVcsModification

All Implemented Interfaces:

Comparable<VcsModification>, ChangeDescriptor, VcsModificationEx, Modification, SVcsModification, VcsModification

Direct Known Subclasses:

MockVcsModificationWithId

public class MockVcsModification
extends Object
implements VcsModificationEx

Field Summary

Fields

Modifier and Type	Field	Description
List<VcsFileModification>	myChanges
Date	myDate
String	myDecription
String	myUser

Constructor Summary

Constructors

Constructor	Description
MockVcsModification(String user, String decription, Date date)
MockVcsModification(String user, String decription, Date date, String version)
MockVcsModification(String user, String decription, Date date, String version, Collection<SBuildType> relatedConfigurations)

Method Summary

Modifier and Type	Method	Description
void	addChange(VcsChange vcsChange)
int	compareTo(VcsModification o)
void	consumeEdgeRelations(BiConsumer<Integer,RelatedConfigurations> consumer)
void	consumeRelations(BiConsumer<String,RelationType> consumer)	Calls the specified consumer, pass it buildType internalId and relation as arguments
void	consumeRelations(BuildTypeIds btIds, BiConsumer<String,RelationType> consumer)	Same as VcsModificationEx.consumeRelations(BiConsumer) but calls the consumer only if a build type id belogs to the ids specified as the first argument BuildTypeIds
static MockVcsModification	createWithOneChangedFile(String user, String description, Date date)
static MockVcsModification	createWithoutFiles(String user, String description, Date date)
void	detachedFromConfigurations(Collection<String> btIds)
VcsFileModification	findChangeByPath(String fileName)	Find file modification corresponding to given fileName, may be null.
Map<String,Object>	getAssociatedData()
Map<String,String>	getAttributes()	Returns modification's attributes or empty map if modification doesn't have any.
Map<SBuildType,RelationType>	getBuildTypeRelations()
int	getChangeCount()	Return number of files changed in this modification
List<VcsFileModification>	getChanges()	Returns list of file modifications related to the change
Date	getCommitDate()	Returns date, when this modification was last updated (e.g.
String	getCommiterName()	Returns user who last updated this modification (e.g.
List<Long>	getCommitterIds()	Returns ids of TeamCity users mapped to this VCS modification by VCS username.
Collection<SUser>	getCommitters()
byte[]	getContentAfter(VcsChangeInfo change)
byte[]	getContentBefore(VcsChangeInfo change)
VcsModificationContext	getContext()
Date	getDate()
String	getDescription()	Returns user comment made for the change
String	getDisplayVersion()
Collection<SVcsModification>	getDuplicates()	Returns duplicates of this VCS modification, (the given modification is not included)
List<FilteredVcsChange>	getFilteredChanges(BuildPromotion buildPromotion)	Returns list of changed files filtered according to checkout rules of the specified build promotion
List<FilteredVcsChange>	getFilteredChanges(SBuild build)	Returns list of changed files filtered according to checkout rules of the specified build
List<FilteredVcsChange>	getFilteredChanges(SBuildType buildType)	Returns list of changed files filtered according to checkout rules of the specified build configuration
List<FilteredVcsChange>	getFilteredChanges(CheckoutRules rules)	Returns list of changed files filtered according to given checkout rules.
Map<SBuildType,SBuild>	getFirstBuilds()	For non-personal builds, returns map of build configuration -> build where this modification was included for the first time.
long	getId()	Unique identifier for the modification
int	getNumberOfRelatedConfigurations()	Returns number of build configurations where this modification appeared.
Collection<SVcsModification>	getParentModifications()	Returns parent modifications of this VCS modification.
Collection<String>	getParentRevisions()	Returns parent revisions for modifications from dag-based VCSes as they were reported by a VCS plugin.
PersonalChangeDescriptor	getPersonalChangeInfo()	For personal changes, returns personal change information details.
SProject	getProject()
Set<String>	getReachableVcsBranches()
Date	getRegistrationDate()	Returns date of this VCS modification registration in the TeamCity server database.
BuildTypeIds	getRelatedBuildTypeIds()
List<String>	getRelatedConfigurationIds(boolean ignoreOverridden)	Returns configurations ids this modification is related to.
Collection<SBuildType>	getRelatedConfigurations()	Returns collection of build configurations where this modification appeared.
Collection<Issue>	getRelatedIssues()	Returns the collection of issues related to this modification (fixed bugs, introduced features, etc).
Collection<SProject>	getRelatedProjects()
SVcsModification	getRelatedVcsChange()
RelationType	getRelation(String buildTypeId)
List<RelationType>	getRelationTypes()
String	getType()
String	getUserName()	Returns name of the user who did this commit (according information from VCS system)
Date	getVcsDate()	Returns when this modification was made
VcsRootInstance	getVcsRoot()	For non-personal modifications returns VCS root where this modification occurred.
String	getVersion()
String	getVersionControlName()	Return version control name as returned by VcsSupportConfig.getDisplayName(); for personal builds "Remote Run" string is returned.
boolean	hasRelation(SBuildType buildType, RelationType relation)	Returns true if the given buildType has relation of the specified type
boolean	isCanBeIgnored()
boolean	isCommitter(User user)	Returns if the specified user is committer for the modification.
boolean	isDuplicateOf(SVcsModification modification)
boolean	isHasRelatedIssues()	Returns whether the modification has related issues (fixed bugs, introduced features, etc).
boolean	isPersonal()	Return true if this modification corresponds to personal change of personal build or pre-tested commit
boolean	isRelatedTo(int parentNum, SBuildType buildType, Predicate<RelationType> relationPredicate)	Returns true if the edge from the parentNum-th parent to this commit has a relation to the specified buildType accepted by the given predicate
boolean	isRelatedTo(String buildTypeId, Predicate<RelationType> relationPredicate)
boolean	isRelatedTo(SBuildType buildType)
boolean	isRelatedTo(SBuildType buildType, boolean ignoreOverridden)
boolean	isRelatedTo(SBuildType buildType, Predicate<RelationType> relationPredicate)	Returns true if this modification has a relation accepted by the specified relation predicate to the given buildType
void	processRelations(BiProcessor<String,RelationType> processor)	Same as VcsModificationEx.consumeRelations(BiConsumer) but allows to stop processing at any point of time.
boolean	relatedConfigurationsLoaded()
boolean	relatedToBuildConfigurationsAccessibleTo(AuthorityHolder authorityHolder)	Returns true if the specified authority holder has read access to at least one build configuration where this VCS modification was detected.
void	resetEdgeRelations()	Resets edge relations of this modification.
void	resetRelatedConfigurations()
void	setCanBeIgnored(boolean canBeIgnored)
void	setDescription(String newDescription)	Set and store new description for the modification in the database.
void	setPesonal(boolean personal)
MockVcsModification	setRoot(VcsRootInstance root)
void	setVersion(String version)

Methods inherited from class java.lang.Object

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

Field Detail

myUser

public String myUser

myDecription

public String myDecription

myDate

public Date myDate

myChanges

public List<VcsFileModification> myChanges

Constructor Detail

MockVcsModification

public MockVcsModification(String user,
                           String decription,
                           Date date)

MockVcsModification

public MockVcsModification(String user,
                           String decription,
                           Date date,
                           String version)

MockVcsModification

public MockVcsModification(String user,
                           String decription,
                           Date date,
                           String version,
                           Collection<SBuildType> relatedConfigurations)

Method Detail

createWithOneChangedFile

public static MockVcsModification createWithOneChangedFile(String user,
                                                           String description,
                                                           Date date)

createWithoutFiles

public static MockVcsModification createWithoutFiles(String user,
                                                     String description,
                                                     Date date)

getUserName

public String getUserName()

Description copied from interface: Modification

Returns name of the user who did this commit (according information from VCS system)

Specified by:

getUserName in interface Modification

Returns:

name of the user who did this commit (according information from VCS system)

getDescription

@NotNull
public String getDescription()

Description copied from interface: Modification

Returns user comment made for the change

Specified by:

getDescription in interface ChangeDescriptor

Specified by:

getDescription in interface Modification

Returns:

user comment made for the change

getVcsDate

@NotNull
public Date getVcsDate()

Description copied from interface: Modification

Returns when this modification was made

Specified by:

getVcsDate in interface Modification

Returns:

when this modification was made

getCommitDate

@NotNull
public Date getCommitDate()

Description copied from interface: SVcsModification

Returns date, when this modification was last updated (e.g. via git rebase) unlike Modification.getVcsDate(), which returns date when the modification was initially authored. Is more or equal to Modification.getVcsDate().

Specified by:

getCommitDate in interface SVcsModification

Returns:

date when this modification was last updated

getCommiterName

@NotNull
public String getCommiterName()

Description copied from interface: VcsModificationEx

Returns user who last updated this modification (e.g. via git rebase, amend, patch apply) unlike Modification.getUserName(), which returns user who initially authored the modification.

Specified by:

getCommiterName in interface VcsModificationEx

Returns:

name of the user who last updated this modification (according to information from VCS system)

getContext

public VcsModificationContext getContext()

Specified by:

getContext in interface VcsModificationEx

getChanges

@NotNull
public List<VcsFileModification> getChanges()

Description copied from interface: VcsModification

Returns list of file modifications related to the change

Specified by:

getChanges in interface VcsModification

Returns:

list of file modifications related to the change

findChangeByPath

public VcsFileModification findChangeByPath(String fileName)

Description copied from interface: VcsModification

Find file modification corresponding to given fileName, may be null. The fileName should exactly match the value from VcsChangeInfo.getFileName()

Specified by:

findChangeByPath in interface VcsModification

Parameters:

fileName - name a file to search for

Returns:

see above

getFirstBuilds

@NotNull
public Map<SBuildType,SBuild> getFirstBuilds()

Description copied from interface: SVcsModification

For non-personal builds, returns map of build configuration -> build where this modification was included for the first time. Cancelled and personal builds are ignored. For personal builds, returns a map from a buildType to the corresponding build which contains this personal change

Specified by:

getFirstBuilds in interface SVcsModification

Returns:

see above

getChangeCount

public int getChangeCount()

Description copied from interface: VcsModification

Return number of files changed in this modification

Specified by:

getChangeCount in interface VcsModification

Returns:

see above

getVcsRoot

@NotNull
public VcsRootInstance getVcsRoot()

Description copied from interface: SVcsModification

For non-personal modifications returns VCS root where this modification occurred. For personal modifications throws UnsupportedOperationException because personal modification can be from several VCS roots simultaneously.

Specified by:

getVcsRoot in interface SVcsModification

Returns:

vcs root instance.

getContentBefore

@NotNull
public byte[] getContentBefore(@NotNull
                               VcsChangeInfo change)
                        throws VcsException

Specified by:

getContentBefore in interface VcsModificationEx

Throws:

VcsException

getContentAfter

@NotNull
public byte[] getContentAfter(@NotNull
                              VcsChangeInfo change)
                       throws VcsException

Specified by:

getContentAfter in interface VcsModificationEx

Throws:

VcsException

getRelatedConfigurationIds

@NotNull
public List<String> getRelatedConfigurationIds(boolean ignoreOverridden)

Description copied from interface: VcsModificationEx

Returns configurations ids this modification is related to.

Specified by:

getRelatedConfigurationIds in interface VcsModificationEx

Parameters:

ignoreOverridden - if true does not return configurations where this modification was attached via overridden root

Returns:

sorted list of build configuration ids

isRelatedTo

public boolean isRelatedTo(@NotNull
                           SBuildType buildType,
                           boolean ignoreOverridden)

Specified by:

isRelatedTo in interface VcsModificationEx

isRelatedTo

public boolean isRelatedTo(@NotNull
                           SBuildType buildType,
                           @NotNull
                           Predicate<RelationType> relationPredicate)

Description copied from interface: VcsModificationEx

Returns true if this modification has a relation accepted by the specified relation predicate to the given buildType

Specified by:

isRelatedTo in interface VcsModificationEx

Parameters:

buildType - buildType of interest

relationPredicate - relation predicate

Returns:

see above

isRelatedTo

public boolean isRelatedTo(@NotNull
                           String buildTypeId,
                           @NotNull
                           Predicate<RelationType> relationPredicate)

Specified by:

isRelatedTo in interface VcsModificationEx

getRelationTypes

@NotNull
public List<RelationType> getRelationTypes()

Specified by:

getRelationTypes in interface VcsModificationEx

Returns:

all types of relations of build configurations associated with this change

isRelatedTo

public boolean isRelatedTo(int parentNum,
                           @NotNull
                           SBuildType buildType,
                           @NotNull
                           Predicate<RelationType> relationPredicate)

Description copied from interface: VcsModificationEx

Returns true if the edge from the parentNum-th parent to this commit has a relation to the specified buildType accepted by the given predicate

Specified by:

isRelatedTo in interface VcsModificationEx

hasRelation

public boolean hasRelation(@NotNull
                           SBuildType buildType,
                           @NotNull
                           RelationType relation)

Description copied from interface: SVcsModification

Returns true if the given buildType has relation of the specified type

Specified by:

hasRelation in interface SVcsModification

Parameters:

buildType - buildType of interest

relation - relation of interest

Returns:

see above

isRelatedTo

public boolean isRelatedTo(@NotNull
                           SBuildType buildType)

Specified by:

isRelatedTo in interface VcsModificationEx

Parameters:

buildType - build configuration

Returns:

true if this modification is attached to specified build configuration.

resetRelatedConfigurations

public void resetRelatedConfigurations()

Specified by:

resetRelatedConfigurations in interface VcsModificationEx

resetEdgeRelations

public void resetEdgeRelations()

Description copied from interface: VcsModificationEx

Resets edge relations of this modification. Next call to VcsModificationEx.isRelatedTo(int, SBuildType, Predicate) will load them from db.

Specified by:

resetEdgeRelations in interface VcsModificationEx

detachedFromConfigurations

public void detachedFromConfigurations(@NotNull
                                       Collection<String> btIds)

Specified by:

detachedFromConfigurations in interface VcsModificationEx

getFilteredChanges

@NotNull
public List<FilteredVcsChange> getFilteredChanges(@NotNull
                                                  CheckoutRules rules)

Description copied from interface: VcsModificationEx

Returns list of changed files filtered according to given checkout rules.

Specified by:

getFilteredChanges in interface VcsModificationEx

Parameters:

rules - checkout rules to filter by.

Returns:

list of filtered changed files.

getReachableVcsBranches

@NotNull
public Set<String> getReachableVcsBranches()

Specified by:

getReachableVcsBranches in interface VcsModificationEx

consumeRelations

public void consumeRelations(@NotNull
                             BiConsumer<String,RelationType> consumer)

Description copied from interface: VcsModificationEx

Calls the specified consumer, pass it buildType internalId and relation as arguments

Specified by:

consumeRelations in interface VcsModificationEx

Parameters:

consumer - consumer to call

consumeRelations

public void consumeRelations(@NotNull
                             BuildTypeIds btIds,
                             @NotNull
                             BiConsumer<String,RelationType> consumer)

Description copied from interface: VcsModificationEx

Same as VcsModificationEx.consumeRelations(BiConsumer) but calls the consumer only if a build type id belogs to the ids specified as the first argument BuildTypeIds

Specified by:

consumeRelations in interface VcsModificationEx

consumer - consumer to call

processRelations

public void processRelations(@NotNull
                             BiProcessor<String,RelationType> processor)

Description copied from interface: VcsModificationEx

Same as VcsModificationEx.consumeRelations(BiConsumer) but allows to stop processing at any point of time.

Specified by:

processRelations in interface VcsModificationEx

getRelation

@Nullable
public RelationType getRelation(@NotNull
                                String buildTypeId)

Specified by:

getRelation in interface VcsModificationEx

consumeEdgeRelations

public void consumeEdgeRelations(@NotNull
                                 BiConsumer<Integer,RelatedConfigurations> consumer)

Specified by:

consumeEdgeRelations in interface VcsModificationEx

relatedConfigurationsLoaded

public boolean relatedConfigurationsLoaded()

Specified by:

relatedConfigurationsLoaded in interface VcsModificationEx

Returns:

true if build configurations related to this change are loaded into the change internal cache

getRelatedBuildTypeIds

public BuildTypeIds getRelatedBuildTypeIds()

Specified by:

getRelatedBuildTypeIds in interface VcsModificationEx

isDuplicateOf

public boolean isDuplicateOf(@NotNull
                             SVcsModification modification)

Specified by:

isDuplicateOf in interface VcsModificationEx

Returns:

true if this modification is a duplicate of another one

getProject

public SProject getProject()

getId

public long getId()

Description copied from interface: VcsModification

Unique identifier for the modification

Specified by:

getId in interface VcsModification

Returns:

unique identifier of the modification

getVersion

@NotNull
public String getVersion()

Specified by:

getVersion in interface VcsModification

getDisplayVersion

public String getDisplayVersion()

Specified by:

getDisplayVersion in interface VcsModification

addChange

public void addChange(VcsChange vcsChange)

isPersonal

public boolean isPersonal()

Description copied from interface: VcsModification

Return true if this modification corresponds to personal change of personal build or pre-tested commit

Specified by:

isPersonal in interface VcsModification

Returns:

true if this modification corresponds to personal change of personal build or pre-tested commit

getCommitterIds

@NotNull
public List<Long> getCommitterIds()

Description copied from interface: SVcsModification

Returns ids of TeamCity users mapped to this VCS modification by VCS username.

Specified by:

getCommitterIds in interface SVcsModification

Returns:

ids of the committers to this change.

getCommitters

@NotNull
public Collection<SUser> getCommitters()

Specified by:

getCommitters in interface SVcsModification

Returns:

collection of TeamCity users mapped to this VCS modification by VCS username.

getRelatedConfigurations

@NotNull
public Collection<SBuildType> getRelatedConfigurations()

Description copied from interface: SVcsModification

Returns collection of build configurations where this modification appeared.

Specified by:

getRelatedConfigurations in interface SVcsModification

Returns:

collection of build configurations

getBuildTypeRelations

@NotNull
public Map<SBuildType,RelationType> getBuildTypeRelations()

Specified by:

getBuildTypeRelations in interface SVcsModification

Returns:

relations this modification has to build configurations

getRelatedProjects

@NotNull
public Collection<SProject> getRelatedProjects()

Specified by:

getRelatedProjects in interface SVcsModification

Returns:

returns collection of projects where this modification appeared.

getNumberOfRelatedConfigurations

public int getNumberOfRelatedConfigurations()

Description copied from interface: SVcsModification

Returns number of build configurations where this modification appeared.

Specified by:

getNumberOfRelatedConfigurations in interface SVcsModification

Returns:

number of build configurations where this modification appeared.

getFilteredChanges

@NotNull
public List<FilteredVcsChange> getFilteredChanges(@NotNull
                                                  SBuildType buildType)

Description copied from interface: SVcsModification

Returns list of changed files filtered according to checkout rules of the specified build configuration

Specified by:

getFilteredChanges in interface SVcsModification

Parameters:

buildType - build configuration

Returns:

list of filtered changed files

getFilteredChanges

@NotNull
public List<FilteredVcsChange> getFilteredChanges(@NotNull
                                                  SBuild build)

Description copied from interface: SVcsModification

Returns list of changed files filtered according to checkout rules of the specified build

Specified by:

getFilteredChanges in interface SVcsModification

Parameters:

build - build

Returns:

list of filtered changed files

getFilteredChanges

@NotNull
public List<FilteredVcsChange> getFilteredChanges(@NotNull
                                                  BuildPromotion buildPromotion)

Description copied from interface: SVcsModification

Returns list of changed files filtered according to checkout rules of the specified build promotion

Specified by:

getFilteredChanges in interface SVcsModification

Parameters:

buildPromotion - build promotion

Returns:

list of filtered changed files

isCommitter

public boolean isCommitter(@NotNull
                           User user)

Description copied from interface: SVcsModification

Returns if the specified user is committer for the modification.

Specified by:

isCommitter in interface SVcsModification

Parameters:

user - specified user.

Returns:

if the specified user is committer for the modification.

getVersionControlName

public String getVersionControlName()

Description copied from interface: VcsModification

Return version control name as returned by VcsSupportConfig.getDisplayName(); for personal builds "Remote Run" string is returned.

Specified by:

getVersionControlName in interface VcsModification

Returns:

version control name

getRelatedIssues

@NotNull
public Collection<Issue> getRelatedIssues()

Description copied from interface: SVcsModification

Returns the collection of issues related to this modification (fixed bugs, introduced features, etc).

Specified by:

getRelatedIssues in interface SVcsModification

Returns:

related issues

See Also:

SVcsModification.isHasRelatedIssues()

isHasRelatedIssues

public boolean isHasRelatedIssues()

Description copied from interface: SVcsModification

Returns whether the modification has related issues (fixed bugs, introduced features, etc).

Specified by:

isHasRelatedIssues in interface SVcsModification

Returns:

true if the modification has related issues

See Also:

SVcsModification.getRelatedIssues()

compareTo

public int compareTo(VcsModification o)

Specified by:

compareTo in interface Comparable<VcsModification>

setRoot

public MockVcsModification setRoot(VcsRootInstance root)

setVersion

public void setVersion(String version)

setPesonal

public void setPesonal(boolean personal)

isCanBeIgnored

public boolean isCanBeIgnored()

setCanBeIgnored

public void setCanBeIgnored(boolean canBeIgnored)

getPersonalChangeInfo

@NotNull
public PersonalChangeDescriptor getPersonalChangeInfo()

Description copied from interface: SVcsModification

For personal changes, returns personal change information details. For non-personal builds, throws exception

Specified by:

getPersonalChangeInfo in interface SVcsModification

Returns:

see above

See Also:

VcsModification.isPersonal()

getRegistrationDate

@NotNull
public Date getRegistrationDate()

Description copied from interface: SVcsModification

Returns date of this VCS modification registration in the TeamCity server database.

Specified by:

getRegistrationDate in interface SVcsModification

Returns:

date of VCS modification registration

getDuplicates

@NotNull
public Collection<SVcsModification> getDuplicates()

Description copied from interface: SVcsModification

Returns duplicates of this VCS modification, (the given modification is not included)

Specified by:

getDuplicates in interface SVcsModification

Returns:

duplicates of this VCS modification

getParentModifications

@NotNull
public Collection<SVcsModification> getParentModifications()

Description copied from interface: SVcsModification

Returns parent modifications of this VCS modification. Returns an empty list if VCS does not provide an information about parents or parents could not be found.

Specified by:

getParentModifications in interface SVcsModification

Returns:

see above

getParentRevisions

@NotNull
public Collection<String> getParentRevisions()

Description copied from interface: SVcsModification

Returns parent revisions for modifications from dag-based VCSes as they were reported by a VCS plugin. For modifications from non-dag-based VCSes returns an empty collection.

Specified by:

getParentRevisions in interface SVcsModification

Returns:

see above

getAttributes

@NotNull
public Map<String,String> getAttributes()

Description copied from interface: SVcsModification

Returns modification's attributes or empty map if modification doesn't have any.

Specified by:

getAttributes in interface SVcsModification

Returns:

see above

getType

@NotNull
public String getType()

Specified by:

getType in interface ChangeDescriptor

getRelatedVcsChange

@Nullable
public SVcsModification getRelatedVcsChange()

Specified by:

getRelatedVcsChange in interface ChangeDescriptor

getDate

@NotNull
public Date getDate()

Specified by:

getDate in interface ChangeDescriptor

setDescription

public void setDescription(@NotNull
                           String newDescription)

Description copied from interface: SVcsModification

Set and store new description for the modification in the database. This action is logged to audit, if current user is set in the authentication context. Empty descriptions are not allowed and ignored.

Specified by:

setDescription in interface SVcsModification

Parameters:

newDescription - new description for the modification

relatedToBuildConfigurationsAccessibleTo

public boolean relatedToBuildConfigurationsAccessibleTo(@NotNull
                                                        AuthorityHolder authorityHolder)

Description copied from interface: SVcsModification

Returns true if the specified authority holder has read access to at least one build configuration where this VCS modification was detected. Method can return false if all build configurations are not accessible to the current authority holder or this VCS modification is not related to any existing build configurations.

Specified by:

relatedToBuildConfigurationsAccessibleTo in interface SVcsModification

getAssociatedData

@NotNull
public Map<String,Object> getAssociatedData()

Specified by:

getAssociatedData in interface ChangeDescriptor