jetbrains.buildServer.serverSide
Interface BuildServerListener

All Superinterfaces:

java.util.EventListener

All Known Implementing Classes:

BuildServerAdapter

public interface BuildServerListener
extends java.util.EventListener

Generic TeamCity server listeners. Most operations with builds, agents, queue can be detected by implementing this listener.

See Also:

BuildServerAdapter

Method Summary

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)
void	agentRemoved(SBuildAgent agent) Called when agent was completely removed from server storage.
void	agentStatusChanged(SBuildAgent agent, boolean wasEnabled, boolean wasAuthorized) Called when the status of an agent is changed by a user
void	agentUnregistered(SBuildAgent agent) Called after build agent unregistration
void	beforeAgentUnregistered(SBuildAgent agent) Called before build agent unregistration
void	beforeBuildFinish(SRunningBuild runningBuild) Called right before build finishing, allows to write additional messages to the build log, update build status.
void	beforeBuildFinish(SRunningBuild runningBuild, boolean buildFailed) Deprecated. see beforeBuildFinish(SRunningBuild runningBuild)
void	beforeBuildTypeDeleted(java.lang.String buildTypeId) Called before cleaning the build configuration data from the database.
void	beforeEntryDelete(SFinishedBuild entry) Called before deletion of the build history entry
void	buildChangedStatus(SRunningBuild build, Status oldStatus, Status newStatus) Called when build status changes from successful to failed
void	buildCommented(SBuild build, User user, java.lang.String comment) Called when user comment the build
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	buildPinned(SBuild build, User user, java.lang.String comment) Called when user pinned the build
void	buildQueueOrderChanged() Called when user reordered build queue order.
void	buildRemovedFromQueue(SQueuedBuild queuedBuild, User user, java.lang.String comment) Called when build configuration removed from 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. Use buildTagsChanged(SBuild, User, List, List)
void	buildTagsChanged(SBuild build, User user, java.util.List<java.lang.String> oldTags, java.util.List<java.lang.String> newTags) Called when build tags have been set to specifiled values
void	buildTypeActiveStatusChanged(SBuildType buildType) Called when build configuration status changed from active to paused and vice versa.
void	buildTypeAddedToQueue(SBuildType buildType) Deprecated.
void	buildTypeAddedToQueue(SQueuedBuild queuedBuild) Called when build configration was added to build queue
void	buildTypeDeleted(java.lang.String buildTypeId) Called after the cleaning the build configuration data from the database.
void	buildTypeMoved(SBuildType buildType, SProject original) Called when build configuration is moved to another project.
void	buildTypeRegistered(SBuildType buildType) Called when build configuration is created or build configuration is reloaded from the disk
void	buildTypeTemplateDeleted(java.lang.String buildTypeTemplateId) Called when build configuration template is deleted
void	buildTypeUnregistered(SBuildType buildType) Called when build configuration is deleted
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(SRunningBuild build) Occurres when changes for a newly started build has been loaded
void	cleanupFinished() Called when database cleanup has been finished.
void	cleanupStarted() Called when database cleanup is going to start.
void	entryDeleted(SFinishedBuild entry) Called after deletion of the 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 revision
void	messageReceived(SRunningBuild build, BuildMessage1 message) Called each time when running build got a message from build agent
void	pluginsLoaded() Called when all server plugins are loaded
void	projectArchived(java.lang.String projectId) Called when project has been archived
void	projectCreated(java.lang.String projectId) Generated when new project was created
void	projectDearchived(java.lang.String projectId) Called when project has been dearchived
void	projectPersisted(java.lang.String projectId) Generated when project configuration persisted on a disk
void	projectRemoved(java.lang.String projectId) Generated when project was removed
void	projectRestored(java.lang.String projectId) Generated when project configuration reloaded from disk
void	responsibleChanged(SBuildType bt, ResponsibilityInfo oldValue, ResponsibilityInfo newValue, boolean isUserAction) Called when build configuration responsible has changed, or responsibility status has 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) Called when test responsibility is changed.
void	serverConfigurationReloaded() Called when the main server configuration file is reloaded
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 disk
void	sourcesVersionReleased(BuildAgent agent) Clean sources performed for the given agent
void	sourcesVersionReleased(BuildType configuration) Clean sources performed for the given configuraton on all agents
void	sourcesVersionReleased(BuildType configuration, BuildAgent agent) Clean sources performed for the given configuraton on the given agent
void	testsMuted(MuteInfo muteInfo) Called when a set of tests are muted (with same mute properties).
void	testsUnmuted(SProject project, java.util.Collection<com.intellij.openapi.util.Pair<MuteInfo,java.util.Collection<STest>>> unmutedGroups) Called when several of tests have been unmuted.
void	vcsRootRemoved(SVcsRoot root) Called when VCS root was removed
void	vcsRootsPersisted() Called when VCS roots are saved to disk
void	vcsRootUpdated(SVcsRoot oldVcsRoot, SVcsRoot newVcsRoot) Called when VCS root settings has c

