jenkins.branch

Class BranchProjectFactory<P extends hudson.model.AbstractProject<P,R> & hudson.model.TopLevelItem,R extends hudson.model.AbstractBuild<P,R>>

java.lang.Object

hudson.model.AbstractDescribableImpl<BranchProjectFactory<?,?>>

jenkins.branch.BranchProjectFactory<P,R>

Type Parameters:

P - the type of the branch projects.

R - the type of the builds of the branch projects.

All Implemented Interfaces:

hudson.model.Describable<BranchProjectFactory<?,?>>, hudson.model.Saveable

public abstract class BranchProjectFactory<P extends hudson.model.AbstractProject<P,R> & hudson.model.TopLevelItem,R extends hudson.model.AbstractBuild<P,R>>
extends hudson.model.AbstractDescribableImpl<BranchProjectFactory<?,?>>
implements hudson.model.Saveable

Creates instances of the branch projects for a specific Branch and also provides some utility methods for updating the branch specific projects.

Author:

Stephen Connolly

Field Summary

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

Constructors

Constructor and Description
BranchProjectFactory()

Method Summary

Methods

Modifier and Type	Method and Description
P	asProject(hudson.model.Item item) Casts the Item into the project type supported by this BranchProjectFactory.
abstract Branch	getBranch(P project) Gets the Branch that a specific project was configured for.
MultiBranchProject<P,R>	getOwner() Gets the current owner.
jenkins.scm.api.SCMRevision	getRevision(P project) Gets the SCMRevision that the project was last built for.
abstract boolean	isProject(hudson.model.Item item) Test if the specified Item is the branch project type supported by this BranchProjectFactory
abstract P	newInstance(Branch branch) Creates a new branch project.
void	save() Saves the BranchProjectFactory
abstract P	setBranch(P project, Branch branch) Replace the Branch that a project was configured for with a new updated Branch.
void	setOwner(MultiBranchProject<P,R> owner) Sets the owner.
void	setRevisionHash(P project, jenkins.scm.api.SCMRevision revision) Sets the SCMRevision that the project was last built for.

Methods inherited from class hudson.model.AbstractDescribableImpl

getDescriptor

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BranchProjectFactory

public BranchProjectFactory()

Method Detail

newInstance

public abstract P newInstance(Branch branch)

Creates a new branch project.

Parameters:

branch - the branch.

Returns:

the new branch project instance.

save

public void save()
          throws IOException

Saves the BranchProjectFactory

Specified by:

save in interface hudson.model.Saveable

Throws:

IOException - if issues saving.

setOwner

public void setOwner(MultiBranchProject<P,R> owner)

Sets the owner.

Parameters:

owner - the owner.

getOwner

public MultiBranchProject<P,R> getOwner()

Gets the current owner.

Returns:

the current owner.

getBranch

@NonNull
public abstract Branch getBranch(@NonNull
                       P project)

Gets the Branch that a specific project was configured for.

Parameters:

project - the project.

Returns:

the Branch that the project was configured for.

setBranch

@NonNull
public abstract P setBranch(@NonNull
                  P project,
                  @NonNull
                  Branch branch)

Replace the Branch that a project was configured for with a new updated Branch.

Parameters:

project - the project.

branch - the new branch.

Returns:

the project.

isProject

public abstract boolean isProject(@CheckForNull
                hudson.model.Item item)

Test if the specified Item is the branch project type supported by this BranchProjectFactory

Parameters:

item - the Item

Returns:

true if and only if the Item is a project supported by this BranchProjectFactory.

asProject

@NonNull
public P asProject(@NonNull
                  hudson.model.Item item)

Casts the Item into the project type supported by this BranchProjectFactory.

Parameters:

item - the Item.

Returns:

the Item upcast to the project type supported by this BranchProjectFactory.

getRevision

@CheckForNull
public jenkins.scm.api.SCMRevision getRevision(P project)

Gets the SCMRevision that the project was last built for.

Parameters:

project - the project.

Returns:

the SCMRevision of the last build.

setRevisionHash

public void setRevisionHash(P project,
                   jenkins.scm.api.SCMRevision revision)
                     throws IOException

Sets the SCMRevision that the project was last built for.

Parameters:

project - the project.

revision - the SCMRevision of the last build.

Throws:

IOException - if there was an issue persisting the details.