hudson.model.BuildHistory Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of hudson-core Show documentation
Contains the core Hudson code and view files to render HTML.
The newest version!
/*******************************************************************************
 *
 * Copyright (c) 2004-2013 Oracle Corporation.
 *
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *
 *  Roy Varghese
 *
 *******************************************************************************/ 
package hudson.model;

import java.util.Calendar;
import java.util.Date;
import java.util.List;

/**
 * Retrieve the history of {@link Run} objects associated with a {@link Job}.
 * 
 * Getting history records is a more light-weight than iterating through
 * {@link Run} objects.
 * 
 * @author Roy Varghese
 */
public interface BuildHistory, RunT extends Run> 
    extends BuildStatusInfo, Iterable> {
    
    
    Record getFirst();
    Record getLast();
    Record getLastCompleted();
    Record getLastFailed();
    Record getLastStable();
    Record getLastUnstable();
    Record getLastSuccessful();
    Record getLastUnsuccessful();
    List> getLastRecordsOverThreshold(int numberOfRecords, Result threshold);
    
    List> allRecords();
    

    /**
     * Summary of a single run or build.
     */        
    public interface Record,RunT extends Run> 
        extends BuildNavigator {
        int getNumber();
        
        JobT getParent();
        RunT getBuild();
        
        Result getResult();
        Run.State getState();
        
        long getTimeInMillis();
        Calendar getTimestamp();
        String getTimestampString();
        String getTimestampString2();
        
        Date getTime();
        long getDuration();
        
        String getBuiltOnNodeName();
        
        String getDisplayName();
        String getDescription();
        String getTruncatedDescription();
        String getFullDisplayName();
        String getUrl();
        
        Executor getExecutor();
        List getBadgeActions();
        
        
        Record getPrevious();
        Record getNext();
        
        Record getPreviousCompleted();
        Record getPreviousInProgress();
        Record getPreviousBuilt();
        Record getPreviousNotFailed();
        Record getPreviousFailed();
        Record getPreviousSuccessful();
        
        List> getPreviousOverThreshold(int numberOfRecords, Result threshold);
        
        
    }
}