Package jenkins.scm.api.trait

Class SCMNavigatorTrait

java.lang.Object

hudson.model.AbstractDescribableImpl<T>

jenkins.scm.api.trait.SCMTrait<SCMNavigatorTrait>

jenkins.scm.api.trait.SCMNavigatorTrait

All Implemented Interfaces:

ExtensionPoint, Describable<SCMNavigatorTrait>

Direct Known Subclasses:

RegexSCMSourceFilterTrait, WildcardSCMSourceFilterTrait

public abstract class SCMNavigatorTrait
extends SCMTrait<SCMNavigatorTrait>

Represents a trait of behaviour or configuration that can be applied to a SCMSource.

Since:

2.2.0

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor	Description
SCMNavigatorTrait()

Method Summary

Modifier and Type	Method	Description
static List<SCMNavigatorTraitDescriptor>	_for(Class<? extends SCMNavigatorContext> contextClass, Class<? extends SCMSourceBuilder> builderClass)	Returns the subset of SCMNavigatorTraitDescriptor instances that are applicable to the specified types of SCMNavigatorContext and SCMSourceBuilder.
static List<SCMNavigatorTraitDescriptor>	_for(SCMNavigatorDescriptor scmNavigator, Class<? extends SCMNavigatorContext> contextClass, Class<? extends SCMSourceBuilder> builderClass)	Returns the subset of SCMNavigatorTraitDescriptor instances that are applicable to the specified SCMNavigatorDescriptor and specified types of SCMNavigatorContext and SCMSourceBuilder.
static DescriptorExtensionList<SCMNavigatorTrait,SCMNavigatorTraitDescriptor>	all()	Returns all the SCMNavigatorTraitDescriptor instances.
final void	applyToBuilder(SCMSourceBuilder<?,?> builder)	Applies this trait to the SCMBuilder.
final void	applyToContext(SCMNavigatorContext<?,?> context)	Applies this trait to the SCMNavigatorContext.
final SCMSourceObserver	applyToObserver(SCMSourceObserver observer)	Applies this trait to an observer for use during a SCMNavigatorRequest.
protected void	decorateBuilder(SCMSourceBuilder<?,?> builder)	SPI: Override this method to decorate a SCMBuilder.
protected void	decorateContext(SCMNavigatorContext<?,?> context)	SPI: Override this method to decorate a SCMNavigatorContext.
protected SCMSourceObserver	decorateObserver(SCMSourceObserver observer)	SPI: Override this method to decorate the SCMSourceObserver used during a SCMNavigatorRequest.
SCMNavigatorTraitDescriptor	getDescriptor()
protected boolean	includeCategory(SCMHeadCategory category)	SPI: Override this method to control whether specific SCMHeadCategory instances are required.
final boolean	isCategoryEnabled(SCMHeadCategory category)	Checks if the supplied category is required by this trait.

Methods inherited from class jenkins.scm.api.trait.SCMTrait

asSetList, asSetList, find

Methods inherited from class java.lang.Object

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

Constructor Details

SCMNavigatorTrait

public SCMNavigatorTrait()

Method Details

applyToContext

public final void applyToContext(SCMNavigatorContext<?,?> context)

Applies this trait to the SCMNavigatorContext.

Parameters:

context - the context.

decorateContext

protected void decorateContext(SCMNavigatorContext<?,?> context)

SPI: Override this method to decorate a SCMNavigatorContext. You can assume that your SCMNavigatorTraitDescriptor.isApplicableToContext(Class) is true within this method and that the provided context is an instance of SCMNavigatorTraitDescriptor.getContextClass().

Parameters:

context - the context (invariant: SCMNavigatorTraitDescriptor.isApplicableToContext(Class) is true and SCMNavigatorTraitDescriptor.getContextClass() Class.isInstance(Object)) is true)

applyToObserver

@NonNull
public final SCMSourceObserver applyToObserver(@NonNull
 SCMSourceObserver observer)

Applies this trait to an observer for use during a SCMNavigatorRequest.

Parameters:

observer - the observer.

Returns:

the supplied observer or a wrapped variant of it.

decorateObserver

@NonNull
protected SCMSourceObserver decorateObserver(@NonNull
 SCMSourceObserver observer)

SPI: Override this method to decorate the SCMSourceObserver used during a SCMNavigatorRequest.

Parameters:

observer - the observer.

Returns:

the supplied observer or a wrapped variant of it.

applyToBuilder

public final void applyToBuilder(SCMSourceBuilder<?,?> builder)

Applies this trait to the SCMBuilder.

Parameters:

builder - the builder.

decorateBuilder

protected void decorateBuilder(SCMSourceBuilder<?,?> builder)

SPI: Override this method to decorate a SCMBuilder. You can assume that your SCMNavigatorTraitDescriptor.isApplicableToBuilder(SCMSourceBuilder) is true within this method and that the provided builder is an instance of SCMNavigatorTraitDescriptor.getBuilderClass().

Parameters:

builder - the builder (invariant: SCMNavigatorTraitDescriptor.isApplicableToBuilder(SCMSourceBuilder) is true and SCMNavigatorTraitDescriptor.getBuilderClass() Class.isInstance(Object)) is true)

isCategoryEnabled

public final boolean isCategoryEnabled(@NonNull
 SCMHeadCategory category)

Checks if the supplied category is required by this trait.

Parameters:

category - the category.

Returns:

true if this trait requires the supplied category.

includeCategory

protected boolean includeCategory(@NonNull
 SCMHeadCategory category)

SPI: Override this method to control whether specific SCMHeadCategory instances are required.

Parameters:

category - the category.

Returns:

true to require the category.

getDescriptor

public SCMNavigatorTraitDescriptor getDescriptor()

Specified by:

getDescriptor in interface Describable<SCMNavigatorTrait>

Overrides:

getDescriptor in class SCMTrait<SCMNavigatorTrait>

all

public static DescriptorExtensionList<SCMNavigatorTrait,SCMNavigatorTraitDescriptor> all()

Returns all the SCMNavigatorTraitDescriptor instances.

Returns:

all the SCMNavigatorTraitDescriptor instances.

_for

public static List<SCMNavigatorTraitDescriptor> _for(@CheckForNull
 Class<? extends SCMNavigatorContext> contextClass,
 @CheckForNull
 Class<? extends SCMSourceBuilder> builderClass)

Returns the subset of SCMNavigatorTraitDescriptor instances that are applicable to the specified types of SCMNavigatorContext and SCMSourceBuilder.

Parameters:

contextClass - (optional) type of SCMNavigatorContext.

builderClass - (optional) type of SCMSourceBuilder.

Returns:

the list of matching SCMNavigatorTraitDescriptor instances.

_for

public static List<SCMNavigatorTraitDescriptor> _for(@CheckForNull
 SCMNavigatorDescriptor scmNavigator,
 @CheckForNull
 Class<? extends SCMNavigatorContext> contextClass,
 @CheckForNull
 Class<? extends SCMSourceBuilder> builderClass)

Returns the subset of SCMNavigatorTraitDescriptor instances that are applicable to the specified SCMNavigatorDescriptor and specified types of SCMNavigatorContext and SCMSourceBuilder.

Parameters:

scmNavigator - (optional) SCMNavigatorDescriptor.

contextClass - (optional) type of SCMNavigatorContext.

builderClass - (optional) type of SCMSourceBuilder.

Returns:

the list of matching SCMNavigatorTraitDescriptor instances.