MapAppLogic

java.lang.Object
- com.partnersoft.maps.app.MapAppLogic

```
public class MapAppLogic
extends java.lang.Object
```
This class provides access to more specific logic classes. All of the "Logic" classes in this hierarchy provide non-visual control of the application's gui and state, and serve as gatekeepers to the undo/redo system. Any changes to the application's state should be performed via one of the methods provided here and in the other logic classes; this ensures that the GUI is kept consistent and that changes are undoable. You can think of this as the "controller" portion of a model-view-controller design.
Copyright 2005-2009 Partner Software, Inc.

Author:

Paul Reavis, Russell Cagle

Field Summary

Fields
Modifier and Type	Field and Description
`protected MapApp`	`app`
`protected MapConfigLogic`	`configLogic`
`protected MapConnectivityLogic`	`connectivityLogic`
`protected MapEditLogic`	`editLogic`
`protected MapFileLogic`	`fileLogic`
`protected MapFindLogic`	`findLogic`
`protected MapGpsLogic`	`gpsLogic`
`protected MapHelpLogic`	`helpLogic`
`protected MapPrintLogic`	`printLogic`
`protected MapQueryLogic`	`queryLogic`
`protected MapSelectionLogic`	`selectionLogic`
`protected MapSoundLogic`	`soundLogic`
`protected MapSpaceLogic`	`spaceLogic`
`protected MapStyleLogic`	`styleLogic`
`protected UndoStack`	`undoStack`
`protected Naming<java.lang.Object>`	`variables` This was marked as deprecated, and was replaced by MapSet.variables.
`protected MapViewLogic`	`viewLogic`
`protected MapWindowLogic`	`windowLogic`

Constructor Summary

Constructors
Constructor and Description

MapAppLogic(MapApp app)

Constructors
Constructor and Description
`MapAppLogic(MapApp app)`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`applyMapSetPreferences()`
`void`	`checkForUpdates(boolean reportUnavailable)` Checks for updates, popping open a prompt dialog if updates are available.
`void`	`checkForUpdatesInBackground()` This is normally only called at application startup.
`void`	`editPreferences()`
`void`	`exitApp()` Closes the application.
`void`	`forceShutdown()` Shuts down the MapApp no matter what.
`MapApp`	`getApp()`
`MapConfigLogic`	`getConfigLogic()`
`MapConnectivityLogic`	`getConnectivityLogic()`
`MapEditLogic`	`getEditLogic()`
`MapFileLogic`	`getFileLogic()`
`MapFindLogic`	`getFindLogic()`
`MapGpsLogic`	`getGpsLogic()`
`MapHelpLogic`	`getHelpLogic()`
`MapPrintLogic`	`getPrintLogic()`
`MapQueryLogic`	`getQueryLogic()`
`MapSelectionLogic`	`getSelectionLogic()`
`MapSoundLogic`	`getSoundLogic()`
`MapSpaceLogic`	`getSpaceLogic()`
`MapStyleLogic`	`getStyleLogic()`
`Naming`	`getVariables()` Replaced by MapSet.variables.
`MapViewLogic`	`getViewLogic()`
`MapWindowLogic`	`getWindowLogic()`
`void`	`initialize()` Initializes the state from preferences and/or defaults.
`void`	`redo()` Redoes the last undone command (whatever it was).
`void`	`restartApp()` Restarts the application.
`boolean`	`runShutdowns()` Attempts to close the MapApp; returns false if it cannot for some reason (usually a confirmShutdownScript in a mapset).
`void`	`runStartups()`
`void`	`showError(java.lang.String errorMessage)`
`void`	`showError(java.lang.String errorMessage, java.lang.Throwable error)`
`void`	`showHTMLReport(java.lang.String title, java.lang.Object htmlContent)` Same as the other showHTMLReport(), but automagically runs toString() on your contents object.
`void`	`showHTMLReport(java.lang.String title, java.lang.String html)` Pops open a MapReportDialog with the given title and contents.
`void`	`undo()` Undoes the last command (whatever it was).

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

app
```
protected MapApp app
```

undoStack
```
protected UndoStack undoStack
```

variables
```
protected Naming<java.lang.Object> variables
```
This was marked as deprecated, and was replaced by MapSet.variables. However, since mapset.variables gets reloaded when the user reloads the config, app.getLogic().variables is the only place to store variables that survive reloading.

windowLogic
```
protected MapWindowLogic windowLogic
```

viewLogic
```
protected MapViewLogic viewLogic
```

selectionLogic

protected MapSelectionLogic selectionLogic

findLogic
```
protected MapFindLogic findLogic
```

editLogic
```
protected MapEditLogic editLogic
```

fileLogic
```
protected MapFileLogic fileLogic
```

gpsLogic
```
protected MapGpsLogic gpsLogic
```

