Interface WizardDescriptor.AsynchronousValidatingPanel<Data>

All Superinterfaces:
WizardDescriptor.Panel<Data>, WizardDescriptor.ValidatingPanel<Data>
All Known Subinterfaces:
WizardDescriptor.ExtendedAsynchronousValidatingPanel<Data>
Enclosing class:
WizardDescriptor
public static interface WizardDescriptor.AsynchronousValidatingPanel<Data> extends WizardDescriptor.ValidatingPanel<Data>
A special interface for panels that need to do additional asynchronous validation when Next or Finish button is clicked.

During background validation is Next or Finish button disabled. On validation success wizard automatically progress to next panel or finishes.

During background validation Cancel button is hooked to signal the validation thread using interrupt().

Note: It is recommended to use ExtendedAsynchronousValidatingPanel instead as it adds a method to conveniently unlock wizard's user interface when the validation is finished.

Since:
6.2 (16 May 2005)

  • Method Details

    • prepareValidation

      void prepareValidation()
      Called synchronously from UI thread when Next of Finish buttons clicked. It allows to lock user input to assure official data for background validation.

    • validate

      void validate() throws WizardValidationException
      Is called in separate thread when Next of Finish buttons are clicked and allows deeper check to find out that panel is in valid state and it is ok to leave it.
      Specified by:
      validate in interface WizardDescriptor.ValidatingPanel<Data>
      Throws:
      WizardValidationException - when validation fails