org.scijava.module
Interface ModuleService

All Superinterfaces:

Comparable<Prioritized>, Contextual, Disposable, HasPluginInfo, Prioritized, RichPlugin, SciJavaPlugin, SciJavaService, Service

All Known Implementing Classes:

DefaultModuleService

public interface ModuleService
extends SciJavaService

Interface for service that tracks and executes available modules.

The module service keeps a master index of all modules known to the system. At heart, a module is a Runnable piece of code, but with explicit typed input and output parameters.

The module service has no innate ability to discover modules, and must be explicitly told about them via the addModule(org.scijava.module.ModuleInfo) and addModules(java.util.Collection) methods.

A module is distinct from a plugin in that plugins extend ImageJ's functionality in some way, taking many forms, whereas modules are always runnable code with typed inputs and outputs. There is a particular type of plugin called a Command which is also a module, but many plugins (e.g., Tools and Displays) are not modules.

Author:

Curtis Rueden

See Also:

Module, PluginService

Method Summary

void	addModule(ModuleInfo module) Manually registers a module with the module service.
void	addModules(Collection<? extends ModuleInfo> modules) Manually registers a list of modules with the module service.
Module	createModule(ModuleInfo info) Creates an instance of the given module.
ModuleIndex	getIndex() Gets the index of available modules.
ModuleInfo	getModuleForAccelerator(Accelerator acc) Gets the module for a given keyboard shortcut.
List<ModuleInfo>	getModules() Gets the list of available modules.
<T> ModuleItem<T>	getSingleInput(Module module, Class<T> type) Checks the given module for a solitary unresolved fillable input of the given type, returning the relevant ModuleItem if found, or null if not exactly one unresolved fillable input of that type.
<T> ModuleItem<T>	getSingleOutput(Module module, Class<T> type) Checks the given module for a solitary unresolved output of the given type, returning the relevant ModuleItem if found, or null if not exactly one unresolved output of that type.
<T> T	load(ModuleItem<T> item) Returns the value, if any, stored in the PrefService for the given ModuleItem.
void	removeModule(ModuleInfo module) Manually unregisters a module with the module service.
void	removeModules(Collection<? extends ModuleInfo> modules) Manually unregisters a list of modules with the module service.
<M extends Module> Future<M>	run(M module, boolean process, Map<String,Object> inputMap) Executes the given module.
<M extends Module> Future<M>	run(M module, boolean process, Object... inputs) Executes the given module.
<M extends Module> Future<M>	run(M module, List<? extends ModulePreprocessor> pre, List<? extends ModulePostprocessor> post, Map<String,Object> inputMap) Executes the given module.
<M extends Module> Future<M>	run(M module, List<? extends ModulePreprocessor> pre, List<? extends ModulePostprocessor> post, Object... inputs) Executes the given module.
Future<Module>	run(ModuleInfo info, boolean process, Map<String,Object> inputMap) Executes the given module.
Future<Module>	run(ModuleInfo info, boolean process, Object... inputs) Executes the given module.
Future<Module>	run(ModuleInfo info, List<? extends ModulePreprocessor> pre, List<? extends ModulePostprocessor> post, Map<String,Object> inputMap) Executes the given module.
Future<Module>	run(ModuleInfo info, List<? extends ModulePreprocessor> pre, List<? extends ModulePostprocessor> post, Object... inputs) Executes the given module.
<T> void	save(ModuleItem<T> item, T value) Registers the given value for the given ModuleItem using the PrefService.
<M extends Module> M	waitFor(Future<M> future) Blocks until the given module is finished executing.

Methods inherited from interface org.scijava.service.Service

initialize, registerEventHandlers

Methods inherited from interface org.scijava.Contextual

context, getContext, setContext

Methods inherited from interface org.scijava.Prioritized

getPriority, setPriority

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface org.scijava.plugin.HasPluginInfo

getInfo, setInfo

Methods inherited from interface org.scijava.Disposable

dispose

Method Detail

getIndex

ModuleIndex getIndex()

Gets the index of available modules.

addModule

void addModule(ModuleInfo module)

Manually registers a module with the module service.

removeModule

void removeModule(ModuleInfo module)

Manually unregisters a module with the module service.

addModules

void addModules(Collection<? extends ModuleInfo> modules)

Manually registers a list of modules with the module service.

removeModules

void removeModules(Collection<? extends ModuleInfo> modules)

Manually unregisters a list of modules with the module service.

getModules

List<ModuleInfo> getModules()

Gets the list of available modules.

getModuleForAccelerator

ModuleInfo getModuleForAccelerator(Accelerator acc)

Gets the module for a given keyboard shortcut.

Parameters:

acc - the accelerator for which to search.

Returns:

the module info for the corresponding module, or null.

createModule

Module createModule(ModuleInfo info)

Creates an instance of the given module.

If the module implements the Contextual interface, the appropriate context is injected. Similarly, if the module implements the Prioritized interface, the appropriate priority is injected.

Note that in the case of commands, this method does not do any preprocessing on the command instances, so parameters will not be auto-populated, initializers will not be executed, etc.

run

Future<Module> run(ModuleInfo info,
                   boolean process,
                   Object... inputs)

Executes the given module.

Parameters:

info - The module to instantiate and run.

process - If true, executes the module with pre- and postprocessing steps from all available PreprocessorPlugins and PostprocessorPlugins in the plugin index; if false, executes the module with no pre- or postprocessing.

inputs - List of input parameter names and values. The expected order is in pairs: an input name followed by its value, for each desired input to populate. Leaving some inputs unpopulated is allowed. Passing the name of an input that is not valid for the module, or passing a value of a type incompatible with the associated input parameter, will issue an error and ignore that name/value pair.

