Package jetbrains.buildServer.serverSide.impl.auth

Class SecuredVcsModificationHistory

java.lang.Object

jetbrains.buildServer.serverSide.impl.auth.SecuredVcsModificationHistory

All Implemented Interfaces:

ModificationFilesLoader, VcsModificationHistory, VcsModificationHistoryEx

public class SecuredVcsModificationHistory
extends Object
implements VcsModificationHistoryEx, ModificationFilesLoader

Author:

Pavel.Sher Date: 20.11.2007

Nested Class Summary

Nested classes/interfaces inherited from interface jetbrains.buildServer.vcs.VcsModificationHistoryEx

VcsModificationHistoryEx.ModificationDataPersistingCallback, VcsModificationHistoryEx.ModificationDataRelations, VcsModificationHistoryEx.ModificationDataRelationsSupplier

Constructor Summary

Constructors

Constructor	Description
SecuredVcsModificationHistory(SecurityContextEx securityContext)

Method Summary

Modifier and Type	Method	Description
void	detachPendingChangesFromBuildType(SBuildType buildType, SVcsRoot parentRoot)
List<SFinishedBuild>	filterBuildsWithChanges(List<SFinishedBuild> builds)	Filters builds and returns only those builds that have at least one modification.
SVcsModification	findChangeById(long modificationId)	Return modification by its id.
List<SVcsModification>	findExpiredModificationsRelatedToVcsRoot(VcsRootInstance vcsRootInstance, long startModId, int maxChangesToReturn)	This method is similar to VcsModificationHistory.findChangeById(long) but it will search not only among cached changes, but also among changes that are already unloaded from the cache.
SVcsModification	findModificationByVersion(VcsRootInstance root, String version)	Returns last modification with specified version in specified VCS root
Long	findModificationIdByVersion(VcsRootInstance root, String version)
List<SVcsModification>	findModificationsByDisplayVersion(String version)	Searches for all VCS modifications with given display version VcsModification.getDisplayVersion() Ordering: most recent modifications go first in the list
List<SVcsModification>	findModificationsByVersion(String version)	Searches for all VCS modifications with given version VcsModification.getVersion() Ordering: most recent modifications go first in the list
Map<String,SVcsModification>	findModificationsByVersions(VcsRootInstance root, Collection<String> versions)
List<SVcsModification>	getAllModifications()	Returns all VCS modifications.
List<SVcsModification>	getAllModifications(SBuildType buildType)	Returns all stored modifications detected for the specified configuration.
List<SVcsModification>	getAllModifications(VcsRootInstance root)	All configurations detected in the specified vcs root.
List<SVcsModification>	getAllModificationsDetectedSince(Date sinceDate)
List<SVcsModification>	getAllUserModifications(User user)	Returns all VCS modifications of specified user
Map<String,String>	getAttributes(SVcsModification modification)	Load attributes of the given modification from DB.
Set<SUser>	getChangeDescriptorCommitters(Collection<ChangeDescriptor> changes, boolean ignoreNonPersonalCommitters)	Returns committers from the specified collection of change descriptors.
Set<SUser>	getChangesCommitters(Collection<SVcsModification> changes, boolean ignoreNonPersonalCommitters)	Returns committers from the specified collection of changes.
Collection<SVcsModification>	getDuplicates(SVcsModification modification, boolean byDisplayVersion)	Get duplicate modifications for given one, (the given modification is not included)
List<Map<String,RelationType>>	getEdgeRelations(VcsModification childCommit)	Returns list of relations for edges from parent commits to the given child commit.
Map<SVcsModification,List<FilteredVcsChange>>	getFilteredChangedFiles(List<SVcsModification> modifications, BuildPromotion buildPromotion)	Returns filtered files using the checkout rules of the promotion.
List<FilteredVcsChange>	getFilteredChangedFiles(SVcsModification modification, BuildPromotion buildPromotion)
List<FilteredVcsChange>	getFilteredChangedFiles(SVcsModification modification, SBuildType buildType)
List<FilteredVcsChange>	getFilteredChangedFiles(SVcsModification modification, CheckoutRules rules)
List<FilteredVcsChange>	getFilteredChanges(SVcsModification modification, SBuildType buildType, SBuild build)	Returns filtered VCS changes for given VCS modification and build configuration.
List<SVcsModification>	getFixedModificationsCount(SBuildType buildType, Long maxModificationId, int count)	Returns a number of VCS modifications related to the specified build configuration and having modification id <= maxModificationId Ordering: most recent modifications go first in the list resulting list can contain less than required count modifications if the configuration doesn't have the requested amount of modifications
SVcsModification	getLastModification(SBuildType buildType)	Returns last modification detected for the specified build configuration
SVcsModification	getLastModification(LVcsRootInstance vcsRoot)	Return last modification detected in the given VcsRoot
List<SVcsModification>	getLastModifications(int numberOfActiveDays)	Returns latest VCS modifications detected within the specified number of active days.
SVcsModification	getLastModificationUpTo(VcsRootInstance root, Long upperBoundModificationId)	Returns last modification detected in the given VCS root with id less than or equals to the given upper bound
List<SVcsModification>	getLastUserModifications(User user, int numberOfActiveDays)	Returns last stored modification detected for the specified user.
DAG<Long>	getModificationIdDag(VcsRootInstance root)	Returns a DAG of modification ids of specified VCS root instance
DAG<Long>	getModificationIdDag(VcsRootInstance root, Long upperBoundModificationId, Long lowerBoundModificationId)	Returns a DAG of modification ids of specified VCS root instance in specified bounds.
RelatedConfigurations	getModificationRelations(SVcsModification modification)	Returns relations the given modification has to build configurations.
List<SVcsModification>	getModificationsDetectedBetween(SBuildType buildType, Long fromModificationId, Long toModificationId)	Load all modifications related to specified build configuration and having modification id between specified ids (i.e.
List<SVcsModification>	getModificationsInRange(VcsRootInstance root, Long fromId, Long toId)	Returns the list of modifications for the specified root, between specified modification ids.
List<SVcsModification>	getModificationsInVersionsRange(VcsRootInstance root, String lowerBoundVersion, String upperBoundVersion)	Returns the list of modifications for the specified root, between specified versions (lower bound is excluded, upper bound is included).
VcsModificationOrder	getModificationsOrder(VcsRootInstance root, String version1, String version2)	Get the order relationship between modifications with specified versions in given VCS root
List<SVcsModification>	getModificationsSinceLastSuccessful(SBuildType buildType)	Returns modifications related to specified build configuration detected since last successful build, returns empty list if there were no successful build.
Collection<SVcsModification>	getParentModifications(SVcsModification modification)	Get parent modifications of the given one.
List<String>	getParentRevisions(SVcsModification modification)	Get parent revisions of given modification.
List<SVcsModification>	getPendingModifications(SBuildType buildType)	Returns pending modifications for the specified build configuration.
List<VcsChange>	getRawChangedFiles(SVcsModification modification)	Loads raw file changes for the given modification id, without applying mapping or filtering
RepositoryState	getStateWithActiveBranches(VcsRootInstance root, RepositoryState state, long maxBranchAgeMillis)	Returns repository state which contains only active branches, i.e.
Iterator<SVcsModification>	getUniqueModificationsIterator(List<SVcsModification> modifications)	Returns iterator over list of VCS modifications.
int	getUserChangesCounter()	Returns total number of times user accounts were changed/created or removed.
boolean	isVcsCacheInitialized()
void	loadMissingVcsRootModifications(VcsRootInstance rootInstance)	Loads VCS changes which could be persisted by some other node into the internal cache
SVcsModification	persistModification(ModificationData modificationData, Collection<SBuildType> relatedConfigurations)	Persists modification if there is no modification in the same root with the same version.
SVcsModification	persistModification(ModificationData modificationData, Collection<SBuildType> relatedConfigurations, BuildTypeChangeRelationCalculator changeRelationCalculator)
List<SVcsModification>	persistModifications(List<ModificationData> modifications, VcsModificationHistoryEx.ModificationDataRelationsSupplier relationsSupplier, VcsModificationHistoryEx.ModificationDataPersistingCallback callback)
void	processBuildTypeModifications(SBuildType buildType, Predicate<VcsRootInstance> vcsRootInstancesFilter, ItemProcessor<SVcsModification> processor, Interval interval, Date minRegistrationDate, int expiredCommitsMaxNum, RelationType... relationTypes)	Processes VCS modifications related to specified build type within the specified interval.
void	processModifications(ItemProcessor<SVcsModification> modificationsProcessor)	This method traverses all VCS modifications and passed them to the modificationsProcessor.
void	scheduleDetachPendingChangesFromBuildType(SBuildType buildType, SVcsRoot vcsRoot)
void	setModificationDescription(long modificationId, String newDescription)	Set and save modification description for modification with given ID
void	setModificationFilesLoaderDelegate(ModificationFilesLoader delegate)
void	setModificationHistoryDelegate(DBVcsModificationHistory delegate)

Methods inherited from class java.lang.Object

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

Constructor Detail

SecuredVcsModificationHistory

public SecuredVcsModificationHistory(@NotNull
                                     SecurityContextEx securityContext)

Method Detail

setModificationHistoryDelegate

public void setModificationHistoryDelegate(@NotNull
                                           DBVcsModificationHistory delegate)

setModificationFilesLoaderDelegate

public void setModificationFilesLoaderDelegate(@NotNull
                                               ModificationFilesLoader delegate)

persistModification

@Nullable
public SVcsModification persistModification(@NotNull
                                            ModificationData modificationData,
                                            @NotNull
                                            Collection<SBuildType> relatedConfigurations)

Description copied from interface: VcsModificationHistoryEx

Persists modification if there is no modification in the same root with the same version.

Specified by:

persistModification in interface VcsModificationHistoryEx

Parameters:

modificationData - modification to persist

relatedConfigurations - related configuration

Returns:

persisted modification or null if modification with specified version in specified root was already persisted.

setModificationDescription

public void setModificationDescription(long modificationId,
                                       @NotNull
                                       String newDescription)

Description copied from interface: VcsModificationHistoryEx

Set and save modification description for modification with given ID

Specified by:

setModificationDescription in interface VcsModificationHistoryEx

newDescription - non-empty new modification description

persistModification

@Nullable
public SVcsModification persistModification(@NotNull
                                            ModificationData modificationData,
                                            @NotNull
                                            Collection<SBuildType> relatedConfigurations,
                                            @NotNull
                                            BuildTypeChangeRelationCalculator changeRelationCalculator)

Specified by:

persistModification in interface VcsModificationHistoryEx

persistModifications

@NotNull
public List<SVcsModification> persistModifications(@NotNull
                                                   List<ModificationData> modifications,
                                                   @NotNull
                                                   VcsModificationHistoryEx.ModificationDataRelationsSupplier relationsSupplier,
                                                   @NotNull
                                                   VcsModificationHistoryEx.ModificationDataPersistingCallback callback)

Specified by:

persistModifications in interface VcsModificationHistoryEx

getLastUserModifications

public List<SVcsModification> getLastUserModifications(User user,
                                                       int numberOfActiveDays)

Description copied from interface: VcsModificationHistoryEx

Returns last stored modification detected for the specified user. Ordering: last modifications go first in the list

Specified by:

getLastUserModifications in interface VcsModificationHistoryEx

getLastModifications

@NotNull
public List<SVcsModification> getLastModifications(int numberOfActiveDays)

Description copied from interface: VcsModificationHistoryEx

Returns latest VCS modifications detected within the specified number of active days. Ordering: most recent modifications go first in the list

Specified by:

getLastModifications in interface VcsModificationHistoryEx

Returns:

see above

findChangeById

@Nullable
public SVcsModification findChangeById(long modificationId)

Description copied from interface: VcsModificationHistory

Return modification by its id.

Specified by:

findChangeById in interface VcsModificationHistory

Parameters:

modificationId - VCS modification id

Returns:

single modification information

See Also:

SVcsModification

getLastModification

@Nullable
public SVcsModification getLastModification(@NotNull
                                            LVcsRootInstance vcsRoot)

Description copied from interface: VcsModificationHistory

Return last modification detected in the given VcsRoot

Specified by:

getLastModification in interface VcsModificationHistory

Parameters:

vcsRoot - VCS root

Returns:

last modification detected in the given VcsRoot

See Also:

SVcsModification, VcsRoot

getLastModificationUpTo

public SVcsModification getLastModificationUpTo(@NotNull
                                                VcsRootInstance root,
                                                @NotNull
                                                Long upperBoundModificationId)

Description copied from interface: VcsModificationHistory

Returns last modification detected in the given VCS root with id less than or equals to the given upper bound

Specified by:

getLastModificationUpTo in interface VcsModificationHistory

Parameters:

root - VCS root of interest

upperBoundModificationId - upper bound modification id

Returns:

see above

getLastModification

@Nullable
public SVcsModification getLastModification(@NotNull
                                            SBuildType buildType)

Description copied from interface: VcsModificationHistory

Returns last modification detected for the specified build configuration

Specified by:

getLastModification in interface VcsModificationHistory

Parameters:

buildType - build configuration

Returns:

last modification detected

getFilteredChanges

public List<FilteredVcsChange> getFilteredChanges(@NotNull
                                                  SVcsModification modification,
                                                  @NotNull
                                                  SBuildType buildType,
                                                  @Nullable
                                                  SBuild build)

Description copied from interface: VcsModificationHistory

Returns filtered VCS changes for given VCS modification and build configuration. Filtered VCS change is a changed file with information whether it was included or excluded by checkout rules of build configuration. Method should not be called for personal modifications.

Specified by:

getFilteredChanges in interface VcsModificationHistory

Parameters:

modification - VCS modification

buildType - build configuration

build - where this modification occurred or null if there is no such build yet

Returns:

filtered changes

getPendingModifications

public List<SVcsModification> getPendingModifications(@NotNull
                                                      SBuildType buildType)

Description copied from interface: VcsModificationHistory

Returns pending modifications for the specified build configuration. Pending modifications are those that are not included in any build yet.

Specified by:

getPendingModifications in interface VcsModificationHistory

Parameters:

buildType - build configuration

Returns:

see above

getAllModifications

public List<SVcsModification> getAllModifications(@NotNull
                                                  SBuildType buildType)

Description copied from interface: VcsModificationHistory

Returns all stored modifications detected for the specified configuration. Ordering: most recent modifications go first in the list

Specified by:

getAllModifications in interface VcsModificationHistory

Parameters:

buildType - specified build configuration.

Returns:

all stored modifications detected for the specified configuration.

getAllModifications

public List<SVcsModification> getAllModifications(@NotNull
                                                  VcsRootInstance root)

Description copied from interface: VcsModificationHistory

All configurations detected in the specified vcs root. Ordering: most recent modifications go first in the list

Specified by:

getAllModifications in interface VcsModificationHistory

Parameters:

root - specified vcs root.

Returns:

all configurations detected in the specified vcs root.

getModificationsInRange

@NotNull
public List<SVcsModification> getModificationsInRange(@Nullable
                                                      VcsRootInstance root,
                                                      @Nullable
                                                      Long fromId,
                                                      @Nullable
                                                      Long toId)

Description copied from interface: VcsModificationHistory

Returns the list of modifications for the specified root, between specified modification ids. Any of parameters can be null, which means it is not set.

Specified by:

getModificationsInRange in interface VcsModificationHistory

Parameters:

root - the VCS root (if null the result will include modifications from all roots)

fromId - will search for modifications with id > fromId

toId - - will search for modifications with id <= toId

Returns:

the list of detected modifications in the specified range

filterBuildsWithChanges

public List<SFinishedBuild> filterBuildsWithChanges(@NotNull
                                                    List<SFinishedBuild> builds)

Description copied from interface: VcsModificationHistory

Filters builds and returns only those builds that have at least one modification. All builds must correspond to the same project.

Specified by:

filterBuildsWithChanges in interface VcsModificationHistory

Parameters:

builds - builds to filter, must be sorted in reverse order, i.e. most recent build first

Returns:

builds containing at least one modification

getModificationsDetectedBetween

@NotNull
public List<SVcsModification> getModificationsDetectedBetween(@NotNull
                                                              SBuildType buildType,
                                                              Long fromModificationId,
                                                              Long toModificationId)

Description copied from interface: VcsModificationHistory

Load all modifications related to specified build configuration and having modification id between specified ids (i.e. returns modifications detected since modification with id fromModificationId till modification with id toModificationId (inclusive)). Specify null for fromModificationId or toModificationId to open the border. Ordering: most recent modifications go first in the list

Specified by:

getModificationsDetectedBetween in interface VcsModificationHistory

Parameters:

buildType - specified build configuration.

fromModificationId - - will search for modifications with id > fromModificationId

toModificationId - - will search for modifications with id <= toModificationId

Returns:

all modifications between fromModificationId and toModificationId.

getFixedModificationsCount

@NotNull
public List<SVcsModification> getFixedModificationsCount(@NotNull
                                                         SBuildType buildType,
                                                         @Nullable
                                                         Long maxModificationId,
                                                         int count)

Description copied from interface: VcsModificationHistory

Returns a number of VCS modifications related to the specified build configuration and having modification id <= maxModificationId Ordering: most recent modifications go first in the list resulting list can contain less than required count modifications if the configuration doesn't have the requested amount of modifications

Specified by:

getFixedModificationsCount in interface VcsModificationHistory

Parameters:

buildType - - specified build configuration.

maxModificationId - - will search for modifications with id <= maxModificationId

count - - count of modifications to return

Returns:

list of modifications with id <=maxModificationId from newest to oldest and not more than the specified count

getModificationsSinceLastSuccessful

@NotNull
public List<SVcsModification> getModificationsSinceLastSuccessful(@NotNull
                                                                  SBuildType buildType)

Description copied from interface: VcsModificationHistory

Returns modifications related to specified build configuration detected since last successful build, returns empty list if there were no successful build.

Specified by:

getModificationsSinceLastSuccessful in interface VcsModificationHistory

Parameters:

buildType - build configuration

Returns:

see above

getAllModifications

@NotNull
public List<SVcsModification> getAllModifications()

Description copied from interface: VcsModificationHistory

Returns all VCS modifications. Ordering: most recent modifications go first in the list

Specified by:

getAllModifications in interface VcsModificationHistory

Returns:

see above

getAllModificationsDetectedSince

@NotNull
public List<SVcsModification> getAllModificationsDetectedSince(@NotNull
                                                               Date sinceDate)

Specified by:

getAllModificationsDetectedSince in interface VcsModificationHistory

Parameters:

sinceDate - date when modification was detected by the server (not the date when it was made in repository).

Returns:

all modifications detected since specified date.

getModificationRelations

@NotNull
public RelatedConfigurations getModificationRelations(@NotNull
                                                      SVcsModification modification)

Description copied from interface: VcsModificationHistoryEx

Returns relations the given modification has to build configurations.

Specified by:

getModificationRelations in interface VcsModificationHistoryEx

Parameters:

modification - modification of interest

Returns:

see above

getEdgeRelations

@NotNull
public List<Map<String,RelationType>> getEdgeRelations(@NotNull
                                                             VcsModification childCommit)

Description copied from interface: VcsModificationHistoryEx

Returns list of relations for edges from parent commits to the given child commit. Index in the list is the number of the parent commit.

Specified by:

getEdgeRelations in interface VcsModificationHistoryEx

scheduleDetachPendingChangesFromBuildType

public void scheduleDetachPendingChangesFromBuildType(@NotNull
                                                      SBuildType buildType,
                                                      @NotNull
                                                      SVcsRoot vcsRoot)

Specified by:

scheduleDetachPendingChangesFromBuildType in interface VcsModificationHistoryEx

detachPendingChangesFromBuildType

public void detachPendingChangesFromBuildType(@NotNull
                                              SBuildType buildType,
                                              @NotNull
                                              SVcsRoot parentRoot)

Specified by:

detachPendingChangesFromBuildType in interface VcsModificationHistoryEx

getChangesCommitters

@NotNull
public Set<SUser> getChangesCommitters(@NotNull
                                       Collection<SVcsModification> changes,
                                       boolean ignoreNonPersonalCommitters)

Description copied from interface: VcsModificationHistoryEx

Returns committers from the specified collection of changes.

Specified by:

getChangesCommitters in interface VcsModificationHistoryEx

Parameters:

changes - changes collection

ignoreNonPersonalCommitters - if true non personal changes committers will not be returned

Returns:

committers

getChangeDescriptorCommitters

@NotNull
public Set<SUser> getChangeDescriptorCommitters(@NotNull
                                                Collection<ChangeDescriptor> changes,
                                                boolean ignoreNonPersonalCommitters)

Description copied from interface: VcsModificationHistoryEx

Returns committers from the specified collection of change descriptors. Change descriptors for non-vcs changes are ignored.

Specified by:

getChangeDescriptorCommitters in interface VcsModificationHistoryEx

Parameters:

changes - change descriptors collection

ignoreNonPersonalCommitters - if true non personal changes committers will not be returned

Returns:

see above

getUserChangesCounter

public int getUserChangesCounter()

Description copied from interface: VcsModificationHistoryEx

Returns total number of times user accounts were changed/created or removed. This counter is used by VcsModification to check whether its committers cache is actual.

Specified by:

getUserChangesCounter in interface VcsModificationHistoryEx

Returns:

see above

getRawChangedFiles

@NotNull
public List<VcsChange> getRawChangedFiles(@NotNull
                                          SVcsModification modification)

Description copied from interface: ModificationFilesLoader

Loads raw file changes for the given modification id, without applying mapping or filtering

Specified by:

getRawChangedFiles in interface ModificationFilesLoader

Parameters:

modification - VCS modification

Returns:

the list of loaded changes

getFilteredChangedFiles

@NotNull
public List<FilteredVcsChange> getFilteredChangedFiles(@NotNull
                                                       SVcsModification modification,
                                                       @NotNull
                                                       SBuildType buildType)

Specified by:

getFilteredChangedFiles in interface ModificationFilesLoader

getFilteredChangedFiles

@NotNull
public List<FilteredVcsChange> getFilteredChangedFiles(@NotNull
                                                       SVcsModification modification,
                                                       @NotNull
                                                       BuildPromotion buildPromotion)

Specified by:

getFilteredChangedFiles in interface ModificationFilesLoader

getFilteredChangedFiles

@NotNull
public List<FilteredVcsChange> getFilteredChangedFiles(@NotNull
                                                       SVcsModification modification,
                                                       @NotNull
                                                       CheckoutRules rules)

Specified by:

getFilteredChangedFiles in interface ModificationFilesLoader

getFilteredChangedFiles

@NotNull
public Map<SVcsModification,List<FilteredVcsChange>> getFilteredChangedFiles(@NotNull
                                                                                   List<SVcsModification> modifications,
                                                                                   @NotNull
                                                                                   BuildPromotion buildPromotion)

Description copied from interface: ModificationFilesLoader

Returns filtered files using the checkout rules of the promotion.

Specified by:

getFilteredChangedFiles in interface ModificationFilesLoader

Parameters:

modifications - modifications whose files to filter

buildPromotion - promotion whose checkout rules to use

Returns:

map from modification to the list of changed files

getDuplicates

@NotNull
public Collection<SVcsModification> getDuplicates(@NotNull
                                                  SVcsModification modification,
                                                  boolean byDisplayVersion)

Description copied from interface: VcsModificationHistoryEx

Get duplicate modifications for given one, (the given modification is not included)

Specified by:

getDuplicates in interface VcsModificationHistoryEx

Parameters:

modification - modification of interest

byDisplayVersion - if true, modifications will be compared not by version but by displayVersion, which would join more modifications but modifications from different branches could be present (in a case of Perforce, at least)

Returns:

collection of duplicate modifications

getParentModifications

@NotNull
public Collection<SVcsModification> getParentModifications(@NotNull
                                                           SVcsModification modification)

Description copied from interface: VcsModificationHistoryEx

Get parent modifications of the given one. Returns an empty collection if VCS does not provide an information about parents or parents could not be found.

Specified by:

getParentModifications in interface VcsModificationHistoryEx

Parameters:

modification - modification of interest

Returns:

see above

getParentRevisions

@NotNull
public List<String> getParentRevisions(@NotNull
                                       SVcsModification modification)

Description copied from interface: VcsModificationHistoryEx

Get parent revisions of given modification. Returns an empty collection if VCS does not provide an information about parents or parents could not be found.

Specified by:

getParentRevisions in interface VcsModificationHistoryEx

Parameters:

modification - modification of interest

Returns:

see above

getAttributes

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

Description copied from interface: VcsModificationHistoryEx

Load attributes of the given modification from DB.

Specified by:

getAttributes in interface VcsModificationHistoryEx

Parameters:

modification - modification of interest

Returns:

see above

getAllUserModifications

@NotNull
public List<SVcsModification> getAllUserModifications(User user)

Description copied from interface: VcsModificationHistoryEx

Returns all VCS modifications of specified user

Specified by:

getAllUserModifications in interface VcsModificationHistoryEx

Parameters:

user - user of interest

Returns:

see above

processModifications

public void processModifications(@NotNull
                                 ItemProcessor<SVcsModification> modificationsProcessor)

Description copied from interface: VcsModificationHistoryEx

This method traverses all VCS modifications and passed them to the modificationsProcessor. Once modificationsProcessor returns false, the traversing stops.

Specified by:

processModifications in interface VcsModificationHistoryEx

Parameters:

modificationsProcessor - SVcsModification items processor

getUniqueModificationsIterator

@NotNull
public Iterator<SVcsModification> getUniqueModificationsIterator(List<SVcsModification> modifications)

Description copied from interface: VcsModificationHistoryEx

Returns iterator over list of VCS modifications. This iterator returns only unique (non-duplicate) modifications from specified collection.

Specified by:

getUniqueModificationsIterator in interface VcsModificationHistoryEx

Parameters:

modifications - list of VCS modifications

Returns:

see above

getModificationsOrder

@NotNull
public VcsModificationOrder getModificationsOrder(@NotNull
                                                  VcsRootInstance root,
                                                  @NotNull
                                                  String version1,
                                                  @NotNull
                                                  String version2)

Description copied from interface: VcsModificationHistory

Get the order relationship between modifications with specified versions in given VCS root

Specified by:

getModificationsOrder in interface VcsModificationHistory

Parameters:

root - VCS root of interest

version1 - version of the first modification

version2 - version of the second modification

Returns:

VcsModificationOrder.BEFORE if modification with version1 happened before modification with version2; VcsModificationOrder.EQUALS if version1 equals version2; VcsModificationOrder.AFTER if modification with version1 happened after modification with version2; VcsModificationOrder.UNKNOWN if the order of modifications cannot be established.

findModificationByVersion

@Nullable
public SVcsModification findModificationByVersion(@NotNull
                                                  VcsRootInstance root,
                                                  @NotNull
                                                  String version)

Description copied from interface: VcsModificationHistoryEx

Returns last modification with specified version in specified VCS root

Specified by:

findModificationByVersion in interface VcsModificationHistoryEx

Parameters:

root - VCS root of interest

version - version of interest

Returns:

see above

findModificationsByVersions

@NotNull
public Map<String,SVcsModification> findModificationsByVersions(@NotNull
                                                                      VcsRootInstance root,
                                                                      @NotNull
                                                                      Collection<String> versions)

Specified by:

findModificationsByVersions in interface VcsModificationHistoryEx

See Also:

VcsModificationHistoryEx.findModificationsByVersions(VcsRootInstance, Collection)

processBuildTypeModifications

public void processBuildTypeModifications(@NotNull
                                          SBuildType buildType,
                                          @NotNull
                                          Predicate<VcsRootInstance> vcsRootInstancesFilter,
                                          @NotNull
                                          ItemProcessor<SVcsModification> processor,
                                          @NotNull
                                          Interval interval,
                                          @Nullable
                                          Date minRegistrationDate,
                                          int expiredCommitsMaxNum,
                                          RelationType... relationTypes)

Description copied from interface: VcsModificationHistoryEx

Processes VCS modifications related to specified build type within the specified interval. Most recent changes come first. Note: this processor traverses not only cached modifications but also expired once, which are already unloaded from the cache

Specified by:

processBuildTypeModifications in interface VcsModificationHistoryEx

vcsRootInstancesFilter - additional filter for VCS root instances, only SVcsModification objects from VCS roots accepted by this filter will be passed to the processor

expiredCommitsMaxNum - max number of the expired commits to process (expired commit is one which exists in our DB but is unloaded from our in-memory cache), set to 0 to disable expired commits lookup

findExpiredModificationsRelatedToVcsRoot

@NotNull
public List<SVcsModification> findExpiredModificationsRelatedToVcsRoot(@NotNull
                                                                       VcsRootInstance vcsRootInstance,
                                                                       long startModId,
                                                                       int maxChangesToReturn)

Description copied from interface: VcsModificationHistoryEx

This method is similar to VcsModificationHistory.findChangeById(long) but it will search not only among cached changes, but also among changes that are already unloaded from the cache.

Specified by:

findExpiredModificationsRelatedToVcsRoot in interface VcsModificationHistoryEx

Returns:

VCS modification with specified id belonging to the specified VCS root instance

loadMissingVcsRootModifications

public void loadMissingVcsRootModifications(@NotNull
                                            VcsRootInstance rootInstance)

Description copied from interface: VcsModificationHistoryEx

Loads VCS changes which could be persisted by some other node into the internal cache

Specified by:

loadMissingVcsRootModifications in interface VcsModificationHistoryEx

Parameters:

rootInstance - root instance whose changes will be loaded

isVcsCacheInitialized

public boolean isVcsCacheInitialized()

Specified by:

isVcsCacheInitialized in interface VcsModificationHistoryEx

Returns:

true if VCS history cache is loaded from the database. Note: if the cache is not initialized, then many methods looking for SVcsModification instances will be hanging.

findModificationIdByVersion

@Nullable
public Long findModificationIdByVersion(@NotNull
                                        VcsRootInstance root,
                                        @Nullable
                                        String version)

Specified by:

findModificationIdByVersion in interface VcsModificationHistoryEx

findModificationsByVersion

@NotNull
public List<SVcsModification> findModificationsByVersion(@NotNull
                                                         String version)

Description copied from interface: VcsModificationHistoryEx

Searches for all VCS modifications with given version VcsModification.getVersion() Ordering: most recent modifications go first in the list

Specified by:

findModificationsByVersion in interface VcsModificationHistoryEx

Parameters:

version - VCS modification version

Returns:

collection of found modifications

findModificationsByDisplayVersion

@NotNull
public List<SVcsModification> findModificationsByDisplayVersion(@NotNull
                                                                String version)

Description copied from interface: VcsModificationHistoryEx

Searches for all VCS modifications with given display version VcsModification.getDisplayVersion() Ordering: most recent modifications go first in the list

Specified by:

findModificationsByDisplayVersion in interface VcsModificationHistoryEx

Parameters:

version - VCS modification display version

Returns:

collection of found modifications

getModificationIdDag

@NotNull
public DAG<Long> getModificationIdDag(@NotNull
                                      VcsRootInstance root)

Description copied from interface: VcsModificationHistoryEx

Returns a DAG of modification ids of specified VCS root instance

Specified by:

getModificationIdDag in interface VcsModificationHistoryEx

Parameters:

root - VCS root instance of interest

Returns:

see above

getModificationIdDag

@NotNull
public DAG<Long> getModificationIdDag(@NotNull
                                      VcsRootInstance root,
                                      @Nullable
                                      Long upperBoundModificationId,
                                      @Nullable
                                      Long lowerBoundModificationId)

Description copied from interface: VcsModificationHistoryEx

Returns a DAG of modification ids of specified VCS root instance in specified bounds. Both bounds can be null, which means open ended range

Specified by:

getModificationIdDag in interface VcsModificationHistoryEx

Parameters:

root - VCS root instance of interest

upperBoundModificationId - upper bound

lowerBoundModificationId - lower bound

Returns:

see above

getModificationsInVersionsRange

@NotNull
public List<SVcsModification> getModificationsInVersionsRange(@NotNull
                                                              VcsRootInstance root,
                                                              @Nullable
                                                              String lowerBoundVersion,
                                                              @Nullable
                                                              String upperBoundVersion)

Description copied from interface: VcsModificationHistoryEx

Returns the list of modifications for the specified root, between specified versions (lower bound is excluded, upper bound is included). Versions can be null, in this case open ended-intervals are used.

Specified by:

getModificationsInVersionsRange in interface VcsModificationHistoryEx

Parameters:

root - the VCS root which modifications will be returned

Returns:

the list of detected modifications in the specified range

See Also:

VcsModificationHistory.getModificationsOrder(VcsRootInstance, String, String), VcsModificationOrder

getStateWithActiveBranches

@NotNull
public RepositoryState getStateWithActiveBranches(@NotNull
                                                  VcsRootInstance root,
                                                  @NotNull
                                                  RepositoryState state,
                                                  long maxBranchAgeMillis)

Description copied from interface: VcsModificationHistoryEx

Returns repository state which contains only active branches, i.e. branches with an age of the last modification smaller than the maxBranchAgeMillis.

Specified by:

getStateWithActiveBranches in interface VcsModificationHistoryEx

Parameters:

root - VCS root of interest

state - repository state to filter

maxBranchAgeMillis - max age of branch in milliseconds

Returns:

see above