org.hkijena.jipipe.api.parameters

Class JIPipeDynamicParameterCollection

java.lang.Object

org.hkijena.jipipe.api.parameters.JIPipeDynamicParameterCollection

All Implemented Interfaces:

JIPipeValidatable, JIPipeCustomParameterCollection, JIPipeParameterCollection, JsonDeserializable

Direct Known Subclasses:

CustomExpressionVariablesParameter, DefaultCacheDisplaySettings, DefaultResultImporterSettings, GeneratedParameters, SlotMapParameterCollection

public class JIPipeDynamicParameterCollection
extends Object
implements JIPipeCustomParameterCollection, JIPipeValidatable, JsonDeserializable

Holds a user-definable set of parameters

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JIPipeDynamicParameterCollection.Deserializer
static class	JIPipeDynamicParameterCollection.ParameterAddingEvent
static class	JIPipeDynamicParameterCollection.UserParameterDefinition Parameter definition by a user

Nested classes/interfaces inherited from interface org.hkijena.jipipe.api.parameters.JIPipeParameterCollection

JIPipeParameterCollection.ParameterChangedEvent, JIPipeParameterCollection.ParameterStructureChangedEvent, JIPipeParameterCollection.ParameterUIChangedEvent

Constructor Summary

Constructors

Constructor and Description
JIPipeDynamicParameterCollection()
JIPipeDynamicParameterCollection(boolean allowUserModification) Creates a new instance.
JIPipeDynamicParameterCollection(boolean allowUserModification, Class<?>[] allowedTypes) Creates a new instance
JIPipeDynamicParameterCollection(boolean allowUserModification, Set<JIPipeParameterTypeInfo> allowedTypes) Creates a new instance
JIPipeDynamicParameterCollection(JIPipeDynamicParameterCollection other) Copies the parameters from the original

Method Summary

Modifier and Type	Method and Description
JIPipeMutableParameterAccess	addParameter(JIPipeMutableParameterAccess parameterAccess) Adds a new parameter.
JIPipeMutableParameterAccess	addParameter(String key, Class<?> fieldClass) Adds a new parameter
JIPipeMutableParameterAccess	addParameter(String key, Class<?> fieldClass, String name, String description, Annotation... annotations)
void	beginModificationBlock() Halts all ParameterStructureChangedEvent until endModificationBlock() is called.
void	clear() Removes all parameters
boolean	containsKey(String key) Returns true if there is a parameter with given key
void	copyTo(JIPipeDynamicParameterCollection target) Copies the parameter configuration into the target
void	endModificationBlock() Ends a modification block started by beginModificationBlock().
void	fromJson(com.fasterxml.jackson.databind.JsonNode node) Loads the holder from JSON
JIPipeParameterAccess	get(String key) Returns the parameter with key
Set<Class<?>>	getAllowedTypes()
EventBus	getEventBus() Gets the event bus that posts events about the parameters
Function<JIPipeDynamicParameterCollection.UserParameterDefinition,JIPipeMutableParameterAccess>	getInstanceGenerator()
JIPipeMutableParameterAccess	getParameter(String key) Gets a parameter by its key
Map<String,JIPipeParameterAccess>	getParameters() Returns all parameters Please note that those parameters must be sourced in this collection.
<T> T	getValue(String key, Class<T> klass) Gets a parameter value
boolean	isAllowUserModification()
void	removeParameter(String key) Removes a parameter
void	reportValidity(JIPipeIssueReport report) Generates a validity report
void	setAllowedTypes(Set<Class<?>> allowedTypes) Sets allowed parameter types
void	setAllowUserModification(boolean allowUserModification) Enabled/disables if modification by users is allowed
void	setInstanceGenerator(Function<JIPipeDynamicParameterCollection.UserParameterDefinition,JIPipeMutableParameterAccess> instanceGenerator)
<T> boolean	setValue(String key, T value) Sets a parameter value
boolean	supportsAllParameterTypes()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.hkijena.jipipe.api.parameters.JIPipeCustomParameterCollection

getChildParameterCollections, getIncludeReflectionParameters

Methods inherited from interface org.hkijena.jipipe.api.parameters.JIPipeParameterCollection

addParameterChangeListener, addParameterChangeListener, getContextActions, getParameter, getParameterAccess, isParameterUIVisible, isParameterUIVisible, setParameter, triggerParameterChange, triggerParameterStructureChange, triggerParameterUIChange

Methods inherited from interface org.hkijena.jipipe.api.JIPipeValidatable

generateValidityReport

Constructor Detail

JIPipeDynamicParameterCollection

public JIPipeDynamicParameterCollection()

JIPipeDynamicParameterCollection

public JIPipeDynamicParameterCollection(boolean allowUserModification)

Creates a new instance. Automatically adds all known registered parameter types

Parameters:

allowUserModification - let user modify this collection

JIPipeDynamicParameterCollection

public JIPipeDynamicParameterCollection(JIPipeDynamicParameterCollection other)

Copies the parameters from the original

Parameters:

other - The original

