com.sibvisions.rad.ui.swing.impl
Class SwingApplication

java.lang.Object
  com.sibvisions.rad.ui.awt.impl.AwtResource<C>
      com.sibvisions.rad.ui.awt.impl.AwtComponent<C>
          com.sibvisions.rad.ui.awt.impl.AwtContainer<C>
              com.sibvisions.rad.ui.swing.impl.container.SwingAbstractFrame<javax.swing.JFrame>
                  com.sibvisions.rad.ui.swing.impl.container.SwingFrame
                      com.sibvisions.rad.ui.swing.impl.SwingApplication

All Implemented Interfaces:

java.awt.event.ComponentListener, java.awt.event.FocusListener, java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.event.WindowListener, java.util.EventListener, ILauncher, IFrame, IToolBarPanel, IWindow, IAlignmentConstants, IComponent, IContainer, IResource, IExceptionListener, INamedObject

public class SwingApplication
extends SwingFrame
implements ILauncher

The SwingApplication is the IApplication implementation for swing applications with full access to the JFrame.

Field Summary

static java.lang.String

PROPERTY_APPLICATION the property name for the application (client properties).

Fields inherited from class com.sibvisions.rad.ui.swing.impl.container.SwingAbstractFrame

bDisposed, bWindowListener, eventWindowActivated, eventWindowClosed, eventWindowClosing, eventWindowDeactivated, eventWindowDeiconified, eventWindowIconified, eventWindowOpened, iconImage, menuBar

Fields inherited from class com.sibvisions.rad.ui.awt.impl.AwtComponent

bComponentListener, bFocusListener, bKeyListener, bMouseListener, eventComponentMoved, eventComponentResized, eventKeyPressed, eventKeyReleased, eventKeyTyped, eventMouseClicked, eventMouseEntered, eventMouseExited, eventMousePressed, eventMouseReleased, eventSource, factory, parent

Fields inherited from class com.sibvisions.rad.ui.awt.impl.AwtResource

resource

Fields inherited from interface javax.rad.application.ILauncher

ENVIRONMENT_DESKTOP, ENVIRONMENT_HEADLESS, ENVIRONMENT_MOBILE, ENVIRONMENT_WEB, PARAM_APPLICATIONLANGUAGE, PARAM_APPLICATIONNAME, PARAM_CODEBASE, PARAM_ENVIRONMENT, PARAM_LOGFACTORY, PARAM_SERVERBASE, PARAM_UIFACTORY

Fields inherited from interface javax.rad.ui.container.IFrame

ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, NORMAL

Fields inherited from interface javax.rad.ui.container.IToolBarPanel

AREA_BOTTOM, AREA_LEFT, AREA_RIGHT, AREA_TOP

Fields inherited from interface javax.rad.ui.IAlignmentConstants

ALIGN_BOTTOM, ALIGN_CENTER, ALIGN_DEFAULT, ALIGN_LEFT, ALIGN_RIGHT, ALIGN_STRETCH, ALIGN_TOP

Constructor Summary

SwingApplication()
Creates a new instance of SwingApplication.

SwingApplication(java.lang.String pApplicationClassName, java.lang.String pConfigFileName, java.lang.String[] pParams)
Creates a new instance of SwingApplication with the desired application.

Method Summary

void	cancelPendingThreads() Cancel/Interrupts all pending threads.
static SwingApplication	createSwingApplication() Creates the application in the UI thread.
static SwingApplication	createSwingApplication(java.lang.String pApplicationClassName, java.lang.String pConfigFileName, java.lang.String[] pParams) Creates the application in the UI thread.
void	dispose() Marks the frame as disposed.
IApplication	getApplication() Gets the launched application.
java.lang.String	getEnvironmentName() Gets the name of the environment for this launcher.
void	getFileHandle(IFileHandleReceiver pFileHandleReceiver, java.lang.String pTitle) Technology independent getFileHandle.
java.lang.Object	getObject(java.lang.String pName) Gets an external object from launchers object store.
java.lang.String	getParameter(java.lang.String pName) Gets a configuration parameter of the application.
java.lang.String	getRegistryKey(java.lang.String pKey) Gets the value for a specific key from the applications registry.
void	handleException(java.lang.Throwable pThrowable) Notification for the listener to handle an exception occured in another part of the program.
boolean	isFullScreen() Gets whether full screen mode is active.
boolean	isSystemExitOnDispose() Gets whether System.exit(int) will be called if dispose is called.
static void	main(java.lang.String[] pArguments) Starts the application as frame.
java.lang.Object	putObject(java.lang.String pName, java.lang.Object pObject) Puts an external object into launchers object store.
void	saveFileHandle(IFileHandle pFileHandle, java.lang.String pTitle) Technology independent saveFileHandle.
void	setFullScreen(boolean pFullScreen) Sets the full screen mode.
void	setParameter(java.lang.String pName, java.lang.String pValue) Sets a configuration parameter of the application.
void	setRegistryKey(java.lang.String pKey, java.lang.String pValue) Sets the value for a specific key to the applications registry.
void	setSystemExitOnDispose(boolean pExitOnDispose) Sets whether System.exit(int) should be called if dispose is called.
void	showDocument(java.lang.String pDocumentName, IRectangle pBounds, java.lang.String pTarget) Requests that external application shows a document indicated by the pDocumentname argument.
void	showFileHandle(IFileHandle pFileHandle) Technology independent showFileHandle.
void	showFileHandle(IFileHandle pFileHandle, IRectangle pBounds, java.lang.String pTarget) Technology independent showFileHandle.
void	startup(java.lang.String pApplicationClassName, java.lang.String pConfigFileName, java.lang.String[] pParams) Starts the application in the UI thread.

