Package 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	Description
static final class	ProjectNamingStrategy.DefaultProjectNamingStrategy	Default implementation which does not restrict the name to any form.
static final 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	Description
static final ProjectNamingStrategy	DEFAULT_NAMING_STRATEGY	The default naming strategy which does not restrict the name of a job.

Constructor Summary

Constructors

Constructor	Description
ProjectNamingStrategy()

Method Summary

Modifier and Type	Method	Description
static DescriptorExtensionList<ProjectNamingStrategy,ProjectNamingStrategy.ProjectNamingStrategyDescriptor>	all()
void	checkName(String name)	Deprecated. Use checkName(String, String)
void	checkName(String parentName, 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 Details

DEFAULT_NAMING_STRATEGY

public static final ProjectNamingStrategy DEFAULT_NAMING_STRATEGY

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

Constructor Details

ProjectNamingStrategy

public ProjectNamingStrategy()

Method Details

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.)

By default looks for a nested class (conventionally named DescriptorImpl) implementing Descriptor and marked with Extension.

Specified by:

getDescriptor in interface Describable<ProjectNamingStrategy>

all

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

checkName

@Deprecated
public void checkName(String name)
               throws Failure

Deprecated.

Use checkName(String, String)

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.

checkName

public void checkName(String parentName,
 String name)
               throws Failure

Called when creating a new job.

Parameters:

parentName - the full name of the parent ItemGroup

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.

Since:

2.367

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.