org.lsst.ccs.gconsole.services.persist

Class PersistenceService

java.lang.Object

org.lsst.ccs.gconsole.base.ConsolePlugin

org.lsst.ccs.gconsole.services.persist.PersistenceService

All Implemented Interfaces:

ConsoleService

@Plugin(name="Persistence Service Plugin",
        id="persistence-service",
        description="Service that facilitates persisting data between the graphical console sessions.")
public class PersistenceService
extends ConsolePlugin
implements ConsoleService

Service that facilitates persisting data between the graphical console sessions.

Author:

onoprien

Constructor Summary

Constructors

Constructor and Description
PersistenceService()

Method Summary

Modifier and Type	Method and Description
void	delete(Persistable.Descriptor descriptor) Deletes the specified descriptor from storage.
Persistable	edit(Persistable in, String title, Component parent) Takes user input and modifies the provided Persistable instance.
List<Creator>	getFactories(String category) Utility method that returns all registered instance creators in the specified category.
Creator	getFactory(String category, String path) Utility method that returns an instance creator identified by category and path.
ArrayList<Persistable.Descriptor>	getSavedDescriptors(String category) Returns a list of saved descriptors in the specified category.
Persistable.Descriptor	load(String category, String title, Component parent) Lets the user select one of the saved descriptors in the specified category.
Persistable	make(Persistable.Descriptor descriptor) Creates a Persistable instance based on the provided descriptor.
Persistable	make(Persistable.Descriptor descriptor, String title, Component parent, String category) Creates a Persistable instance by letting the user to select one of the available creators in the given category, and using the provided descriptor (if any) as the starting point.
void	save(Persistable.Descriptor descriptor) Saves the specified descriptor to disk, making it available in future console sessions.
void	saveAs(Persistable.Descriptor descriptor, String title, Component parent) Saves the descriptor to disk, letting the user specify path, name, and description.
void	startService() Called by the framework to start the service.

Methods inherited from class org.lsst.ccs.gconsole.base.ConsolePlugin

getConsole, getServices, initialize, propertiesChanged, restore, save, setServicesProvider, shutdown, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.lsst.ccs.gconsole.base.ConsoleService

stopService

Constructor Detail

PersistenceService

public PersistenceService()

Method Detail

startService

public void startService()

Called by the framework to start the service.

Specified by:

startService in interface ConsoleService

make

public Persistable make(Persistable.Descriptor descriptor)

Creates a Persistable instance based on the provided descriptor. No user interaction. An instance of Persistable is constructed by the Creator identified in the descriptor, then its restore(...) method is called.

Parameters:

descriptor - JavaBean that describes the Persistable type and state.

Returns:

Newly created Persistable, or null if it cannot be created.

make

public Persistable make(Persistable.Descriptor descriptor,
                        String title,
                        Component parent,
                        String category)

Creates a Persistable instance by letting the user to select one of the available creators in the given category, and using the provided descriptor (if any) as the starting point. Returns null if the user cancels creation. Throws RuntimeException if editing fails for any other reason.

Parameters:

descriptor - Object state to be used as a starting point.

title - User-interaction dialog title, or null if the default title should be used.

parent - Graphical component to be use as a parent for user-interaction dialog(s).

category - Object category.

Returns:

Newly created Persistable, or null if the object creation was canceled by the user.

edit

public Persistable edit(Persistable in,
                        String title,
                        Component parent)

Takes user input and modifies the provided Persistable instance. Returns null if the user cancels editing. Throws RuntimeException if editing fails for any other reason.

Parameters:

in - Instance to be edited.

title - User-interaction dialog title, or null if the default title should be used.

parent - Graphical component to be use as a parent for user-interaction dialog(s).

Returns:

Edited instance. This may or may not be the same instance that was passed to this method as in parameter.

save

public void save(Persistable.Descriptor descriptor)

Saves the specified descriptor to disk, making it available in future console sessions. The method will display an error message if the descriptor does not have category or path set.

Parameters:

descriptor - Descriptor to be saved.

saveAs

public void saveAs(Persistable.Descriptor descriptor,
                   String title,
                   Component parent)

Saves the descriptor to disk, letting the user specify path, name, and description. The saved descriptor will be available in future console sessions.

Parameters:

descriptor - Descriptor to be saved.

title - User interaction dialog title.

parent - User interaction dialog parent component, or null if the parent is the console window.

delete

public void delete(Persistable.Descriptor descriptor)

Deletes the specified descriptor from storage.

Parameters:

descriptor - Descriptor to be removed.

load

public Persistable.Descriptor load(String category,
                                   String title,
                                   Component parent)

Lets the user select one of the saved descriptors in the specified category.

Parameters:

category - Persistable object category.

title - User interaction dialog title.

parent - User interaction dialog parent component, or null if the parent is the console window.

Returns:

Chosen descriptor.

getFactory

public Creator getFactory(String category,
                          String path)

Utility method that returns an instance creator identified by category and path.

Parameters:

category - Creator category.

path - Creator path.

Returns:

Desired factory, or null if no such factory is known to this service.

getFactories

public List<Creator> getFactories(String category)

Utility method that returns all registered instance creators in the specified category.

Parameters:

category - Persistable object category.

Returns:

List of known creators.

getSavedDescriptors

public ArrayList<Persistable.Descriptor> getSavedDescriptors(String category)

Returns a list of saved descriptors in the specified category.

Parameters:

category - Persistable object category.

Returns:

List of saved descriptors.