Package jetbrains.buildServer.serverSide.impl

Class RunningBuildImpl

java.lang.Object

jetbrains.buildServer.serverSide.impl.BaseBuild

jetbrains.buildServer.serverSide.impl.BaseRunningBuild

jetbrains.buildServer.serverSide.impl.RunningBuildImpl

All Implemented Interfaces:

Build, RunningBuild, RunningBuildInfo, BuildEx, BuildPromotionOwner, ParametersSupport, RunningBuildEx, SBuild, SRunningBuild

Direct Known Subclasses:

SecuredRunningBuild

public class RunningBuildImpl
extends BaseRunningBuild
implements RunningBuildEx

Nested Class Summary

Nested classes/interfaces inherited from class jetbrains.buildServer.serverSide.impl.BaseRunningBuild

BaseRunningBuild.ArtifactsStats

Field Summary

Fields inherited from class jetbrains.buildServer.serverSide.impl.BaseRunningBuild

myLastUpdateTimestamp, myStatusText, OLD_UNEXPECTED_FINISH

Fields inherited from class jetbrains.buildServer.serverSide.impl.BaseBuild

myBuildId, myContext, myStatsCallCounter, REMOTE_ARTIFACTS_PREFIX

Fields inherited from interface jetbrains.buildServer.serverSide.RunningBuildEx

DEPENDENCIES_SKIP_ENABLED

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RunningBuildImpl(BuildPromotionEx buildPromotion, RunningBuildData runningBuildData, BuildContext context)	Used for loading the build from DB.
protected	RunningBuildImpl(BuildPromotionEx buildPromotion, SAgentRestrictor queuedAgentRestrictor, String rawTriggeredBy, int agentId, int agentTypeId, BuildContext context)

Method Summary