Method Detail

agentRegistered

void agentRegistered(SBuildAgent agent,
                     long currentlyRunningBuildId)

Called when build agent is registered (connected)

Parameters:

agent - which was registered

currentlyRunningBuildId - id of the build which is running on this build agent

agentDescriptionUpdated

void agentDescriptionUpdated(@NotNull
                             SBuildAgent agent)

Called when build agent description update is finished. This event is executed update synchronization on agent instance.

Parameters:

agent - agent with updated agent description

Since:

6.0

beforeAgentUnregistered

void beforeAgentUnregistered(SBuildAgent agent)

Called before build agent unregistration

Parameters:

agent - which is about to unregister

agentUnregistered

void agentUnregistered(SBuildAgent agent)

Called after build agent unregistration

Parameters:

agent - which was unregistered

agentStatusChanged

void agentStatusChanged(@NotNull
                        SBuildAgent agent,
                        boolean wasEnabled,
                        boolean wasAuthorized)

Called when the status of an agent is changed by a user

Parameters:

agent - the agent

wasEnabled - the previous status

wasAuthorized - previous authorized state

agentRemoved

void agentRemoved(SBuildAgent agent)

Called when agent was completely removed from server storage.

Parameters:

agent - removed agent

buildTypeAddedToQueue

void buildTypeAddedToQueue(SBuildType buildType)

Deprecated.

Called when build configration was added to build queue

Parameters:

buildType - build configuration added to build queue

buildTypeAddedToQueue

void buildTypeAddedToQueue(@NotNull
                           SQueuedBuild queuedBuild)

Called when build configration was added to build queue

Parameters:

queuedBuild - queued build added to the queue

buildRemovedFromQueue

void buildRemovedFromQueue(@NotNull
                           SQueuedBuild queuedBuild,
                           User user,
                           java.lang.String comment)

Called when build configuration removed from build queue

Parameters:

queuedBuild - queued build removed from the queue

user - if build was removed manually, contains the user who removed build configuration from queue

comment - provided by user when removeding build from queue

buildPinned

void buildPinned(@NotNull
                 SBuild build,
                 @Nullable
                 User user,
                 @Nullable
                 java.lang.String comment)

Called when user pinned the build

Parameters:

build - pinned build

user - the user who pinned the build

comment - comment provided by user when pinning build

buildUnpinned

void buildUnpinned(@NotNull
                   SBuild build,
                   @Nullable
                   User user,
                   @Nullable
                   java.lang.String comment)

Called when user unpinned the build

Parameters:

build - unpinned build

user - the user who unpinned the build

comment - comment provided by user when unpinning build

buildQueueOrderChanged

void buildQueueOrderChanged()

Called when user reordered build queue order. Is not called when build is started.

buildTypeRegistered

void buildTypeRegistered(SBuildType buildType)

Called when build configuration is created or build configuration is reloaded from the disk

Parameters:

buildType - registered build configuration

buildTypeUnregistered

void buildTypeUnregistered(SBuildType buildType)

Called when build configuration is deleted

Parameters:

buildType - unregistered build configuration

buildTypeMoved

void buildTypeMoved(SBuildType buildType,
                    SProject original)

Called when build configuration is moved to another project.

Parameters:

buildType - build type

original - the original project

beforeBuildTypeDeleted

void beforeBuildTypeDeleted(@NotNull
                            java.lang.String buildTypeId)

Called before cleaning the build configuration data from the database.

Parameters:

buildTypeId - id of build configuration

buildTypeDeleted

void buildTypeDeleted(@NotNull
                      java.lang.String buildTypeId)

Called after the cleaning the build configuration data from the database.

Parameters:

buildTypeId - id of build configuration

buildTypeTemplateDeleted

void buildTypeTemplateDeleted(@NotNull
                              java.lang.String buildTypeTemplateId)

