ucar.unidata.view.geoloc

Class ProjectionManager

java.lang.Object

ucar.unidata.view.geoloc.ProjectionManager

All Implemented Interfaces:

java.awt.event.ActionListener, java.util.EventListener

public class ProjectionManager
extends java.lang.Object
implements java.awt.event.ActionListener

Manages a modal dialogue box that allows the user to define projections using subclasses of ucar.unidata.gis.ProjectionImpl.

    1) It uses bean introspection on ProjectionImpl subclasses to dynamically
       configure edit fields for the projection's parameters. The subclass should
       define getXXX() and setXXX() methods for each parameter.
    3) when the user selects a projection, a NewProjectionEvent is sent to any listeners
    4) currently the list of possible projection classes is maintained as a
       hard-wired list of class names. This should be rethunk.
 

Version:

$Revision: 1.57 $

Author:

John Caron

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROPERTY_CHANGE property change identifier

Constructor Summary

Constructors

Constructor and Description
ProjectionManager() Default constructor
ProjectionManager(javax.swing.RootPaneContainer parent) Create a new ProjectionManager
ProjectionManager(javax.swing.RootPaneContainer parent, boolean makeDialog) Create a new ProjectionManager.
ProjectionManager(javax.swing.RootPaneContainer parent, java.util.List projections) Create a new ProjectionManager.
ProjectionManager(javax.swing.RootPaneContainer parent, java.util.List projections, boolean makeDialog) Create a new ProjectionManager.
ProjectionManager(javax.swing.RootPaneContainer parent, java.util.List projections, boolean makeDialog, java.lang.String helpId) Create a new ProjectionManager.
ProjectionManager(javax.swing.RootPaneContainer parent, java.util.List projections, boolean makeDialog, java.lang.String helpId, java.util.List maps) Create a new ProjectionManager.
ProjectionManager(javax.swing.RootPaneContainer parent, java.lang.Object dummy) Create a new ProjectionManager.

Method Summary

Modifier and Type	Method and Description
void	accept() Accept a change.
void	actionPerformed(java.awt.event.ActionEvent event) Handle action events
static void	addDefaultProjection(java.lang.String projectionClass) Add the given class to the list of default projections
void	addPropertyChangeListener(java.beans.PropertyChangeListener l) Add a property change listener.
void	close() Close this widget
boolean	contains(java.lang.String id) See if the manager contains the projection by name.
void	destroy() Destroy this object
void	doDelete() Delete the selected projection.
void	doEdit() _more_
void	doExport() Export a list of user selected projections
void	doNew() _more_
void	edit(boolean isNew) Edit a projection.
java.awt.Component	getContents() Get the contents as a component.
static java.util.List	getDefaultProjections() Create the list of default projection classes
javax.swing.JDialog	getDialog() Get this as a dialog.
java.lang.String	getManagerName() Get the name of this manager to put in a menu
java.lang.Class	getPersistentObjectClass() Get the Class type of the objects managed; must implement Serializable, Cloneable
java.util.List	getProjections() Get the list of projections that this manager manages
PersistentObject	getSelection() Get the currently selected object, of type getPersistentObjectClass()
static void	main(java.lang.String[] args) Test the class
static java.util.List	makeDefaultProjections() Make the default projections from the internal list of classes.
void	removePropertyChangeListener(java.beans.PropertyChangeListener l) Remove a property change listener.
void	saveProjection(ucar.unidata.geoloc.ProjectionImpl proj) Store this Projection in the data table
void	setMaps(java.util.List maps) Set the list of maps to use in this ProjectionManager
void	setProjections(java.util.List list) Set the list of projections for this manager
void	setSelection(PersistentObject select) Set the currently selected thing: must be of type getPersistentObjectClass().
void	show() Popup the Manager Dialog
void	storePersistentData() Dummy method for stores

Methods inherited from class java.lang.Object

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

Field Detail

PROPERTY_CHANGE

public static final java.lang.String PROPERTY_CHANGE

property change identifier

See Also:

Constant Field Values

Constructor Detail

ProjectionManager

public ProjectionManager()

Default constructor

ProjectionManager

public ProjectionManager(javax.swing.RootPaneContainer parent,
                         java.lang.Object dummy)

Create a new ProjectionManager.

Parameters:

parent - parent container

dummy - dummy argument for clients that try to pass in a store

ProjectionManager

public ProjectionManager(javax.swing.RootPaneContainer parent)

Create a new ProjectionManager

Parameters:

parent - parent container

