Class DefaultBuildChooser

    • Constructor Detail

      • DefaultBuildChooser

        @DataBoundConstructor
        public DefaultBuildChooser()
    • Method Detail

      • getCandidateRevisions

        public Collection<hudson.plugins.git.Revision> getCandidateRevisions​(boolean isPollCall,
                                                                             String branchSpec,
                                                                             org.jenkinsci.plugins.gitclient.GitClient git,
                                                                             TaskListener listener,
                                                                             BuildData data,
                                                                             BuildChooserContext context)
                                                                      throws hudson.plugins.git.GitException,
                                                                             IOException,
                                                                             InterruptedException
        Determines which Revisions to build. If only one branch is chosen and only one repository is listed, then just attempt to find the latest revision number for the chosen branch. If multiple branches are selected or the branches include wildcards, then use the advanced usecase as defined in the getAdvancedCandidateRevisions method.
        Overrides:
        getCandidateRevisions in class BuildChooser
        Parameters:
        isPollCall - true if this method is called from pollChanges.
        branchSpec - contains the name of a single branch to be built this will be non-null only in the simple case, in advanced cases with multiple repositories and/or branches specified then this value will be null.
        git - Used for invoking Git
        listener - build log
        data - build data to be used Information that captures what we did during the last build.
        context - Object that provides access back to the model object. This is because the build chooser can be invoked on an agent where there's no direct access to the build/project for which this is invoked. If isPollCall is false, then call back to both project and build are available. If isPollCall is true, then only the callback to the project is available as there's no contextual build object.
        Returns:
        the candidate revision. Can be an empty set to indicate that there's nothing to build.
        Throws:
        IOException - on input or output error
        hudson.plugins.git.GitException - on git error
        InterruptedException - when interrupted