Package jetbrains.buildServer.serverSide
Class BuildServerAdapter
- java.lang.Object
-
- jetbrains.buildServer.serverSide.ProjectsModelListenerAdapter
-
- jetbrains.buildServer.serverSide.BuildServerAdapter
-
- All Implemented Interfaces:
java.util.EventListener
,BuildServerListener
,ProjectsModelListener
,ServerListener
public class BuildServerAdapter extends ProjectsModelListenerAdapter implements BuildServerListener
A helper for writingBuildServerListener
s.
-
-
Constructor Summary
Constructors Constructor Description BuildServerAdapter()
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
agentDescriptionUpdated(SBuildAgent agent)
Called when build agent description update is finished.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
agentRemoved(int agentId)
Called when agent with specified id is removed.void
agentRemoved(SBuildAgent agent)
Called when agent was completely removed from server storage.void
agentsDescriptionUpdated(java.util.Collection<SBuildAgent> agents)
Same asBuildServerListener.agentDescriptionUpdated(SBuildAgent)
but is sent for a number of agents at once.void
agentStatusChanged(SBuildAgent agent, boolean wasEnabled, boolean wasAuthorized)
Called when the status of an agent is changed by a user
Some events may be skipped when an agent is registered on another node.void
agentUnregistered(SBuildAgent agent)
Deprecated.void
agentUnregistered(SBuildAgent agent, java.lang.String reason)
Called after build agent unregistration
Some events may be skipped when an agent was registered on another node.void
beforeAgentUnregistered(SBuildAgent agent)
Called before build agent unregistration
Some events may be skipped when an agent was registered on another node.void
beforeBuildFinish(SRunningBuild runningBuild)
Called right before build finishing, allows to write additional messages to the build log, update build status.void
beforeEntryDelete(SFinishedBuild entry)
Called before deletion of the build history entryvoid
beforeServerConfigurationLoaded()
Called before the server configuration is loaded by the server on startup.void
buildArtifactsChanged(SBuild build)
Called when build artifacts are changed by the server on disk, for example, when cleanup removed some files.void
buildChangedStatus(SRunningBuild build, Status oldStatus, Status newStatus)
Called when build status changes from successful to failedvoid
buildCommented(SBuild build, User user, java.lang.String comment)
Called when user comment the build.void
buildDetachedFromAgent(SRunningBuild build)
Called after build is detached from agent, making the agent available to other buildsvoid
buildFinished(SRunningBuild build)
Called after build finishing, only if build was not interruptedvoid
buildInterrupted(SRunningBuild build)
Called after build finishing, only if build was interruptedvoid
buildPinned(SBuild build, User user, java.lang.String comment)
Called when user pinned the build.void
buildProblemsChanged(SBuild build, java.util.List<BuildProblemData> before, java.util.List<BuildProblemData> after)
Called when list of build problems changes (problems added, removed)
before
parameter may be empty or contain some outdated data when the problems are changed on another node: current node is main server but the problem was added on messages processing node current node is read-only but the problem was added on the main servervoid
buildProblemsMuted(MuteInfo muteInfo)
Called when a set of build problems are muted (with same mute properties).void
buildProblemsUnmuted(SUser user, java.util.Map<MuteInfo,java.util.Collection<BuildProblemInfo>> unmutedGroups)
Called when a set of build problems are unmuted.void
buildPromotionTagsChanged(BuildPromotion buildPromotion, User user, java.util.Collection<TagData> oldTags, java.util.Collection<TagData> newTags)
Called when build promotion tags have been set to specified values
Some parameters may be omitted when the tags were changed on another node (i.e.void
buildQueueOrderChanged()
Called when user reordered build queue order.void
buildRemovedFromQueue(SQueuedBuild queued, User user, java.lang.String comment)
Called when a build is removed from the build queue (started, deleted, optimized, etc.) Some events may be missing when the current node is not responsible for managing build queue.void
buildStarted(SRunningBuild build)
Called when build is about to start.void
buildTagsChanged(SBuild build, java.util.List<java.lang.String> oldTags, java.util.List<java.lang.String> newTags)
Deprecated.void
buildTagsChanged(SBuild build, User user, java.util.List<java.lang.String> oldTags, java.util.List<java.lang.String> newTags)
Deprecated.void
buildTypeAddedToQueue(SBuildType buildType)
Deprecated.void
buildTypeAddedToQueue(SQueuedBuild queuedBuild)
Called when build configuration was added to build queue Some events may be missing when the current node is not responsible for managing build queue.void
buildUnpinned(SBuild build, User user, java.lang.String comment)
Called when user unpinned the build.void
changeAdded(VcsModification modification, VcsRoot root, java.util.Collection<SBuildType> buildTypes)
Called when a new modification (user commit) was detected.void
changesLoaded(BuildPromotion buildPromotion)
This method is called if changes are loaded for a build promotion while it was in the queue or when it was starting.void
changesLoaded(SRunningBuild build)
Called when changes for a newly started build have been loaded successfully.void
cleanupFinished()
Called when database cleanup has been finished.void
cleanupStarted()
Called when database cleanup is going to start.void
entriesDeleted(java.util.Collection<SFinishedBuild> removedEntries)
Called after deletion of a set of build history entries Only one ofBuildServerListener.entryDeleted(SFinishedBuild)
or this method should be overriden in a listener.void
entryCreated(SFinishedBuild build)
Called when build is added to the history.void
entryDeleted(SFinishedBuild entry)
Called after deletion of a build history entry.void
labelingFailed(SBuild build, VcsRoot root, java.lang.Throwable exception)
Labeling process failed for the specified build and root with the specified problem.void
labelingSucceed(SBuild build, BuildRevision revision)
Labeling process succeed for the specified build and revisionvoid
messageReceived(SRunningBuild build, BuildMessage1 message)
Deprecated.void
pluginsLoaded()
Called when all server plugins are loaded, but beforeServerListener.serverStartup()
event.void
responsibleChanged(SBuildType bt, ResponsibilityEntry oldValue, ResponsibilityEntry newValue)
Called when build configuration responsible has changed, or responsibility status has changed
Some events may be omitted when the responsibility was changed on another node, i.e.void
responsibleChanged(SProject project, java.util.Collection<BuildProblemInfo> buildProblems, ResponsibilityEntry entry)
Called when responsibility for several build problems at once is changed.void
responsibleChanged(SProject project, java.util.Collection<TestName> testNames, ResponsibilityEntry entry, boolean isUserAction)
Called when responsibility for several tests at once is changed.void
responsibleChanged(SProject project, TestNameResponsibilityEntry oldValue, TestNameResponsibilityEntry newValue, boolean isUserAction)
Deprecated.void
responsibleRemoved(SProject project, java.util.Collection<BuildProblemInfo> buildProblems, ResponsibilityEntry entry)
Called when responsibility for build problems is removed.void
responsibleRemoved(SProject project, TestNameResponsibilityEntry entry)
Called when responsibility for several tests at once is changed.void
serverConfigurationReloaded()
Called after the server configuration is loaded by the server on startup.void
serverShutdown()
Called when server shutdown has been started.void
serverShutdownComplete()
Event called after server shutdown complete.void
serverStartup()
Called when server has been started and its configuration has been loaded from the diskvoid
sourcesVersionReleased(BuildAgent agent)
Clean sources performed for the given agentvoid
sourcesVersionReleased(BuildType configuration)
Clean sources performed for the given configuration on all agentsvoid
sourcesVersionReleased(BuildType configuration, BuildAgent agent)
Clean sources performed for the given configuration on the given agentvoid
statisticValuePublished(SBuild build, java.lang.String valueTypeKey, java.math.BigDecimal value)
Called upon statistic-value related to the given build have been publishedvoid
testsMuted(MuteInfo muteInfo)
Called when a set of tests are muted (with same mute properties).void
testsUnmuted(SUser user, java.util.Map<MuteInfo,java.util.Collection<STest>> unmutedGroups)
Called when several of tests have been unmuted.-
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
-
-
-
-
Method Detail
-
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 interfaceBuildServerListener
- Parameters:
agent
- which was registeredcurrentlyRunningBuildId
- id of the build which is running on this build agent, -1 if no build is running on agent
-
agentDescriptionUpdated
public void agentDescriptionUpdated(@NotNull SBuildAgent agent)
Description copied from interface:BuildServerListener
Called when build agent description update is finished.
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:
agentDescriptionUpdated
in interfaceBuildServerListener
- Parameters:
agent
- agent with updated agent description
-
agentsDescriptionUpdated
public void agentsDescriptionUpdated(@NotNull java.util.Collection<SBuildAgent> agents)
Description copied from interface:BuildServerListener
Same asBuildServerListener.agentDescriptionUpdated(SBuildAgent)
but is sent for a number of agents at once.- Specified by:
agentsDescriptionUpdated
in interfaceBuildServerListener
- Parameters:
agents
- a collection of agents
-
agentUnregistered
@Deprecated public void agentUnregistered(@NotNull SBuildAgent agent)
Deprecated.Description copied from interface:BuildServerListener
Called after build agent unregistration
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:
agentUnregistered
in interfaceBuildServerListener
- Parameters:
agent
- which was unregistered
-
agentUnregistered
public void agentUnregistered(@NotNull SBuildAgent agent, @NotNull java.lang.String reason)
Description copied from interface:BuildServerListener
Called after build agent unregistration
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:
agentUnregistered
in interfaceBuildServerListener
- Parameters:
agent
- which was unregisteredreason
- why the agent unregistered
-
beforeAgentUnregistered
public void beforeAgentUnregistered(@NotNull SBuildAgent agent)
Description copied from interface:BuildServerListener
Called before build agent unregistration
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:
beforeAgentUnregistered
in interfaceBuildServerListener
- Parameters:
agent
- which is about to unregister
-
agentRemoved
public void agentRemoved(@NotNull SBuildAgent agent)
Description copied from interface:BuildServerListener
Called when agent was completely removed from server storage.
The event is not called when the current node doesn't manage agents, i.e. on read-only node- Specified by:
agentRemoved
in interfaceBuildServerListener
- Parameters:
agent
- removed agent- See Also:
see #agentRemoved(int)
-
agentRemoved
public void agentRemoved(int agentId)
Description copied from interface:BuildServerListener
Called when agent with specified id is removed. If server has agent instance then bothBuildServerListener.agentRemoved(SBuildAgent)
and this method are called. If server does not have an agent, for example, if agent was removed by another node, then only this method is called.- Specified by:
agentRemoved
in interfaceBuildServerListener
- Parameters:
agentId
- id of the removed agent
-
buildTypeAddedToQueue
@Deprecated public void buildTypeAddedToQueue(@NotNull SBuildType buildType)
Deprecated.Description copied from interface:BuildServerListener
Called when build configuration was added to build queue- Specified by:
buildTypeAddedToQueue
in interfaceBuildServerListener
- Parameters:
buildType
- build configuration added to build queue
-
buildTypeAddedToQueue
public void buildTypeAddedToQueue(@NotNull SQueuedBuild queuedBuild)
Description copied from interface:BuildServerListener
Called when build configuration was added to build queue Some events may be missing when the current node is not responsible for managing build queue. For example, on read-only node the event may be skipped if a build was in the queue for a short period of time, i.e. removed shortly after being added.- Specified by:
buildTypeAddedToQueue
in interfaceBuildServerListener
- Parameters:
queuedBuild
- queued build added to the queue
-
buildRemovedFromQueue
public void buildRemovedFromQueue(@NotNull SQueuedBuild queued, User user, java.lang.String comment)
Description copied from interface:BuildServerListener
Called when a build is removed from the build queue (started, deleted, optimized, etc.) Some events may be missing when the current node is not responsible for managing build queue. For example, on read-only node the event may be skipped if a build was in the queue for a short period of time, i.e. removed shortly after being added.- Specified by:
buildRemovedFromQueue
in interfaceBuildServerListener
- Parameters:
queued
- queued build removed from the queueuser
- if build was removed manually, contains the user who removed build configuration from queuecomment
- provided by user when removing build from queue
-
buildPinned
public void buildPinned(@NotNull SBuild build, @Nullable User user, @Nullable java.lang.String comment)
Description copied from interface:BuildServerListener
Called when user pinned the build. NB build could be pinned multiple times without unpinning
user
andcomment
parameters are omitted (nulls) when the build was pinned on another node (i.e. it's not called on read-only node)- Specified by:
buildPinned
in interfaceBuildServerListener
- Parameters:
build
- pinned builduser
- the user who pinned the buildcomment
- comment provided by user when pinning build
-
buildUnpinned
public void buildUnpinned(@NotNull SBuild build, @Nullable User user, @Nullable java.lang.String comment)
Description copied from interface:BuildServerListener
Called when user unpinned the build. NB build could be unpinned multiple times without pinning
user
andcomment
parameters are omitted (nulls) when the build was unpinned on another node (i.e. it's not called on read-only node)- Specified by:
buildUnpinned
in interfaceBuildServerListener
- Parameters:
build
- unpinned builduser
- the user who unpinned the buildcomment
- comment provided by user when unpinning build
-
buildQueueOrderChanged
public void buildQueueOrderChanged()
Description copied from interface:BuildServerListener
Called when user reordered build queue order. Is not called when build is started. Some events may be missing when the current node is not responsible for managing build queue. For example, read-only node is not aware of all the queue changes which happened on the main server.- Specified by:
buildQueueOrderChanged
in interfaceBuildServerListener
-
changesLoaded
public void changesLoaded(@NotNull BuildPromotion buildPromotion)
Description copied from interface:BuildServerListener
This method is called if changes are loaded for a build promotion while it was in the queue or when it was starting. The method is called irregardless of whether the checking for changes operation was successful or not. If operation failed, thenBuildPromotion.isFailedToCollectChanges()
will return true. Note: TeamCity collects changes for builds in the queue in several cases, the most common one if the build participates in a build chain. This is a more general version of the now deprecatedBuildServerListener.changesLoaded(SRunningBuild)
method.- Specified by:
changesLoaded
in interfaceBuildServerListener
- Parameters:
buildPromotion
- a build promotion for which changes have been collected
-
buildStarted
public void buildStarted(@NotNull SRunningBuild build)
Description copied from interface:BuildServerListener
Called when build is about to start. Changes are not loaded yet, and build agent didn't start the build yet.- Specified by:
buildStarted
in interfaceBuildServerListener
- Parameters:
build
- build configuration whose status has changed
-
changesLoaded
public void changesLoaded(@NotNull SRunningBuild build)
Description copied from interface:BuildServerListener
Called when changes for a newly started build have been loaded successfully. The method is not called if checking for changes operation failed.- Specified by:
changesLoaded
in interfaceBuildServerListener
- Parameters:
build
- build, whose changes are loaded
-
buildChangedStatus
public void buildChangedStatus(@NotNull SRunningBuild build, Status oldStatus, Status newStatus)
Description copied from interface:BuildServerListener
Called when build status changes from successful to failed- Specified by:
buildChangedStatus
in interfaceBuildServerListener
- Parameters:
build
- corresponding running buildoldStatus
- previous statusnewStatus
- new status
-
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 interfaceBuildServerListener
- Parameters:
build
- running build // TODO: shall pass SFinishedBuild as parameter
-
beforeBuildFinish
public void beforeBuildFinish(@NotNull SRunningBuild runningBuild)
Description copied from interface:BuildServerListener
Called right before build finishing, allows to write additional messages to the build log, update build status.- Specified by:
beforeBuildFinish
in interfaceBuildServerListener
- Parameters:
runningBuild
- corresponding running build
-
messageReceived
@Deprecated public void messageReceived(@NotNull SRunningBuild build, @NotNull BuildMessage1 message)
Deprecated.Description copied from interface:BuildServerListener
Called each time when running build got a message from build agent- Specified by:
messageReceived
in interfaceBuildServerListener
- Parameters:
build
- running buildmessage
- message sent to the build
-
responsibleChanged
public void responsibleChanged(@NotNull SBuildType bt, @NotNull ResponsibilityEntry oldValue, @NotNull ResponsibilityEntry newValue)
Description copied from interface:BuildServerListener
Called when build configuration responsible has changed, or responsibility status has changed
Some events may be omitted when the responsibility was changed on another node, i.e. it's not called on read-only node when the responsibility was assigned and immediately removed on the main server.- Specified by:
responsibleChanged
in interfaceBuildServerListener
- Parameters:
bt
- build configurationoldValue
- previous responsibility entrynewValue
- new responsibility entry
-
responsibleChanged
@Deprecated public void responsibleChanged(@NotNull SProject project, @Nullable TestNameResponsibilityEntry oldValue, @NotNull TestNameResponsibilityEntry newValue, boolean isUserAction)
Deprecated.Description copied from interface:BuildServerListener
Called when test responsibility is changed.- Specified by:
responsibleChanged
in interfaceBuildServerListener
- Parameters:
project
- the project in which test responsibility has changedoldValue
- old responsibility entrynewValue
- new responsibility entryisUserAction
- true if responsibility status was changed manually via Web UI
-
responsibleChanged
public void responsibleChanged(@NotNull SProject project, @NotNull java.util.Collection<TestName> testNames, @NotNull ResponsibilityEntry entry, boolean isUserAction)
Description copied from interface:BuildServerListener
Called when responsibility for several tests at once is changed.
Some events may be omitted when the responsibility was changed on another node, i.e. it's not called on read-only node when the responsibility was assigned and immediately removed on the main server.- Specified by:
responsibleChanged
in interfaceBuildServerListener
- Parameters:
project
- the projecttestNames
- test namesentry
- the new responsibility entry for each testisUserAction
- true if responsibility status was changed manually via Web UI
-
responsibleRemoved
public void responsibleRemoved(@NotNull SProject project, @NotNull TestNameResponsibilityEntry entry)
Description copied from interface:BuildServerListener
Called when responsibility for several tests at once is changed.
Some events may be omitted when the responsibility was changed on another node, i.e. it's not called on read-only node when the responsibility was assigned and immediately removed on the main server.- Specified by:
responsibleRemoved
in interfaceBuildServerListener
- Parameters:
project
- the projectentry
- the new responsibility entry for each test
-
responsibleChanged
public void responsibleChanged(@NotNull SProject project, @NotNull java.util.Collection<BuildProblemInfo> buildProblems, @Nullable ResponsibilityEntry entry)
Description copied from interface:BuildServerListener
Called when responsibility for several build problems at once is changed.
Some events may be omitted when the responsibility was changed on another node, i.e. it's not called on read-only node when the responsibility was assigned and immediately removed on the main server.- Specified by:
responsibleChanged
in interfaceBuildServerListener
- Parameters:
project
- the projectbuildProblems
- build problemsentry
- the new responsibility entry or null if responsibility is removed (better useBuildServerListener.responsibleRemoved(SProject, Collection, ResponsibilityEntry)
method to subscribe to the 'removed' events)
-
responsibleRemoved
public void responsibleRemoved(@NotNull SProject project, @NotNull java.util.Collection<BuildProblemInfo> buildProblems, @NotNull ResponsibilityEntry entry)
Description copied from interface:BuildServerListener
Called when responsibility for build problems is removed.
Some events may be omitted when the responsibility was changed on another node, i.e. it's not called on read-only node when the responsibility was assigned and immediately removed on the main server.- Specified by:
responsibleRemoved
in interfaceBuildServerListener
- Parameters:
project
- the projectbuildProblems
- build problemsentry
- the removed responsibility entry
-
beforeEntryDelete
public void beforeEntryDelete(@NotNull SFinishedBuild entry)
Description copied from interface:BuildServerListener
Called before deletion of the build history entry- Specified by:
beforeEntryDelete
in interfaceBuildServerListener
- Parameters:
entry
- build to be deleted
-
entryDeleted
public void entryDeleted(@NotNull SFinishedBuild entry)
Description copied from interface:BuildServerListener
Called after deletion of a build history entry. Better useBuildServerListener.entriesDeleted(java.util.Collection)
. Only this method orBuildServerListener.entriesDeleted(java.util.Collection)
should be overriden in a listener.- Specified by:
entryDeleted
in interfaceBuildServerListener
- Parameters:
entry
- deleted build- See Also:
BuildServerListener.entriesDeleted(java.util.Collection)
-
entriesDeleted
public void entriesDeleted(@NotNull java.util.Collection<SFinishedBuild> removedEntries)
Description copied from interface:BuildServerListener
Called after deletion of a set of build history entries Only one ofBuildServerListener.entryDeleted(SFinishedBuild)
or this method should be overriden in a listener.- Specified by:
entriesDeleted
in interfaceBuildServerListener
- Parameters:
removedEntries
- deleted builds
-
entryCreated
public void entryCreated(@NotNull SFinishedBuild build)
Description copied from interface:BuildServerListener
Called when build is added to the history.- Specified by:
entryCreated
in interfaceBuildServerListener
-
serverShutdown
public void serverShutdown()
Description copied from interface:ServerListener
Called when server shutdown has been started. In addition, this method is called for a plugin before it is unloaded, may be used for releasing resources and cleanup.- Specified by:
serverShutdown
in interfaceServerListener
-
serverStartup
public void serverStartup()
Description copied from interface:ServerListener
Called when server has been started and its configuration has been loaded from the disk- Specified by:
serverStartup
in interfaceServerListener
-
pluginsLoaded
public void pluginsLoaded()
Description copied from interface:BuildServerListener
Called when all server plugins are loaded, but beforeServerListener.serverStartup()
event.- Specified by:
pluginsLoaded
in interfaceBuildServerListener
-
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 interfaceBuildServerListener
- Parameters:
build
- running build // TODO: shall pass SFinishedBuild as parameter
-
buildDetachedFromAgent
public void buildDetachedFromAgent(@NotNull SRunningBuild build)
Description copied from interface:BuildServerListener
Called after build is detached from agent, making the agent available to other builds- Specified by:
buildDetachedFromAgent
in interfaceBuildServerListener
- Parameters:
build
- running build
-
changeAdded
public void changeAdded(@NotNull VcsModification modification, @NotNull VcsRoot root, @Nullable java.util.Collection<SBuildType> buildTypes)
Description copied from interface:BuildServerListener
Called when a new modification (user commit) was detected. Vcs modification can be detected during periodical process of changes collecting (in this case buildTypes parameter is null) or during build(s) startup phase. In the latter case buildTypes parameter will contain collection of build configurations for which changes collection was performed.- Specified by:
changeAdded
in interfaceBuildServerListener
- Parameters:
modification
- detected VCS modificationroot
- VCS root where modification was detectedbuildTypes
- if changes were detected when a build starts collection of buildTypes where changes collection was performed
-
agentStatusChanged
public void agentStatusChanged(@NotNull SBuildAgent agent, boolean wasEnabled, boolean wasAuthorized)
Description copied from interface:BuildServerListener
Called when the status of an agent is changed by a user
Some events may be skipped when an agent is registered on another node. For example on read-only node the event is not called for an agent which status was changed twice (enabled and then immediately disabled) on the main server.- Specified by:
agentStatusChanged
in interfaceBuildServerListener
- Parameters:
agent
- the agentwasEnabled
- the previous statuswasAuthorized
- previous authorized state
-
cleanupStarted
public void cleanupStarted()
Description copied from interface:BuildServerListener
Called when database cleanup is going to start.- Specified by:
cleanupStarted
in interfaceBuildServerListener
-
cleanupFinished
public void cleanupFinished()
Description copied from interface:BuildServerListener
Called when database cleanup has been finished.- Specified by:
cleanupFinished
in interfaceBuildServerListener
-
serverShutdownComplete
public void serverShutdownComplete()
Description copied from interface:BuildServerListener
Event called after server shutdown complete. Used to terminate hung child processes.- Specified by:
serverShutdownComplete
in interfaceBuildServerListener
-
sourcesVersionReleased
public void sourcesVersionReleased(@NotNull BuildAgent agent)
Description copied from interface:BuildServerListener
Clean sources performed for the given agent- Specified by:
sourcesVersionReleased
in interfaceBuildServerListener
- Parameters:
agent
- build agent whose sources are about to clean todo: change to S-interfaces
-
sourcesVersionReleased
public void sourcesVersionReleased(@NotNull BuildType configuration)
Description copied from interface:BuildServerListener
Clean sources performed for the given configuration on all agents- Specified by:
sourcesVersionReleased
in interfaceBuildServerListener
- Parameters:
configuration
- build configuration, whose sources to clean todo: change to S-interfaces
-
sourcesVersionReleased
public void sourcesVersionReleased(@NotNull BuildType configuration, @NotNull BuildAgent agent)
Description copied from interface:BuildServerListener
Clean sources performed for the given configuration on the given agent- Specified by:
sourcesVersionReleased
in interfaceBuildServerListener
- Parameters:
configuration
- build configuration, whose sources to cleanagent
- agent where to clean sources todo: change to S-interfaces
-
labelingFailed
public void labelingFailed(@NotNull SBuild build, @NotNull VcsRoot root, @NotNull java.lang.Throwable exception)
Description copied from interface:BuildServerListener
Labeling process failed for the specified build and root with the specified problem.- Specified by:
labelingFailed
in interfaceBuildServerListener
- Parameters:
build
- build for which labeling failed.root
- root for which labeling failed.exception
- labeling cause.
-
labelingSucceed
public void labelingSucceed(@NotNull SBuild build, @NotNull BuildRevision revision)
Description copied from interface:BuildServerListener
Labeling process succeed for the specified build and revision- Specified by:
labelingSucceed
in interfaceBuildServerListener
- Parameters:
build
- build for which labeling failed.revision
- labeled.
-
buildTagsChanged
@Deprecated public void buildTagsChanged(@NotNull SBuild build, @NotNull java.util.List<java.lang.String> oldTags, @NotNull java.util.List<java.lang.String> newTags)
Deprecated.Description copied from interface:BuildServerListener
Called when build tags have been set to specified values- Specified by:
buildTagsChanged
in interfaceBuildServerListener
- Parameters:
build
- corresponding build, which tags have been setoldTags
- previous tags on the buildnewTags
- new tags on the build
-
buildTagsChanged
@Deprecated public void buildTagsChanged(@NotNull SBuild build, User user, @NotNull java.util.List<java.lang.String> oldTags, @NotNull java.util.List<java.lang.String> newTags)
Deprecated.Description copied from interface:BuildServerListener
Called when build tags have been set to specified values- Specified by:
buildTagsChanged
in interfaceBuildServerListener
- Parameters:
build
- corresponding build, which tags have been setuser
- user who set new tagsoldTags
- previous tags on the buildnewTags
- new tags on the build
-
buildPromotionTagsChanged
public void buildPromotionTagsChanged(@NotNull BuildPromotion buildPromotion, @Nullable User user, @NotNull java.util.Collection<TagData> oldTags, @NotNull java.util.Collection<TagData> newTags)
Description copied from interface:BuildServerListener
Called when build promotion tags have been set to specified values
Some parameters may be omitted when the tags were changed on another node (i.e. when the event is called on read-only node):user
is null,oldTags
are empty.- Specified by:
buildPromotionTagsChanged
in interfaceBuildServerListener
- Parameters:
buildPromotion
- corresponding build promotion, which tags have been setuser
- user who set new tagsoldTags
- previous tags on the build promotion (public and private)newTags
- new tags on the build promotion (public and private)
-
buildCommented
public void buildCommented(@NotNull SBuild build, @Nullable User user, @Nullable java.lang.String comment)
Description copied from interface:BuildServerListener
Called when user comment the build.
user
andcomment
parameters are omitted (nulls) when the build was commented on another node (i.e. when the event is called on read-only node).- Specified by:
buildCommented
in interfaceBuildServerListener
- Parameters:
build
- commented builduser
- the user who commented the buildcomment
- comment provided by user
-
beforeServerConfigurationLoaded
public void beforeServerConfigurationLoaded()
Description copied from interface:BuildServerListener
Called before the server configuration is loaded by the server on startup.- Specified by:
beforeServerConfigurationLoaded
in interfaceBuildServerListener
-
serverConfigurationReloaded
public void serverConfigurationReloaded()
Description copied from interface:BuildServerListener
Called after the server configuration is loaded by the server on startup.- Specified by:
serverConfigurationReloaded
in interfaceBuildServerListener
-
testsMuted
public void testsMuted(@NotNull MuteInfo muteInfo)
Description copied from interface:BuildServerListener
Called when a set of tests are muted (with same mute properties). All tests are in the same project.
The method in not called when the test was muted on another node (i.e. when the current node is a read-only node)- Specified by:
testsMuted
in interfaceBuildServerListener
- Parameters:
muteInfo
- mute info
-
testsUnmuted
public void testsUnmuted(@Nullable SUser user, @NotNull java.util.Map<MuteInfo,java.util.Collection<STest>> unmutedGroups)
Description copied from interface:BuildServerListener
Called when several of tests have been unmuted. Tests can be belong to several projects.
The method in not called when the test was unmuted on another node (i.e. when the current node is a read-only node)- Specified by:
testsUnmuted
in interfaceBuildServerListener
- Parameters:
user
- user that unmuted tests, or null if they were unmuted automatically.unmutedGroups
- groups of tests that were unmuted.
-
buildProblemsChanged
public void buildProblemsChanged(@NotNull SBuild build, @NotNull java.util.List<BuildProblemData> before, @NotNull java.util.List<BuildProblemData> after)
Description copied from interface:BuildServerListener
Called when list of build problems changes (problems added, removed)
before
parameter may be empty or contain some outdated data when the problems are changed on another node:- current node is main server but the problem was added on messages processing node
- current node is read-only but the problem was added on the main server
- Specified by:
buildProblemsChanged
in interfaceBuildServerListener
- Parameters:
build
- corresponding buildbefore
- list of build problems before changeafter
- list of build problems after change
-
statisticValuePublished
public void statisticValuePublished(@NotNull SBuild build, @NotNull java.lang.String valueTypeKey, @NotNull java.math.BigDecimal value)
Description copied from interface:BuildServerListener
Called upon statistic-value related to the given build have been published- Specified by:
statisticValuePublished
in interfaceBuildServerListener
- Parameters:
build
- build this particular value pertains tovalueTypeKey
- target statistic-value's type-keyvalue
- target build-value
-
buildProblemsMuted
public void buildProblemsMuted(@NotNull MuteInfo muteInfo)
Description copied from interface:BuildServerListener
Called when a set of build problems are muted (with same mute properties). All problems belong the same project.
The method in not called when the problem was muted on another node (i.e. when the current node is a read-only node)- Specified by:
buildProblemsMuted
in interfaceBuildServerListener
- Parameters:
muteInfo
- mute info
-
buildProblemsUnmuted
public void buildProblemsUnmuted(@Nullable SUser user, @NotNull java.util.Map<MuteInfo,java.util.Collection<BuildProblemInfo>> unmutedGroups)
Description copied from interface:BuildServerListener
Called when a set of build problems are unmuted. Problems can be belong to several projects.
The method in not called when the problem was unmuted on another node (i.e. when the current node is a read-only node)- Specified by:
buildProblemsUnmuted
in interfaceBuildServerListener
- Parameters:
user
- user that unmuted problems, or null if they were unmuted automatically.unmutedGroups
- groups of build problems that were unmuted.
-
buildArtifactsChanged
public void buildArtifactsChanged(@NotNull SBuild build)
Description copied from interface:BuildServerListener
Called when build artifacts are changed by the server on disk, for example, when cleanup removed some files.- Specified by:
buildArtifactsChanged
in interfaceBuildServerListener
- Parameters:
build
- build whose artifacts were changed
-
-