Called when build configuration template is deleted

Parameters:

buildTypeTemplateId - id of build configuration template

Since:

6.5

buildTypeActiveStatusChanged

void buildTypeActiveStatusChanged(SBuildType buildType)

Called when build configuration status changed from active to paused and vice versa.

Parameters:

buildType - build configuration whose status has changed

buildStarted

void buildStarted(SRunningBuild build)

Called when build is about to start. Changes are not loaded yet, and build agent didn't start the build yet.

Parameters:

build - build configuration whose status has changed

changesLoaded

void changesLoaded(SRunningBuild build)

Occurres when changes for a newly started build has been loaded

Parameters:

build - build, whose changes are loaded

buildChangedStatus

void buildChangedStatus(SRunningBuild build,
                        Status oldStatus,
                        Status newStatus)

Called when build status changes from successful to failed

Parameters:

build - corresponding running build

oldStatus - previous status

newStatus - new status

beforeBuildFinish

void beforeBuildFinish(SRunningBuild runningBuild,
                       boolean buildFailed)

Deprecated. see beforeBuildFinish(SRunningBuild runningBuild)

beforeBuildFinish

void beforeBuildFinish(SRunningBuild runningBuild)

Called right before build finishing, allows to write additional messages to the build log, update build status.

Parameters:

runningBuild - corresponding running build

buildFinished

void buildFinished(SRunningBuild build)

Called after build finishing, only if build was not interrupted

Parameters:

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

buildInterrupted

void buildInterrupted(SRunningBuild build)

Called after build finishing, only if build was interrupted

Parameters:

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

messageReceived

void messageReceived(SRunningBuild build,
                     BuildMessage1 message)

Called each time when running build got a message from build agent

Parameters:

build - running build

message - message sent to the build

responsibleChanged

void responsibleChanged(@NotNull
                        SBuildType bt,
                        @NotNull
                        ResponsibilityInfo oldValue,
                        @NotNull
                        ResponsibilityInfo newValue,
                        boolean isUserAction)

Called when build configuration responsible has changed, or responsibility status has changed

Parameters:

bt - build configuration

oldValue - previous responsibility state

newValue - new responsibility state

isUserAction - true if responsibility status was changed manually via Web UI

responsibleChanged

void responsibleChanged(@NotNull
                        SProject project,
                        @Nullable
                        TestNameResponsibilityEntry oldValue,
                        @NotNull
                        TestNameResponsibilityEntry newValue,
                        boolean isUserAction)

Called when test responsibility is changed.

Parameters:

project - the project in which test responsibility has changed

oldValue - old responsibility entry

newValue - new responsibility entry

isUserAction - true if responsibility status was changed manually via Web UI

Since:

5.0

responsibleChanged

void responsibleChanged(@NotNull
                        SProject project,
                        @NotNull
                        java.util.Collection<TestName> testNames,
                        @NotNull
                        ResponsibilityEntry entry,
                        boolean isUserAction)

Called when responsibility for several tests at once is changed.

Parameters:

project - the project

testNames - test names

entry - the new responsibility entry for each test

isUserAction - true if responsibility status was changed manually via Web UI

Since:

6.0

beforeEntryDelete

void beforeEntryDelete(SFinishedBuild entry)

Called before deletion of the build history entry

Parameters:

entry - build to be deleted

entryDeleted

void entryDeleted(SFinishedBuild entry)

Called after deletion of the build history entry

Parameters:

entry - deleted build

projectCreated

void projectCreated(java.lang.String projectId)

Generated when new project was created

Parameters:

projectId - id of the created project

projectRemoved

void projectRemoved(java.lang.String projectId)

Generated when project was removed

Parameters:

projectId - deleted projectId

projectPersisted

void projectPersisted(java.lang.String projectId)

Generated when project configuration persisted on a disk

Parameters:

projectId - id of the saved project

projectRestored

void projectRestored(java.lang.String projectId)

Generated when project configuration reloaded from disk

Parameters:

projectId - id of the reloaded project

projectArchived

void projectArchived(java.lang.String projectId)

Called when project has been archived

Parameters:

projectId - id of archived project

projectDearchived

void projectDearchived(java.lang.String projectId)

Called when project has been dearchived

Parameters:

projectId - id of dearchived project

serverShutdown

void serverShutdown()

Called when server shutdown has been started

serverStartup

void serverStartup()

