org.hkijena.jipipe.api.registries

Class JIPipeSettingsRegistry

java.lang.Object

org.hkijena.jipipe.api.parameters.AbstractJIPipeParameterCollection

org.hkijena.jipipe.api.registries.JIPipeSettingsRegistry

All Implemented Interfaces:

JIPipeCustomParameterCollection, JIPipeParameterCollection, JIPipeParameterCollection.ParameterChangedEventListener

public class JIPipeSettingsRegistry
extends AbstractJIPipeParameterCollection
implements JIPipeCustomParameterCollection, JIPipeParameterCollection.ParameterChangedEventListener

Registry for settings. Settings are organized in "sheets" (parameter collections)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JIPipeSettingsRegistry.Sheet A settings sheet

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

JIPipeParameterCollection.ParameterChangedEvent, JIPipeParameterCollection.ParameterChangedEventEmitter, JIPipeParameterCollection.ParameterChangedEventListener, JIPipeParameterCollection.ParameterStructureChangedEvent, JIPipeParameterCollection.ParameterStructureChangedEventEmitter, JIPipeParameterCollection.ParameterStructureChangedEventListener, JIPipeParameterCollection.ParameterUIChangedEvent, JIPipeParameterCollection.ParameterUIChangedEventEmitter, JIPipeParameterCollection.ParameterUIChangedEventListener

Constructor Summary

Constructors

Constructor and Description
JIPipeSettingsRegistry(JIPipe jiPipe)

Method Summary

Modifier and Type	Method and Description
JIPipe	getJIPipe()
Map<String,JIPipeParameterAccess>	getParameters() Returns all parameters Please note that those parameters must be sourced in this collection.
static Path	getPropertyFile()
static com.fasterxml.jackson.databind.JsonNode	getRawNode() Gets the raw property files Json node
BiMap<String,JIPipeSettingsRegistry.Sheet>	getRegisteredSheets()
<T extends JIPipeParameterCollection> T	getSettings(String id, Class<T> settingsClass) Gets the settings instance with given ID
void	load(Path file) Loads settings from the specified file
void	onParameterChanged(JIPipeParameterCollection.ParameterChangedEvent event)
void	register(String id, String name, Icon icon, String category, Icon categoryIcon, JIPipeParameterCollection parameterCollection) Registers a new settings sheet
void	register(String id, String name, String description, Icon icon, String category, Icon categoryIcon, JIPipeParameterCollection parameterCollection) Registers a new settings sheet
void	reload() Reloads the settings from the default file if it exists
void	save() Saves the settings to the default settings file
void	save(Path file) Saves the settings to the specified file

Methods inherited from class org.hkijena.jipipe.api.parameters.AbstractJIPipeParameterCollection

getParameterChangedEventEmitter, getParameterStructureChangedEventEmitter, getParameterUIChangedEventEmitter

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

emitParameterChangedEvent, emitParameterStructureChangedEvent, emitParameterUIChangedEvent, getContextActions, getParameter, getParameterAccess, getParameterChangedEventEmitter, getParameterStructureChangedEventEmitter, getParameterUIChangedEventEmitter, installUIOverrideParameterEditor, installUIParameterOptions, isParameterUIVisible, isParameterUIVisible, setParameter

Constructor Detail

JIPipeSettingsRegistry

public JIPipeSettingsRegistry(JIPipe jiPipe)

Method Detail

getRawNode

public static com.fasterxml.jackson.databind.JsonNode getRawNode()

Gets the raw property files Json node

Returns:

the node. Never null.

getPropertyFile

public static Path getPropertyFile()

Returns:

The location of the file where the settings are stored

register

public void register(String id,
                     String name,
                     Icon icon,
                     String category,
                     Icon categoryIcon,
                     JIPipeParameterCollection parameterCollection)

Registers a new settings sheet

Parameters:

id - unique ID of the sheet

name - sheet name

icon - sheet icon

category - sheet category. If left null or empty, it will default to "General"

categoryIcon - optional icon. If null, a wrench icon is used.

parameterCollection - the object that holds the parameters

register

public void register(String id,
                     String name,
                     String description,
                     Icon icon,
                     String category,
                     Icon categoryIcon,
                     JIPipeParameterCollection parameterCollection)

Registers a new settings sheet

Parameters:

id - unique ID of the sheet

name - sheet name

description - sheet description

icon - sheet icon

category - sheet category. If left null or empty, it will default to "General"

categoryIcon - optional icon. If null, a wrench icon is used.

parameterCollection - the object that holds the parameters

getSettings

public <T extends JIPipeParameterCollection> T getSettings(String id,
                                                           Class<T> settingsClass)

Gets the settings instance with given ID

Type Parameters:

T - the settings class

Parameters:

id - the ID

settingsClass - the settings class

Returns:

the settings instance.

getRegisteredSheets

public BiMap<String,JIPipeSettingsRegistry.Sheet> getRegisteredSheets()

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

save

public void save(Path file)

Saves the settings to the specified file

Parameters:

file - the file path

save

public void save()

Saves the settings to the default settings file

load

public void load(Path file)

Loads settings from the specified file

Parameters:

file - the file

reload

public void reload()

Reloads the settings from the default file if it exists

getJIPipe

public JIPipe getJIPipe()

onParameterChanged

public void onParameterChanged(JIPipeParameterCollection.ParameterChangedEvent event)

Specified by:

onParameterChanged in interface JIPipeParameterCollection.ParameterChangedEventListener