Package jetbrains.buildServer.status

Class CommittedBuildsHolderImpl

java.lang.Object

jetbrains.buildServer.serverSide.ProjectsModelListenerAdapter

jetbrains.buildServer.serverSide.BuildServerAdapter

jetbrains.buildServer.status.CommittedBuildsHolderImpl

All Implemented Interfaces:

EventListener, BuildServerListener, ProjectsModelListener, ServerListener, CommittedBuildsHolder, UserModelListener

public class CommittedBuildsHolderImpl
extends BuildServerAdapter
implements UserModelListener, CommittedBuildsHolder

For each user who made changes maintains builds where changes appeared. For each build configuration and user there should be only one (or none) finished build and all running builds containing this user changes (including personal builds). Finished personal builds are not stored in the cache.

When server starts the cache is loaded from database.

Constructor Summary

Constructors

Constructor	Description
CommittedBuildsHolderImpl(ProjectManager projectManager, BuildsManager buildsManager, EventDispatcher<BuildServerListener> eventDispatcher, UserModelEx userModel, SecurityContextEx securityContext, UserChangesFilter userChangesFilter)

Method Summary

Modifier and Type	Method	Description
void	agentRegistered(SBuildAgent agent, long currentlyRunningBuildId)	Called when build agent is registered (connected) Some events may be skipped when an agent was registered on another node.
void	buildFinished(SRunningBuild build)	Called after build finishing, only if build was not interrupted
void	buildInterrupted(SRunningBuild build)	Called after build finishing, only if build was interrupted
void	changesLoaded(SRunningBuild build)	Called when changes for a newly started build have been loaded successfully.
void	entriesDeleted(Collection<SFinishedBuild> removedEntries)	Called after deletion of a set of build history entries Only one of BuildServerListener.entryDeleted(SFinishedBuild) or this method should be overriden in a listener.
Collection<SBuild>	getCommittedBuilds(long userId)	Returns builds containing changes of the specified user
boolean	isInitialized()	Returns true if this service is initialized.
void	preLoadCache()
void	setExecutor(ExecutorService executorService)
void	userAccountChanged(User user)	Called if user account settings changed.
void	userAccountCreated(User user)	Called when a new user account is created.
void	userAccountRemoved(long userId)	Called when user account is removed
void	userAccountRemoved(User user)	Called if user account removed
void	userRolesChanged(User user)	Called if user roles changed.

Methods inherited from class jetbrains.buildServer.serverSide.BuildServerAdapter

agentDescriptionUpdated, agentRemoved, agentRemoved, agentsDescriptionUpdated, agentStatusChanged, agentUnregistered, agentUnregistered, beforeAgentUnregistered, beforeBuildFinish, beforeEntryDelete, beforeServerConfigurationLoaded, buildArtifactsChanged, buildChangedStatus, buildCommented, buildDetachedFromAgent, buildPinned, buildProblemsChanged, buildProblemsMuted, buildProblemsUnmuted, buildPromotionTagsChanged, buildQueueOrderChanged, buildRemovedFromQueue, buildStarted, buildTagsChanged, buildTagsChanged, buildTypeAddedToQueue, buildTypeAddedToQueue, buildUnpinned, changeAdded, changesLoaded, cleanupFinished, cleanupStarted, entryCreated, entryDeleted, labelingFailed, labelingSucceed, messageReceived, pluginsLoaded, responsibleChanged, responsibleChanged, responsibleChanged, responsibleChanged, responsibleRemoved, responsibleRemoved, serverConfigurationReloaded, serverShutdown, serverShutdownComplete, serverStartup, sourcesVersionReleased, sourcesVersionReleased, sourcesVersionReleased, statisticValuePublished, testsMuted, testsUnmuted

Methods inherited from class jetbrains.buildServer.serverSide.ProjectsModelListenerAdapter

beforeBuildTypeDeleted, beforeBuildTypesDeleted, buildTypeActiveStatusChanged, buildTypeDeleted, buildTypeDescriptionUpdated, buildTypeExternalIdChanged, buildTypeMoved, buildTypePersisted, buildTypeRegistered, buildTypeRenamed, buildTypeTemplateDeleted, buildTypeTemplateDeleted, buildTypeTemplateExternalIdChanged, buildTypeTemplateMoved, buildTypeTemplatePersisted, buildTypeTemplateRestored, buildTypeUnregistered, projectArchived, projectCreated, projectDearchived, projectDescriptionUpdated, projectExternalIdChanged, projectFeatureAdded, projectFeatureChanged, projectFeatureRemoved, projectMoved, projectPersisted, projectPluginDataFileRemoved, projectPluginDataFileSaved, projectRemoved, projectRemoved, projectRenamed, projectRestored, vcsRootExternalIdChanged, vcsRootMoved, vcsRootPersisted, vcsRootRemoved, vcsRootsPersisted, vcsRootUpdated

Methods inherited from class java.lang.Object

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

Methods inherited from interface jetbrains.buildServer.serverSide.ProjectsModelListener