spaceLogic
```
protected MapSpaceLogic spaceLogic
```

printLogic
```
protected MapPrintLogic printLogic
```

configLogic
```
protected MapConfigLogic configLogic
```

helpLogic
```
protected MapHelpLogic helpLogic
```

queryLogic
```
protected MapQueryLogic queryLogic
```

connectivityLogic

protected MapConnectivityLogic connectivityLogic

soundLogic
```
protected MapSoundLogic soundLogic
```

styleLogic
```
protected MapStyleLogic styleLogic
```

Constructor Detail
- MapAppLogic
```
public MapAppLogic(MapApp app)
```

Method Detail
- undo
```
public void undo()
```
  Undoes the last command (whatever it was).
- redo
```
public void redo()
```
  Redoes the last undone command (whatever it was).
- initialize
```
public void initialize()
```
  Initializes the state from preferences and/or defaults.
- exitApp
```
public void exitApp()
```
  Closes the application.
- restartApp
```
public void restartApp()
```
  Restarts the application.
- runStartups
```
public void runStartups()
```
- applyMapSetPreferences
```
public void applyMapSetPreferences()
```
- runShutdowns
```
public boolean runShutdowns()
```
  Attempts to close the MapApp; returns false if it cannot for some reason (usually a confirmShutdownScript in a mapset).
  
  Returns:
- forceShutdown
```
public void forceShutdown()
```
  Shuts down the MapApp no matter what.
- showError
```
public void showError(java.lang.String errorMessage)
```
- showError
```
public void showError(java.lang.String errorMessage,
             java.lang.Throwable error)
```
- showHTMLReport
```
public void showHTMLReport(java.lang.String title,
                  java.lang.String html)
```
  Pops open a MapReportDialog with the given title and contents.
- showHTMLReport
```
public void showHTMLReport(java.lang.String title,
                  java.lang.Object htmlContent)
```
  Same as the other showHTMLReport(), but automagically runs toString() on your contents object.
- editPreferences
```
public void editPreferences()
```
- checkForUpdatesInBackground
```
public void checkForUpdatesInBackground()
```
  This is normally only called at application startup. It spawns a separate thread to check for updates and notifies the user only if updates are available.
- checkForUpdates
```
public void checkForUpdates(boolean reportUnavailable)
```
  Checks for updates, popping open a prompt dialog if updates are available. If reportUnavailable is false, then it does not notify the user if there are no updates available or if the request fails. If reportUnavailable is true, it notifies the user appropriately. It logs regardless.
  
  Parameters:
  reportUnavailable -
- getWindowLogic
```
public MapWindowLogic getWindowLogic()
```
- getViewLogic
```
public MapViewLogic getViewLogic()
```
- getSelectionLogic
```
public MapSelectionLogic getSelectionLogic()
```
- getFindLogic
```
public MapFindLogic getFindLogic()
```
- getEditLogic
```
public MapEditLogic getEditLogic()
```
- getFileLogic
```
public MapFileLogic getFileLogic()
```
- getGpsLogic
```
public MapGpsLogic getGpsLogic()
```
- getSpaceLogic
```
public MapSpaceLogic getSpaceLogic()
```
- getPrintLogic
```
public MapPrintLogic getPrintLogic()
```
- getConfigLogic
```
public MapConfigLogic getConfigLogic()
```
- getQueryLogic
```
public MapQueryLogic getQueryLogic()
```
- getHelpLogic
```
public MapHelpLogic getHelpLogic()
```
- getConnectivityLogic
```
public MapConnectivityLogic getConnectivityLogic()
```
- getApp
```
public MapApp getApp()
```
- getVariables
```
public Naming getVariables()
```
  Replaced by MapSet.variables.
  
  Returns:
- getSoundLogic
```
public MapSoundLogic getSoundLogic()
```
- getStyleLogic
```
public MapStyleLogic getStyleLogic()
```

Class MapAppLogic

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

app

undoStack

variables

windowLogic

viewLogic

selectionLogic

findLogic

editLogic

fileLogic

gpsLogic

spaceLogic

printLogic

configLogic

helpLogic

queryLogic

connectivityLogic

soundLogic

styleLogic

Constructor Detail

MapAppLogic

Method Detail

undo

redo

initialize

exitApp

restartApp

runStartups

applyMapSetPreferences

runShutdowns

forceShutdown

showError

showError

showHTMLReport

showHTMLReport

editPreferences

checkForUpdatesInBackground

checkForUpdates

getWindowLogic

getViewLogic

getSelectionLogic

getFindLogic

getEditLogic

getFileLogic

getGpsLogic

getSpaceLogic

getPrintLogic

getConfigLogic

getQueryLogic

getHelpLogic

getConnectivityLogic

getApp

getVariables

getSoundLogic

getStyleLogic