com.ur.urcap.api.contribution.program.swing

Interface SwingProgramNodeService<C extends ProgramNodeContribution,V extends SwingProgramNodeView<C>>

Type Parameters:

C - the (generic) type parameter for the interface representing the type of ProgramNodeContribution created by this SwingProgramNodeService

V - the (generic) type parameter for the interface representing the type of the view used by all the ProgramNodeContribution created by this service

All Superinterfaces:

URCapProgramNodeService

public interface SwingProgramNodeService<C extends ProgramNodeContribution,V extends SwingProgramNodeView<C>>
extends URCapProgramNodeService

Defines an API required for defining and adding to PolyScope a new type of program node and corresponding screen where the user interface is Swing-based.

Method Summary

Modifier and Type	Method and Description
void	configureContribution(ContributionConfiguration configuration) This method is called once after the SwingProgramNodeService is registered.
C	createNode(ProgramAPIProvider apiProvider, V view, DataModel model, CreationContext context) Creates a new program node instance.
V	createView(ViewAPIProvider apiProvider) Creates a new View instance which implements the UI for your program node screen.
String	getId() Get the unique identifier for this kind of program node.
String	getTitle(Locale locale)

Method Detail

getId

String getId()

Get the unique identifier for this kind of program node. The identifier will be used when storing programs that use the program node.

Returns:

the unique identifier

configureContribution

void configureContribution(ContributionConfiguration configuration)

This method is called once after the SwingProgramNodeService is registered. Modify the configuration parameter to configure your contribution. The configuration object will already have default values for its properties matching most use cases.

The values of the ContributionConfiguration object will be read once immediately after this method call. Changing values at a later stage will have no effect, so do not store a reference to the configuration object.

If the default values are appropriate, leave this method empty.

Parameters:

configuration - a modifiable ContributionConfiguration with default values

getTitle

String getTitle(Locale locale)

Parameters:

locale - The current locale of PolyScope. Can be used for supporting titles in several languages.

Returns:

The text displayed in the Structure Tab for program nodes created by this service as well as the title of the corresponding program node screen. Called once at start up.

createView

V createView(ViewAPIProvider apiProvider)

Creates a new View instance which implements the UI for your program node screen. Called once when a new program is loaded or created.

Parameters:

apiProvider - Provides access to functionality and services available from within PolyScope related to user interface and user interaction

Returns:

the view

createNode

C createNode(ProgramAPIProvider apiProvider,
             V view,
             DataModel model,
             CreationContext context)

Creates a new program node instance. This happens when the user clicks the button on the Structure tab or when an existing program node is loaded

The returned node must use the supplied data model object to retrieve and store the data contained in it.

Parameters:

apiProvider - Provides access to functionality and services available from within PolyScope relevant for the program node

view - the View created by createView(ViewAPIProvider)

model - object where all configuration data of the new program node instance is to be stored in and retrieved from

context - the context in which this node is created

Returns:

the newly constructed program node contribution instance