Methods inherited from class com.sibvisions.rad.ui.swing.impl.container.SwingFrame

addIntern, addWindowListenerToResource, capture, centerRelativeTo, getModalDesktopPane, getState, getTitle, isActive, isResizable, pack, removeIntern, setIconImage, setLayoutIntern, setMenuBar, setResizable, setState, setTitle, setVisible, toBack, toFront, windowActivated, windowClosed, windowClosing, windowDeactivated, windowDeiconified, windowIconified, windowOpened

Methods inherited from class com.sibvisions.rad.ui.swing.impl.container.SwingAbstractFrame

addToolBar, addToolBar, addToolBarIntern, addWindowListener, eventWindowActivated, eventWindowClosed, eventWindowClosing, eventWindowDeactivated, eventWindowDeiconified, eventWindowIconified, eventWindowOpened, getIconImage, getMenuBar, getToolBar, getToolBarArea, getToolBarCount, getTranslation, indexOfToolBar, isDisposed, removeAllToolBars, removeToolBar, removeToolBar, removeToolBarIntern, setCursor, setToolBarArea, setTranslation

Methods inherited from class com.sibvisions.rad.ui.awt.impl.AwtContainer

add, add, add, add, checkAdd, getComponent, getComponentCount, getLayout, indexOf, remove, remove, removeAll, setLayout

Methods inherited from class com.sibvisions.rad.ui.awt.impl.AwtComponent

addComponentListener, addFocusListener, addKeyListener, addMouseListener, componentHidden, componentMoved, componentResized, componentShown, createImage, createMouseEvent, equals, eventComponentMoved, eventComponentResized, eventFocusGained, eventFocusLost, eventKeyPressed, eventKeyReleased, eventKeyTyped, eventMouseClicked, eventMouseEntered, eventMouseExited, eventMousePressed, eventMouseReleased, focusGained, focusLost, getBackground, getBounds, getCursor, getEventSource, getFactory, getFont, getForeground, getHorizontalAlignment, getLocation, getLocationRelativeTo, getMaximumSize, getMinimumSize, getName, getParent, getPreferredSize, getSize, getStyle, getTabIndex, getToolTipText, getVerticalAlignment, hashCode, invalidateLayout, isBackgroundSet, isCursorSet, isEnabled, isFocusable, isFontSet, isForegroundSet, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isVisible, keyPressed, keyReleased, keyTyped, mouseClicked, mouseEntered, mouseExited, mousePressed, mouseReleased, requestFocus, setBackground, setBounds, setEnabled, setEventSource, setFactory, setFocusable, setFont, setForeground, setHorizontalAlignment, setLocation, setLocationRelativeTo, setMaximumSize, setMinimumSize, setName, setParent, setPreferredSize, setSize, setStyle, setTabIndex, setToolTipText, setVerticalAlignment, validate

Methods inherited from class com.sibvisions.rad.ui.awt.impl.AwtResource

getResource, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.rad.ui.container.IFrame

getIconImage, getMenuBar, getState, getTitle, isResizable, setIconImage, setMenuBar, setResizable, setState, setTitle

Methods inherited from interface javax.rad.ui.container.IWindow

centerRelativeTo, eventWindowActivated, eventWindowClosed, eventWindowClosing, eventWindowDeactivated, eventWindowDeiconified, eventWindowIconified, eventWindowOpened, getTranslation, isActive, isDisposed, pack, setTranslation, toBack, toFront

Methods inherited from interface javax.rad.ui.container.IToolBarPanel

