TestFormController (JGUIraffe 1.3.1 Test API)

java.lang.Object
- net.sf.jguiraffe.gui.builder.window.ctrl.TestFormController

```
public class TestFormController
extends Object
```
Test class for FormController.

Version:

$Id: TestFormController.java 205 2012-01-29 18:29:57Z oheger $

Author:

Oliver Heger

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class TestFormController.FormBeanTestImpl
A test form bean class.

Nested Classes
Modifier and Type	Class and Description
`static class`	`TestFormController.FormBeanTestImpl` A test form bean class.

Constructor Summary

Constructors
Constructor and Description

TestFormController()

Constructors
Constructor and Description
`TestFormController()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`setUp()`
`void`	`testActionPerformedCancel()` Tests the handling of the action event for the cancel button.
`void`	`testActionPerformedNoComponentName()` Tests processing of an action event that does not have a component name.
`void`	`testActionPerformedOkInvalid()` Tests the handling of the action event for the OK button when the form's input fields contain invalid data.
`void`	`testActionPerformedOkValid()` Tests the handling of the action event for the OK button when the form's input fields contain valid data.
`void`	`testActionPerformedUnknownButton()` Tests the actionPerformed() method when an unknown event is received.
`void`	`testAddFieldStatusListener()` Tests whether listeners for field status events can be added.
`void`	`testAddFieldStatusListenerNull()` Tries to add a null field status listener.
`void`	`testAddFormListenerNull()` Tries to add a null form listener.
`void`	`testAddValidationListener()` Tests whether validation listeners can be added and are called correctly.
`void`	`testAddValidationListenerNull()` Tries to add a null validation listener.
`void`	`testCreateFormControllerEventNoController()` Tries to create a form controller event without a controller reference.
`void`	`testCreateFormControllerFieldStatusEventNoField()` Tries to create a field status event without a field name.
`void`	`testCreateFormControllerValidationEventNoResults()` Tries to create a validation event without results.
`void`	`testFetchMessageOutputBuilderData()` Tests obtaining the message output object from the builder data.
`void`	`testFetchMessageOutputExplicit()` Tests obtaining the message output object when one was explicitly set.
`void`	`testFetchValidationMessageBoxCaptionDefault()` Tests obtaining the caption for the validation message box when no caption was set explicitly.
`void`	`testFetchValidationMessageFormatDefault()` Tests obtaining the validation message format object when no specific object was set.
`void`	`testFetchValidationMessageFormatExplicit()` Tests obtaining the validation message format object when it was explicitly set.
`void`	`testFireFormEventCommitted()` Tests the form event fired for a committed form.
`void`	`testFireFormEventNotCommitted()` Tests the form event fired for a non-committed form.
`void`	`testGetBuilderData()` Tests whether the BuilderData object can be obtained.
`void`	`testGetForm()` Tests querying the form from the controller.
`void`	`testGetFormBean()` Tests querying the form bean.
`void`	`testGetFormListeners()` Tests whether the registered form listeners can be queried.
`void`	`testGetLastValidationResults()` Tests whether the results of the last validation are recorded and can be queried later.
`void`	`testGetLastValidationResultsNoValidation()` Tests the results returned by getLastValidationResults() if no validation has been performed so far.
`void`	`testInit()` Tests a newly created controller.
`void`	`testInitialValidation()` Tests the initial validation that happens when the form is opened.
`void`	`testIsFieldVisited()` Tests whether visited fields are correctly tracked.
`void`	`testListenerRegistrationViaReflection()` Tests whether event listeners can be registered at a controller using the reflection-based mechanism supported by FormEventManager.
`void`	`testRemoveFieldStatusListener()` Tests whether field status listeners can be removed.
`void`	`testRemoveFormListener()` Tests whether a form listener can be removed.
`void`	`testRemoveValidationListener()` Tests whether validation listeners can be removed.
`void`	`testSetFormValidatorExistingForm()` Tests whether a `FormValidator` can be set if the form already exists.
`void`	`testValidateWithErrorMessageDisplay()` Tests the validation method that displays error messages in case of validation failures.
`void`	`testValidationInvalidNotVisited()` Tests a validation if the field is invalid, but has not yet been visited.
`void`	`testValidationLastStatus()` Tests whether the last known validation status is stored.
`void`	`testValidationNoModel()` Tests validation if no model object exists.
`void`	`testValidationValid()` Tests a valid validation.
`void`	`testWindowClosedCancelCommand()` Tests whether the cancel command is executed when the form is not committed.
`void`	`testWindowClosedFormListenerCommitted()` Tests whether form listeners are called when the window is closed and the form was committed.
`void`	`testWindowClosedFormListenerNotCommitted()` Tests whether form listeners are called when the window is closed and the form was not committed.
`void`	`testWindowClosedOKCommand()` Tests whether the OK command is executed when the form is committed.
`void`	`testWindowEvents()` Tests the dummy implementations of the other window events.
`void`	`testWindowOpenedFocusListener()` Tests whether the controller registers itself as focus listener.
`void`	`testWindowOpenedFormValidator()` Tests whether the `FormValidator` is set when the window is opened.
`void`	`testWindowOpenedInitFormFields()` Tests whether the form's fields are initialized in the setup phase.
`void`	`testWindowOpenedNoCompBuilderData()` Tests the windowOpened() method when no component builder data is set.
`void`	`testWindowOpenedNoWindow()` Tests the windowOpened() method when no window object is specified.
`void`	`testWindowOpenedNoWindowBuilderData()` Tests the windowOpened() method when no window builder data is set.
`void`	`testWindowOpenedRegisterBtnCancel()` Tests whether an action listener for the cancel button is registered.
`void`	`testWindowOpenedRegisterBtnOk()` Tests whether an action listener for the OK button is registered.
`void`	`testWindowOpenedValidationTrigger()` Tests whether the validation trigger is called in the setup phase.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - TestFormController
```
public TestFormController()
```
- Method Detail
  - setUp
```
public void setUp()
           throws Exception