ProjectionManager

public ProjectionManager(javax.swing.RootPaneContainer parent,
                         boolean makeDialog)

Create a new ProjectionManager.

Parameters:

parent - parent container

makeDialog - true to make this a dialog

ProjectionManager

public ProjectionManager(javax.swing.RootPaneContainer parent,
                         java.util.List projections)

Create a new ProjectionManager.

Parameters:

parent - JFrame (application) or JApplet (applet)

projections - list of initial projections

ProjectionManager

public ProjectionManager(javax.swing.RootPaneContainer parent,
                         java.util.List projections,
                         boolean makeDialog)

Create a new ProjectionManager.

Parameters:

parent - JFrame (application) or JApplet (applet)

projections - list of initial projections

makeDialog - true to make this a dialog

ProjectionManager

public ProjectionManager(javax.swing.RootPaneContainer parent,
                         java.util.List projections,
                         boolean makeDialog,
                         java.lang.String helpId)

Create a new ProjectionManager.

Parameters:

parent - JFrame (application) or JApplet (applet)

projections - list of initial projections

makeDialog - true to make this a dialog

helpId - help id if dialog

ProjectionManager

public ProjectionManager(javax.swing.RootPaneContainer parent,
                         java.util.List projections,
                         boolean makeDialog,
                         java.lang.String helpId,
                         java.util.List maps)

Create a new ProjectionManager.

Parameters:

parent - JFrame (application) or JApplet (applet)

projections - list of initial projections

makeDialog - true to make this a dialog

helpId - help id if dialog

maps - List of MapData

Method Detail

addDefaultProjection

public static void addDefaultProjection(java.lang.String projectionClass)

Add the given class to the list of default projections

Parameters:

projectionClass - The class

getDefaultProjections

public static java.util.List getDefaultProjections()

Create the list of default projection classes

Returns:

list of default projection classes

storePersistentData

public void storePersistentData()

Dummy method for stores

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent event)

Handle action events

Specified by:

actionPerformed in interface java.awt.event.ActionListener

Parameters:

event - event to handle

close

public void close()

Close this widget

doExport

public void doExport()

Export a list of user selected projections

makeDefaultProjections

public static java.util.List makeDefaultProjections()

Make the default projections from the internal list of classes.

Returns:

list of default projections

setMaps

public void setMaps(java.util.List maps)

Set the list of maps to use in this ProjectionManager

Parameters:

maps - list of MapData's (may be null)

setProjections

public void setProjections(java.util.List list)

Set the list of projections for this manager

Parameters:

list - list of projections

getProjections

public java.util.List getProjections()

Get the list of projections that this manager manages

Returns:

list of projections

getManagerName

public java.lang.String getManagerName()

Get the name of this manager to put in a menu

Returns:

manager name

getPersistentObjectClass

public java.lang.Class getPersistentObjectClass()

Get the Class type of the objects managed; must implement Serializable, Cloneable

Returns:

the type of class that this manager manages

getContents

public java.awt.Component getContents()

Get the contents as a component.

Returns:

the contents

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener l)

Add a property change listener.

Parameters:

l - listener to add

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener l)

Remove a property change listener.

Parameters:

l - listener to remove

getDialog

public javax.swing.JDialog getDialog()

Get this as a dialog.

Returns:

the dialog or null if not made as a dialog

show

public void show()

Popup the Manager Dialog

destroy

public void destroy()

Destroy this object

getSelection

public PersistentObject getSelection()

Get the currently selected object, of type getPersistentObjectClass()

Returns:

currently selected object

setSelection

public void setSelection(PersistentObject select)

Set the currently selected thing: must be of type getPersistentObjectClass(). This does NOT fire a PropertyChangeEvent

Parameters:

select - the object to select.

accept

public void accept()

Accept a change.

contains

public boolean contains(java.lang.String id)

See if the manager contains the projection by name.

Parameters:

id - name of projection

Returns:

true if the projection is managed by this

doDelete

public void doDelete()

Delete the selected projection.

doEdit

public void doEdit()

_more_

doNew

public void doNew()

_more_

edit

public void edit(boolean isNew)

Edit a projection. Used to change an existing projection or add a new one.

Parameters:

isNew - true if this is a new projection.

saveProjection

public void saveProjection(ucar.unidata.geoloc.ProjectionImpl proj)

Store this Projection in the data table

Parameters:

proj - the Projection to store

main

public static void main(java.lang.String[] args)

Test the class

Parameters:

args - not used