addToolBar, addToolBar, getToolBar, getToolBarArea, getToolBarCount, indexOfToolBar, removeAllToolBars, removeToolBar, removeToolBar, setToolBarArea

Methods inherited from interface javax.rad.ui.IContainer

add, add, add, add, getComponent, getComponentCount, getLayout, indexOf, remove, remove, removeAll, setLayout

Methods inherited from interface javax.rad.ui.IComponent

capture, eventComponentMoved, eventComponentResized, eventFocusGained, eventFocusLost, eventKeyPressed, eventKeyReleased, eventKeyTyped, eventMouseClicked, eventMouseEntered, eventMouseExited, eventMousePressed, eventMouseReleased, getBackground, getBounds, getCursor, getEventSource, getFactory, getFont, getForeground, getLocation, getLocationRelativeTo, getMaximumSize, getMinimumSize, getName, getParent, getPreferredSize, getSize, getStyle, getTabIndex, getToolTipText, isBackgroundSet, isCursorSet, isEnabled, isFocusable, isFontSet, isForegroundSet, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isVisible, requestFocus, setBackground, setBounds, setCursor, setEnabled, setEventSource, setFocusable, setFont, setForeground, setLocation, setLocationRelativeTo, setMaximumSize, setMinimumSize, setName, setParent, setPreferredSize, setSize, setStyle, setTabIndex, setToolTipText, setVisible

Methods inherited from interface javax.rad.ui.IResource

getResource

Field Detail

PROPERTY_APPLICATION

public static final java.lang.String PROPERTY_APPLICATION

the property name for the application (client properties).

See Also:

Constant Field Values

Constructor Detail

SwingApplication

public SwingApplication()

Creates a new instance of SwingApplication. Use this constructor if you need access to the frame before the application is started.

See Also:

startup(String, String, String[])

SwingApplication

public SwingApplication(java.lang.String pApplicationClassName,
                        java.lang.String pConfigFileName,
                        java.lang.String[] pParams)

Creates a new instance of SwingApplication with the desired application.

Parameters:

pApplicationClassName - the full qualified class name of the IApplication to run.

pConfigFileName - gives the name of the configuration file (default: application.xml)

pParams - additional or preferred parameters. The parameters overrides the parameters from the config file

Method Detail

main

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

Starts the application as frame. The first argument should give the full qualified class name of the application to run.

Parameters:

pArguments - the launcher arguments: main-class [config.xml key1=value1 key2=value2]

createSwingApplication

public static SwingApplication createSwingApplication()

Creates the application in the UI thread.

Returns:

the swing application

createSwingApplication

public static SwingApplication createSwingApplication(java.lang.String pApplicationClassName,
                                                      java.lang.String pConfigFileName,
                                                      java.lang.String[] pParams)

Creates the application in the UI thread.

Parameters:

pApplicationClassName - the full qualified class name of the IApplication to run.

pConfigFileName - gives the name of the configuration file (default: application.xml)

pParams - additional or preferred parameters. The parameters overrides the parameters from the config file

Returns:

the swing application

startup

public void startup(java.lang.String pApplicationClassName,
                    java.lang.String pConfigFileName,
                    java.lang.String[] pParams)

Starts the application in the UI thread.

Parameters:

pApplicationClassName - the full qualified class name of the IApplication to run.

pConfigFileName - gives the name of the configuration file (default: application.xml)

pParams - additional or preferred parameters. The parameters overrides the parameters from the config file

dispose

public void dispose()

Marks the frame as disposed.

Specified by:

dispose in interface IWindow

Overrides:

dispose in class SwingFrame

See Also:

IWindow.pack(), IComponent.setVisible(boolean)

getParameter

public java.lang.String getParameter(java.lang.String pName)

Gets a configuration parameter of the application.

Specified by:

getParameter in interface ILauncher

Parameters:

pName - the parameter name

Returns:

the value of the parameter or null if the parameter does not exist

setParameter

public void setParameter(java.lang.String pName,
                         java.lang.String pValue)

Sets a configuration parameter of the application.

Specified by:

setParameter in interface ILauncher

Parameters:

pName - the parameter name

pValue - the value for the parameter or null to delete the parameter

showDocument

public void showDocument(java.lang.String pDocumentName,
                         IRectangle pBounds,
                         java.lang.String pTarget)
                  throws java.lang.Throwable

Requests that external application shows a document indicated by the pDocumentname argument. The target argument indicates where the document should be displayed. Applications can also ignore the target information.

Specified by:

showDocument in interface ILauncher

Parameters:

pDocumentName - the location/filename of the document. (local or network adress)

pBounds - the bounds for the document, if supported from the implementation

