com.atlassian.bamboo.resultsummary

Interface AgentResultsSummaryManager

All Known Implementing Classes:

AgentBuildResultsSummaryManagerImpl

@PublicApi
public interface AgentResultsSummaryManager

Manager relating to BuildResultsSummary when filtering by agent

Method Summary

Modifier and Type	Method and Description
long	calculateUtilisedAgentTime(long agentId) Calculates the time spent performing builds of an agent.
int	countBuildResultsSummariesForAgent(@NotNull BuildAgent buildAgent)
int	countFailedBuildResultsSummariesForAgent(@NotNull BuildAgent buildAgent)
@NotNull List<BuildResultsSummary>	getAllBuildResultsSummariesForAgent(@NotNull Long agentId) Returns all BuildResultsSummary for the passed BuildAgent's id.
@NotNull List<BuildResultsSummary>	getBuildResultsSummariesForAgent(@NotNull Long agentId, int firstResult, int maxResult) Returns a list of BuildResultsSummary for the passed BuildAgent's id in the given range.
@Nullable BuildResultsSummary	getLastBuildForAgent(@NotNull String planKey, @NotNull Long agentId)
@Nullable BuildResultsSummary	getLastSuccessfulBuildForAgent(@NotNull String planKey, @NotNull Long agentId)
@NotNull List<BuildResultsSummary>	getLatestSummariesForAgent(@NotNull Long agentId, @NotNull Date fromDate) Retrieves build summaries for agent id not older than certain date.
@NotNull List<BuildResultsSummary>	getLatestSummariesForAgent(@NotNull Long agentId, int maxCount) Retrieves n last build summaries for agent.
@Nullable BuildResultsSummary	getLatestSummaryForAgent(long agentId)
long	getNumberOfSummariesForAgent(long agentId) Retrieves the total count of build summaries executed on an agent.

Method Detail

getLastBuildForAgent

@Nullable
@Nullable BuildResultsSummary getLastBuildForAgent(@NotNull
                                                             @NotNull String planKey,
                                                             @NotNull
                                                             @NotNull Long agentId)

getLastSuccessfulBuildForAgent

@Nullable
@Nullable BuildResultsSummary getLastSuccessfulBuildForAgent(@NotNull
                                                                       @NotNull String planKey,
                                                                       @NotNull
                                                                       @NotNull Long agentId)

countBuildResultsSummariesForAgent

int countBuildResultsSummariesForAgent(@NotNull
                                       @NotNull BuildAgent buildAgent)

countFailedBuildResultsSummariesForAgent

int countFailedBuildResultsSummariesForAgent(@NotNull
                                             @NotNull BuildAgent buildAgent)

getAllBuildResultsSummariesForAgent

@NotNull
@NotNull List<BuildResultsSummary> getAllBuildResultsSummariesForAgent(@NotNull
                                                                                @NotNull Long agentId)

Returns all BuildResultsSummary for the passed BuildAgent's id.

Parameters:

agentId - id of the agent to get the result summaries for

Returns:

all BuildResultsSummary for the passed BuildAgent's id.

getBuildResultsSummariesForAgent

@NotNull
@NotNull List<BuildResultsSummary> getBuildResultsSummariesForAgent(@NotNull
                                                                             @NotNull Long agentId,
                                                                             int firstResult,
                                                                             int maxResult)

Returns a list of BuildResultsSummary for the passed BuildAgent's id in the given range.

Parameters:

agentId -

firstResult -

maxResult -

Returns:

getNumberOfSummariesForAgent

long getNumberOfSummariesForAgent(long agentId)

Retrieves the total count of build summaries executed on an agent.

Parameters:

agentId - id of an agent

Returns:

number of summaries

getLatestSummariesForAgent

@NotNull
@NotNull List<BuildResultsSummary> getLatestSummariesForAgent(@NotNull
                                                                       @NotNull Long agentId,
                                                                       @NotNull
                                                                       @NotNull Date fromDate)

Retrieves build summaries for agent id not older than certain date.

Parameters:

agentId - id of an agent

fromDate - beginning of the search period

Returns:

List of BuildResultsSummary

getLatestSummariesForAgent

@NotNull
@NotNull List<BuildResultsSummary> getLatestSummariesForAgent(@NotNull
                                                                       @NotNull Long agentId,
                                                                       int maxCount)

Retrieves n last build summaries for agent.

Parameters:

agentId - id of an agent

maxCount - maximum number of elements to retrieve

Returns:

List of BuildResultsSummary

getLatestSummaryForAgent

@Nullable
@Nullable BuildResultsSummary getLatestSummaryForAgent(long agentId)

calculateUtilisedAgentTime

long calculateUtilisedAgentTime(long agentId)

Calculates the time spent performing builds of an agent.

Parameters:

agentId -

Returns: