prajna.geo

Class GeoMapper

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Panel

java.applet.Applet

javax.swing.JApplet

prajna.geo.GeoMapper

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.ChangeListener, javax.swing.RootPaneContainer

public class GeoMapper
extends javax.swing.JApplet
implements javax.swing.event.ChangeListener

Simple mapping application with support for projections, layer editing and interaction.

Author:

Edward Swing

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JApplet

javax.swing.JApplet.AccessibleJApplet

Nested classes/interfaces inherited from class java.applet.Applet

java.applet.Applet.AccessibleApplet

Nested classes/interfaces inherited from class java.awt.Panel

java.awt.Panel.AccessibleAWTPanel

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.swing.JApplet

accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
GeoMapper() Creates a new DemoGeoMapper object.
GeoMapper(javax.swing.JFrame frame) Creates a new DemoGeoMapper as a local application.
GeoMapper(javax.swing.JFrame frame, boolean useGoogle) Creates a new DemoGeoMapper as a local application.

Method Summary

Methods

Modifier and Type	Method and Description
void	addLayer(GeoLayer layer) Add a geographic layer to the display.
protected void	addRadioButton(java.lang.String buttonName) Add a radio button to the internal button group and button panel.
protected void	handleClick(java.awt.Point click, int button, java.lang.String action) Handle the click of a mouse over the map.
protected void	handlePick(GeoShape picked) Handle the picking of a GeoShape.
void	init() Initialize this method when it is running as an applet.
void	loadLayers(java.util.List<java.lang.String> names) Load geographic layers into this map display.
static void	main(java.lang.String[] args) Run this class as a demonstration application.
java.util.List<java.lang.String>	queryForLayers() Query the user for layers to display.
void	redrawMap() Redraw the current map
void	setBaseUrl(java.net.URL baseUrl) Set the base ESRI url used to access shape files
protected javax.swing.JPanel	setupActionPane() Set up an action pane which can be used within this application.
void	showLayerList() Display the geographic layer editor
protected void	showText(java.lang.String text) Show the text string in the scrolling information window.
void	stateChanged(javax.swing.event.ChangeEvent evt) Receive a stateChanged event.

Methods inherited from class javax.swing.JApplet

addImpl, createRootPane, getAccessibleContext, getContentPane, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isRootPaneCheckingEnabled, paramString, remove, repaint, setContentPane, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.applet.Applet

destroy, getAppletContext, getAppletInfo, getAudioClip, getAudioClip, getCodeBase, getDocumentBase, getImage, getImage, getLocale, getParameter, getParameterInfo, isActive, isValidateRoot, newAudioClip, play, play, resize, resize, setStub, showStatus, start, stop

Methods inherited from class java.awt.Panel

addNotify

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoMapper

public GeoMapper()

Creates a new DemoGeoMapper object. This no-arg method is needed to construct this class as an applet.

GeoMapper

public GeoMapper(javax.swing.JFrame frame)

Creates a new DemoGeoMapper as a local application. By default, this uses a GoogleMap as the underlying geographic canvas.

Parameters:

frame - The frame of the object to display the application in

GeoMapper

public GeoMapper(javax.swing.JFrame frame,
         boolean useGoogle)

Creates a new DemoGeoMapper as a local application.

Parameters:

frame - The frame of the object to display the application in

useGoogle - flag determining whether to use GoogleMaps as the underlying geographic canvas.

Method Detail

addLayer

public void addLayer(GeoLayer layer)

Add a geographic layer to the display. This method simply adds the layer to the underlying geographic canvas.

Parameters:

layer - the layer to add

addRadioButton

protected final void addRadioButton(java.lang.String buttonName)

Add a radio button to the internal button group and button panel. Whenever a mouse click occurs over the map, the location is handled by the handleClick method, with the name of the radio button pass as the action parameter.

Parameters:

buttonName - the button name, used for both display and the action associated with the button being selected

handleClick

protected void handleClick(java.awt.Point click,
               int button,
               java.lang.String action)

Handle the click of a mouse over the map. This method checks whether the action is a Pick or a Zoom action. If the action is Pick, then this method calls handlePick with the picked shape. If it is a Zoom action, the canvas radius is resized based upon which mouse button was clicked. The Left mouse button zooms in, while the Right mouse button zooms out. This method is protected, so that developers can easily override the standard behavior, and add additional buttons or functionality.

Parameters:

click - The point clicked

button - the button used to make the click

action - The action string

handlePick

protected void handlePick(GeoShape picked)

Handle the picking of a GeoShape. This method simply displays the name and field data to the information area of the display. This method is protected so that developers can easily override this behavior

Parameters:

picked - the shape picked. This can be null if no shape was actually picked.

init

public void init()

Initialize this method when it is running as an applet. This method looks for the mapType and esriBase parameters when initializing. The esriBase is used to set the base URL where the ESRI shape files may be found. If not set, the applet tries to use the applet document base. The mapType is used to determine the type of underlying geographic display. If the parameter is set to google, a Google map will be used as the underlying display. Otherwise, a vector-based map will be used.

Overrides:

init in class java.applet.Applet

loadLayers

public void loadLayers(java.util.List<java.lang.String> names)

Load geographic layers into this map display. This method tries to read ESRI shape files with the names in the list to build layers. If the layer has already been added, it is not reloaded. All layers are initially pickable, and assigned random colors.

Parameters:

names - the names of the ESRI shape files to be loaded.

queryForLayers

public java.util.List<java.lang.String> queryForLayers()

Query the user for layers to display. This method uses the ESRI base directory and opens a file chooser, allowing the user to select multiple files. The base names of all files selected are returned.

Returns:

a list of the base names of all files selected

redrawMap

public void redrawMap()

Redraw the current map

setBaseUrl

public void setBaseUrl(java.net.URL baseUrl)

Set the base ESRI url used to access shape files

Parameters:

baseUrl - the URL where the ESRI shape files are located

setupActionPane

protected javax.swing.JPanel setupActionPane()

Set up an action pane which can be used within this application. The action pane allows developers to create custom applications by adding functionality to the GUI. By default, this method returns null. It is protected, so a developer can easily override it. The action panel would appear at the top of the display.

Returns:

a panel to be used as an action panel

showLayerList

public void showLayerList()

Display the geographic layer editor

showText

protected void showText(java.lang.String text)

Show the text string in the scrolling information window. This method is protected to allow custom applications to use or override the method.

Parameters:

text - the text to display in the information window

stateChanged

public void stateChanged(javax.swing.event.ChangeEvent evt)

Receive a stateChanged event. This method is typically called when the geographic layer editor is updated. The method resets the display to reflect the changes made in the geographic layer editor.

Specified by:

stateChanged in interface javax.swing.event.ChangeListener

Parameters:

evt - The change event.

main

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

Run this class as a demonstration application. By default, the display uses a Google Map as the background. It queries the user to locate the ESRI layers to add to the display.

Parameters:

args - command line arguments. The first argument must be the ESRI base directory. Any additional arguments are used as layer names to be loaded.