jetbrains.buildServer.serverSide
Interface BuildsManager

All Superinterfaces:

RunningBuildsManager

All Known Subinterfaces:

SBuildServer

public interface BuildsManager
extends RunningBuildsManager

Since:

5.1

Method Summary

SBuild	findBuildInstanceByBuildNumber(java.lang.String buildTypeId, java.lang.String buildNumber) Returns the most recent build (ordered by changes) with the specified build number
SBuild	findBuildInstanceById(long buildId) Return the build which corresponds to given buildId.
java.util.Collection<SBuild>	findBuildInstances(java.util.Collection<java.lang.Long> buildIds) Returns collection of builds corresponding to the specified builds ids.
java.util.List<SBuild>	findBuildInstancesByBuildNumber(java.lang.String buildTypeId, java.lang.String buildNumber) Returns builds in specified build configuration id having the specified build number.
SBuild	findPreviousBuild(SBuild build) Finds a non personal build (running or finished) which was started before the specified build and contains same or previous changes than the specified build.
SBuild	findPreviousBuild(SBuild build, BuildDataFilter filter) Same as findPreviousBuild(jetbrains.buildServer.serverSide.SBuild) but searches for a previous build among builds accepted by the specified filter.

Methods inherited from interface jetbrains.buildServer.serverSide.RunningBuildsManager

findRunningBuildById, getNumberOfRunningBuilds, getRunningBuildOnAgent, getRunningBuilds, getRunningBuilds, getRunningStatus

Method Detail

findBuildInstanceById

@Nullable
SBuild findBuildInstanceById(long buildId)

Return the build which corresponds to given buildId. Build can be running, or it can be finished.

Parameters:

buildId - build identifier

Returns:

the build which corresponds to given buildId

See Also:

Build.isFinished(), findBuildInstanceByBuildNumber(String, String)

findPreviousBuild

@Nullable
SBuild findPreviousBuild(@NotNull
                                  SBuild build)

Finds a non personal build (running or finished) which was started before the specified build and contains same or previous changes than the specified build. The resulting build belongs to the same build configuration.

Parameters:

build - build to find previous build for

Returns:

previous build in same build configuration or null if there is no previous build

findPreviousBuild

@Nullable
SBuild findPreviousBuild(@NotNull
                                  SBuild build,
                                  @NotNull
                                  BuildDataFilter filter)

Same as findPreviousBuild(jetbrains.buildServer.serverSide.SBuild) but searches for a previous build among builds accepted by the specified filter. Previous mean containing previous changes or with same changes but started before this one.

Parameters:

build - build to find previous build for

filter - build filter

Returns:

previous build in same build configuration matching the specified filter or null if there is no previous build

findBuildInstances

java.util.Collection<SBuild> findBuildInstances(java.util.Collection<java.lang.Long> buildIds)

Returns collection of builds corresponding to the specified builds ids. Both running and finished builds can appear in the resulting collection. The collection will contain existing builds only. NOTE: RETURNED COLLECTION WILL NOT MAINTAIN REQUESTED ORDER!

Parameters:

buildIds - build identifiers to be searched for.

Returns:

see above

findBuildInstanceByBuildNumber

@Nullable
SBuild findBuildInstanceByBuildNumber(@NotNull
                                               java.lang.String buildTypeId,
                                               @NotNull
                                               java.lang.String buildNumber)

Returns the most recent build (ordered by changes) with the specified build number

Parameters:

buildTypeId - build configuration identifier

buildNumber - build number string

Returns:

see above

findBuildInstancesByBuildNumber

@NotNull
java.util.List<SBuild> findBuildInstancesByBuildNumber(@NotNull
                                                               java.lang.String buildTypeId,
                                                               @NotNull
                                                               java.lang.String buildNumber)

Returns builds in specified build configuration id having the specified build number. Builds are ordered by changes, i.e. the most recent build first. The list may contain personal builds too.

Parameters:

buildTypeId - build configuration id

buildNumber - build number

Returns:

see above

Since:

5.1.5