Package io.jenkins.plugins.casc.core

Class ItemsRootConfigurator

java.lang.Object

io.jenkins.plugins.casc.core.ItemsRootConfigurator

All Implemented Interfaces:

Configurator<Jenkins>, RootElementConfigurator<Jenkins>

@Extension
public class ItemsRootConfigurator
extends Object
implements RootElementConfigurator<Jenkins>

Field Summary

Fields inherited from interface io.jenkins.plugins.casc.RootElementConfigurator

LOGGER

Constructor Summary

Constructors

Constructor	Description
ItemsRootConfigurator()

Method Summary

Modifier and Type	Method	Description
Jenkins	check(CNode config, ConfigurationContext context)	Run the same logic as Configurator.configure(CNode, ConfigurationContext) in dry-run mode.
Jenkins	configure(CNode config, ConfigurationContext context)	Configures/creates a Jenkins object based on a tree.
Set<Attribute<Jenkins,?>>	describe()	Determine the list of Attribute available for configuration of the managed component.
CNode	describe(Jenkins instance, ConfigurationContext context)	Describe a component as a Configuration Nodes CNode to be exported as yaml.
String	getName()	Get a configurator name.
Class<Jenkins>	getTarget()	Target type this configurator can handle.
Jenkins	getTargetComponent(ConfigurationContext context)	Retrieve the target component managed by this RootElementConfigurator

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.jenkins.plugins.casc.Configurator

canConfigure, describeStructure, getAttributes, getConfigurators, getDisplayName, getImplementedAPI, getNames

Methods inherited from interface io.jenkins.plugins.casc.RootElementConfigurator

isRootElement

Constructor Details

ItemsRootConfigurator

public ItemsRootConfigurator()

Method Details

getName

@NonNull
public String getName()

Description copied from interface: Configurator

Get a configurator name. This should return the default name for the configurator, used for exporting yaml see Configurator.getNames() for all possible names which will be considered when configuring.

Specified by:

getName in interface Configurator<Jenkins>

Returns:

short name for this component when used in a configuration.yaml file

getTarget

public Class<Jenkins> getTarget()

Description copied from interface: Configurator

Target type this configurator can handle.

Specified by:

getTarget in interface Configurator<Jenkins>

getTargetComponent

public Jenkins getTargetComponent(ConfigurationContext context)

Description copied from interface: RootElementConfigurator

Retrieve the target component managed by this RootElementConfigurator

Specified by:

getTargetComponent in interface RootElementConfigurator<Jenkins>

Parameters:

context -

Returns:

configure

@NonNull
public Jenkins configure(CNode config,
 ConfigurationContext context)
                  throws ConfiguratorException

Description copied from interface: Configurator

Configures/creates a Jenkins object based on a tree.

Specified by:

configure in interface Configurator<Jenkins>

Parameters:

config - Map/List/primitive objects (think YAML) that represents the configuration from which a Jenkins object is configured.

context - Fully configured Jenkins object used as the starting point for this configuration.

Returns:

Fully configured Jenkins object that results from this configuration. if no new objects got created, but some existing objects may have been modified, return updated target object.

Throws:

ConfiguratorException - if something went wrong, depends on the concrete implementation

check

public Jenkins check(CNode config,
 ConfigurationContext context)
              throws ConfiguratorException

Description copied from interface: Configurator

Run the same logic as Configurator.configure(CNode, ConfigurationContext) in dry-run mode. Used to verify configuration is fine before being actually applied to a live jenkins controller.

Specified by:

check in interface Configurator<Jenkins>

Parameters:

config - Map/List/primitive objects (think YAML) that represents the configuration from which a Jenkins object is configured.

context - Fully configured Jenkins object used as the starting point for this configuration.

Throws:

ConfiguratorException - on configuration error

describe

public CNode describe(Jenkins instance,
 ConfigurationContext context)

Description copied from interface: Configurator

Describe a component as a Configuration Nodes CNode to be exported as yaml. Only export attributes which are not set to default value.

Specified by:

describe in interface Configurator<Jenkins>

describe

@NonNull
public Set<Attribute<Jenkins,?>> describe()

Description copied from interface: Configurator

Determine the list of Attribute available for configuration of the managed component.

Specified by:

describe in interface Configurator<Jenkins>

Returns:

A set of Attributes that describes this object