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 writing BuildServerListeners.

Constructor Summary

Constructors

Constructor and Description
BuildServerAdapter()

Method Summary

Modifier and Type	Method and 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(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 Some events may be skipped when an agent is registered on another node.
void	agentUnregistered(SBuildAgent agent) 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 entry
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 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	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 server
void	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(SRunningBuild build) Called 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	entriesDeleted(java.util.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.
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 revision
void	messageReceived(SRunningBuild build, BuildMessage1 message) Deprecated.
void	pluginsLoaded() Called when all server plugins are loaded, but before ServerListener.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, TestNameResponsibilityEntry entry) Called when responsibility for several tests at once 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 configuration on all agents
void	sourcesVersionReleased(BuildType configuration, BuildAgent agent) Clean sources performed for the given configuration on the given agent
void	statisticValuePublished(SBuild build, java.lang.String valueTypeKey, java.math.BigDecimal value) Called upon statistic-value related to the given build have been published
void	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, buildTypeActiveStatusChanged, buildTypeDeleted, buildTypeExternalIdChanged, buildTypeMoved, buildTypePersisted, buildTypeRegistered, buildTypeTemplateDeleted, buildTypeTemplateDeleted, buildTypeTemplateExternalIdChanged, buildTypeTemplatePersisted, buildTypeTemplateRestored, buildTypeUnregistered, projectArchived, projectCreated, projectDearchived, projectExternalIdChanged, projectFeatureAdded, projectFeatureChanged, projectFeatureRemoved, projectMoved, projectPersisted, projectRemoved, projectRemoved, projectRestored, vcsRootExternalIdChanged, 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, buildTypeActiveStatusChanged, buildTypeDeleted, buildTypeExternalIdChanged, buildTypeMoved, buildTypePersisted, buildTypeRegistered, buildTypeTemplateDeleted, buildTypeTemplateDeleted, buildTypeTemplateExternalIdChanged, buildTypeTemplatePersisted, buildTypeTemplateRestored, buildTypeUnregistered, projectArchived, projectCreated, projectDearchived, projectExternalIdChanged, projectFeatureAdded, projectFeatureChanged, projectFeatureRemoved, projectMoved, projectPersisted, projectRemoved, projectRemoved, projectRestored, vcsRootExternalIdChanged, vcsRootPersisted, vcsRootRemoved, vcsRootsPersisted, vcsRootUpdated

Constructor Detail

BuildServerAdapter

public BuildServerAdapter()

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 interface BuildServerListener

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

agentDescriptionUpdated

public void agentDescriptionUpdated(@NotNull
                                    SBuildAgent agent)

Description copied from interface: BuildServerListener

Called when build agent description update is finished. This event is executed update synchronization on agent instance.
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 interface BuildServerListener

Parameters:

agent - agent with updated agent description

agentUnregistered

public void agentUnregistered(@NotNull
                              SBuildAgent agent)

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 interface BuildServerListener

Parameters:

agent - which was 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 interface BuildServerListener

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 interface BuildServerListener

Parameters:

agent - 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 interface BuildServerListener

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 interface BuildServerListener

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 interface BuildServerListener

Parameters:

queued - 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 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 and comment 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 interface BuildServerListener

Parameters:

build - pinned build

user - the user who pinned the build

comment - 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 and comment 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 interface BuildServerListener

Parameters:

build - unpinned build

user - the user who unpinned the build

comment - 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 interface BuildServerListener

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 interface BuildServerListener

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 has been loaded

Specified by:

changesLoaded in interface BuildServerListener

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 interface BuildServerListener

Parameters:

build - corresponding running build

oldStatus - previous status

newStatus - 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 interface BuildServerListener

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 interface BuildServerListener

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 interface BuildServerListener

Parameters:

build - running build

message - 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 interface BuildServerListener

Parameters:

bt - build configuration

oldValue - previous responsibility entry

newValue - 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 interface BuildServerListener

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

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 interface BuildServerListener

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

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 interface BuildServerListener

Parameters:

project - the project

entry - 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 interface BuildServerListener

Parameters:

project - the project

buildProblems - build problems

entry - the new responsibility entry or null if responsibility is removed

beforeEntryDelete

public void beforeEntryDelete(@NotNull
                              SFinishedBuild entry)

Description copied from interface: BuildServerListener

Called before deletion of the build history entry

Specified by:

beforeEntryDelete in interface BuildServerListener

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 use BuildServerListener.entriesDeleted(java.util.Collection). Only this method or BuildServerListener.entriesDeleted(java.util.Collection) should be overriden in a listener.

Specified by:

entryDeleted in interface BuildServerListener

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 of BuildServerListener.entryDeleted(SFinishedBuild) or this method should be overriden in a listener.

Specified by:

entriesDeleted in interface BuildServerListener

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 interface BuildServerListener

serverShutdown

public void serverShutdown()

Description copied from interface: ServerListener

Called when server shutdown has been started

Specified by:

serverShutdown in interface ServerListener

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 interface ServerListener

pluginsLoaded

public void pluginsLoaded()

Description copied from interface: BuildServerListener

Called when all server plugins are loaded, but before ServerListener.serverStartup() event.

Specified by:

pluginsLoaded in interface BuildServerListener

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

Parameters:

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

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 interface BuildServerListener

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

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 interface BuildServerListener

Parameters:

agent - the agent

wasEnabled - the previous status

wasAuthorized - previous authorized state

cleanupStarted

public void cleanupStarted()

Description copied from interface: BuildServerListener

Called when database cleanup is going to start.

Specified by:

cleanupStarted in interface BuildServerListener

cleanupFinished

public void cleanupFinished()

Description copied from interface: BuildServerListener

Called when database cleanup has been finished.

Specified by:

cleanupFinished in interface BuildServerListener

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 interface BuildServerListener

sourcesVersionReleased

public void sourcesVersionReleased(@NotNull
                                   BuildAgent agent)

Description copied from interface: BuildServerListener

Clean sources performed for the given agent

Specified by:

sourcesVersionReleased in interface BuildServerListener

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 interface BuildServerListener

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 interface BuildServerListener

Parameters:

configuration - build configuration, whose sources to clean

agent - 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 interface BuildServerListener

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 interface BuildServerListener

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 interface BuildServerListener

Parameters:

build - corresponding build, which tags have been set

oldTags - previous tags on the build

newTags - 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 interface BuildServerListener

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

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 interface BuildServerListener

Parameters:

buildPromotion - corresponding build promotion, which tags have been set

user - user who set new tags

oldTags - 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 and comment 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 interface BuildServerListener

Parameters:

build - commented build

user - the user who commented the build

comment - comment provided by user

serverConfigurationReloaded

public void serverConfigurationReloaded()

Description copied from interface: BuildServerListener

Called when the main server configuration file is reloaded

Specified by:

serverConfigurationReloaded in interface BuildServerListener

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 interface BuildServerListener

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 interface BuildServerListener

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 interface BuildServerListener

Parameters:

build - corresponding build

before - list of build problems before change

after - 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 interface BuildServerListener

Parameters:

build - build this particular value pertains to

valueTypeKey - target statistic-value's type-key

value - 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 interface BuildServerListener

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 interface BuildServerListener

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 interface BuildServerListener

Parameters:

build - build whose artifacts were changed