Package com.evolveum.midpoint.schema.config

Class ConfigurationItem<T extends Serializable & Cloneable>

java.lang.Object

com.evolveum.midpoint.schema.config.ConfigurationItem<T>

All Implemented Interfaces:

Serializable, Cloneable

Direct Known Subclasses:

AbstractAssignmentConfigItem, AbstractPolicyRuleConfigItem, AutoAssignMappingConfigItem, AutoassignSpecificationConfigItem, ConstructionConfigItem, EventHandlerConfigItem, ExecuteScriptConfigItem, ExpressionConfigItem, ExpressionParameterConfigItem, FocalAutoassignSpecificationConfigItem, FunctionExpressionEvaluatorConfigItem, MappingConfigItem, MetadataMappingConfigItem, MultiSourceDataHandlingConfigItem, MultiSourceItemDefinitionConfigItem, ObjectSelectorConfigItem, ObjectTemplateItemDefinitionConfigItem, ObjectTemplateMappingConfigItem, PolicyActionConfigItem, ResourceAttributeDefinitionConfigItem, ResourceObjectAssociationConfigItem

@Experimental
public class ConfigurationItem<T extends Serializable & Cloneable>
extends Object
implements Serializable, Cloneable

Helper class that provides complex information about a configuration item (e.g., a mapping). Currently, the most prominent information is the origin of the item value.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final Object	DESC	Used as a convenience marker for fullDescription() in error messages.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ConfigurationItem(@NotNull ConfigurationItem<? extends T> original)	For internal use.
	ConfigurationItem(T value, @NotNull ConfigurationItemOrigin origin)

Method Summary

Modifier and Type	Method	Description
<X extends ConfigurationItem<T>> X	as(@NotNull Class<X> clazz)
protected static <V extends Serializable & Cloneable, CI extends RAW_CI, RAW_CI extends ConfigurationItem<V>> CI	as(RAW_CI value, @NotNull Class<CI> clazz)	Null-safe variant of as(Class).
static <T extends Serializable & Cloneable, X extends ConfigurationItem<T>> @NotNull List<X>	asList(@NotNull List<ConfigurationItem<T>> list, @NotNull Class<X> clazz)
protected <X extends Serializable & Cloneable, CI extends ConfigurationItem<X>> CI	child(X value, @NotNull Class<CI> clazz, Object... pathSegments)
protected <X extends Serializable & Cloneable> ConfigurationItem<X>	child(X value, Object... pathSegments)
ConfigurationItem<T>	clone()	Intentionally not calling super.clone, as the value is final (and we have to clone it); so we would have to hack this using reflection turning off the `final` flag.
void	configCheck(boolean value, String template, Object... arguments)	Checks the value, and if it's `false`, emits a ConfigurationException.
<V> V	configNonNull(V value, String template, Object... arguments)	As configCheck(boolean, String, Object...), but checks that the value is not null.
static <T extends Serializable & Cloneable> @NotNull ConfigurationItem<T>	embedded(T value)
boolean	equals(Object obj)
@NotNull String	fullDescription()
int	hashCode()
@NotNull String	localDescription()	To be overridden in specific subclasses.
static <T extends Serializable & Cloneable> @NotNull ConfigurationItem<T>	of(T value, @NotNull ConfigurationItemOrigin origin)
static <T extends Serializable & Cloneable> @NotNull List<ConfigurationItem<T>>	ofList(@NotNull List<T> items, @NotNull OriginProvider<? super T> originProvider)
static <T extends Serializable & Cloneable, X extends ConfigurationItem<T>> @NotNull List<X>	ofList(@NotNull List<T> items, @NotNull OriginProvider<? super T> originProvider, @NotNull Class<X> clazz)
static <T extends Serializable & Cloneable> @NotNull List<ConfigurationItem<T>>	ofListEmbedded(@NotNull List<T> items)
@NotNull ConfigurationItemOrigin	origin()
@NotNull ConfigurationItemOrigin	originFor(@NotNull ItemPath path)
<C extends Containerable> @NotNull OriginProvider<C>	originProviderFor(@NotNull ItemPath path)
String	toString()
T	value()

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

DESC

