org.scijava.plugin

Interface WrapperService<DT,PT extends WrapperPlugin<DT>>

Type Parameters:

DT - Base data type

PT - Plugin type

All Superinterfaces:

Comparable<Prioritized>, Contextual, Disposable, HasPluginInfo, Identifiable, Initializable, Locatable, Logged, Prioritized, PTService<PT>, RichPlugin, SciJavaPlugin, Service, Typed<DT>, TypedService<DT,PT>, Versioned

All Known Subinterfaces:

DataHandleService, WidgetService

All Known Implementing Classes:

AbstractWrapperService, DefaultDataHandleService, DefaultWidgetService

public interface WrapperService<DT,PT extends WrapperPlugin<DT>>
extends TypedService<DT,PT>

A service for managing WrapperPlugins of a particular type. A WrapperPlugin is a stateful TypedPlugin which wraps a particular object of its associated data type. For any given data object, the service is capable of wrapping it with the most appropriate wrapper by sequentially querying each WrapperPlugin on its list for compatibility.

Note that like PTService, SingletonService and TypedService, WrapperService is not a service interface defining API for a specific concrete service implementation, but rather a more general layer in a type hierarchy intended to ease creation of services that fit its pattern.

Author:

Curtis Rueden

See Also:

WrapperPlugin, PTService

Method Summary

Modifier and Type	Method and Description
default <D extends DT> PT	create(D data) Creates a new plugin instance wrapping the given associated data object.
default void	initialize() Performs any needed initialization when the service is first loaded.
default boolean	supports(DT data) Gets whether this object is compatible with the given data object.

Methods inherited from interface org.scijava.plugin.TypedService

find

Methods inherited from interface org.scijava.plugin.PTService

create, getPlugins, getPluginService, getPluginType, pluginService

Methods inherited from interface org.scijava.service.Service

registerEventHandlers

Methods inherited from interface org.scijava.plugin.RichPlugin

getIdentifier, log

Methods inherited from interface org.scijava.Contextual

context, getContext, setContext

Methods inherited from interface org.scijava.Prioritized

compareTo, getPriority, setPriority

Methods inherited from interface org.scijava.plugin.HasPluginInfo

getInfo, setInfo

Methods inherited from interface org.scijava.Locatable

getLocation

Methods inherited from interface org.scijava.Versioned

getVersion

Methods inherited from interface org.scijava.Disposable

dispose

Methods inherited from interface org.scijava.Typed

getType

Method Detail

create

default <D extends DT> PT create(D data)

Creates a new plugin instance wrapping the given associated data object.

Returns:

An appropriate plugin instance, or null if the data is not compatible with any available plugin.

initialize

default void initialize()

Description copied from interface: Service

Performs any needed initialization when the service is first loaded.

NB: This method is not intended to be called directly. It is called by the service framework itself (specifically by the ServiceHelper) when initializing the service. It should not be called a second time.

Specified by:

initialize in interface Initializable

Specified by:

initialize in interface Service

supports

default boolean supports(DT data)

Description copied from interface: Typed

Gets whether this object is compatible with the given data object.

By default, this method will return true iff the data is assignable to the associated type given by Typed.getType(). But individual implementations may have other requirements beyond class assignability.

Specified by:

supports in interface Typed<DT>