Modifier and Type	Method	Description
void	addBuildMessage(BuildMessage1 message)	Adds new message from server to the build.
void	addBuildMessages(List<BuildMessage1> messages)	Adds new server messages to the build.
void	buildPatch(OutputStream stream, FullCheckoutFlag fullCheckoutFlag, boolean personalChanges, AgentCheckoutDirRevisionInfo workDirState)
void	buildPersonalPatch(OutputStream stream, long personalChangeId, AgentCheckoutDirRevisionInfo workDirState)
void	clearCachedEstimate()
void	closeBuildLog()	Closes the build log's root block, flushes messages and closes the build log
BuildAgentEx	computeAgentlessBuildAgent()
boolean	computeProbablyHanging(long currentTime)
AgentBuild	createAgentBuild()	Creates structure containing all of the parameters which should be sent to an agent
void	detachedFromAgent()	Should be called when the build has been detached from the agent and agent can start some other build
protected boolean	doBuildFinish()
void	finish(Date finishDate)	Finalizes all build related activities and finishes the build.
void	finishedOnOtherNode()
void	finishImmediately(Date finishDate, boolean failed)	For tests only!
BuildAgentEx	getAgent()	Get build agent this running build is running on.
String	getAgentAccessCode()	Returns access code which can be used by agent to access server resources by HTTP.
int	getAgentId()
String	getAgentName()	Returns agent name where build is running or happened to run if finished.
ArtifactsUploadLimit	getArtifactsLimit()
BuildConfigurationInfo	getBuildConfiguration()
long	getBuildCounter()
BuildLogEx	getBuildLog()	Returns build log.
BuildLogEx	getBuildLogIfInitialized()
String	getBuildNumber()	Returns build number in the user defined format (unresolved parameters in build number will be replaced with '???').
Map<String,String>	getBuildOwnParameters()	Returns map of parameters (configuration params, system properties and environment variables) excluding parameters provided by extensions.
BuildPromotionInfo	getBuildPromotionInfo()
ShortStatistics	getCachedShortStatistics(boolean calculateIfAbsent)	Return cached short statistics for this build.
int	getCompletedPercent()
int	getCompletedPercent(long currentTime)
String	getCurrentPath()	Returns short description of current running step.
long	getDurationEstimate()	Returns server estimation for this build duration in seconds.
long	getDurationOvertime()	Returns how much in seconds this build duration exceeded estimated duration.
long	getElapsedTime()	Returns elapsed time for this build.
long	getElapsedTime(long currentTime)
long	getEstimatedDurationExceededTime(long currentTime)
long	getEstimationForTimeLeft()	Returns server estimation for this build remaining time.
long	getEstimationForTimeLeft(long currentTime)
Date	getFinishDate()	Returns finish timestamp for the build (server time) or null if it hasn't been finished yet.
Date	getLastBuildActivityTimestamp()
String	getProgressText()
String	getProjectExternalId()	Returns external id of the project this build belongs to.
String	getProjectId()	Returns internal id of the project this build belongs to.
Integer	getQueuedAgentId()
SAgentRestrictor	getQueuedAgentRestrictor()	Returns an agent restrictor this build was queued with (when build configuration was added to queue).
String	getRawBuildNumber()	Returns raw build number (i.e.
Map<String,Boolean>	getRunnersState()
StatusDescriptor	getStatusDescriptor()	Returns status descriptor of the build
List<TestInfo>	getTestMessages(int skipTests, int maxTestsToLoad)	Retrieves information about tests failed in the build.
TestRunMuter	getTestRunMuter()	Returns a special service that allows to mute test run if neccessary.
long	getTimeSpentSinceLastBuildActivity()	Returns time in seconds spent since last build activity.
UserDataStorage	getUserDataStorage()	Use this object to associate some data with the current instance.
protected void	initialize(boolean newBuild)
boolean	isCompositeBuild()	Returns true if this build is a composite build.
boolean	isFinished()
boolean	isFinishReceived()
boolean	isProbablyHanging()	Returns true if server thinks this build has hung.
boolean	isStarting()	Returns true if the build is trying to start on an agent and runBuild() command has not finished yet
void	markAsFinished(Date finishDate, boolean failed)
void	markAsFinishedUnexpectedly(String reason)
void	muteBuildProblems(boolean muteIfTrue)	Makes all existing build problems enabled or disabled
boolean	occupiesAgent()
void	prepareArtifactDependencies()	Resolves artifact dependencies by replacing "latest" rules with actual build ids.
void	publishArtifact(String path, byte[] content)	Adds artifact to the build by the specified path
void	publishArtifact(String path, File srcFile)	Adds artifact to the build by the specified path
void	publishArtifact(String path, File srcFile, PublishArtifactProgressListener progressListener)	Adds artifact to the build from the specified file allowing to trace progress
void	publishArtifact(String path, InputStream is)	Adds artifact to the build by the specified path
void	publishArtifact(String path, InputStream source, PublishArtifactProgressListener progressListener)	Adds artifact to the build from the specified stream allowing to trace progress
void	resetAgentCache()	Resets internal cache of agent instance
boolean	runUnlessFinished(Runnable action)	Executes specified runnable if build is not finished.
void	serverShutdown()
void	serverStartup()
void	setBuildNumber(String newBuildNumber)	Set new value for this build build number instead of current one.
void	setBuildStatus(Status status)	Set current status of the running build.
void	setStartTimes(Date agentStartTime, Date serverStartTime, TimeZone agentTimeZone)	Sets timestamps when command to run build was sent to an agent.
void	start(boolean async)	Must be invoked only once when build starts.
void	stop(RunningBuildState interruptedState, User user, String comment, boolean reAdd2Queue)
void	stopNoInterrupt()	Stops build on server and on agent without making it interrupted
String	toString()
void	updateBuild()
boolean	updateBuildInfo()	Loads build interruption and build finish timestamps from database into the build.

Methods inherited from class jetbrains.buildServer.serverSide.impl.BaseRunningBuild

addRemoteArtifact, createSettingsDigest, finish, getArtifactsStats, getBuildDescription, getBuildPromotion, getCanceledInfo, getCompletedStages, getDependencyGraph, getHangingDependency, getLastUpdateDelayMsecs, getRunningState, getStatisticValuesCollection, initCurrentStatisticValues, isInterrupted, loadCancelledInfoFromDB, logFinalMessages, notifyOnBuildProblemsChanged, resolveArtifactDependencies, setCanceledInfo, setCustomStatusText, setInterrupted, skipBuildChainBuilds, startBuildFailureChecker, stop, stopBuildFailureChecker, updateBuildIfLastUpdateExpired, updateBuildStatisticValues, writeFinishProperties, writeSettingsDigestFile

Methods inherited from class jetbrains.buildServer.serverSide.impl.BaseBuild

addBuildProblem, addUserBuildProblem, buildProblemsChanged, convertToAgentTime, convertToServerTime, createShortStatistics, deleteBuildProblem, doGetBuildFinishParameters, doGetBuildStartParameters, getArtifactDependencies, getArtifacts, getArtifactsDirectory, getAuditLogFactory, getAuditLogProvider, getBranch, getBuildComment, getBuildContext, getBuildFeaturesOfType, getBuildFinishParameters, getBuildId, getBuildNumberParameters, getBuildNumberWithoutRefs, getBuildProblems, getBuildStartParameters, getBuildStatistics, getBuildStatus, getBuildType, getBuildTypeExternalId, getBuildTypeId, getBuildTypeName, getChanges, getClientStartDate, getClientTimeZone, getCommitters, getCompilationErrorMessages, getContainingChanges, getCustomDataStorage, getCustomDataStorageIdsByPrefix, getDetachFromAgentReceivedTimestamp, getDownloadedArtifacts, getDuration, getDurationOnAgent, getFailureReasons, getFileContent, getFinishOnAgentDate, getFirstInternalError, getFirstInternalErrorMessage, getFullName, getFullStatistics, getId, getLabels, getLogMessages, getOwner, getParametersProvider, getPreviousFinished, getProvidedArtifacts, getQueuedDate, getRecentlyFinishedBuild, getRelatedIssues, getRemoteArtifacts, getRemoteArtifactsByType, getRevisions, getSequenceBuild, getServerStartDate, getSettingsDigestFile, getSettingsDigestFromFile, getShortStatistics, getStartDate, getStatisticValue, getStatisticValues, getStatus, getTags, getTemporaryCustomDataStorage, getTriggeredBy, getValueResolver, getValueResolver, getValueResolver, getVariablesProvider, getVcsRootEntries, getWaitReasons, hasBuildFinishParameters, hasBuildProblemOfType, hasTests, initMetrics, isAgentLessBuild, isArtifactsExists, isDetachedFromAgent, isHasInternalArtifactsOnly, isHasRelatedIssues, isInternalError, isOutdated, isOutOfChangesSequence, isPersonal, isPersonalPatchAvailable, isPinned, isResponsibleNeeded, isStartedOnAgent, isTimedOut, isUsedByOtherBuilds, muteBuildProblems, now, nowDate, preloadFailedTests, publishStatisticValue, resetBuildFinalParameters, setBuildComment, setBuildStartTimes, setTags, setTags, updateExternalArtifactsInfoOnAccess

Methods inherited from class java.lang.Object

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

Methods inherited from interface jetbrains.buildServer.Build

getBuildId, getBuildStatus, getBuildTypeExternalId, getBuildTypeId, getBuildTypeName, getCanceledInfo, getCompilationErrorMessages, getDuration, getFullName, getLogMessages, getStartDate, isPersonal

Methods inherited from interface jetbrains.buildServer.serverSide.BuildPromotionOwner

getSequenceBuild

Methods inherited from interface jetbrains.buildServer.serverSide.ParametersSupport

getParametersProvider

Methods inherited from interface jetbrains.buildServer.serverSide.RunningBuildEx

finish, getBuildPromotion, getCompletedStages, getDetachFromAgentReceivedTimestamp, getHangingDependency, getStatisticValuesCollection, getTemporaryCustomDataStorage, setCustomStatusText, skipBuildChainBuilds, startBuildFailureChecker, stopBuildFailureChecker, updateBuildIfLastUpdateExpired, updateBuildStatisticValues, updateExternalArtifactsInfoOnAccess, writeSettingsDigestFile

Methods inherited from interface jetbrains.buildServer.serverSide.SBuild

addBuildProblem, addUserBuildProblem, convertToAgentTime, convertToServerTime, getArtifactDependencies, getArtifacts, getArtifactsDirectory, getBranch, getBuildComment, getBuildDescription, getBuildFeaturesOfType, getBuildStatistics, getBuildType, getChanges, getClientStartDate, getClientTimeZone, getCommitters, getContainingChanges, getCustomDataStorage, getDownloadedArtifacts, getFailureReasons, getFileContent, getFinishOnAgentDate, getFirstInternalError, getFirstInternalErrorMessage, getFullStatistics, getLabels, getOwner, getPreviousFinished, getProvidedArtifacts, getQueuedDate, getRecentlyFinishedBuild, getRelatedIssues, getRemoteArtifacts, getRemoteArtifactsByType, getRevisions, getServerStartDate, getShortStatistics, getStatisticValue, getStatisticValues, getTags, getTriggeredBy, getValueResolver, getVcsRootEntries, getWaitReasons, hasBuildProblemOfType, hasTests, isAgentLessBuild, isArtifactsExists, isDetachedFromAgent, isHasInternalArtifactsOnly, isHasRelatedIssues, isInternalError, isOutdated, isOutOfChangesSequence, isPinned, isResponsibleNeeded, isStartedOnAgent, isUsedByOtherBuilds, muteBuildProblems, setBuildComment, setTags, setTags

Methods inherited from interface jetbrains.buildServer.serverSide.SRunningBuild

addRemoteArtifact, isInterrupted, setInterrupted, stop

Constructor Detail

RunningBuildImpl

protected RunningBuildImpl(@NotNull
                           BuildPromotionEx buildPromotion,
                           @Nullable
                           SAgentRestrictor queuedAgentRestrictor,
                           String rawTriggeredBy,
                           int agentId,
                           int agentTypeId,
                           @NotNull
                           BuildContext context)

Throws:

IllegalArgumentException - if buildPromotion is a composite one.

RunningBuildImpl

protected RunningBuildImpl(@NotNull
                           BuildPromotionEx buildPromotion,
                           RunningBuildData runningBuildData,
                           @NotNull
                           BuildContext context)

Used for loading the build from DB.

Throws:

IllegalArgumentException - if buildPromotion is a composite one.

Method Detail

initialize

protected void initialize(boolean newBuild)

prepareArtifactDependencies

public void prepareArtifactDependencies()

Description copied from interface: RunningBuildEx

Resolves artifact dependencies by replacing "latest" rules with actual build ids.

Specified by:

prepareArtifactDependencies in interface RunningBuildEx

getBuildConfiguration

@Nullable
public BuildConfigurationInfo getBuildConfiguration()

Specified by:

getBuildConfiguration in interface RunningBuildInfo

Returns:

the corresponding build configuration or null if the configuration has been concurrently deleted

getAgent

@NotNull
public BuildAgentEx getAgent()

Description copied from interface: SRunningBuild

Get build agent this running build is running on. May be unregistered or even dead agent, but never null.

Specified by:

getAgent in interface RunningBuildInfo

Specified by:

getAgent in interface SBuild

Specified by:

getAgent in interface SRunningBuild

Specified by:

getAgent in class BaseRunningBuild

Returns:

agent where this build executed.

computeAgentlessBuildAgent

@NotNull
public BuildAgentEx computeAgentlessBuildAgent()

getQueuedAgentRestrictor

@Nullable
public SAgentRestrictor getQueuedAgentRestrictor()

Description copied from interface: RunningBuildEx

Returns an agent restrictor this build was queued with (when build configuration was added to queue). Returns null if build was not queued on a specific agent / agent set.

Specified by:

getQueuedAgentRestrictor in interface RunningBuildEx

Specified by:

getQueuedAgentRestrictor in interface SRunningBuild

Returns:

see above

getQueuedAgentId

public Integer getQueuedAgentId()

Specified by:

getQueuedAgentId in interface SRunningBuild

Returns:

agent this build was queued on or null if build was not queued on a specific agent

addBuildMessages

public void addBuildMessages(@NotNull
                             List<BuildMessage1> messages)

Description copied from interface: SRunningBuild

Adds new server messages to the build.

Specified by:

addBuildMessages in interface SRunningBuild

Parameters:

messages - new build messages.

addBuildMessage

public void addBuildMessage(@NotNull
                            BuildMessage1 message)

Description copied from interface: RunningBuildEx

Adds new message from server to the build.

Specified by:

addBuildMessage in interface RunningBuildEx

Specified by:

addBuildMessage in interface SRunningBuild

getProgressText

@NotNull
public String getProgressText()

Specified by:

getProgressText in interface RunningBuildEx

Returns:

current progress text calculated for the build; this text is used in build status line

getCurrentPath

public String getCurrentPath()

Description copied from interface: SRunningBuild

Returns short description of current running step.

Specified by:

getCurrentPath in interface SRunningBuild

Returns:

short description of current running step.

getFinishDate

@Nullable
public Date getFinishDate()

Description copied from interface: Build

Returns finish timestamp for the build (server time) or null if it hasn't been finished yet.

Specified by:

getFinishDate in interface Build

Returns:

Date/time when the build has been finished, null if still running.

toString

public String toString()

Overrides:

toString in class Object

doBuildFinish

protected boolean doBuildFinish()

Overrides:

doBuildFinish in class BaseRunningBuild

finishedOnOtherNode

public void finishedOnOtherNode()

Specified by:

finishedOnOtherNode in interface RunningBuildEx

Overrides:

finishedOnOtherNode in class BaseRunningBuild

runUnlessFinished

public boolean runUnlessFinished(@NotNull
                                 Runnable action)

Description copied from interface: RunningBuildEx

Executes specified runnable if build is not finished. Build won't finish until runnable completes.

Specified by:

runUnlessFinished in interface RunningBuildEx

Parameters:

action - runnable

Returns:

true if runnable was executed

getStatusDescriptor

public StatusDescriptor getStatusDescriptor()

Description copied from interface: Build

Returns status descriptor of the build

Specified by:

getStatusDescriptor in interface Build

Returns:

Descriptor of the current status of the build

getCachedShortStatistics

@Nullable
public ShortStatistics getCachedShortStatistics(boolean calculateIfAbsent)

Description copied from interface: BuildEx

Return cached short statistics for this build.

Specified by:

getCachedShortStatistics in interface BuildEx

Parameters:

calculateIfAbsent - if true, then statistics is calculated if it is not cached yet, if false and there is no statistics in cache, then null is returned

Returns:

see above

updateBuild

public void updateBuild()

Specified by:

updateBuild in interface RunningBuildEx

updateBuildInfo

public boolean updateBuildInfo()

Description copied from interface: RunningBuildEx

Loads build interruption and build finish timestamps from database into the build. Returns true if running build exists in DB and false otherwise.

Specified by:

updateBuildInfo in interface RunningBuildEx

clearCachedEstimate

@TestOnly
public void clearCachedEstimate()

getProjectId

@Nullable
public String getProjectId()

Description copied from interface: Build

Returns internal id of the project this build belongs to. Same as getBuildType().getProjectId().

Specified by:

getProjectId in interface Build

Returns:

internal id of the project this build belongs to. Same as getBuildType().getProjectId().

getProjectExternalId

@Nullable
public String getProjectExternalId()

Description copied from interface: Build

Returns external id of the project this build belongs to. Same as getBuildType().getProjectId().

Specified by:

getProjectExternalId in interface Build

Returns:

external id of the project this build belongs to. Same as getBuildType().getProjectId().

getAgentName

@NotNull
public String getAgentName()

Description copied from interface: Build

Returns agent name where build is running or happened to run if finished.

Specified by:

getAgentName in interface Build

Returns:

Agent name where build has been started on

setStartTimes

public void setStartTimes(@NotNull
                          Date agentStartTime,
                          @NotNull
                          Date serverStartTime,
                          @NotNull
                          TimeZone agentTimeZone)

Description copied from interface: RunningBuildEx

Sets timestamps when command to run build was sent to an agent.

Specified by:

setStartTimes in interface RunningBuildEx

Parameters:

agentStartTime - agent timestamp

serverStartTime - server timestamp

getCompletedPercent

public int getCompletedPercent()

Specified by:

getCompletedPercent in interface SRunningBuild

Returns:

completed percentage for the build according to build duration estimated time. or -1 if there is no estimate

getCompletedPercent

public int getCompletedPercent(long currentTime)

getEstimationForTimeLeft

public long getEstimationForTimeLeft()

Description copied from interface: RunningBuild

Returns server estimation for this build remaining time.

Specified by:

getEstimationForTimeLeft in interface RunningBuild

Specified by:

getEstimationForTimeLeft in interface RunningBuildInfo

Returns:

estimation for time left to finish the build in seconds or -1 if estimate is not available.

getBuildPromotionInfo

@NotNull
public BuildPromotionInfo getBuildPromotionInfo()

Specified by:

getBuildPromotionInfo in interface RunningBuildInfo

Returns:

Returns build promotion, associated with this running build

occupiesAgent

public boolean occupiesAgent()

Specified by:

occupiesAgent in interface RunningBuildInfo

Returns:

true if the build executes on the agent.

getEstimationForTimeLeft

public long getEstimationForTimeLeft(long currentTime)

isFinishReceived

public boolean isFinishReceived()

Specified by:

isFinishReceived in interface RunningBuildEx

Returns:

true if build finished was received by the server.

publishArtifact

public final void publishArtifact(@NotNull
                                  String path,
                                  @NotNull
                                  byte[] content)
                           throws IOException

Description copied from interface: RunningBuildEx

Adds artifact to the build by the specified path

Specified by:

publishArtifact in interface RunningBuildEx

Parameters:

path - path where to store artifact

content - artifact content

Throws:

IOException

publishArtifact

public final void publishArtifact(@NotNull
                                  String path,
                                  @NotNull
                                  File srcFile)
                           throws IOException

Description copied from interface: RunningBuildEx

Adds artifact to the build by the specified path

Specified by:

publishArtifact in interface RunningBuildEx

Parameters:

path - path where to store artifact

srcFile - file containing artifact content; note that after the publishing srcFile can be removed

Throws:

IOException

publishArtifact

public final void publishArtifact(@NotNull
                                  String path,
                                  @NotNull
                                  File srcFile,
                                  @Nullable
                                  PublishArtifactProgressListener progressListener)
                           throws IOException

Description copied from interface: RunningBuildEx

Adds artifact to the build from the specified file allowing to trace progress

Specified by:

publishArtifact in interface RunningBuildEx

Parameters:

path - path where to store artifact

srcFile - file containing artifact content; note that after the publishing srcFile can be removed

progressListener - PublishArtifactProgressListener to track progress

Throws:

IOException

publishArtifact

public final void publishArtifact(@NotNull
                                  String path,
                                  @NotNull
                                  InputStream is)
                           throws IOException

Description copied from interface: RunningBuildEx

Adds artifact to the build by the specified path

Specified by:

publishArtifact in interface RunningBuildEx

Parameters:

path - path where to store artifact

Throws:

IOException

publishArtifact

public final void publishArtifact(@NotNull
                                  String path,
                                  @NotNull
                                  InputStream source,
                                  @Nullable
                                  PublishArtifactProgressListener progressListener)
                           throws IOException

Description copied from interface: RunningBuildEx

Adds artifact to the build from the specified stream allowing to trace progress

Specified by:

publishArtifact in interface RunningBuildEx

Parameters:

path - path where to store artifact

progressListener - PublishArtifactProgressListener to track progress

Throws:

IOException

getDurationEstimate

public long getDurationEstimate()

Description copied from interface: RunningBuild

Returns server estimation for this build duration in seconds.

Specified by:

getDurationEstimate in interface RunningBuild

Returns:

build duration estimation in seconds or -1 if estimate is not available.

getDurationOvertime

public long getDurationOvertime()

Description copied from interface: RunningBuild

Returns how much in seconds this build duration exceeded estimated duration.

Specified by:

getDurationOvertime in interface RunningBuild

Returns:

how much in seconds this build duration exceeded estimated duration or -1 if estimate is not available.

getEstimatedDurationExceededTime

public long getEstimatedDurationExceededTime(long currentTime)

getElapsedTime

public long getElapsedTime()

Description copied from interface: RunningBuild

Returns elapsed time for this build.

Specified by:

getElapsedTime in interface RunningBuild

Returns:

elapsed time for this build in seconds.

getElapsedTime

public long getElapsedTime(long currentTime)

getBuildNumber

@NotNull
public String getBuildNumber()

Description copied from interface: Build

Returns build number in the user defined format (unresolved parameters in build number will be replaced with '???').

Specified by:

getBuildNumber in interface Build

Returns:

presentable build number

setBuildNumber

public void setBuildNumber(@NotNull
                           String newBuildNumber)

Description copied from interface: SRunningBuild

Set new value for this build build number instead of current one. If newBuildNumber has pattern {build.number}, it is replaced with the current build number

Specified by:

setBuildNumber in interface SRunningBuild

Parameters:

newBuildNumber - new value for this build build number

getTestMessages

public List<TestInfo> getTestMessages(int skipTests,
                                      int maxTestsToLoad)

Description copied from interface: Build

Retrieves information about tests failed in the build. Note that for running build currently executing test will be added to the list too.

Specified by:

getTestMessages in interface Build

Overrides:

getTestMessages in class BaseBuild

Parameters:

skipTests - index/order number of the first test to load (zero based)

maxTestsToLoad - indicates how many tests to load, -1 to load all

Returns:

list of plain messages

isFinished

public boolean isFinished()

Specified by:

isFinished in interface Build

Returns:

true if the build was finished and was saved to the history

getBuildLog

@NotNull
public BuildLogEx getBuildLog()

Description copied from interface: SBuild

Returns build log.

Specified by:

getBuildLog in interface BuildEx

Specified by:

getBuildLog in interface RunningBuildEx

Specified by:

getBuildLog in interface SBuild

Returns:

build log.

getBuildLogIfInitialized

@Nullable
public BuildLogEx getBuildLogIfInitialized()

Specified by:

getBuildLogIfInitialized in interface RunningBuildEx

getAgentAccessCode

public String getAgentAccessCode()

Description copied from interface: SRunningBuild

Returns access code which can be used by agent to access server resources by HTTP.

Specified by:

getAgentAccessCode in interface SRunningBuild

Returns:

access code

createAgentBuild

@NotNull
public AgentBuild createAgentBuild()
                            throws BuildTypeNotFoundException

Description copied from interface: RunningBuildEx

Creates structure containing all of the parameters which should be sent to an agent

Specified by:

createAgentBuild in interface RunningBuildEx

Returns:

Throws:

BuildTypeNotFoundException

getRawBuildNumber

public String getRawBuildNumber()

Description copied from interface: SBuild

Returns raw build number (i.e. build number with unresolved parameters if they exist) in contradistinction to Build.getBuildNumber() method which will return build number with all unresolved parameters replaced with ???.

Specified by:

getRawBuildNumber in interface SBuild

Specified by:

getRawBuildNumber in class BaseBuild

Returns:

raw build number which can contain unresolved parameters

getBuildCounter

public long getBuildCounter()

Specified by:

getBuildCounter in interface RunningBuildEx

Specified by:

getBuildCounter in class BaseBuild

Returns:

value of build counter when this build started

isProbablyHanging

public boolean isProbablyHanging()

Description copied from interface: SRunningBuild

Returns true if server thinks this build has hung. The build is considered hung if its estimate is exceeded and there were no messages from this build for some time.

Specified by:

isProbablyHanging in interface SRunningBuild

Returns:

true if build is probably hanging

computeProbablyHanging

public boolean computeProbablyHanging(long currentTime)

getLastBuildActivityTimestamp

public Date getLastBuildActivityTimestamp()

Specified by:

getLastBuildActivityTimestamp in interface SRunningBuild

Returns:

timestamp of last message received from a build.

getTimeSpentSinceLastBuildActivity

public long getTimeSpentSinceLastBuildActivity()

Description copied from interface: SRunningBuild

Returns time in seconds spent since last build activity.

Specified by:

getTimeSpentSinceLastBuildActivity in interface SRunningBuild

Returns:

time in seconds

start

public void start(boolean async)

Description copied from interface: RunningBuildEx

Must be invoked only once when build starts.

Specified by:

start in interface RunningBuildEx

isStarting

public boolean isStarting()

Description copied from interface: RunningBuildEx

Returns true if the build is trying to start on an agent and runBuild() command has not finished yet

Specified by:

isStarting in interface RunningBuildEx

Returns:

stop

public void stop(@NotNull
                 RunningBuildState interruptedState,
                 @Nullable
                 User user,
                 @NotNull
                 String comment,
                 boolean reAdd2Queue)

Specified by:

stop in interface RunningBuildEx

Parameters:

interruptedState - how to interrupt the build, should have interrupted status

user - optional user who stops the build

comment - comment for build interruption

reAdd2Queue - if true, the build will be re-added to queue with the same build promotion (to the end of the queue)

finish

public void finish(@NotNull
                   Date finishDate)

Description copied from interface: SRunningBuild

Finalizes all build related activities and finishes the build. Build must be finished on agent. Takes no effect for already finished or interrupted builds.

Specified by:

finish in interface SRunningBuild

Parameters:

finishDate - finish date

stopNoInterrupt

public final void stopNoInterrupt()

Description copied from interface: RunningBuildEx

Stops build on server and on agent without making it interrupted

Specified by:

stopNoInterrupt in interface RunningBuildEx

buildPatch

public void buildPatch(OutputStream stream,
                       @NotNull
                       FullCheckoutFlag fullCheckoutFlag,
                       boolean personalChanges,
                       @NotNull
                       AgentCheckoutDirRevisionInfo workDirState)
                throws IOException

Specified by:

buildPatch in interface RunningBuildEx

Throws:

IOException

buildPersonalPatch

public void buildPersonalPatch(OutputStream stream,
                               long personalChangeId,
                               @NotNull
                               AgentCheckoutDirRevisionInfo workDirState)
                        throws IOException

Specified by:

buildPersonalPatch in interface RunningBuildEx

Throws:

IOException

getAgentId

public int getAgentId()

Specified by:

getAgentId in interface SRunningBuild

Returns:

id of the agent where this build is running; returns -1 for agent less builds

getBuildOwnParameters

@NotNull
public Map<String,String> getBuildOwnParameters()

Description copied from interface: SBuild

Returns map of parameters (configuration params, system properties and environment variables) excluding parameters provided by extensions.

Specified by:

getBuildOwnParameters in interface SBuild

Overrides:

getBuildOwnParameters in class BaseBuild

Returns:

set of build parameters known on the server-side for the build.

getTestRunMuter

@NotNull
public TestRunMuter getTestRunMuter()

Description copied from interface: RunningBuildEx

Returns a special service that allows to mute test run if neccessary.

Specified by:

getTestRunMuter in interface RunningBuildEx

Returns:

an instance of the test run muter.

getUserDataStorage

@NotNull
public UserDataStorage getUserDataStorage()

Description copied from interface: RunningBuildEx

Use this object to associate some data with the current instance. Stored data is not persisted and is not copied to another instance of the given object.

Specified by:

getUserDataStorage in interface RunningBuildEx

Returns:

user data holder

setBuildStatus

public void setBuildStatus(Status status)

Description copied from interface: SRunningBuild

Set current status of the running build. Useful before build finish to update build status.

Specified by:

setBuildStatus in interface SRunningBuild

Parameters:

status - new status of the build

muteBuildProblems

public void muteBuildProblems(boolean muteIfTrue)

Description copied from interface: BuildEx

Makes all existing build problems enabled or disabled

Specified by:

muteBuildProblems in interface BuildEx

Overrides:

muteBuildProblems in class BaseBuild

Parameters:

muteIfTrue - pass true to make build successful, false to make existing problems visible again

markAsFinished

public void markAsFinished(@NotNull
                           Date finishDate,
                           boolean failed)

Specified by:

markAsFinished in interface RunningBuildEx

markAsFinishedUnexpectedly

public void markAsFinishedUnexpectedly(@NotNull
                                       String reason)

Specified by:

markAsFinishedUnexpectedly in interface RunningBuildEx

finishImmediately

public void finishImmediately(@NotNull
                              Date finishDate,
                              boolean failed)

Description copied from interface: RunningBuildEx

For tests only!

Specified by:

finishImmediately in interface RunningBuildEx

resetAgentCache

public void resetAgentCache()

Description copied from interface: RunningBuildEx

Resets internal cache of agent instance

Specified by:

resetAgentCache in interface RunningBuildEx

serverStartup

public void serverStartup()

Specified by:

serverStartup in interface RunningBuildEx

serverShutdown

public void serverShutdown()

Specified by:

serverShutdown in interface RunningBuildEx

isCompositeBuild

public boolean isCompositeBuild()

Description copied from interface: SBuild

Returns true if this build is a composite build.

Specified by:

isCompositeBuild in interface SBuild

Returns:

see above

closeBuildLog

public void closeBuildLog()

Description copied from interface: RunningBuildEx

Closes the build log's root block, flushes messages and closes the build log

Specified by:

closeBuildLog in interface RunningBuildEx

getArtifactsLimit

@NotNull
public ArtifactsUploadLimit getArtifactsLimit()

Specified by:

getArtifactsLimit in interface RunningBuildEx

getRunnersState

@NotNull
public Map<String,Boolean> getRunnersState()
                                          throws BuildTypeNotFoundException

Specified by:

getRunnersState in interface RunningBuildEx

Throws:

BuildTypeNotFoundException

detachedFromAgent

public void detachedFromAgent()

Description copied from interface: RunningBuildEx

Should be called when the build has been detached from the agent and agent can start some other build

Specified by:

detachedFromAgent in interface RunningBuildEx