```
    Throws:
    
    Exception
  - testInit
```
public void testInit()
```
    Tests a newly created controller.
  - testGetForm
```
public void testGetForm()
```
    Tests querying the form from the controller.
  - testGetFormBean
```
public void testGetFormBean()
```
    Tests querying the form bean.
  - testWindowOpenedNoCompBuilderData
```
public void testWindowOpenedNoCompBuilderData()
```
    Tests the windowOpened() method when no component builder data is set. This should cause an exception.
  - testWindowOpenedNoWindowBuilderData
```
public void testWindowOpenedNoWindowBuilderData()
```
    Tests the windowOpened() method when no window builder data is set. This should cause an exception.
  - testWindowOpenedNoWindow
```
public void testWindowOpenedNoWindow()
```
    Tests the windowOpened() method when no window object is specified. This should cause an exception.
  - testWindowOpenedRegisterBtnOk
```
public void testWindowOpenedRegisterBtnOk()
```
    Tests whether an action listener for the OK button is registered.
  - testWindowOpenedRegisterBtnCancel
```
public void testWindowOpenedRegisterBtnCancel()
```
    Tests whether an action listener for the cancel button is registered.
  - testWindowOpenedFocusListener
```
public void testWindowOpenedFocusListener()
```
    Tests whether the controller registers itself as focus listener.
  - testWindowOpenedValidationTrigger
```
public void testWindowOpenedValidationTrigger()
```
    Tests whether the validation trigger is called in the setup phase.
  - testWindowOpenedInitFormFields
```
public void testWindowOpenedInitFormFields()
```
    Tests whether the form's fields are initialized in the setup phase.
  - testWindowOpenedFormValidator
```
public void testWindowOpenedFormValidator()
```
    Tests whether the FormValidator is set when the window is opened.
  - testSetFormValidatorExistingForm
```
public void testSetFormValidatorExistingForm()
```
    Tests whether a FormValidator can be set if the form already exists.
  - testWindowEvents
```
public void testWindowEvents()
```
    Tests the dummy implementations of the other window events. We can only test here whether an exception is thrown.
  - testIsFieldVisited
```
public void testIsFieldVisited()
```
    Tests whether visited fields are correctly tracked.
  - testInitialValidation
```
public void testInitialValidation()
```
    Tests the initial validation that happens when the form is opened.
  - testValidationInvalidNotVisited
```
public void testValidationInvalidNotVisited()
```
    Tests a validation if the field is invalid, but has not yet been visited.
  - testValidationLastStatus
```
public void testValidationLastStatus()
```
    Tests whether the last known validation status is stored.
  - testValidationValid
```
public void testValidationValid()
```
    Tests a valid validation. Data should be copied into the model object.
  - testGetLastValidationResults
```
public void testGetLastValidationResults()
```
    Tests whether the results of the last validation are recorded and can be queried later.
  - testGetLastValidationResultsNoValidation
```
public void testGetLastValidationResultsNoValidation()
```
    Tests the results returned by getLastValidationResults() if no validation has been performed so far. In this case a valid results object should be returned.
  - testValidationNoModel
```
public void testValidationNoModel()
```
    Tests validation if no model object exists. This should work, but no data is copied.
  - testGetBuilderData
```
public void testGetBuilderData()
```
    Tests whether the BuilderData object can be obtained.
  - testFetchMessageOutputExplicit
```
public void testFetchMessageOutputExplicit()
```
    Tests obtaining the message output object when one was explicitly set.
  - testFetchMessageOutputBuilderData
```
public void testFetchMessageOutputBuilderData()
```
    Tests obtaining the message output object from the builder data.
  - testFetchValidationMessageFormatExplicit
```
public void testFetchValidationMessageFormatExplicit()
```
    Tests obtaining the validation message format object when it was explicitly set.
  - testFetchValidationMessageFormatDefault
```
public void testFetchValidationMessageFormatDefault()
```
    Tests obtaining the validation message format object when no specific object was set. In this case the default format object from the bean context must be fetched.
  - testFetchValidationMessageBoxCaptionDefault
```
public void testFetchValidationMessageBoxCaptionDefault()
```
    Tests obtaining the caption for the validation message box when no caption was set explicitly. In this case it will be fetched from the resources.
  - testActionPerformedCancel
```
public void testActionPerformedCancel()
```
    Tests the handling of the action event for the cancel button. The associated window should be closed immediately.
  - testActionPerformedOkValid
```
public void testActionPerformedOkValid()
```
    Tests the handling of the action event for the OK button when the form's input fields contain valid data.
  - testActionPerformedOkInvalid
```
public void testActionPerformedOkInvalid()
```
    Tests the handling of the action event for the OK button when the form's input fields contain invalid data. In this case the window is not closed, but an error message is displayed using the message output object. Also all form fields should be marked as visited.
  - testValidateWithErrorMessageDisplay
```
public void testValidateWithErrorMessageDisplay()
```
    Tests the validation method that displays error messages in case of validation failures.
  - testActionPerformedUnknownButton
```
public void testActionPerformedUnknownButton()
```
    Tests the actionPerformed() method when an unknown event is received. This should be ignored.
  - testActionPerformedNoComponentName
```
public void testActionPerformedNoComponentName()
```
    Tests processing of an action event that does not have a component name. This event should be ignored. (It's unlikely that such an event will ever be received, but you never know...)
  - testWindowClosedOKCommand
```
public void testWindowClosedOKCommand()
```
    Tests whether the OK command is executed when the form is committed.
  - testWindowClosedCancelCommand
```
public void testWindowClosedCancelCommand()
```
    Tests whether the cancel command is executed when the form is not committed.
  - testCreateFormControllerEventNoController
```
public void testCreateFormControllerEventNoController()
```
    Tries to create a form controller event without a controller reference. This should cause an exception.
  - testCreateFormControllerValidationEventNoResults
```
public void testCreateFormControllerValidationEventNoResults()
```
    Tries to create a validation event without results. This should cause an exception.
  - testAddValidationListener
```
public void testAddValidationListener()
```
    Tests whether validation listeners can be added and are called correctly.
  - testAddValidationListenerNull
```
public void testAddValidationListenerNull()
```
    Tries to add a null validation listener. This should cause an exception.
  - testRemoveValidationListener
```
public void testRemoveValidationListener()
```
    Tests whether validation listeners can be removed.
  - testCreateFormControllerFieldStatusEventNoField
```
public void testCreateFormControllerFieldStatusEventNoField()
```
    Tries to create a field status event without a field name. This should cause an exception.
  - testAddFieldStatusListener
```
public void testAddFieldStatusListener()
```
    Tests whether listeners for field status events can be added.
  - testAddFieldStatusListenerNull
```
public void testAddFieldStatusListenerNull()
```
    Tries to add a null field status listener. This should cause an exception.
  - testRemoveFieldStatusListener
```
public void testRemoveFieldStatusListener()
```
    Tests whether field status listeners can be removed.
  - testAddFormListenerNull
```
public void testAddFormListenerNull()
```
    Tries to add a null form listener. This should cause an exception.
  - testRemoveFormListener
```
public void testRemoveFormListener()
```
    Tests whether a form listener can be removed.
  - testGetFormListeners
```
public void testGetFormListeners()
```
    Tests whether the registered form listeners can be queried.
  - testFireFormEventNotCommitted
```
public void testFireFormEventNotCommitted()
```
    Tests the form event fired for a non-committed form.
  - testFireFormEventCommitted
```
public void testFireFormEventCommitted()
```
    Tests the form event fired for a committed form.
  - testWindowClosedFormListenerNotCommitted
```
public void testWindowClosedFormListenerNotCommitted()
```
    Tests whether form listeners are called when the window is closed and the form was not committed.
  - testWindowClosedFormListenerCommitted
```
public void testWindowClosedFormListenerCommitted()
```
    Tests whether form listeners are called when the window is closed and the form was committed.
  - testListenerRegistrationViaReflection
```
public void testListenerRegistrationViaReflection()
```
    Tests whether event listeners can be registered at a controller using the reflection-based mechanism supported by FormEventManager. This is important to demonstrate whether event registration tags work with these kinds of listeners.

Class TestFormController

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

TestFormController

Method Detail

setUp

testInit

testGetForm

testGetFormBean

testWindowOpenedNoCompBuilderData

testWindowOpenedNoWindowBuilderData

testWindowOpenedNoWindow

testWindowOpenedRegisterBtnOk

testWindowOpenedRegisterBtnCancel

testWindowOpenedFocusListener

testWindowOpenedValidationTrigger

testWindowOpenedInitFormFields

testWindowOpenedFormValidator

testSetFormValidatorExistingForm

testWindowEvents

testIsFieldVisited

testInitialValidation

testValidationInvalidNotVisited

testValidationLastStatus

testValidationValid

testGetLastValidationResults

testGetLastValidationResultsNoValidation

testValidationNoModel

testGetBuilderData

testFetchMessageOutputExplicit

testFetchMessageOutputBuilderData

testFetchValidationMessageFormatExplicit

testFetchValidationMessageFormatDefault

testFetchValidationMessageBoxCaptionDefault

testActionPerformedCancel

testActionPerformedOkValid

testActionPerformedOkInvalid

testValidateWithErrorMessageDisplay

testActionPerformedUnknownButton

testActionPerformedNoComponentName

testWindowClosedOKCommand

testWindowClosedCancelCommand

testCreateFormControllerEventNoController

testCreateFormControllerValidationEventNoResults

testAddValidationListener

testAddValidationListenerNull

testRemoveValidationListener

testCreateFormControllerFieldStatusEventNoField

testAddFieldStatusListener

testAddFieldStatusListenerNull

testRemoveFieldStatusListener

testAddFormListenerNull

testRemoveFormListener

testGetFormListeners

testFireFormEventNotCommitted

testFireFormEventCommitted

testWindowClosedFormListenerNotCommitted

testWindowClosedFormListenerCommitted

testListenerRegistrationViaReflection