semorg.gui
Class LecturerWindow

java.lang.Object
  extended by semorg.gui.LecturerWindow

public class LecturerWindow
extends Object

The window for editing new or existing lecturer records.


Nested Class Summary
(package private)  class LecturerWindow.InputChangedListener
          Inner class which provides a listener reacting on changes of the input in this window.
 
Field Summary
private  org.eclipse.swt.widgets.Button abortButton
           
private  org.eclipse.swt.widgets.Button addressLabelButton
           
private  org.eclipse.swt.widgets.Combo annexCombo
           
private  org.eclipse.swt.widgets.Button applyButton
           
private  org.eclipse.swt.widgets.Text bioText
          The text field which shows the biography of the lecturer record.
private  CalendarControl birthDayCalendar
           
private  org.eclipse.swt.widgets.Text cityText
           
private  AssociationTabControl conductControl
          The control widget to manage the association conduct.
private  org.eclipse.swt.widgets.Combo countryCombo
           
private  org.eclipse.swt.widgets.Text dailyFeeText
           
private  org.eclipse.swt.widgets.Text emailText
           
private  org.eclipse.swt.widgets.Text faxText
           
private  CalendarControl firstContactCalendar
           
private  org.eclipse.swt.widgets.Text firstNameText
           
private  org.eclipse.swt.widgets.Text hourlyFeeText
           
private  Lecturer input
          Holds the data of the actual displayed lecturer record.
private  boolean inputChanged
          Is set to true if the input has been changed and not committed yet, otherwise it is set to false.
private  LecturerWindow.InputChangedListener inputChangedListener
          Listener instance added to the most elements of the window.
private  boolean inputEditingEnabled
          true if the editing of the input (i.e. the elements of the form) has been enabled, otherwise it is false.
private  AssociationTabControl instructorControl
          The control widget to manage the association instructor.
private  org.eclipse.swt.widgets.Text memoText
           
private  org.eclipse.swt.widgets.Text mobileText
           
private  org.eclipse.swt.widgets.Text nameText
          Text field for the lastname of the lecurer.
private  org.eclipse.swt.widgets.Button newButton
           
private  org.eclipse.swt.widgets.Button nextButton
          The triangle-button with the apex to the right.
private  org.eclipse.swt.widgets.Label numberLabel
           
private  org.eclipse.swt.widgets.Text numberText
           
private  org.eclipse.swt.widgets.Button okButton
           
private  org.eclipse.swt.widgets.Text phoneText
           
private  org.eclipse.swt.widgets.Button prevButton
          The triangle-button with the apex to the left.
private  org.eclipse.swt.widgets.Combo salutationCombo
           
private  boolean settingInput
          Is set to true if the data from the database (or corresponding from input) is to be set into the window form, otherwise false.
private  org.eclipse.swt.widgets.Shell shell
          The editing window.
private  org.eclipse.swt.widgets.Text shortMessageText
           
private  org.eclipse.swt.widgets.Text streetText
           
private  AssociationTabControl supervisorControl
          The control widget to manage the association supervisor.
private  int titleBarHeight
          The height of the title bar.
private  org.eclipse.swt.widgets.Combo titleCombo
           
private  org.eclipse.swt.widgets.Text zipCodeText
           
 
Constructor Summary
private LecturerWindow(org.eclipse.swt.widgets.Shell parent, AssociationTabControl caller)
          Creates a LecturerWindow instance with the given shell as the parent shell.
  LecturerWindow(org.eclipse.swt.widgets.Shell parent, Lecturer input, AssociationTabControl caller)
          Creates an instance of this class, sets the input and finally opens it.
 
Method Summary
protected  boolean checkInput()
          Checks if all obligatory attributes (salutation, lastname) of a lecturer record are entered into the window form and if the entered fees are correct float numbers.
protected  void commitInputToDB()
          Reads the data from the window form elements, sets the values to a Lecturer instance and commits the changes / the new record into the database.
private  boolean confirmClose()
          Creates a message dialog if the data in the window form has been changed (or was entered newly) and these changes haven't been confirmed (e.g. by clicking the ok button) or discarded so far.
private  void createButtonListener(org.eclipse.swt.widgets.Composite buttons, AssociationTabControl caller)
          Adds a listener to several buttons of the window form.
private  boolean onSave()
          Checks whether the input has been changed (i.e. inputChanged equals true) or not.
private  void setInput(Lecturer lecturer)
          Loads a given lecturer record into the window form of initialize the elements of the form the empty string/null if no data is given.
private  void setInputComponentsEnabled(boolean enabled)
          According to the value of the given parameter (true/false) this method enables / disables the widgets of the window form.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

input

private Lecturer input
Holds the data of the actual displayed lecturer record. If a new record is entered it is set to null until the changes have been committed.


settingInput

private boolean settingInput
Is set to true if the data from the database (or corresponding from input) is to be set into the window form, otherwise false.

That is needed to prevent the ModifyListener from firing when the data is load into the window form by using the .setText() methods of the gui elements.


inputChanged

private boolean inputChanged
Is set to true if the input has been changed and not committed yet, otherwise it is set to false.


inputEditingEnabled

private boolean inputEditingEnabled
true if the editing of the input (i.e. the elements of the form) has been enabled, otherwise it is false.

This flag indicates whether the actual displayed record has been locked by the actual editing window or not. This avoids the releasing of records which are locked by other editing windows.


inputChangedListener

private LecturerWindow.InputChangedListener inputChangedListener
Listener instance added to the most elements of the window.


shell

private org.eclipse.swt.widgets.Shell shell
The editing window.


titleBarHeight

private int titleBarHeight
The height of the title bar.


