Package jetbrains.buildServer.serverSide

Interface SQueuedBuild

All Superinterfaces:

BuildPromotionOwner, CompatibleAgents, QueuedBuild

All Known Subinterfaces:

QueuedBuildEx

All Known Implementing Classes:

QueuedBuildImpl, SecuredQueuedBuild

public interface SQueuedBuild
extends QueuedBuild, BuildPromotionOwner, CompatibleAgents

Build in the queue object.

Method Summary

Modifier and Type	Method	Description
SBuildAgent	getBuildAgent()	Deprecated. use QueuedBuild.getAgentRestrictor().
BuildEstimates	getBuildEstimates()	Returns a BuildEstimates object describing the estimated values of the pending build.
SBuildType	getBuildType()
List<SBuildAgent>	getCanRunOnAgents()	Returns agents this build can run on
Map<SBuildAgent,CompatibilityResult>	getCompatibilityMap()	Returns compatibility map, key is an agent and value is compatibility result.
String	getRequestor()	Deprecated. see getTriggeredBy()
TriggeredBy	getTriggeredBy()	Returns details about who and how added this build in queue.
void	removeFromQueue(User user, String comment)	Removes this queued build from the build queue

Methods inherited from interface jetbrains.buildServer.serverSide.BuildPromotionOwner

getBuildPromotion, getSequenceBuild

Methods inherited from interface jetbrains.buildServer.serverSide.CompatibleAgents

getAgentCompatibility, getCompatibleAgents

Methods inherited from interface jetbrains.buildServer.QueuedBuild

getAgentRestrictor, getBuildAgentId, getBuildTypeId, getItemId, getOrderNumber, getWhenQueued, isPersonal

Method Detail

getBuildType

@NotNull
SBuildType getBuildType()
                 throws BuildTypeNotFoundException

Returns:

build configuration object.

Throws:

BuildTypeNotFoundException - if build configuration to which this queued build corresponds does not exist

getCanRunOnAgents

@NotNull
List<SBuildAgent> getCanRunOnAgents()

Returns agents this build can run on

Returns:

agents this build can run on

getCompatibilityMap

@NotNull
Map<SBuildAgent,CompatibilityResult> getCompatibilityMap()

Description copied from interface: CompatibleAgents

Returns compatibility map, key is an agent and value is compatibility result.

Specified by:

getCompatibilityMap in interface CompatibleAgents

Returns:

compatible agents map

getBuildAgent

@Deprecated
@Nullable
SBuildAgent getBuildAgent()

Deprecated.

use QueuedBuild.getAgentRestrictor(). Returns actual agent to which build configuration is scheduled or null if there is no such agent or build configuration is not scheduled to a specific agent.

Returns:

build agent to run build on or null

getBuildEstimates

@Nullable
BuildEstimates getBuildEstimates()

Returns a BuildEstimates object describing the estimated values of the pending build. The returned time interval can be open, that is it doesn't contain the finish estimate (getEndPoint() returns null) in case of inability to estimate build duration. The time base for the time interval is the moment of invocation (with some accuracy).

Returns:

null if the times cannot be estimated or the build isn't in the queue.

removeFromQueue

void removeFromQueue(@Nullable
                     User user,
                     String comment)

Removes this queued build from the build queue

Parameters:

user - user who initiated remove

comment - comment

getRequestor

@Deprecated
@NotNull
String getRequestor()

Deprecated.

see getTriggeredBy()

Returns the reason, why configuration has been queued (for example, it might be trigger name, if configuration was triggered, of user name, it it was added to queue manually).

Returns:

string requestor.

getTriggeredBy

TriggeredBy getTriggeredBy()

Returns details about who and how added this build in queue.

Returns:

see above