jenkins.model

Class ProjectNamingStrategy

java.lang.Object

jenkins.model.ProjectNamingStrategy

All Implemented Interfaces:

ExtensionPoint, Describable<ProjectNamingStrategy>

Direct Known Subclasses:

ProjectNamingStrategy.DefaultProjectNamingStrategy, ProjectNamingStrategy.PatternProjectNamingStrategy

public abstract class ProjectNamingStrategy
extends Object
implements Describable<ProjectNamingStrategy>, ExtensionPoint

This ExtensionPoint allows to enforce the name of projects/jobs.

Author:

Dominik Bartholdi (imod)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ProjectNamingStrategy.DefaultProjectNamingStrategy Default implementation which does not restrict the name to any form.
static class	ProjectNamingStrategy.PatternProjectNamingStrategy Naming strategy which allows the admin to define a pattern a job's name has to follow.
static class	ProjectNamingStrategy.ProjectNamingStrategyDescriptor

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field and Description
static ProjectNamingStrategy	DEFAULT_NAMING_STRATEGY The default naming strategy which does not restrict the name of a job.

Constructor Summary

Constructors

Constructor and Description
ProjectNamingStrategy()

Method Summary

Modifier and Type	Method and Description
static DescriptorExtensionList<ProjectNamingStrategy,ProjectNamingStrategy.ProjectNamingStrategyDescriptor>	all()
void	checkName(String name) Called when creating a new job.
ProjectNamingStrategy.ProjectNamingStrategyDescriptor	getDescriptor() Gets the descriptor for this instance.
boolean	isForceExistingJobs() This flag can be used to force existing jobs to be migrated to a new naming strategy - if this method returns true, the naming will be enforced at every config change.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_NAMING_STRATEGY

public static final ProjectNamingStrategy DEFAULT_NAMING_STRATEGY

The default naming strategy which does not restrict the name of a job.

Constructor Detail

ProjectNamingStrategy

public ProjectNamingStrategy()

Method Detail

getDescriptor

public ProjectNamingStrategy.ProjectNamingStrategyDescriptor getDescriptor()

Description copied from interface: Describable

Gets the descriptor for this instance.

Descriptor is a singleton for every concrete Describable implementation, so if a.getClass() == b.getClass() then by default a.getDescriptor() == b.getDescriptor() as well. (In rare cases a single implementation class may be used for instances with distinct descriptors.)

Specified by:

getDescriptor in interface Describable<ProjectNamingStrategy>

all

public static DescriptorExtensionList<ProjectNamingStrategy,ProjectNamingStrategy.ProjectNamingStrategyDescriptor> all()

checkName

public void checkName(String name)
               throws Failure

Called when creating a new job.

Parameters:

name - the name given from the UI

Throws:

Failure - if the user has to be informed about an illegal name, forces the user to change the name before submitting. The message of the failure will be presented to the user.

isForceExistingJobs

public boolean isForceExistingJobs()

This flag can be used to force existing jobs to be migrated to a new naming strategy - if this method returns true, the naming will be enforced at every config change. If false is returned, only new jobs have to follow the strategy.

Returns:

true if existing jobs should be enforced to confirm to the naming standard.