numberLabel

private final org.eclipse.swt.widgets.Label numberLabel

numberText

private final org.eclipse.swt.widgets.Text numberText

salutationCombo

private final org.eclipse.swt.widgets.Combo salutationCombo

titleCombo

private final org.eclipse.swt.widgets.Combo titleCombo

firstNameText

private final org.eclipse.swt.widgets.Text firstNameText

nameText

private final org.eclipse.swt.widgets.Text nameText
Text field for the lastname of the lecurer.


streetText

private final org.eclipse.swt.widgets.Text streetText

zipCodeText

private final org.eclipse.swt.widgets.Text zipCodeText

cityText

private final org.eclipse.swt.widgets.Text cityText

countryCombo

private final org.eclipse.swt.widgets.Combo countryCombo

annexCombo

private final org.eclipse.swt.widgets.Combo annexCombo

phoneText

private final org.eclipse.swt.widgets.Text phoneText

mobileText

private final org.eclipse.swt.widgets.Text mobileText

faxText

private final org.eclipse.swt.widgets.Text faxText

emailText

private final org.eclipse.swt.widgets.Text emailText

birthDayCalendar

private final CalendarControl birthDayCalendar

firstContactCalendar

private final CalendarControl firstContactCalendar

bioText

private final org.eclipse.swt.widgets.Text bioText
The text field which shows the biography of the lecturer record.


dailyFeeText

private final org.eclipse.swt.widgets.Text dailyFeeText

hourlyFeeText

private final org.eclipse.swt.widgets.Text hourlyFeeText

shortMessageText

private final org.eclipse.swt.widgets.Text shortMessageText

memoText

private final org.eclipse.swt.widgets.Text memoText

supervisorControl

private AssociationTabControl supervisorControl
The control widget to manage the association supervisor.


instructorControl

private AssociationTabControl instructorControl
The control widget to manage the association instructor.


conductControl

private AssociationTabControl conductControl
The control widget to manage the association conduct.


okButton

private final org.eclipse.swt.widgets.Button okButton

applyButton

private final org.eclipse.swt.widgets.Button applyButton

newButton

private final org.eclipse.swt.widgets.Button newButton

abortButton

private final org.eclipse.swt.widgets.Button abortButton

prevButton

private final org.eclipse.swt.widgets.Button prevButton
The triangle-button with the apex to the left.


nextButton

private final org.eclipse.swt.widgets.Button nextButton
The triangle-button with the apex to the right.


addressLabelButton

private final org.eclipse.swt.widgets.Button addressLabelButton
Constructor Detail

LecturerWindow

private LecturerWindow(org.eclipse.swt.widgets.Shell parent,
                       AssociationTabControl caller)
Creates a LecturerWindow instance with the given shell as the parent shell.

It also adds a listener which reacts on closing events. It checks if changes have been made and if so it opens a dialog which informs the user and asks for a decision (confirm/discard). Finally it releases the locked record (if one is displayed and it is locked by this editing window).

Parameters:
parent - Shell instance used the as parent shell of the lecturer window.
caller - AssociationTabControl instance which called the editing window. If editing window is called by a menu this parameter is null.

LecturerWindow

public LecturerWindow(org.eclipse.swt.widgets.Shell parent,
                      Lecturer input,
                      AssociationTabControl caller)
Creates an instance of this class, sets the input and finally opens it.

Parameters:
parent - the parent shell to which this window belongs
input - the lecturer data to be displayed in the window
Method Detail

setInput

private void setInput(Lecturer lecturer)
Loads a given lecturer record into the window form of initialize the elements of the form the empty string/null if no data is given.

Parameters:
lecturer - Lecturer instance which contains the data to be displayed or null if a completely new record is to be edited.

setInputComponentsEnabled

private void setInputComponentsEnabled(boolean enabled)
According to the value of the given parameter (true/false) this method enables / disables the widgets of the window form.

Note: It also sets the member inputEditingEnabled to the value of the parameter to signal that editing of the input has been enabled or not.

Parameters:
enabled - if equals true the widgets are enabled otherwise the widgets get disabled.

createButtonListener

private void createButtonListener(org.eclipse.swt.widgets.Composite buttons,
                                  AssociationTabControl caller)
Adds a listener to several buttons of the window form.

This involves at the moment the buttons okButton, abortButton, applyButton, newButton, prevButton, nextButton.


checkInput

protected boolean checkInput()
Checks if all obligatory attributes (salutation, lastname) of a lecturer record are entered into the window form and if the entered fees are correct float numbers.

Returns:
true if all mandatory fields are set and the fee values are valid float numbers (if entered), otherwise false.
See Also:
Utility.isCorrectFloat(String)

commitInputToDB

protected void commitInputToDB()
Reads the data from the window form elements, sets the values to a Lecturer instance and commits the changes / the new record into the database. Furthermore the member input is set to the new values.


confirmClose

private boolean confirmClose()
Creates a message dialog if the data in the window form has been changed (or was entered newly) and these changes haven't been confirmed (e.g. by clicking the ok button) or discarded so far. It also receives the decision of the user (confirm/discard changes or abort the window closing) and handels it. In the positive case (confirmation of the changes) it invokes the method onSave().

Returns:
true if the shell can be closed and false otherwise.

onSave

private boolean onSave()
Checks whether the input has been changed (i.e. inputChanged equals true) or not. If changes have been done, it firstly checks if the changes are valid (checkInput()), secondly invokes the method commitInputToDB() to commit the changes and thirdly updates the GUI by invoking the method setInput(Lecturer).

Returns:
true if nothing has changed or the commit of the changes to the database was successful, false otherwise.