Package jetbrains.buildServer.serverSide

Interface HistoryBuild

  • All Known Implementing Classes:
    BuildBuilder.HistoryBuildStub, HistoryBuildSnapshot
    public interface HistoryBuild
    This interface is used to save build information to database. It is also used to provide information to build status string builder.

    • Method Detail

      • getBuildId

        long getBuildId()
        Returns:
        unique ID of the build

      • getBuildPromotion

        BuildPromotion getBuildPromotion()
        Returns promotion state associated with this build.
        Returns:
        see above

      • getBuildTypeId

        String getBuildTypeId()
        Returns:
        internal id of the build configuration

      • getProjectId

        String getProjectId()
        Returns:
        internal id of the project

      • getCanceledInfo

        @Nullable
CanceledInfo getCanceledInfo()
        Returns:
        build cancellation information if the build was cancelled, null otherwise

      • getFullName

        String getFullName()
        Returns:
        full name of the

      • getClientStartDate

        @Nullable
Date getClientStartDate()

      • convertToServerTime

        @NotNull
Date convertToServerTime​(@NotNull
                         Date clientTime)

      • getStartDate

        @NotNull
Date getStartDate()

      • getRemoveFromQueueDate

        @NotNull
Date getRemoveFromQueueDate()

      • getBuildStatus

        Status getBuildStatus()
        Returns:
        current build status (success, fail, etc)

      • getShortStatistics

        ShortStatistics getShortStatistics()
        Returns a "short" statistics for the build (including information about failed/successful tests, compilation errors), see ShortStatistics.

        This function doesn't guarantee that the returned statistics will actuial at this time. In opposite, if another thread is changing build informaition at the same time, this function returns a bit old data but does it quickly.

        This behaviour is needed because a lot of UI pages required this statistics, often for many build for one page, so making this function providing always actual data will couse a seriouse performance problem.

        Returns:
        short build statistics.

      • getBuildDescription

        @Nullable
String getBuildDescription()
        Returns:
        explicit build description line, which was set explicitly to the build, if such description exists and null otherwise.

      • getAgentName

        @NotNull
String getAgentName()
        Returns:
        build agent name which is build is run on

      • getAgentTypeId

        int getAgentTypeId()
        Returns:
        agent type id of the associated agent

      • isPersonal

        boolean isPersonal()
        Returns:
        true if this build is personal one, like remote run or pre-tested commit

      • getBuildNumber

        String getBuildNumber()
        Returns:
        build number

      • getRawTriggeredBy

        String getRawTriggeredBy()
        Returns:
        build trigger string (triggered by VCS, user, schedule etc)

      • getQueuedDate

        @NotNull
Date getQueuedDate()
        When the build was added to queue.
        Returns:
        build queued time.

      • getServerStartDate

        @NotNull
Date getServerStartDate()
        When the build was removed from queue and started.
        Returns:
        build start time on the server.

      • getFinalStatusText

        @NotNull
String getFinalStatusText()