Returns:

Future of the module instance being executed. Calling Future.get() will block until execution is complete.

run

Future<Module> run(ModuleInfo info,
                   boolean process,
                   Map<String,Object> inputMap)

Executes the given module.

Parameters:

info - The module to instantiate and run.

process - If true, executes the module with pre- and postprocessing steps from all available PreprocessorPlugins and PostprocessorPlugins in the plugin index; if false, executes the module with no pre- or postprocessing.

inputMap - Table of input parameter values, with keys matching the ModuleInfo's input parameter names. Passing a value of a type incompatible with the associated input parameter will issue an error and ignore that value.

Returns:

Future of the module instance being executed. Calling Future.get() will block until execution is complete.

run

Future<Module> run(ModuleInfo info,
                   List<? extends ModulePreprocessor> pre,
                   List<? extends ModulePostprocessor> post,
                   Object... inputs)

Executes the given module.

Parameters:

info - The module to instantiate and run.

pre - List of preprocessing steps to perform.

post - List of postprocessing steps to perform.

inputs - List of input parameter names and values. The expected order is in pairs: an input name followed by its value, for each desired input to populate. Leaving some inputs unpopulated is allowed. Passing the name of an input that is not valid for the module, or passing a value of a type incompatible with the associated input parameter, will issue an error and ignore that name/value pair.

Returns:

Future of the module instance being executed. Calling Future.get() will block until execution is complete.

run

Future<Module> run(ModuleInfo info,
                   List<? extends ModulePreprocessor> pre,
                   List<? extends ModulePostprocessor> post,
                   Map<String,Object> inputMap)

Executes the given module.

Parameters:

info - The module to instantiate and run.

pre - List of preprocessing steps to perform.

post - List of postprocessing steps to perform.

inputMap - Table of input parameter values, with keys matching the ModuleInfo's input parameter names. Passing a value of a type incompatible with the associated input parameter will issue an error and ignore that value.

Returns:

Future of the module instance being executed. Calling Future.get() will block until execution is complete.

run

<M extends Module> Future<M> run(M module,
                                 boolean process,
                                 Object... inputs)

Executes the given module.

Parameters:

module - The module to run.

process - If true, executes the module with pre- and postprocessing steps from all available PreprocessorPlugins and PostprocessorPlugins in the plugin index; if false, executes the module with no pre- or postprocessing.

inputs - List of input parameter names and values. The expected order is in pairs: an input name followed by its value, for each desired input to populate. Leaving some inputs unpopulated is allowed. Passing the name of an input that is not valid for the module, or passing a value of a type incompatible with the associated input parameter, will issue an error and ignore that name/value pair.

Returns:

Future of the module instance being executed. Calling Future.get() will block until execution is complete.

run

<M extends Module> Future<M> run(M module,
                                 boolean process,
                                 Map<String,Object> inputMap)

Executes the given module.

Parameters:

module - The module to run.

process - If true, executes the module with pre- and postprocessing steps from all available PreprocessorPlugins and PostprocessorPlugins in the plugin index; if false, executes the module with no pre- or postprocessing.

inputMap - Table of input parameter values, with keys matching the ModuleInfo's input parameter names. Passing a value of a type incompatible with the associated input parameter will issue an error and ignore that value.

Returns:

Future of the module instance being executed. Calling Future.get() will block until execution is complete.

run

<M extends Module> Future<M> run(M module,
                                 List<? extends ModulePreprocessor> pre,
                                 List<? extends ModulePostprocessor> post,
                                 Object... inputs)

Executes the given module.

Parameters:

module - The module to run.

pre - List of preprocessing steps to perform.

post - List of postprocessing steps to perform.

inputs - List of input parameter names and values. The expected order is in pairs: an input name followed by its value, for each desired input to populate. Leaving some inputs unpopulated is allowed. Passing the name of an input that is not valid for the module, or passing a value of a type incompatible with the associated input parameter, will issue an error and ignore that name/value pair.

Returns:

Future of the module instance being executed. Calling Future.get() will block until execution is complete.

run

<M extends Module> Future<M> run(M module,
                                 List<? extends ModulePreprocessor> pre,
                                 List<? extends ModulePostprocessor> post,
                                 Map<String,Object> inputMap)

Executes the given module.

Parameters:

module - The module to run.

pre - List of preprocessing steps to perform.

post - List of postprocessing steps to perform.

inputMap - Table of input parameter values, with keys matching the module's ModuleInfo's input parameter names. Passing a value of a type incompatible with the associated input parameter will issue an error and ignore that value.

Returns:

Future of the module instance being executed. Calling Future.get() will block until execution is complete.

waitFor

<M extends Module> M waitFor(Future<M> future)

Blocks until the given module is finished executing.

getSingleInput

<T> ModuleItem<T> getSingleInput(Module module,
                                 Class<T> type)

Checks the given module for a solitary unresolved fillable input of the given type, returning the relevant ModuleItem if found, or null if not exactly one unresolved fillable input of that type.

getSingleOutput

<T> ModuleItem<T> getSingleOutput(Module module,
                                  Class<T> type)

Checks the given module for a solitary unresolved output of the given type, returning the relevant ModuleItem if found, or null if not exactly one unresolved output of that type.

save

<T> void save(ModuleItem<T> item,
              T value)

Registers the given value for the given ModuleItem using the PrefService.

load

<T> T load(ModuleItem<T> item)

Returns the value, if any, stored in the PrefService for the given ModuleItem.