beforeBuildTypeDeleted, beforeBuildTypesDeleted, buildTypeActiveStatusChanged, buildTypeDeleted, buildTypeDescriptionUpdated, buildTypeExternalIdChanged, buildTypeMoved, buildTypePersisted, buildTypeRegistered, buildTypeRenamed, buildTypeTemplateDeleted, buildTypeTemplateDeleted, buildTypeTemplateExternalIdChanged, buildTypeTemplateMoved, buildTypeTemplatePersisted, buildTypeTemplateRestored, buildTypeUnregistered, projectArchived, projectCreated, projectDearchived, projectDescriptionUpdated, projectExternalIdChanged, projectFeatureAdded, projectFeatureChanged, projectFeatureRemoved, projectMoved, projectPersisted, projectPluginDataFileRemoved, projectPluginDataFileSaved, projectRemoved, projectRemoved, projectRenamed, projectRestored, vcsRootExternalIdChanged, vcsRootMoved, vcsRootPersisted, vcsRootRemoved, vcsRootsPersisted, vcsRootUpdated

Constructor Detail

CommittedBuildsHolderImpl

public CommittedBuildsHolderImpl(@NotNull
                                 ProjectManager projectManager,
                                 @NotNull
                                 BuildsManager buildsManager,
                                 @NotNull
                                 EventDispatcher<BuildServerListener> eventDispatcher,
                                 @NotNull
                                 UserModelEx userModel,
                                 @NotNull
                                 SecurityContextEx securityContext,
                                 @NotNull
                                 UserChangesFilter userChangesFilter)

Method Detail

setExecutor

public void setExecutor(ExecutorService executorService)

getCommittedBuilds

@NotNull
public Collection<SBuild> getCommittedBuilds(long userId)

Description copied from interface: CommittedBuildsHolder

Returns builds containing changes of the specified user

Specified by:

getCommittedBuilds in interface CommittedBuildsHolder

Returns:

isInitialized

public boolean isInitialized()

Description copied from interface: CommittedBuildsHolder

Returns true if this service is initialized. If it is not yet initialized than calls to CommittedBuildsHolder.getCommittedBuilds(long) can block until initialization is complete.

Specified by:

isInitialized in interface CommittedBuildsHolder

Returns:

see above

preLoadCache

public void preLoadCache()

changesLoaded

public void changesLoaded(@NotNull
                          SRunningBuild build)

Description copied from interface: BuildServerListener

Called when changes for a newly started build have been loaded successfully. This event is always sent after the buildStarted. If the build changes were collected while the build was sitting in the queue, then this even will still be sent after the build starts. The method is not called if checking for changes operation failed.

Specified by:

changesLoaded in interface BuildServerListener

Overrides:

changesLoaded in class BuildServerAdapter

Parameters:

build - build, whose changes are loaded

buildFinished

public void buildFinished(@NotNull
                          SRunningBuild build)

Description copied from interface: BuildServerListener

Called after build finishing, only if build was not interrupted

Specified by:

buildFinished in interface BuildServerListener

Overrides:

buildFinished in class BuildServerAdapter

Parameters:

build - running build // TODO: shall pass SFinishedBuild as parameter

entriesDeleted

public void entriesDeleted(@NotNull
                           Collection<SFinishedBuild> removedEntries)

Description copied from interface: BuildServerListener

Called after deletion of a set of build history entries Only one of BuildServerListener.entryDeleted(SFinishedBuild) or this method should be overriden in a listener.

Specified by:

entriesDeleted in interface BuildServerListener

Overrides:

entriesDeleted in class BuildServerAdapter

Parameters:

removedEntries - deleted builds

buildInterrupted

public void buildInterrupted(@NotNull
                             SRunningBuild build)

Description copied from interface: BuildServerListener

Called after build finishing, only if build was interrupted

Specified by:

buildInterrupted in interface BuildServerListener

Overrides:

buildInterrupted in class BuildServerAdapter

Parameters:

build - running build // TODO: shall pass SFinishedBuild as parameter

agentRegistered

public void agentRegistered(@NotNull
                            SBuildAgent agent,
                            long currentlyRunningBuildId)

Description copied from interface: BuildServerListener

Called when build agent is registered (connected)
Some events may be skipped when an agent was registered on another node. For example on read-only node the event is not called for an agent which was registered on the main server for a short period of time (registered and then immediately unregistered).

Specified by:

agentRegistered in interface BuildServerListener

Overrides:

agentRegistered in class BuildServerAdapter

Parameters:

agent - which was registered

currentlyRunningBuildId - id of the build which is running on this build agent, -1 if no build is running on agent

userAccountCreated

public void userAccountCreated(@NotNull
                               User user)

Description copied from interface: UserModelListener

Called when a new user account is created. The event may not be called if the user was created and immediately removed on another node.

Specified by:

userAccountCreated in interface UserModelListener

Parameters:

user - created user

userAccountChanged

public void userAccountChanged(@NotNull
                               User user)

Description copied from interface: UserModelListener

Called if user account settings changed. The event may not be called if the user was removed immediately after being changed on another node.

Specified by:

userAccountChanged in interface UserModelListener

Parameters:

user - updated user

userAccountRemoved

public void userAccountRemoved(@NotNull
                               User user)

Description copied from interface: UserModelListener

Called if user account removed

Specified by:

userAccountRemoved in interface UserModelListener

Parameters:

user - removed user

userAccountRemoved

public void userAccountRemoved(long userId)

Description copied from interface: UserModelListener

Called when user account is removed

Specified by:

userAccountRemoved in interface UserModelListener

Parameters:

userId - id of the removed user

userRolesChanged

public void userRolesChanged(@NotNull
                             User user)

Description copied from interface: UserModelListener

Called if user roles changed. The event may not be called if the user was removed immediately after being changed on another node.

Specified by:

userRolesChanged in interface UserModelListener

Parameters:

user - updated user