JIPipeDynamicParameterCollection

public JIPipeDynamicParameterCollection(boolean allowUserModification,
                                        Set<JIPipeParameterTypeInfo> allowedTypes)

Creates a new instance

Parameters:

allowUserModification - let user modify this collection

allowedTypes - The parameter types that can be added by the user (ignored if user cannot add).

JIPipeDynamicParameterCollection

public JIPipeDynamicParameterCollection(boolean allowUserModification,
                                        Class<?>[] allowedTypes)

Creates a new instance

Parameters:

allowUserModification - let user modify this collection

allowedTypes - The parameter types that can be added by the user (ignored if user cannot add).

Method Detail

getParameters

public Map<String,JIPipeParameterAccess> getParameters()

Description copied from interface: JIPipeCustomParameterCollection

Returns all parameters Please note that those parameters must be sourced in this collection. Use getChildParameterCollections() to add those

Specified by:

getParameters in interface JIPipeCustomParameterCollection

Returns:

Map from parameter ID to its access. The ID is not necessarily equal to JIPipeParameterAccess.getKey()

addParameter

public JIPipeMutableParameterAccess addParameter(JIPipeMutableParameterAccess parameterAccess)

Adds a new parameter. The parameterHolder attribute is changed

Parameters:

parameterAccess - the parameter

Returns:

the parameter access or null if it was cancelled

supportsAllParameterTypes

public boolean supportsAllParameterTypes()

addParameter

public JIPipeMutableParameterAccess addParameter(String key,
                                                 Class<?> fieldClass)

Adds a new parameter

Parameters:

key - A unique key

fieldClass - The parameter class

Returns:

The created parameter access

clear

public void clear()

Removes all parameters

removeParameter

public void removeParameter(String key)

Removes a parameter

Parameters:

key - The parameter key

getParameter

public JIPipeMutableParameterAccess getParameter(String key)

Gets a parameter by its key

Parameters:

key - The parameter key

Returns:

The parameter access

getValue

public <T> T getValue(String key,
                      Class<T> klass)

Gets a parameter value

Type Parameters:

T - The parameter type

Parameters:

key - The parameter key

klass - The returned type

Returns:

The parameter value

setValue

public <T> boolean setValue(String key,
                            T value)

Sets a parameter value

Type Parameters:

T - The parameter type

Parameters:

key - The parameter key

value - The parameter value

Returns:

True if setting the value was successful

getAllowedTypes

public Set<Class<?>> getAllowedTypes()

Returns:

Allowed parameter types

setAllowedTypes

public void setAllowedTypes(Set<Class<?>> allowedTypes)

Sets allowed parameter types

Parameters:

allowedTypes - Parameter types

fromJson

public void fromJson(com.fasterxml.jackson.databind.JsonNode node)

Loads the holder from JSON

Specified by:

fromJson in interface JsonDeserializable

Parameters:

node - JSON data

isAllowUserModification

public boolean isAllowUserModification()

Returns:

True if modification by users is allowed

setAllowUserModification

public void setAllowUserModification(boolean allowUserModification)

Enabled/disables if modification by users is allowed

Parameters:

allowUserModification - True if modification is allowed

getEventBus

public EventBus getEventBus()

Description copied from interface: JIPipeParameterCollection

Gets the event bus that posts events about the parameters

Specified by:

getEventBus in interface JIPipeParameterCollection

Returns:

The event bus triggering JIPipeParameterCollection.ParameterChangedEvent and JIPipeParameterCollection.ParameterStructureChangedEvent

containsKey

public boolean containsKey(String key)

Returns true if there is a parameter with given key

Parameters:

key - the parameter key

Returns:

if there is a parameter with given key

get

public JIPipeParameterAccess get(String key)

Returns the parameter with key

Parameters:

key - the parameter key

Returns:

the parameter access

beginModificationBlock

public void beginModificationBlock()

Halts all ParameterStructureChangedEvent until endModificationBlock() is called. Use this method for many changes at once

endModificationBlock

public void endModificationBlock()

Ends a modification block started by beginModificationBlock(). Triggers a ParameterStructureChangedEvent

copyTo

public void copyTo(JIPipeDynamicParameterCollection target)

Copies the parameter configuration into the target

Parameters:

target - the target configuration

reportValidity

public void reportValidity(JIPipeIssueReport report)

Description copied from interface: JIPipeValidatable

Generates a validity report

Specified by:

reportValidity in interface JIPipeValidatable

Parameters:

report - the report to be added to

getInstanceGenerator

public Function<JIPipeDynamicParameterCollection.UserParameterDefinition,JIPipeMutableParameterAccess> getInstanceGenerator()

setInstanceGenerator

public void setInstanceGenerator(Function<JIPipeDynamicParameterCollection.UserParameterDefinition,JIPipeMutableParameterAccess> instanceGenerator)

addParameter

public JIPipeMutableParameterAccess addParameter(String key,
                                                 Class<?> fieldClass,
                                                 String name,
                                                 String description,
                                                 Annotation... annotations)