public static final Object DESC

Used as a convenience marker for fullDescription() in error messages.

Constructor Details

ConfigurationItem

protected ConfigurationItem(@NotNull
 @NotNull ConfigurationItem<? extends T> original)

For internal use.

ConfigurationItem

public ConfigurationItem(@NotNull
 T value,
 @NotNull
 @NotNull ConfigurationItemOrigin origin)

Method Details

of

@NotNull
public static <T extends Serializable & Cloneable>
@NotNull ConfigurationItem<T> of(@NotNull
 T value,
 @NotNull
 @NotNull ConfigurationItemOrigin origin)

embedded

@NotNull
public static <T extends Serializable & Cloneable>
@NotNull ConfigurationItem<T> embedded(@NotNull
 T value)

ofListEmbedded

@NotNull
public static <T extends Serializable & Cloneable>
@NotNull List<ConfigurationItem<T>> ofListEmbedded(@NotNull
 @NotNull List<T> items)

ofList

@NotNull
public static <T extends Serializable & Cloneable>
@NotNull List<ConfigurationItem<T>> ofList(@NotNull
 @NotNull List<T> items,
 @NotNull
 @NotNull OriginProvider<? super T> originProvider)

ofList

@NotNull
public static <T extends Serializable & Cloneable,
X extends ConfigurationItem<T>>
@NotNull List<X> ofList(@NotNull
 @NotNull List<T> items,
 @NotNull
 @NotNull OriginProvider<? super T> originProvider,
 @NotNull
 @NotNull Class<X> clazz)

value

@NotNull
public T value()

origin

@NotNull
public @NotNull ConfigurationItemOrigin origin()

originFor

@NotNull
public @NotNull ConfigurationItemOrigin originFor(@NotNull
 @NotNull ItemPath path)

originProviderFor

@NotNull
public <C extends Containerable>
@NotNull OriginProvider<C> originProviderFor(@NotNull
 @NotNull ItemPath path)

as

@Contract("null, _ -> null; !null, _ -> !null")
protected static <V extends Serializable & Cloneable,
CI extends RAW_CI,
RAW_CI extends ConfigurationItem<V>>
CI as(@Nullable
 RAW_CI value,
 @NotNull
 @NotNull Class<CI> clazz)

Null-safe variant of as(Class).

asList

@NotNull
public static <T extends Serializable & Cloneable,
X extends ConfigurationItem<T>>
@NotNull List<X> asList(@NotNull
 @NotNull List<ConfigurationItem<T>> list,
 @NotNull
 @NotNull Class<X> clazz)

as

@NotNull
public <X extends ConfigurationItem<T>> X as(@NotNull
 @NotNull Class<X> clazz)

child

@Contract("null, _, _ -> null; !null, _, _ -> !null")
protected <X extends Serializable & Cloneable,
CI extends ConfigurationItem<X>>
CI child(@Nullable
 X value,
 @NotNull
 @NotNull Class<CI> clazz,
 Object... pathSegments)

child

@Contract("null, _ -> null; !null, _ -> !null")
protected <X extends Serializable & Cloneable>
ConfigurationItem<X> child(@Nullable
 X value,
 Object... pathSegments)

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

clone

public ConfigurationItem<T> clone()

Intentionally not calling super.clone, as the value is final (and we have to clone it); so we would have to hack this using reflection turning off the `final` flag.

Overrides:

clone in class Object

toString

public String toString()

Overrides:

toString in class Object

localDescription

@NotNull
public @NotNull String localDescription()

To be overridden in specific subclasses.

fullDescription

@NotNull
public @NotNull String fullDescription()

configCheck

public void configCheck(boolean value,
 String template,
 Object... arguments)
                 throws ConfigurationException

Checks the value, and if it's `false`, emits a ConfigurationException. Note that DESC can be used as a placeholder for fullDescription() in the `arguments`.

Throws:

ConfigurationException

configNonNull

@Contract("null, _, _ -> fail")
@NotNull
public <V> V configNonNull(V value,
 String template,
 Object... arguments)
                    throws ConfigurationException

As configCheck(boolean, String, Object...), but checks that the value is not null.

Throws:

ConfigurationException