Valkyrie RCP Reference Guide

The Valkyrie RCP team

1.0-SNAPSHOT

Copies of this document may be made for your own use and for distribution to others, provided that you do not charge any fee for such copies and further provided that each copy contains this Copyright Notice, whether distributed in print or electronically.


1. Introduction
1.1. Overview
1.2. A quick dissection
1.2.1. Anatomy of a rich client application
1.2.2. Application windows
1.2.3. Views
1.2.4. Commands
1.2.5. Messages and icons
1.2.6. Other components
2. Basics
2.1. Getting started using the archetype
2.2. The factories
2.3. Lifecycle
2.4. Views
2.5. Widgets
3. Applications
3.1. Application
3.2. Application lifecycle
3.3. Hooking into a lifecycle
3.4. Example: adding login functionality
3.5. Other possible uses
3.6. Playing with the status bar
3.7. Application windows
4. Commands
4.1. Why the abstraction
4.2. How to create a simple command
4.3. Configure a programmatically created command
4.4. Transforming the command to a visual component
4.5. Commands i18n and images
4.6. Grouping commands
4.7. Building a command group in a Spring context
4.8. Getting a Spring configured command in code
4.9. Defining global commands
4.10. Addding shortcuts to commands
5. Views
5.1. What is a view
5.2. View descriptors
5.3. Creating views
5.4. Creating a view descriptor for a view
5.5. Showing the view in the application
5.6. Changing the behavior of global commands in a view context
6. Forms and binding
6.1. FormModel and ValueModel
6.1.1. What is a ValueModel
6.1.2. What is a FormModel
6.1.3. The default formmodel
6.1.4. Buffering
6.1.5. Read-only manipulation
6.1.6. Validation
6.1.7. Creating formmodels
6.2. Binding
6.2.1. What is binding
6.2.2. How does binding work and what does it do
6.2.3. Binders
6.2.4. Binder examples
6.2.5. Creating a custom binder
6.3. Forms
6.3.1. What is a form
6.3.2. Creating a form
6.3.3. FormBuilders
6.3.4. Binder selection
6.3.5. Internationalization
6.3.6. Adding forms to forms, a.k.a. child forms
6.3.7. Form validation
7. Validation
7.1. Why validation
7.2. Validation choices
7.3. Rule validation
7.3.1. Using the rules framework
7.3.2. Constraints
7.3.3. Validation triggers
7.3.4. Dependent properties
7.3.5. Setting i18n messages for custom rules
7.4. JSR validator integration
7.5. Combining validators
7.6. Integrating your own or another third-party validation framework
8. Exception handling
8.1. Why not just use try and catch?
8.2. Built-in exception handlers
8.2.1. SilentExceptionHandler
8.2.2. MessagesDialogExceptionHandler
8.2.3. JSR303ValidatorDialogExceptionHandler
8.2.4. Custom exception handler
8.3. Picking the right exception handler for the right exception
8.3.1. SimpleExceptionHandlerDelegate
8.3.2. ChainInspectingExceptionHandlerDelegate
8.3.3. ExceptionPurger
9. Security
9.1. Integration security in a GUI application
9.2. Spring Security integration
10. Widgets
11. Form component interceptors
11.1. Introduction
11.2. Creating your own interceptor
11.3. Configuration
11.4. Built-in interceptors
11.4.1. Error overlay image
11.4.2. Error background color
11.4.3. Text editing popup (undo, copy, paste, ...)
11.4.4. Combobox auto completion
11.4.5. Overlay image indicating dirty value
11.4.6. Select all text on focus
11.4.7. Setting the caret to the beginning of the field
11.4.8. Showing a tooltip
11.4.9. Changing the rendering of a checkbox
11.4.10. Showing the caption of the currently focussed component in the statusbar
11.4.11. Showing the description of the currently focussed component in the statusbar
12. Wizards
12.1. Why use wizards
12.2. Creating a wizard
12.3. Showing wizards
13. Integration with other frameworks
13.1. Flexibility
13.2. VLDocking
13.3. JIDE
13.4. Adding support for other frameworks