pTarget - a String indicating where to display the document.

Throws:

java.lang.Throwable - if the document couldn't opened/shown

showFileHandle

public void showFileHandle(IFileHandle pFileHandle,
                           IRectangle pBounds,
                           java.lang.String pTarget)
                    throws java.lang.Throwable

Technology independent showFileHandle. A file chooser dialog should occur. This Function returns immediate.

Specified by:

showFileHandle in interface ILauncher

Parameters:

pFileHandle - the IFileHandle to save.

pBounds - the bounds for the document, if supported from the implementation

pTarget - a String indicating where to display the document.

Throws:

java.lang.Throwable - if an error occurs during saving the file.

showFileHandle

public void showFileHandle(IFileHandle pFileHandle)
                    throws java.lang.Throwable

Technology independent showFileHandle. A file chooser dialog should occur. This Function returns immediate.

Specified by:

showFileHandle in interface ILauncher

Parameters:

pFileHandle - the IFileHandle to save.

Throws:

java.lang.Throwable - if an error occurs during saving the file.

saveFileHandle

public void saveFileHandle(IFileHandle pFileHandle,
                           java.lang.String pTitle)
                    throws java.lang.Throwable

Technology independent saveFileHandle. A file chooser dialog should occur. This Function returns immediate.

Specified by:

saveFileHandle in interface ILauncher

Parameters:

pFileHandle - the IFileHandle to save.

pTitle - the title for the dialog or null to set a default title

Throws:

java.lang.Throwable - if an error occurs during saving the file.

getFileHandle

public void getFileHandle(IFileHandleReceiver pFileHandleReceiver,
                          java.lang.String pTitle)
                   throws java.lang.Throwable

Technology independent getFileHandle. A file chooser dialog should occur, and as result this function informs the IFileHandle receiver.

Specified by:

getFileHandle in interface ILauncher

Parameters:

pFileHandleReceiver - the IFileHandle receiver that should receive the file.

pTitle - the title for the dialog or null to set a default title

Throws:

java.lang.Throwable - if an error occurs during getting the file.

cancelPendingThreads

public void cancelPendingThreads()

Cancel/Interrupts all pending threads.

Specified by:

cancelPendingThreads in interface ILauncher

setRegistryKey

public void setRegistryKey(java.lang.String pKey,
                           java.lang.String pValue)

Sets the value for a specific key to the applications registry. The registry is a local store for persistent values.

Specified by:

setRegistryKey in interface ILauncher

Parameters:

pKey - the key to set

pValue - the value to set or null to remove the key from the registry

getRegistryKey

public java.lang.String getRegistryKey(java.lang.String pKey)

Gets the value for a specific key from the applications registry.

Specified by:

getRegistryKey in interface ILauncher

Parameters:

pKey - the key to get

Returns:

the value for the key or null if the key is not available

getEnvironmentName

public java.lang.String getEnvironmentName()

Gets the name of the environment for this launcher. The environment could be used to en-/disable features.

Specified by:

getEnvironmentName in interface ILauncher

Returns:

the name of the environment, e.g. ILauncher.ENVIRONMENT_HEADLESS, ILauncher.ENVIRONMENT_DESKTOP

handleException

public void handleException(java.lang.Throwable pThrowable)

Notification for the listener to handle an exception occured in another part of the program.

Specified by:

handleException in interface IExceptionListener

Parameters:

pThrowable - the occured exception

getApplication

public IApplication getApplication()

Gets the launched application.

Returns:

the application

putObject

public java.lang.Object putObject(java.lang.String pName,
                                  java.lang.Object pObject)

Puts an external object into launchers object store.

Parameters:

pName - the name of the object

pObject - the object or null to remove the object from the store

Returns:

the previous object

getObject

public java.lang.Object getObject(java.lang.String pName)

Gets an external object from launchers object store.

Parameters:

pName - the name of the object

Returns:

the object or null if no object was found with the given name

setSystemExitOnDispose

public void setSystemExitOnDispose(boolean pExitOnDispose)

Sets whether System.exit(int) should be called if dispose is called.

Parameters:

pExitOnDispose - true to call System.exit(int), false otherwise

isSystemExitOnDispose

public boolean isSystemExitOnDispose()

Gets whether System.exit(int) will be called if dispose is called.

Returns:

true if System.exit(int) will be called, false otherwise

setFullScreen

public void setFullScreen(boolean pFullScreen)

Sets the full screen mode.

Parameters:

pFullScreen - true to enable full screen mode, false to set normal mode

isFullScreen

public boolean isFullScreen()

Gets whether full screen mode is active.

Returns:

true if full screen mode is active, false otherwise