com.sptci.echo
Class JDOApplication

java.lang.Object
  nextapp.echo.app.ApplicationInstance
      com.sptci.echo.Application
          com.sptci.echo.JDOApplication

All Implemented Interfaces:

Serializable

public class JDOApplication
extends Application

An application class that maintains a JDO PersistenceManager for the lifecycle of the session. This class does not provide any built in Transaction management. Use this class if you want precise control over the Transaction boundary.

Copyright 2007 Sans Pareil Technologies, Inc.

Version:

$Id: JDOApplication.java 4723 2009-02-28 16:46:02Z rakesh $

Author:

Rakesh Vidyadharan 2007-06-03

See Also:

Serialized Form

Field Summary

protected javax.jdo.PersistenceManager

persistenceManager The persistence manager instance that is to be used for the current session.

Fields inherited from class com.sptci.echo.Application

contentPane, dataDirectory, logger, MINIMUM_INTERVAL, pollingInterval, principal, properties, TIME_ZONES, timeZone, user, window

Fields inherited from class nextapp.echo.app.ApplicationInstance

FOCUSED_COMPONENT_CHANGED_PROPERTY, ID_STRING, LOCALE_CHANGED_PROPERTY, MODAL_COMPONENTS_CHANGED_PROPERTY, STYLE_SHEET_CHANGED_PROPERTY, WINDOWS_CHANGED_PROPERTY

Constructor Summary

JDOApplication()
Default constructor.

Method Summary

void	activate() Over-ridden to open a persistence manager if necessary.
protected void	closePersistenceManager() Close persistenceManager when it is no longer necessary.
void	dispose() Invoked when the application is disposed and will not be used again.
static JDOApplication	getApplication() Convenience method to return the active application as a properly typed object.
static javax.jdo.PersistenceManager	getPersistenceManager() Returns persistenceManager.
protected void	openPersistenceManager() Initialiase persistenceManager if necessary.
void	passivate() Over-ridden to close the persistenceManager if necessary.

Methods inherited from class com.sptci.echo.Application

addPane, addTask, getContentPane, getDataDirectory, getLocales, getLogger, getOffset, getParentView, getPrincipal, getProperty, getTimeZone, getUser, getWindow, getZIndex, hasQueuedTasks, init, processFatalException, processFatalException, removePane, removeTask, setContentPane, setDataDirectory, setPrincipal, setProperty, setUser, updatePollingInterval

Methods inherited from class nextapp.echo.app.ApplicationInstance

addPropertyChangeListener, createTaskQueue, doInit, doValidation, enqueueCommand, enqueueTask, firePropertyChange, generateId, generateSystemId, getActive, getComponentByRenderId, getContextProperty, getDefaultWindow, getFocusedComponent, getLayoutDirection, getLocale, getModalContextRoot, getStyle, getStyleSheet, getUpdateManager, hasTaskQueues, processInput, processQueuedTasks, removePropertyChangeListener, removeTaskQueue, setActive, setContextProperty, setFocusedComponent, setLocale, setStyleSheet

Methods inherited from class java.lang.Object

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

Field Detail

persistenceManager

protected transient javax.jdo.PersistenceManager persistenceManager

The persistence manager instance that is to be used for the current session.

Constructor Detail

JDOApplication

public JDOApplication()
               throws javax.jdo.JDOException

Default constructor. Initialises persistenceManager.

Throws:

javax.jdo.JDOException - If errors are encountered while initialising persistenceManager.

Method Detail

getApplication

public static JDOApplication getApplication()

Convenience method to return the active application as a properly typed object.

Returns:

The currently active Application instance.

getPersistenceManager

public static javax.jdo.PersistenceManager getPersistenceManager()

Returns persistenceManager.

Returns:

PersistenceManager The value/reference of/to persistenceManager.

activate

public void activate()

Over-ridden to open a persistence manager if necessary.

Overrides:

activate in class ApplicationInstance

passivate

public void passivate()

Over-ridden to close the persistenceManager if necessary.

Overrides:

passivate in class ApplicationInstance

See Also:

closePersistenceManager()

dispose

public void dispose()

Invoked when the application is disposed and will not be used again. Closes persistenceManager.

Overrides:

dispose in class ApplicationInstance

See Also:

closePersistenceManager(), ApplicationInstance.dispose()

openPersistenceManager

protected void openPersistenceManager()

Initialiase persistenceManager if necessary.

closePersistenceManager

protected void closePersistenceManager()

Close persistenceManager when it is no longer necessary. This is usually called when the instance is being dispose()d or passivate()ed.