COPYRIGHT © 2002 - 2011 JIDE SOFTWARE, INC. ALL RIGHTS RESERVED JIDE Desktop Application Framework Developer Guide 1 COPYRIGHT © 2002 - 2011 JIDE SOFTWARE, INC. ALL RIGHTS RESERVED Table of Contents WHAT IS JIDE DESKTOP APPLICATION FRAMEWORK ........................................................ 6 AN ARCHITECTURAL FRAMEWORK ...................................................................................................... 6 BASE FUNCTIONALITY ......................................................................................................................... 6 BETTER DESKTOP INTEGRATION .......................................................................................................... 7 EXPLORING JIDE DESKTOP APPLICATION FRAMEWORK ................................................. 8 DESKTOPAPPLICATION ........................................................................................................................ 9 ApplicationLifecycleListener .......................................................................................................... 9 Application Data ........................................................................................................................... 10 DATAMODEL ..................................................................................................................................... 11 Data Persistence ........................................................................................................................... 12 DataModel Implementations ......................................................................................................... 12 Data Origination .......................................................................................................................... 13 Primary and Secondary DataModels ............................................................................................ 15 Monitoring the Data Lifecycle ...................................................................................................... 15 DATAVIEW ........................................................................................................................................ 16 DataViewFactory .......................................................................................................................... 17 MVC FLOW ....................................................................................................................................... 19 Data Lifecycle ............................................................................................................................... 19 PRINTING ........................................................................................................................................... 20 COMMANDLINE ................................................................................................................................. 20 CommandLine and Object Conversion ......................................................................................... 21 ENVIRONMENT VARIABLES ............................................................................................................... 21 ACTIONS ............................................................................................................................................ 22 THREADED ACTIVITIES ...................................................................................................................... 22 Creating an Activity ...................................................................................................................... 23 Activity Progress ........................................................................................................................... 23 Activity Actions ............................................................................................................................. 24 CUSTOM EVENTS ............................................................................................................................... 25 PREFERENCES .................................................................................................................................... 26 HELP .................................................................................................................................................. 27 VERSIONING ...................................................................................................................................... 28 VENDOR ............................................................................................................................................. 28 LOCALIZATION .................................................................................................................................. 28 Localizing Basic Application properties ....................................................................................... 29 OS-Extended Variants .................................................................................................................. 30 MAKING A GUI APPLICATION .................................................................................................... 30 APPLICATION UI TECHNOLOGY ......................................................................................................... 31 APPLICATION UI HIGHLIGHTS ........................................................................................................... 32 Java Cross-Platform Highlights ................................................................................................... 32 2 COPYRIGHT © 2002 - 2011 JIDE SOFTWARE, INC. ALL RIGHTS RESERVED GNU/Linux Highlights (Gnome) ................................................................................................... 32 GNU/Linux Highlights (KDE) ...................................................................................................... 33 MAC OS X Highlights ................................................................................................................... 34 Windows XP Highlights ................................................................................................................ 35 GUIAPPLICATIONLIFECYCLELISTENER ............................................................................................. 35 ACCESSING THE APPLICATION UI ...................................................................................................... 36 Extending an Application UI ........................................................................................................ 36 THE GUIAPPLICATION CLASS ........................................................................................................... 39 SETTING THE APPLICATION STYLE .................................................................................................... 40 Using Split Application Optional Style ......................................................................................... 41 FramedApplicationFeature .......................................................................................................... 42 SETTING FUNDAMENTAL GUIAPPLICATION PROPERTIES .................................................................. 45 SETTING THE SWING LOOK AND FEEL ................................................................................................ 46 APPLICATION DATA CYCLE ............................................................................................................... 48 Creating Different DataModels and DataViews ........................................................................... 48 MANAGING MODELS.......................................................................................................................... 50 MANAGING VIEWS ............................................................................................................................. 51 DataViewListener ......................................................................................................................... 53 Secondary and Auxiliary DataViews ............................................................................................ 53 WINDOW MANAGEMENT ................................................................................................................... 55 WindowCustomizer ....................................................................................................................... 55 ApplicationWindowsUI ................................................................................................................. 56 Window Sizing .............................................................................................................................. 57 Window Titling Logic ................................................................................................................... 57 WORKING WITH ACTIONS .................................................................................................................. 58 Pre-Installed Actions .................................................................................................................... 60 User Actions ................................................................................................................................. 62 Auto Installation of Actions into GUI ........................................................................................... 63 WORKING WITH ICONS ......................................................................................................................