Called when server has been started and its configuration has been loaded from the disk

pluginsLoaded

void pluginsLoaded()

Called when all server plugins are loaded

changeAdded

void changeAdded(@NotNull
                 VcsModification modification,
                 @NotNull
                 VcsRoot root,
                 @Nullable
                 java.util.Collection<SBuildType> buildTypes)

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.

Parameters:

modification - detected VCS modification

root - VCS root where modification was detected

buildTypes - if changes were detected when a build starts collection of buildTypes where changes collection was performed

cleanupStarted

void cleanupStarted()

Called when database cleanup is going to start.

cleanupFinished

void cleanupFinished()

Called when database cleanup has been finished.

serverShutdownComplete

void serverShutdownComplete()

Event called after server shutdown complete. Used to terminate hung child processes.

sourcesVersionReleased

void sourcesVersionReleased(@NotNull
                            BuildAgent agent)

Clean sources performed for the given agent

Parameters:

agent - build agent whose sources are about to clean todo: change to S-interfaces

sourcesVersionReleased

void sourcesVersionReleased(@NotNull
                            BuildType configuration)

Clean sources performed for the given configuraton on all agents

Parameters:

configuration - build configuration, whose sources to clean todo: change to S-interfaces

sourcesVersionReleased

void sourcesVersionReleased(@NotNull
                            BuildType configuration,
                            @NotNull
                            BuildAgent agent)

Clean sources performed for the given configuraton on the given agent

Parameters:

configuration - build configuration, whose sources to clean

agent - agent where to clean sources todo: change to S-interfaces

labelingFailed

void labelingFailed(SBuild build,
                    VcsRoot root,
                    java.lang.Throwable exception)

Labeling process failed for the specified build and root with the specified problem.

Parameters:

build - build for which labeling failed.

root - root for which labeling failed.

exception - labeling cause.

labelingSucceed

void labelingSucceed(SBuild build,
                     BuildRevision revision)

Labeling process succeed for the specified build and revision

Parameters:

build - build for which labeling failed.

revision - labeled.

buildTagsChanged

void buildTagsChanged(SBuild build,
                      java.util.List<java.lang.String> oldTags,
                      java.util.List<java.lang.String> newTags)

Deprecated. Use buildTagsChanged(SBuild, User, List, List)

Called when build tags have been set to specifiled values

Parameters:

build - corresponding build, which tags have been set

oldTags - previous tags on the build

newTags - new tags on the build

buildTagsChanged

void buildTagsChanged(SBuild build,
                      User user,
                      java.util.List<java.lang.String> oldTags,
                      java.util.List<java.lang.String> newTags)

Called when build tags have been set to specifiled values

Parameters:

build - corresponding build, which tags have been set

user - user who set new tags

oldTags - previous tags on the build

newTags - new tags on the build

Since:

4.0.1

buildCommented

void buildCommented(@NotNull
                    SBuild build,
                    @Nullable
                    User user,
                    @Nullable
                    java.lang.String comment)

Called when user comment the build

Parameters:

build - commented build

user - the user who commented the build

comment - comment provided by user

serverConfigurationReloaded

void serverConfigurationReloaded()

Called when the main server configuration file is reloaded

Since:

4.5

vcsRootsPersisted

void vcsRootsPersisted()

Called when VCS roots are saved to disk

Since:

5.0

vcsRootRemoved

void vcsRootRemoved(@NotNull
                    SVcsRoot root)

Called when VCS root was removed

Parameters:

root - vcs root

Since:

5.0

vcsRootUpdated

void vcsRootUpdated(@NotNull
                    SVcsRoot oldVcsRoot,
                    @NotNull
                    SVcsRoot newVcsRoot)

Called when VCS root settings has c

Parameters:

oldVcsRoot -

newVcsRoot -

testsMuted

void testsMuted(@NotNull
                MuteInfo muteInfo)

Called when a set of tests are muted (with same mute properties). All tests are in the same project.

Parameters:

muteInfo - mute info

Since:

6.5

testsUnmuted

void testsUnmuted(@NotNull
                  SProject project,
                  @NotNull
                  java.util.Collection<com.intellij.openapi.util.Pair<MuteInfo,java.util.Collection<STest>>> unmutedGroups)

Called when several of tests have been unmuted. All tests belong to one project.

Parameters:

project - project where tests were unmuted.

unmutedGroups - groups of tests that were unmuted.

Since:

6.5